---
name: groundwater-wells-aquifers-and-registry-api
description: "Groundwater Wells, Aquifers and Registry API skill. Use when working with Groundwater Wells, Aquifers and Registry for aquifer-codes, aquifers, cities. Covers 24 endpoints."
version: 1.0.0
generator: lapsh
---

# Groundwater Wells, Aquifers and Registry API
API version: v1

## Auth
ApiKey JWT in header

## Base URL
https://apps.nrs.gov.bc.ca/gwells/api/v1/

## Setup
1. Set your API key in the appropriate header
2. GET /aquifer-codes/demand/ -- return a list of aquifer demand codes
3. Explore available endpoints below

## Endpoints
24 endpoints across 9 groups. See references/api-spec.lap for full details.

### Aquifer-codes
| Method | Path | Description |
|--------|------|-------------|
| GET | /aquifer-codes/demand/ | return a list of aquifer demand codes |
| GET | /aquifer-codes/materials/ | return a list of aquifer material codes |
| GET | /aquifer-codes/productivity/ | return a list of aquifer productivity codes |
| GET | /aquifer-codes/quality-concerns/ | return a list of quality concern codes |
| GET | /aquifer-codes/subtypes/ | return a list of aquifer subtype codes |
| GET | /aquifer-codes/vulnerability/ | return a list of aquifer vulnerability codes |
| GET | /aquifer-codes/water-use/ | return a list of water use codes |

### Aquifers
| Method | Path | Description |
|--------|------|-------------|
| GET | /aquifers/ | return a list of aquifers |
| GET | /aquifers/names/ | List all aquifers in a simplified format |
| GET | /aquifers/{aquifer_id}/ | return details of aquifers |
| GET | /aquifers/{aquifer_id}/files | list files found for the aquifer identified in the uri |

### Cities
| Method | Path | Description |
|--------|------|-------------|
| GET | /cities/drillers/ | returns a list of cities with a qualified, registered operator (driller or installer) |
| GET | /cities/installers/ | returns a list of cities with a qualified, registered operator (driller or installer) |

### Config
| Method | Path | Description |
|--------|------|-------------|
| GET | /config | serves general configuration |

### Drillers
| Method | Path | Description |
|--------|------|-------------|
| GET | /drillers/ | Returns a list of all person records |
| GET | /drillers/names/ | Search for a person in the Register |
| GET | /drillers/{person_guid}/files/ | list files found for the aquifer identified in the uri |

### Keycloak
| Method | Path | Description |
|--------|------|-------------|
| GET | /keycloak | serves keycloak config |

### Submissions
| Method | Path | Description |
|--------|------|-------------|
| GET | /submissions/options/ | Options required for submitting activity report forms |

### Surveys
| Method | Path | Description |
|--------|------|-------------|
| GET | /surveys/ | returns a list of active surveys |

### Wells
| Method | Path | Description |
|--------|------|-------------|
| GET | /wells/ | returns a list of wells |
| GET | /wells/tags/ | seach for wells by tag or owner |
| GET | /wells/{tag}/files | list files found for the well identified in the uri |
| GET | /wells/{well_tag_number} | Return well detail. |

## Common Questions
Match user requests to endpoints in references/api-spec.lap. Key patterns:
- "List all demand?" -> GET /aquifer-codes/demand/
- "List all materials?" -> GET /aquifer-codes/materials/
- "List all productivity?" -> GET /aquifer-codes/productivity/
- "List all quality-concerns?" -> GET /aquifer-codes/quality-concerns/
- "List all subtypes?" -> GET /aquifer-codes/subtypes/
- "List all vulnerability?" -> GET /aquifer-codes/vulnerability/
- "List all water-use?" -> GET /aquifer-codes/water-use/
- "Search aquifers?" -> GET /aquifers/
- "Search names?" -> GET /aquifers/names/
- "Get aquifer details?" -> GET /aquifers/{aquifer_id}/
- "List all files?" -> GET /aquifers/{aquifer_id}/files
- "List all drillers?" -> GET /cities/drillers/
- "List all installers?" -> GET /cities/installers/
- "List all config?" -> GET /config
- "Search drillers?" -> GET /drillers/
- "List all keycloak?" -> GET /keycloak
- "List all options?" -> GET /submissions/options/
- "List all surveys?" -> GET /surveys/
- "List all wells?" -> GET /wells/
- "Search tags?" -> GET /wells/tags/
- "Get well details?" -> GET /wells/{well_tag_number}
- "How to authenticate?" -> See Auth section above

## Response Tips
- Check response schemas in references/api-spec.lap for field details
- Paginated endpoints accept limit/offset or cursor parameters

## References
- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

> Generated from the official API spec by [LAP](https://lap.sh)