USGS Water API Documentation
Developer documentation for the services hosted at api.water.usgs.gov.
The services at api.water.usgs.gov are organized under five base paths.
Each section below documents one service path. The NLDI has been migrated
from Java to Python; the API contract is unchanged — see
Getting Started with the NLDI
for migration details.
| Service path | Documentation | What it provides |
|---|---|---|
/nldi/linked-data/ |
NLDI Core API | Network navigation, feature discovery, and basin delineation on the NHDPlusV2 hydrologic network |
/nldi/pygeoapi/ |
NLDI pygeoapi Processes | Geoprocessing services — raindrop trace, split catchment, and cross sections — exposed via OGC API – Processes |
/fabric/pygeoapi/ |
Fabric pygeoapi | NHDPlusV2 and NHDPlusHR vector features (flowlines, catchments, hydrologic units, gages) via OGC API – Features and Tiles |
/gdp/pygeoapi/ |
GDP pygeoapi | Gridded climate and meteorological datasets via OGC API – EDR, STAC, and Processes |
/nwaa/ |
NWAA Web Services | National Water Availability Assessment Data Companion |