GET /nwis/gwlevels
Summary: Get groundwater level data
Operation ID: getGroundwaterLevels
Auth: unknown
Operation ID: getGroundwaterLevels
Auth: unknown
Description
Retrieve historical manually-recorded groundwater levels from wells. This is distinct from automated real-time data available via the Instantaneous Values service.
Parameters (19)
agencyCd
(string, query, optional)
Agency code
aquiferCd
(string, query, optional)
National aquifer codes (10 characters, up to 1000 values)
bBox
(string, query, optional)
Bounding box as west,south,east,north
countyCd
(string, query, optional)
5-digit FIPS county codes (1-20 values)
endDT
(string, query, optional)
End date in ISO-8601 format
format
(string, query, optional, default: json)
Output format
Constraints: {'enum': ['json', 'rdb', 'waterml']}
holeDepthMax
(number, query, optional)
Maximum hole depth in feet
holeDepthMin
(number, query, optional)
Minimum hole depth in feet
huc
(string, query, optional)
Hydrologic Unit Code(s) (1-10 values)
localAquiferCd
(string, query, optional)
State-local aquifer codes (format: ST:AAAAAAA, up to 1000 values)
parameterCd
(string, query, optional)
USGS parameter codes (e.g., 72019=depth to water level, 62610=level above NGVD)
period
(string, query, optional)
ISO-8601 duration for data range
siteStatus
(string, query, optional, default: all)
Filter by site status
Constraints: {'enum': ['all', 'active', 'inactive']}
siteType
(string, query, optional)
Site type codes (e.g., GW, GW-MW)
sites
(string, query, optional)
Comma-separated site numbers (1-100 values)
startDT
(string, query, optional)
Start date in ISO-8601 format
stateCd
(string, query, optional)
Two-letter US state code
Constraints: {'minLength': 2, 'maxLength': 2}
wellDepthMax
(number, query, optional)
Maximum well depth in feet
wellDepthMin
(number, query, optional)
Minimum well depth in feet
Examples (1)
| Title | Type | URL | Action |
|---|---|---|---|
| Get groundwater level data | openapi-spec |
https://waterservices.usgs.gov/nwis/gwlevels?sites=375907091432201&period=P1Y |
Probe History
Status Codes
| Time | Status | Latency | Size |
|---|---|---|---|
| 2026-03-23 10:40:55.935109 | 400 | 613ms |