Skip to main content
All providers

USGS Water Services

GeoUS

waterservices.usgs.gov

US streamflow, gage height and groundwater readings from the National Water Information System, live and historical.

Capabilities (8)

GET /v1/data/usgswater/continuous1 credit

Returns individual continuous (sensor) observations for a monitoring location as GeoJSON features with time, parameter code, value, unit, qualifier and approval status.

monitoring_location_idparameter_code?statistic_id?datetime?time_series_id?approval_status?limit?offset?
GET /v1/data/usgswater/daily1 credit

Returns the daily-statistic time series for a gauge - usually daily mean discharge - as a WaterML-in-JSON timeSeries document.

sitesparameterCd?startDT?endDT?statCd?siteStatus?
GET /v1/data/usgswater/fieldmeasurements1 credit

Returns discrete field visit measurements for a site as GeoJSON - manual discharge and stage readings taken by a hydrographer, with measurement quality rating and the party that took it.

monitoring_location_idparameter_code?datetime?limit?offset?
GET /v1/data/usgswater/instantaneous1 credit

Returns the real-time sensor time series for a gauge - typically 15-minute discharge, gage height or temperature - as a WaterML-in-JSON timeSeries document with values, timestamps and qualifier codes.

sitesparameterCd?startDT?endDT?period?siteStatus?modifiedSince?
GET /v1/data/usgswater/latest1 credit

Returns the most recent value of every continuous time series at one monitoring location as GeoJSON, each feature carrying parameter code, statistic, value, unit, timestamp and approval status.

monitoring_location_idparameter_code?statistic_id?limit?offset?
GET /v1/data/usgswater/parametercodes1 credit

Returns the USGS parameter code dictionary - code, parameter name, unit of measure, group and full description - as GeoJSON features.

id?parameter_name?parameter_group_code?unit_of_measure?limit?offset?
GET /v1/data/usgswater/peaks1 credit

Returns the annual peak streamflow and peak gage height record for a site as GeoJSON, one feature per water year, which is the basis for flood-frequency work.

monitoring_location_idparameter_code?water_year?limit?offset?
GET /v1/data/usgswater/sites1 credit

Returns USGS monitoring locations as GeoJSON features with site number, name, agency, coordinates, site type, state and county, altitude, drainage area and hydrologic unit.

id?monitoring_location_name?monitoring_location_number?agency_code?state_name?county_name?site_type_code?hydrologic_unit_code?national_aquifer_code?bbox?limit?offset?

Licence

A work of the United States Government, not subject to copyright protection in the United States (17 U.S.C. 105). USGS water data is in the public domain.

https://www.usgs.gov/information-policies-and-instructions/copyrights-and-credits

Attribution

Display this wherever you show the data. It arrives on every response as provenance.attribution_text.

Source: U.S. Geological Survey, National Water Information System

Cache: up to 900s