USGS Water Data

App · 19 actions

Read the U.S. Geological Survey's water data for thousands of rivers, streams, lakes and wells across the United States: find monitoring sites, get the latest streamflow, water level and water temperature, read readings and daily values for any period, compare today with what is normal for the date, check gages against nearby flood levels, and get groundwater levels, water quality samples and river camera images. No account or API key required.

Actions

ActionWhat it does
Check flood levelsCompare a gage's latest water level with the places nearby that USGS has surveyed as flooding at a set level (roads, bridges, boat ramps, buildings): which are flooding, and how far the water must rise to reach the next one.
Compare to normalCompare a site's latest reading with the same day of the year in every past year on record: the typical (median) value, the record low and high, where today falls as a percentile, and a plain answer such as Below normal or Much above normal.
Find monitoring sitesFind USGS monitoring sites (river gages, lakes, wells, springs, weather stations) by state, county, type, what they measure, name or map area.
Find places flooding nowList the places USGS has surveyed near its gages (roads, bridges, boat ramps, buildings) where the water is at or above their flood level right now, across the country or in one state.
Find river camerasList the public cameras at USGS sites in a state, each with the site it watches and a link to its newest image.
Find sites near a locationFind USGS monitoring sites within a distance of a point, nearest first, with how far away each one is and what it measures.
Get annual peak flowsGet the highest discharge or gage height of each water year (October to September) on record, newest or largest first, with the record peak and notes such as dam regulation.
Get daily valuesGet a measurement's daily mean, minimum and maximum (or daily total, for precipitation) for a range of days, with the range's highest and lowest.
Get field measurementsGet the values USGS hydrographers measured by hand on site visits, such as discharge and gage height, newest first, with how they were measured and how accurate they were rated.
Get groundwater levelsGet the water levels measured in a well, newest first: depth to water below the land surface and the water level's elevation, with how much it changed over the measurements listed.
Get latest readingsGet the newest reading of every sensor at a site, such as streamflow, gage height (water level) and water temperature, with when it was taken, whether it is provisional, and any notes such as ice.
Get monthly or yearly statisticsGet the mean, median, minimum, maximum and percentiles of a measurement's daily values for each month, calendar year or water year in a range.
Get readings for a time rangeGet a sensor's readings (usually every 5 to 15 minutes) for a time range of up to 3 years, with the low, high, average and latest.
Get site camera imagesGet the images from a site's public river camera: the newest one in three sizes, a time-lapse video when the camera makes one, and its recent images.
Get site detailsGet a monitoring site's name, type, location, county and state, altitude, drainage area and watershed, and for a well its depth and aquifer.
Get typical values for the yearGet what is typical at a site for each day or month of the year, from its whole record: mean, median, record low and high, and percentiles, with how many years they cover.
Get water quality samplesGet the results of water samples taken at a site and analysed in the field or a lab, such as nutrients, metals, bacteria or pesticides, newest first, with units and whether each result is final.
List what a site measuresList everything a site records: each measurement, whether it is real-time readings, daily values or annual peaks, since when, and whether it is still recorded.
Look up parameter codesFind the 5-digit codes USGS uses for what it measures, by code, by words in their name or description, or by group, with the unit each is reported in.

Check flood levels

Compare a gage's latest water level with the places nearby that USGS has surveyed as flooding at a set level (roads, bridges, boat ramps, buildings): which are flooding, and how far the water must rise to reach the next one. Says so when a gage has no surveyed places.

Inputs

Site numbersite_numbertextRequired
The gage's USGS site number. 'Find places flooding now' lists gages with surveyed places.

Outputs

countnumber
How many places are listed.
floodingtrue/false
True when at least one place is flooding.
flooding_countnumber
How many places are flooding.
foundtrue/false
True when USGS has surveyed flood levels for this gage.
latest_timetext
When the latest water level was taken.
latest_valuenumber
The latest water level.
locationslist
The places, lowest level first.
next_impact_levelnumber
The level at which that place floods.
next_impact_nametext
The lowest place not yet flooding.
parameter_codetext
The code of the water level compared (00065 is gage height).
provisionaltrue/false
True when the value is provisional: recent data USGS has not reviewed yet, which may still be revised.
rise_to_next_impactnumber
How far the water must rise to reach that place, in the gage's units.
site_idtext
The site's full id: the agency, a dash and the site number (USGS-01646500).
site_nametext
The gage's name.
site_numbertext
The site number, 8 to 15 digits (01646500).
unittext
The unit the values are in (ft³/s, ft, °C).
urltext
The site's page on USGS Water Data for the Nation.
Example output
{
  "count": 3,
  "flooding": false,
  "flooding_count": 0,
  "found": true,
  "latest_time": "2026-10-22T08:45:00Z",
  "latest_value": 4.54,
  "locations": [
    {
      "difference": -4.46,
      "flooding": false,
      "id": 19518,
      "impact_statement": "Water floods the boat ramp beneath SR-93 in Grady County.",
      "latitude": 30.791743,
      "level": 9,
      "longitude": -84.154767,
      "name": "Boat Ramp",
      "nws_id": "TMLG1",
      "source": "National Weather Service",
      "unit": "ft"
    },
    {
      "difference": -7.46,
      "flooding": false,
      "id": 19528,
      "impact_statement": "Water approaches the top of the boat ramp south of US-19 in Thomas County.",
      "latitude": 30.925891,
      "level": 12,
      "longitude": -83.999433,
      "name": "Boat Ramp 2",
      "nws_id": "TMLG1",
      "source": "National Weather Service",
      "unit": "ft"
    },
    {
      "difference": -7.89,
      "flooding": false,
      "id": 19527,
      "impact_statement": "Top of left bank",
      "latitude": 30.875694,
      "level": 12.43,
      "longitude": -84.046583,
      "name": "BANK",
      "nws_id": "TMLG1",
      "source": "USGS",
      "unit": "ft"
    }
  ],
  "next_impact_level": 9,
  "next_impact_name": "Boat Ramp",
  "parameter_code": "00065",
  "provisional": true,
  "rise_to_next_impact": 4.46,
  "site_id": "USGS-02327500",
  "site_name": "OCHLOCKONEE RIVER NEAR THOMASVILLE, GA",
  "site_number": "02327500",
  "unit": "ft",
  "url": "https://waterdata.usgs.gov/monitoring-location/USGS-02327500/"
}

Compare to normal

Compare a site's latest reading with the same day of the year in every past year on record: the typical (median) value, the record low and high, where today falls as a percentile, and a plain answer such as Below normal or Much above normal.

Inputs

Site numbersite_numbertextRequired
The USGS site number, 8 to 15 digits. 'Find monitoring sites' finds one, and it is in the address of the site's page on waterdata.usgs.gov.
Measurementparameter_codetext
What to compare. Pick from what the site measures (type the site number first), or type a 5-digit parameter code. Defaults to discharge (00060).Default: 00060.

Outputs

comparedtrue/false
True when there was both a latest reading and a long-term record for this day to compare it with.
conditiontext
The reading in words, using USGS's classes: Much below normal, Below normal, Normal, Above normal, Much above normal, or a record.
day_of_yeartext
The calendar day compared (MM-DD).
latest_timetext
When the latest reading was taken.
latest_valuenumber
The latest reading.
normal_maximumnumber
The highest daily mean ever recorded on this day.
normal_meannumber
The average of the daily means for this day of year.
normal_mediannumber
The median daily mean for this day of year.
normal_minimumnumber
The lowest daily mean ever recorded on this day.
notetext
Why no comparison was made, when it was not.
parameter_codetext
USGS's 5-digit code for what is measured (00060 is discharge).
parameter_nametext
What is measured, in USGS's words (Discharge).
percent_of_mediannumber
The latest reading as a percentage of the median.
percentile_ranknumber
Where the latest reading falls among past years on this day, 0 to 100 (estimated between the published percentiles).
percentilesobject
Percentiles of the daily means for this day of year.
provisionaltrue/false
True when the value is provisional: recent data USGS has not reviewed yet, which may still be revised.
site_idtext
The site's full id: the agency, a dash and the site number (USGS-01646500).
site_numbertext
The site number, 8 to 15 digits (01646500).
unittext
The unit the values are in (ft³/s, ft, °C).
urltext
The site's page on USGS Water Data for the Nation.
years_of_recordnumber
How many years of approved data the normals come from.
Example output
{
  "compared": true,
  "condition": "Normal",
  "day_of_year": "10-22",
  "latest_time": "2026-10-22T08:50:00Z",
  "latest_value": 4360,
  "normal_maximum": 53700,
  "normal_mean": 5529.43,
  "normal_median": 2565,
  "normal_minimum": 687,
  "note": null,
  "parameter_code": "00060",
  "parameter_name": "Discharge (streamflow)",
  "percent_of_median": 170,
  "percentile_rank": 75.1,
  "percentiles": {
    "p10": 1174,
    "p25": 1680,
    "p5": 958.4,
    "p75": 4317.5,
    "p90": 15030,
    "p95": 29080
  },
  "provisional": true,
  "site_id": "USGS-01646500",
  "site_number": "01646500",
  "unit": "ft\u00b3/s",
  "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01646500/",
  "years_of_record": 96
}

Find monitoring sites

Find USGS monitoring sites (river gages, lakes, wells, springs, weather stations) by state, county, type, what they measure, name or map area. Each site comes with its number, location, what it measures and a link to its page. By default only sites reporting real-time data are listed.

Inputs

Statestatetext
The state or territory to search. Leave empty to search by name or map area only.One of: AL (Alabama), AK (Alaska), AS (American Samoa), AZ (Arizona), AR (Arkansas), CA (California), CO (Colorado), CT (Connecticut), DE (Delaware), DC (District of Columbia), and 46 more.
Countycountytext
Only sites in this county of the state. Leave empty for the whole state.
Site typesite_typetext
Only this kind of site. Leave empty for every kind.One of: ST (Stream or river), ST-TS (Tidal stream), ST-CA (Canal), ST-DCH (Ditch), LK (Lake or reservoir), ES (Estuary), OC (Ocean), OC-CO (Coastal ocean), WE (Wetland), SP (Spring), and 4 more.
Measuresparameter_codetext
Only sites that measure this. Pick a common one or type a 5-digit parameter code. Leave empty for sites measuring anything.
Name containsnametext
Only sites whose name contains these words, for example a river's name.
Map areabounding_boxtext
Only sites inside this box: west, south, east, north in decimal degrees.
Which sitesactivitytext
Sites reporting now have real-time sensors with data from the last 7 days. Choose all sites to include ones that stopped years ago.One of: real_time (Sites reporting now (real-time sensors)), recent (Sites with any data in the last year), any (All sites, including discontinued ones). Default: real_time.
Number of siteslimitnumber
The most sites to list. Defaults to 50.From 1 to 1000. Default: 50.

Outputs

countnumber
How many sites are listed.
searchedtext
What was searched for, in words.
siteslist
The sites found, sorted by name.
truncatedtrue/false
True when more sites matched than were listed: narrow the search or raise the number of sites.
Example output
{
  "count": 2,
  "searched": "sites reporting now, stream or river, measuring Discharge (streamflow), county 031, in Maryland",
  "sites": [
    {
      "agency": "USGS",
      "county": "Montgomery County",
      "distance_miles": null,
      "drainage_area_sq_mi": 0.79,
      "huc": "020700080801",
      "last_data_time": "2026-10-22T06:00:00Z",
      "latitude": 39.2066111111111,
      "longitude": -77.2885833333333,
      "measures": [
        "Discharge (streamflow)"
      ],
      "name": "CABIN BRANCH NEAR BOYDS, MD",
      "parameter_codes": [
        "00060"
      ],
      "site_id": "USGS-01644380",
      "site_number": "01644380",
      "site_type": "Stream",
      "state": "Maryland",
      "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01644380/"
    },
    {
      "agency": "USGS",
      "county": "Montgomery County",
      "distance_miles": null,
      "drainage_area_sq_mi": 27,
      "huc": "020600060104",
      "last_data_time": "2026-10-22T07:45:00Z",
      "latitude": 39.174527777777776,
      "longitude": -77.02141666666667,
      "measures": [
        "Discharge (streamflow)"
      ],
      "name": "HAWLINGS RIVER NEAR SANDY SPRING, MD",
      "parameter_codes": [
        "00060"
      ],
      "site_id": "USGS-01591700",
      "site_number": "01591700",
      "site_type": "Stream",
      "state": "Maryland",
      "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01591700/"
    }
  ],
  "truncated": true
}

Find places flooding now

List the places USGS has surveyed near its gages (roads, bridges, boat ramps, buildings) where the water is at or above their flood level right now, across the country or in one state.

Inputs

Statestatetext
Only this state. Leave empty for the whole country.One of: AL (Alabama), AK (Alaska), AS (American Samoa), AZ (Arizona), AR (Arkansas), CA (California), CO (Colorado), CT (Connecticut), DE (Delaware), DC (District of Columbia), and 46 more.

Outputs

countnumber
How many places are flooding.
placeslist
The places flooding now, by state and gage.
site_countnumber
How many gages they belong to.
site_numberslist
The gages with flooding places.
statetext
The state searched, or empty for the whole country.
Example output
{
  "count": 2,
  "places": [
    {
      "above_by": 0.84,
      "current_level": 5.84,
      "impact_statement": "The river has reached bankfull in places.",
      "latitude": 38.030651,
      "level": 5,
      "longitude": -108.109889,
      "name": "BANK",
      "nws_id": "SMPC2",
      "site_name": "SAN MIGUEL RIVER NEAR PLACERVILLE, CO",
      "site_number": "09172500",
      "state": null,
      "unit": "ft",
      "url": "https://waterdata.usgs.gov/monitoring-location/USGS-09172500/"
    },
    {
      "above_by": 0.88,
      "current_level": 60.88,
      "impact_statement": "Approximate bridge chord.",
      "latitude": 40.313749,
      "level": 60,
      "longitude": -124.283191,
      "name": "CHORD",
      "nws_id": "MTOC1",
      "site_name": "MATTOLE R NR PETROLIA CA",
      "site_number": "11469000",
      "state": "CA",
      "unit": "ft",
      "url": "https://waterdata.usgs.gov/monitoring-location/USGS-11469000/"
    }
  ],
  "site_count": 2,
  "site_numbers": [
    "09172500",
    "11469000"
  ],
  "state": null
}

Find river cameras

List the public cameras at USGS sites in a state, each with the site it watches and a link to its newest image.

Inputs

StatestatetextRequired
The state to list cameras in.One of: AL (Alabama), AK (Alaska), AS (American Samoa), AZ (Arizona), AR (Arkansas), CA (California), CO (Colorado), CT (Connecticut), DE (Delaware), DC (District of Columbia), and 46 more.
Name containsnametext
Only cameras whose name contains these words, such as a river's name.

Outputs

cameraslist
The cameras, sorted by name.
countnumber
How many cameras are listed.
statetext
The state searched (two-letter code).
Example output
{
  "cameras": [
    {
      "camera_id": "MD_Beaverdam_Creek_near_Cheverly",
      "description": "Beaverdam Creek near Cheverly, MD",
      "latitude": 38.91630556,
      "longitude": -76.9343056,
      "name": "Beaverdam Creek near Cheverly",
      "newest_image_small_url": "https://usgs-nims-images.s3.amazonaws.com/720/MD_Beaverdam_Creek_near_Cheverly/MD_Beaverdam_Creek_near_Cheverly_newest.jpg",
      "newest_image_time": "2026-10-21T14:00:03Z",
      "newest_image_url": "https://usgs-nims-images.s3.amazonaws.com/overlay/MD_Beaverdam_Creek_near_Cheverly/MD_Beaverdam_Creek_near_Cheverly_newest.jpg",
      "newest_thumbnail_url": "https://usgs-nims-images.s3.amazonaws.com/thumbnail/MD_Beaverdam_Creek_near_Cheverly/MD_Beaverdam_Creek_near_Cheverly_newest.jpg",
      "site_number": "01651730",
      "state": "MD",
      "time_zone": "US/Eastern",
      "timelapse_url": "https://usgs-nims-images.s3.amazonaws.com/timelapse/MD_Beaverdam_Creek_near_Cheverly/MD_Beaverdam_Creek_near_Cheverly_720.mp4"
    }
  ],
  "count": 1,
  "state": "MD"
}

Find sites near a location

Find USGS monitoring sites within a distance of a point, nearest first, with how far away each one is and what it measures.

Inputs

LatitudelatitudenumberRequired
The point's latitude in decimal degrees (38.95).From -90 to 90.
LongitudelongitudenumberRequired
The point's longitude in decimal degrees; west is negative (-77.13).From -180 to 180.
Within (miles)radius_milesnumber
How far from the point to look. Defaults to 10 miles.From 0.1 to 100.0. Default: 10.0.
Site typesite_typetext
Only this kind of site. Leave empty for every kind.One of: ST (Stream or river), ST-TS (Tidal stream), ST-CA (Canal), ST-DCH (Ditch), LK (Lake or reservoir), ES (Estuary), OC (Ocean), OC-CO (Coastal ocean), WE (Wetland), SP (Spring), and 4 more.
Measuresparameter_codetext
Only sites that measure this. Pick a common one or type a 5-digit parameter code. Leave empty for sites measuring anything.
Which sitesactivitytext
Sites reporting now have real-time sensors with data from the last 7 days. Choose all sites to include ones that stopped years ago.One of: real_time (Sites reporting now (real-time sensors)), recent (Sites with any data in the last year), any (All sites, including discontinued ones). Default: real_time.
Number of siteslimitnumber
The most sites to list, nearest first. Defaults to 25.From 1 to 1000. Default: 25.

Outputs

countnumber
How many sites are listed.
latitudenumber
The latitude searched around.
longitudenumber
The longitude searched around.
radius_milesnumber
How far from the point was searched, in miles.
siteslist
The sites found, nearest first.
truncatedtrue/false
True when more sites matched than were listed: shrink the radius or raise the number of sites.
Example output
{
  "count": 2,
  "latitude": 38.95,
  "longitude": -77.13,
  "radius_miles": 5.0,
  "sites": [
    {
      "agency": "USGS",
      "county": "Montgomery County",
      "distance_miles": 0.13,
      "drainage_area_sq_mi": 11560,
      "huc": "020700081005",
      "last_data_time": "2026-10-22T08:00:00Z",
      "latitude": 38.949777777777776,
      "longitude": -77.12763888888888,
      "measures": [
        "Discharge (streamflow)",
        "Dissolved oxygen",
        "Gage height (water level)",
        "Nitrate plus nitrite",
        "pH",
        "Specific conductance",
        "Stream water level (NAVD88)",
        "Turbidity",
        "Water temperature"
      ],
      "name": "POTOMAC RIVER NEAR WASH, DC LITTLE FALLS PUMP STA",
      "parameter_codes": [
        "00010",
        "00060",
        "00065",
        "00095",
        "00300",
        "00400",
        "63160",
        "63680",
        "99133"
      ],
      "site_id": "USGS-01646500",
      "site_number": "01646500",
      "site_type": "Stream",
      "state": "Maryland",
      "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01646500/"
    },
    {
      "agency": "USGS",
      "county": "Fairfax County",
      "distance_miles": 2.55,
      "drainage_area_sq_mi": 2.05,
      "huc": "020700081005",
      "last_data_time": "2026-10-22T08:15:00Z",
      "latitude": 38.9597771566359,
      "longitude": -77.1756742556365,
      "measures": [
        "Autosampler count",
        "Discharge (streamflow)",
        "Dissolved oxygen",
        "Gage height (water level)",
        "pH",
        "Specific conductance",
        "Turbidity",
        "Water temperature"
      ],
      "name": "DEAD RUN AT WHANN AVENUE NEAR MCLEAN, VA",
      "parameter_codes": [
        "00010",
        "00060",
        "00065",
        "00095",
        "00300",
        "00400",
        "63680",
        "99234"
      ],
      "site_id": "USGS-01646305",
      "site_number": "01646305",
      "site_type": "Stream",
      "state": "Virginia",
      "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01646305/"
    }
  ],
  "truncated": true
}

Get annual peak flows

Get the highest discharge or gage height of each water year (October to September) on record, newest or largest first, with the record peak and notes such as dam regulation.

Inputs

Site numbersite_numbertextRequired
The USGS site number, 8 to 15 digits. 'Find monitoring sites' finds one, and it is in the address of the site's page on waterdata.usgs.gov.
Peak ofparameter_codetext
Discharge or gage height. Defaults to discharge.One of: 00060 (Peak discharge (streamflow)), 00065 (Peak gage height (water level)). Default: 00060.
Orderordertext
Newest year first, or largest peak first.One of: newest (Newest year first), largest (Largest peak first). Default: newest.
Number of peakslimitnumber
The most peaks to list. Defaults to 100.From 1 to 1000. Default: 100.

Outputs

countnumber
How many peaks are listed.
parameter_codetext
USGS's 5-digit code for what is measured (00060 is discharge).
parameter_nametext
What is measured, in USGS's words (Discharge).
peakslist
The annual peaks, in the order asked for.
record_datetext
The day of the highest peak on record.
record_valuenumber
The highest peak on record.
record_water_yearnumber
The water year of the highest peak on record.
site_idtext
The site's full id: the agency, a dash and the site number (USGS-01646500).
site_numbertext
The site number, 8 to 15 digits (01646500).
urltext
The site's page on USGS Water Data for the Nation.
years_on_recordnumber
How many annual peaks USGS has.
Example output
{
  "count": 2,
  "parameter_code": "00060",
  "parameter_name": "Discharge (streamflow)",
  "peaks": [
    {
      "date": "1936-03-19",
      "highest_since": 1889,
      "qualifiers": [],
      "time_of_day": null,
      "unit": "ft\u00b3/s",
      "value": 484000,
      "water_year": 1936
    },
    {
      "date": "1942-10-17",
      "highest_since": null,
      "qualifiers": [],
      "time_of_day": null,
      "unit": "ft\u00b3/s",
      "value": 447000,
      "water_year": 1943
    }
  ],
  "record_date": "1936-03-19",
  "record_value": 484000,
  "record_water_year": 1936,
  "site_id": "USGS-01646500",
  "site_number": "01646500",
  "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01646500/",
  "years_on_record": 95
}

Get daily values

Get a measurement's daily mean, minimum and maximum (or daily total, for precipitation) for a range of days, with the range's highest and lowest. Leave the dates empty for the last 30 days.

Inputs

Site numbersite_numbertextRequired
The USGS site number, 8 to 15 digits. 'Find monitoring sites' finds one, and it is in the address of the site's page on waterdata.usgs.gov.
Measurementparameter_codetextRequired
What to read. Pick from what the site measures (type the site number first), or type USGS's 5-digit parameter code, such as 00060 for discharge.
Fromstart_datedate
The first day. Leave empty for 30 days before the last day.
Toend_datedate
The last day. Leave empty for today.

Outputs

any_provisionaltrue/false
True when at least one value is provisional and may still be revised.
averagenumber
The average of the daily means.
countnumber
How many days are listed.
dayslist
The days with values, oldest first.
end_datetext
The last day asked for.
highestnumber
The highest daily value in the range.
highest_datetext
The day of the highest value.
latest_datetext
The newest day listed.
latest_valuenumber
The newest day's mean (or its total, or maximum, when there is no mean).
lowestnumber
The lowest daily value in the range.
lowest_datetext
The day of the lowest value.
parameter_codetext
USGS's 5-digit code for what is measured (00060 is discharge).
parameter_nametext
What is measured, in USGS's words (Discharge).
site_idtext
The site's full id: the agency, a dash and the site number (USGS-01646500).
site_numbertext
The site number, 8 to 15 digits (01646500).
start_datetext
The first day asked for.
truncatedtrue/false
True when the range held more days than one request returns; the newest are listed.
unittext
The unit the values are in (ft³/s, ft, °C).
urltext
The site's page on USGS Water Data for the Nation.
Example output
{
  "any_provisional": true,
  "average": 17.214,
  "count": 2,
  "days": [
    {
      "date": "2026-10-15",
      "maximum": 19.6,
      "mean": 18.9,
      "median": null,
      "minimum": 18.4,
      "provisional": true,
      "qualifiers": [],
      "total": null
    },
    {
      "date": "2026-10-16",
      "maximum": 19.6,
      "mean": 18.8,
      "median": null,
      "minimum": 18.3,
      "provisional": true,
      "qualifiers": [],
      "total": null
    }
  ],
  "end_date": "2026-10-21",
  "highest": 19.6,
  "highest_date": "2026-10-15",
  "latest_date": "2026-10-21",
  "latest_value": 15.5,
  "lowest": 14.5,
  "lowest_date": "2026-10-21",
  "parameter_code": "00010",
  "parameter_name": "Water temperature",
  "site_id": "USGS-01646500",
  "site_number": "01646500",
  "start_date": "2026-10-15",
  "truncated": false,
  "unit": "\u00b0C",
  "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01646500/"
}

Get field measurements

Get the values USGS hydrographers measured by hand on site visits, such as discharge and gage height, newest first, with how they were measured and how accurate they were rated.

Inputs

Site numbersite_numbertextRequired
The USGS site number, 8 to 15 digits. 'Find monitoring sites' finds one, and it is in the address of the site's page on waterdata.usgs.gov.
Measurementparameter_codetext
Only this measurement. Leave empty for all of them.One of: 00060 (Discharge (streamflow)), 00065 (Gage height (water level)).
Fromstart_datedate
The first day to include. Leave empty for no start.
Toend_datedate
The last day to include. Leave empty for up to today.
Number of measurementslimitnumber
The most measurements to list, newest first. Defaults to 50.From 1 to 1000. Default: 50.

Outputs

countnumber
How many measurements are listed.
latest_timetext
When the newest measurement was made.
measurementslist
The measurements, newest first.
site_idtext
The site's full id: the agency, a dash and the site number (USGS-01646500).
site_numbertext
The site number, 8 to 15 digits (01646500).
urltext
The site's page on USGS Water Data for the Nation.
visit_countnumber
How many site visits they come from.
Example output
{
  "count": 2,
  "latest_time": "2026-10-07T14:52:31Z",
  "measurements": [
    {
      "agency": "USGS",
      "control_condition": "Clear",
      "measurement_rating": "Fair",
      "method": null,
      "parameter_code": "00065",
      "parameter_name": "Gage height (water level)",
      "provisional": true,
      "qualifiers": [],
      "reading_type": "Mean gage height",
      "time": "2026-10-07T14:52:31Z",
      "unit": "ft",
      "value": 2.72,
      "visit_id": "0fa20b03-b359-453c-9f75-fc03f35dcb98"
    },
    {
      "agency": "USGS",
      "control_condition": "Clear",
      "measurement_rating": "Fair",
      "method": "Acoustic Doppler Current Profiler",
      "parameter_code": "00060",
      "parameter_name": "Discharge (streamflow)",
      "provisional": true,
      "qualifiers": [],
      "reading_type": "Discharge",
      "time": "2026-10-07T14:52:31Z",
      "unit": "ft\u00b3/s",
      "value": 1630,
      "visit_id": "0fa20b03-b359-453c-9f75-fc03f35dcb98"
    }
  ],
  "site_id": "USGS-01646500",
  "site_number": "01646500",
  "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01646500/",
  "visit_count": 1
}

Get groundwater levels

Get the water levels measured in a well, newest first: depth to water below the land surface and the water level's elevation, with how much it changed over the measurements listed.

Inputs

Well site numbersite_numbertextRequired
The well's USGS site number, usually 15 digits. Find wells with 'Find monitoring sites' and the site type Well.
Fromstart_datedate
The first day to include. Leave empty for no start.
Toend_datedate
The last day to include. Leave empty for up to today.
Number of measurementslimitnumber
The most measurements to list, newest first. Defaults to 100.From 1 to 1000. Default: 100.

Outputs

change_ftnumber
The newest depth minus the oldest one listed: positive means the water level fell.
countnumber
How many measurements are listed.
deepest_depth_ftnumber
The largest depth to water listed (the lowest water level).
latest_depth_to_water_ftnumber
The newest depth to water, in feet.
latest_timetext
When the newest measurement was made.
measurementslist
The measurements, newest first.
shallowest_depth_ftnumber
The smallest depth to water listed (the highest water level).
site_idtext
The site's full id: the agency, a dash and the site number (USGS-01646500).
site_numbertext
The site number, 8 to 15 digits (01646500).
urltext
The site's page on USGS Water Data for the Nation.
Example output
{
  "change_ft": 0.38,
  "count": 2,
  "deepest_depth_ft": 25.93,
  "latest_depth_to_water_ft": 25.93,
  "latest_time": "2026-09-23T10:56:00Z",
  "measurements": [
    {
      "agency": "USGS",
      "depth_to_water_ft": 25.93,
      "elevation_datum": "NAVD88",
      "method": "GW level, calib electric tape",
      "provisional": true,
      "qualifiers": [
        "Static"
      ],
      "time": "2026-09-23T10:56:00Z",
      "water_level_elevation_ft": 162.36
    },
    {
      "agency": "USGS",
      "depth_to_water_ft": 25.91,
      "elevation_datum": "NAVD88",
      "method": "GW level, calib electric tape",
      "provisional": true,
      "qualifiers": [
        "Static"
      ],
      "time": "2026-09-02T11:03:00Z",
      "water_level_elevation_ft": 162.38
    }
  ],
  "shallowest_depth_ft": 25.55,
  "site_id": "USGS-390151076561501",
  "site_number": "390151076561501",
  "url": "https://waterdata.usgs.gov/monitoring-location/USGS-390151076561501/"
}

Get latest readings

Get the newest reading of every sensor at a site, such as streamflow, gage height (water level) and water temperature, with when it was taken, whether it is provisional, and any notes such as ice. Streamflow, gage height and water temperature are also given on their own for easy use.

Inputs

Site numbersite_numbertextRequired
The USGS site number, 8 to 15 digits. 'Find monitoring sites' finds one, and it is in the address of the site's page on waterdata.usgs.gov.
Measurementparameter_codetext
Only this measurement. Leave empty for every sensor at the site.
Include discontinued sensorsinclude_discontinuedtrue/false
Also list the last reading of sensors the site no longer runs.Default: false.

Outputs

any_provisionaltrue/false
True when at least one value is provisional and may still be revised.
countnumber
How many readings are listed.
gage_height_ftnumber
The latest gage height (water level), in feet. Empty when the site does not measure it.
latest_timetext
When the newest of the readings was taken.
readingslist
The latest reading of each sensor at the site.
site_idtext
The site's full id: the agency, a dash and the site number (USGS-01646500).
site_numbertext
The site number, 8 to 15 digits (01646500).
streamflow_cfsnumber
The latest discharge (streamflow), in cubic feet per second. Empty when the site does not measure it.
urltext
The site's page on USGS Water Data for the Nation.
water_temperature_cnumber
The latest water temperature, in degrees Celsius. Empty when the site does not measure it.
Example output
{
  "any_provisional": true,
  "count": 3,
  "gage_height_ft": 3.26,
  "latest_time": "2026-10-22T08:50:00Z",
  "readings": [
    {
      "approval_status": "Provisional",
      "current": true,
      "location_note": null,
      "parameter_code": "00060",
      "parameter_name": "Discharge (streamflow)",
      "provisional": true,
      "qualifiers": [],
      "time": "2026-10-22T08:50:00Z",
      "time_series_id": "66a4e3fb8abe42fcb0942b5c0fe98f68",
      "unit": "ft\u00b3/s",
      "value": 4360
    },
    {
      "approval_status": "Provisional",
      "current": true,
      "location_note": "From multiparameter sonde",
      "parameter_code": "00300",
      "parameter_name": "Dissolved oxygen",
      "provisional": true,
      "qualifiers": [],
      "time": "2026-10-22T08:50:00Z",
      "time_series_id": "bb18f3558934465194f8da1d5f1c3df3",
      "unit": "mg/L",
      "value": 10.3
    },
    {
      "approval_status": "Provisional",
      "current": true,
      "location_note": null,
      "parameter_code": "00065",
      "parameter_name": "Gage height (water level)",
      "provisional": true,
      "qualifiers": [],
      "time": "2026-10-22T08:50:00Z",
      "time_series_id": "8a83eb3a3cbc4087b0c201cf07c0c76d",
      "unit": "ft",
      "value": 3.26
    }
  ],
  "site_id": "USGS-01646500",
  "site_number": "01646500",
  "streamflow_cfs": 4360,
  "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01646500/",
  "water_temperature_c": 15
}

Get monthly or yearly statistics

Get the mean, median, minimum, maximum and percentiles of a measurement's daily values for each month, calendar year or water year in a range. Only reviewed (approved) data is counted, so the latest months may be missing.

Inputs

Site numbersite_numbertextRequired
The USGS site number, 8 to 15 digits. 'Find monitoring sites' finds one, and it is in the address of the site's page on waterdata.usgs.gov.
Measurementparameter_codetext
What to compare. Pick from what the site measures (type the site number first), or type a 5-digit parameter code. Defaults to discharge (00060).Default: 00060.
One row perintervaltext
Months, calendar years or water years.One of: month (Each month), calendar_year (Each calendar year (January to December)), water_year (Each water year (October to September)). Default: month.
Fromstart_datedate
The first day of the range. Leave empty for a year before the end (ten years for yearly statistics).
Toend_datedate
The last day of the range. Leave empty for today.

Outputs

countnumber
How many periods are listed.
end_datetext
The last day asked for.
foundtrue/false
True when USGS has statistics for the range.
intervaltext
The length of each period: month, calendar_year or water_year.
parameter_codetext
USGS's 5-digit code for what is measured (00060 is discharge).
parameter_nametext
What is measured, in USGS's words (Discharge).
periodslist
One row per period, oldest first.
site_idtext
The site's full id: the agency, a dash and the site number (USGS-01646500).
site_numbertext
The site number, 8 to 15 digits (01646500).
start_datetext
The first day asked for.
unittext
The unit the values are in (ft³/s, ft, °C).
urltext
The site's page on USGS Water Data for the Nation.
Example output
{
  "count": 2,
  "end_date": "2024-09-30",
  "found": true,
  "interval": "water_year",
  "parameter_code": "00060",
  "parameter_name": "Discharge (streamflow)",
  "periods": [
    {
      "days": 365,
      "end_date": "2021-09-30",
      "label": "Water year 2021",
      "maximum": 89700,
      "mean": 10562.03,
      "median": 7290,
      "minimum": 1410,
      "p10": 2654,
      "p25": 3915,
      "p5": 2032,
      "p75": 12100,
      "p90": 19440,
      "p95": 31970,
      "start_date": "2020-10-01"
    },
    {
      "days": 365,
      "end_date": "2022-09-30",
      "label": "Water year 2022",
      "maximum": 102000,
      "mean": 8419.37,
      "median": 5600,
      "minimum": 1750,
      "p10": 2690,
      "p25": 3475,
      "p5": 2411,
      "p75": 9755,
      "p90": 14320,
      "p95": 20440,
      "start_date": "2021-10-01"
    }
  ],
  "site_id": "USGS-01646500",
  "site_number": "01646500",
  "start_date": "2020-10-01",
  "unit": "ft\u00b3/s",
  "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01646500/"
}

Get readings for a time range

Get a sensor's readings (usually every 5 to 15 minutes) for a time range of up to 3 years, with the low, high, average and latest. Leave the times empty for the last 24 hours.

Inputs

Site numbersite_numbertextRequired
The USGS site number, 8 to 15 digits. 'Find monitoring sites' finds one, and it is in the address of the site's page on waterdata.usgs.gov.
Measurementparameter_codetextRequired
What to read. Pick from what the site measures (type the site number first), or type USGS's 5-digit parameter code, such as 00060 for discharge.
Fromstart_timedate and time
The start of the range. Leave empty for 24 hours before the end.
Toend_timedate and time
The end of the range. Leave empty for now.
Number of readingslimitnumber
The most readings to return; when the range has more, the newest are kept. Defaults to 1000.From 1 to 10000. Default: 1000.

Outputs

any_provisionaltrue/false
True when at least one value is provisional and may still be revised.
changenumber
The newest reading minus the oldest one.
countnumber
How many readings are listed.
endtext
The end of the time range (ISO 8601, UTC).
latest_timetext
When the newest reading was taken.
latest_valuenumber
The newest reading in the range.
maximumnumber
The highest reading in the range.
maximum_timetext
When the highest reading was taken.
meannumber
The average of the readings.
minimumnumber
The lowest reading in the range.
minimum_timetext
When the lowest reading was taken.
parameter_codetext
USGS's 5-digit code for what is measured (00060 is discharge).
parameter_nametext
What is measured, in USGS's words (Discharge).
readingslist
The readings, oldest first.
site_idtext
The site's full id: the agency, a dash and the site number (USGS-01646500).
site_numbertext
The site number, 8 to 15 digits (01646500).
starttext
The start of the time range (ISO 8601, UTC).
time_series_idtext
USGS's id for the series read.
truncatedtrue/false
True when the range held more readings than were asked for; the newest ones are listed.
unittext
The unit the values are in (ft³/s, ft, °C).
urltext
The site's page on USGS Water Data for the Nation.
Example output
{
  "any_provisional": true,
  "change": -60,
  "count": 3,
  "end": "2026-10-22T09:34:07Z",
  "latest_time": "2026-10-22T08:50:00Z",
  "latest_value": 4360,
  "maximum": 4420,
  "maximum_time": "2026-10-22T07:55:00Z",
  "mean": 4370,
  "minimum": 4360,
  "minimum_time": "2026-10-22T08:00:00Z",
  "parameter_code": "00060",
  "parameter_name": "Discharge (streamflow)",
  "readings": [
    {
      "provisional": true,
      "qualifiers": [],
      "time": "2026-10-22T07:55:00Z",
      "value": 4420
    },
    {
      "provisional": true,
      "qualifiers": [],
      "time": "2026-10-22T08:00:00Z",
      "value": 4360
    },
    {
      "provisional": true,
      "qualifiers": [],
      "time": "2026-10-22T08:05:00Z",
      "value": 4360
    }
  ],
  "site_id": "USGS-01646500",
  "site_number": "01646500",
  "start": "2026-10-21T09:34:07Z",
  "time_series_id": "66a4e3fb8abe42fcb0942b5c0fe98f68",
  "truncated": true,
  "unit": "ft\u00b3/s",
  "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01646500/"
}

Get site camera images

Get the images from a site's public river camera: the newest one in three sizes, a time-lapse video when the camera makes one, and its recent images. Says so when the site has no camera.

Inputs

Site numbersite_numbertextRequired
The USGS site number. 'Find river cameras' lists the sites with one.
Recent imagesrecent_imagesnumber
How many recent images to list besides the newest. Defaults to 5.From 0 to 50. Default: 5.

Outputs

cameraslist
The site's cameras.
countnumber
How many cameras are listed.
has_cameratrue/false
True when the site has a public camera.
site_idtext
The site's full id: the agency, a dash and the site number (USGS-01646500).
site_numbertext
The site number, 8 to 15 digits (01646500).
urltext
The site's page on USGS Water Data for the Nation.
Example output
{
  "cameras": [
    {
      "camera_id": "WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire",
      "description": "Chippewa River at Grand Ave at Eau Claire, WI",
      "latitude": 44.80959899,
      "longitude": -91.5029665,
      "name": "Chippewa River at Grand Ave at Eau Claire",
      "newest_image_small_url": "https://usgs-nims-images.s3.amazonaws.com/720/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire_newest.jpg",
      "newest_image_time": "2026-10-22T02:00:02Z",
      "newest_image_url": "https://usgs-nims-images.s3.amazonaws.com/overlay/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire_newest.jpg",
      "newest_thumbnail_url": "https://usgs-nims-images.s3.amazonaws.com/thumbnail/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire_newest.jpg",
      "recent_images": [
        {
          "small_url": "https://usgs-nims-images.s3.amazonaws.com/720/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire___2026-10-22T02-00-02Z.jpg",
          "thumbnail_url": "https://usgs-nims-images.s3.amazonaws.com/thumbnail/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire___2026-10-22T02-00-02Z.jpg",
          "time": "2026-10-22T02:00:02Z",
          "url": "https://usgs-nims-images.s3.amazonaws.com/overlay/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire___2026-10-22T02-00-02Z.jpg"
        },
        {
          "small_url": "https://usgs-nims-images.s3.amazonaws.com/720/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire___2026-10-22T01-00-02Z.jpg",
          "thumbnail_url": "https://usgs-nims-images.s3.amazonaws.com/thumbnail/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire___2026-10-22T01-00-02Z.jpg",
          "time": "2026-10-22T01:00:02Z",
          "url": "https://usgs-nims-images.s3.amazonaws.com/overlay/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire___2026-10-22T01-00-02Z.jpg"
        }
      ],
      "site_number": "05366800",
      "state": "WI",
      "time_zone": "US/Central",
      "timelapse_url": "https://usgs-nims-images.s3.amazonaws.com/timelapse/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire_720.mp4"
    }
  ],
  "count": 1,
  "has_camera": true,
  "site_id": "USGS-05366800",
  "site_number": "05366800",
  "url": "https://waterdata.usgs.gov/monitoring-location/USGS-05366800/"
}

Get site details

Get a monitoring site's name, type, location, county and state, altitude, drainage area and watershed, and for a well its depth and aquifer. Says so when there is no such site.

Inputs

Site numbersite_numbertextRequired
The USGS site number, 8 to 15 digits. 'Find monitoring sites' finds one, and it is in the address of the site's page on waterdata.usgs.gov.

Outputs

agencytext
The agency that runs the site (USGS).
altitude_datumtext
The vertical datum the altitude is measured from (NAVD88).
altitude_ftnumber
The height of the land surface or gage datum, in feet.
aquifer_codetext
The local aquifer the well draws from (wells only).
aquifer_typetext
Whether the aquifer is confined or unconfined (wells only).
construction_datetext
When the well was built, as USGS records it.
contributing_drainage_area_sq_minumber
The part of the drainage area that actually feeds the stream, in square miles.
countytext
The county the site is in.
drainage_area_sq_minumber
The land area draining to the site, in square miles.
foundtrue/false
True when USGS has a site with this number.
hole_depth_ftnumber
How deep the hole was drilled, in feet (wells only).
huctext
The hydrologic unit code: the watershed the site is in.
latitudenumber
The site's latitude, in decimal degrees.
longitudenumber
The site's longitude, in decimal degrees.
nametext
The site's name.
national_aquifer_codetext
The principal aquifer the well draws from (wells only).
site_idtext
The site's full id: the agency, a dash and the site number (USGS-01646500).
site_numbertext
The site number, 8 to 15 digits (01646500).
site_typetext
What kind of place it is (Stream, Well, Lake).
statetext
The state the site is in.
time_zonetext
The site's standard time zone (EST).
urltext
The site's page on USGS Water Data for the Nation.
uses_daylight_saving_timetrue/false
True when the site's local clock moves for daylight saving time.
well_depth_ftnumber
How deep the well was built, in feet (wells only).
Example output
{
  "agency": "USGS",
  "altitude_datum": "NAVD88",
  "altitude_ft": 37.04,
  "aquifer_code": null,
  "aquifer_type": null,
  "construction_date": null,
  "contributing_drainage_area_sq_mi": null,
  "county": "Montgomery County",
  "drainage_area_sq_mi": 11560,
  "found": true,
  "hole_depth_ft": null,
  "huc": "020700081005",
  "latitude": 38.949777777777776,
  "longitude": -77.12763888888888,
  "name": "POTOMAC RIVER NEAR WASH, DC LITTLE FALLS PUMP STA",
  "national_aquifer_code": null,
  "site_id": "USGS-01646500",
  "site_number": "01646500",
  "site_type": "Stream",
  "state": "Maryland",
  "time_zone": "EST",
  "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01646500/",
  "uses_daylight_saving_time": true,
  "well_depth_ft": null
}

Get typical values for the year

Get what is typical at a site for each day or month of the year, from its whole record: mean, median, record low and high, and percentiles, with how many years they cover.

Inputs

Site numbersite_numbertextRequired
The USGS site number, 8 to 15 digits. 'Find monitoring sites' finds one, and it is in the address of the site's page on waterdata.usgs.gov.
Measurementparameter_codetext
What to compare. Pick from what the site measures (type the site number first), or type a 5-digit parameter code. Defaults to discharge (00060).Default: 00060.
One row perperiodtext
Days or months of the year.One of: day_of_year (Each day of the year), month_of_year (Each month of the year). Default: day_of_year.
Fromstart_datedate
The first day or month to include; only its month and day are used. Leave both dates empty for the whole year.
Toend_datedate
The last day or month to include; only its month and day are used.

Outputs

countnumber
How many rows are listed.
foundtrue/false
True when USGS has statistics for this site and parameter.
normalslist
One row per day or month, in calendar order.
parameter_codetext
USGS's 5-digit code for what is measured (00060 is discharge).
parameter_nametext
What is measured, in USGS's words (Discharge).
periodtext
Whether the rows are days of the year (day_of_year) or months (month_of_year).
site_idtext
The site's full id: the agency, a dash and the site number (USGS-01646500).
site_numbertext
The site number, 8 to 15 digits (01646500).
time_series_idtext
The daily series the statistics are computed from.
unittext
The unit the values are in (ft³/s, ft, °C).
urltext
The site's page on USGS Water Data for the Nation.
Example output
{
  "count": 2,
  "found": true,
  "normals": [
    {
      "label": "January",
      "maximum": 31000,
      "mean": 10593.85,
      "median": 9305,
      "minimum": 1380,
      "p10": 3101,
      "p25": 5500,
      "p5": 2271.5,
      "p75": 13750,
      "p90": 22490,
      "p95": 26525,
      "period": "01",
      "years": 96
    },
    {
      "label": "February",
      "maximum": 53450,
      "mean": 13295.99,
      "median": 11675,
      "minimum": 1785,
      "p10": 5029,
      "p25": 7331.25,
      "p5": 3651,
      "p75": 17312.5,
      "p90": 24275,
      "p95": 29190,
      "period": "02",
      "years": 96
    }
  ],
  "parameter_code": "00060",
  "parameter_name": "Discharge (streamflow)",
  "period": "month_of_year",
  "site_id": "USGS-01646500",
  "site_number": "01646500",
  "time_series_id": "2cf409b0d9694c01828f5d4ff14586a5",
  "unit": "ft\u00b3/s",
  "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01646500/"
}

Get water quality samples

Get the results of water samples taken at a site and analysed in the field or a lab, such as nutrients, metals, bacteria or pesticides, newest first, with units and whether each result is final. Leave the dates empty for the last year.

Inputs

Site numbersite_numbertextRequired
The USGS site number, 8 to 15 digits. 'Find monitoring sites' finds one, and it is in the address of the site's page on waterdata.usgs.gov.
Kind of resultgrouptext
Only results of this kind. Leave empty for all.One of: Physical, Nutrient, Inorganics, Major, Metals, Inorganics, Major, Non-metals, Inorganics, Minor, Metals, Inorganics, Minor, Non-metals, Microbiological, Biological, Organics, Pesticide, Organics, PCBs, and 6 more.
Parameter codeparameter_codetext
Only results with this 5-digit USGS parameter code. Leave empty for all.
Fromstart_datedate
The first day to include. Leave empty for a year before the last day.
Toend_datedate
The last day to include. Leave empty for up to today.
Number of resultslimitnumber
The most results to list, newest first. Defaults to 100.From 1 to 1000. Default: 100.

Outputs

characteristicslist
Each characteristic among the results, once.
countnumber
How many results are listed.
end_datetext
The last day searched.
resultslist
The results, newest sample first.
sample_countnumber
How many samples the results come from.
site_idtext
The site's full id: the agency, a dash and the site number (USGS-01646500).
site_numbertext
The site number, 8 to 15 digits (01646500).
start_datetext
The first day searched.
truncatedtrue/false
True when more results matched than were listed.
urltext
The site's page on USGS Water Data for the Nation.
Example output
{
  "characteristics": [
    "Inorganic nitrogen (nitrate and nitrite)"
  ],
  "count": 2,
  "end_date": "2025-12-31",
  "results": [
    {
      "characteristic": "Inorganic nitrogen (nitrate and nitrite)",
      "date": "2025-09-30",
      "detection": null,
      "fraction": "Filtered field and/or lab",
      "group": "Nutrient",
      "method": "NO3+NO2, wf, FCC,NaR, DA",
      "parameter_code": "00631",
      "sample_id": "e48f5f73-a566-4c52-a5a1-2e918aa8960f",
      "status": "Accepted",
      "time": "10:00:00",
      "time_zone": "EST",
      "unit": "mg/L",
      "value": 0.634,
      "value_text": "0.634"
    },
    {
      "characteristic": "Inorganic nitrogen (nitrate and nitrite)",
      "date": "2025-06-26",
      "detection": null,
      "fraction": "Filtered field and/or lab",
      "group": "Nutrient",
      "method": "NO3+NO2, wf, FCC,NaR, DA",
      "parameter_code": "00631",
      "sample_id": "06062484-ae7f-458d-a36d-8271a573eccc",
      "status": "Accepted",
      "time": "09:45:00",
      "time_zone": "EST",
      "unit": "mg/L",
      "value": 0.889,
      "value_text": "0.889"
    }
  ],
  "sample_count": 2,
  "site_id": "USGS-01646500",
  "site_number": "01646500",
  "start_date": "2025-01-01",
  "truncated": false,
  "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01646500/"
}

List what a site measures

List everything a site records: each measurement, whether it is real-time readings, daily values or annual peaks, since when, and whether it is still recorded.

Inputs

Site numbersite_numbertextRequired
The USGS site number, 8 to 15 digits. 'Find monitoring sites' finds one, and it is in the address of the site's page on waterdata.usgs.gov.
Include discontinuedinclude_discontinuedtrue/false
Also list measurements the site no longer records.Default: false.

Outputs

active_countnumber
How many of them are still recorded.
countnumber
How many series are listed.
foundtrue/false
True when the site records any series.
parameterslist
Each thing the site still measures, once.
site_idtext
The site's full id: the agency, a dash and the site number (USGS-01646500).
site_numbertext
The site number, 8 to 15 digits (01646500).
time_serieslist
The site's series, active ones first.
urltext
The site's page on USGS Water Data for the Nation.
Example output
{
  "active_count": 3,
  "count": 3,
  "found": true,
  "parameters": [
    {
      "code": "00060",
      "name": "Discharge (streamflow)",
      "unit": "ft\u00b3/s"
    },
    {
      "code": "00065",
      "name": "Gage height (water level)",
      "unit": "ft"
    }
  ],
  "site_id": "USGS-01646500",
  "site_number": "01646500",
  "time_series": [
    {
      "active": true,
      "begin": "1972-06-09T05:00:00Z",
      "data_type": "Continuous",
      "end": "2026-10-22T07:50:00Z",
      "location_note": null,
      "parameter_code": "00060",
      "parameter_description": "Discharge, cubic feet per second",
      "parameter_name": "Discharge (streamflow)",
      "primary": true,
      "statistic": "Instantaneous",
      "time_series_id": "66a4e3fb8abe42fcb0942b5c0fe98f68",
      "unit": "ft\u00b3/s"
    },
    {
      "active": true,
      "begin": "1930-03-01T05:00:00Z",
      "data_type": "Daily",
      "end": "2026-10-20T04:00:00Z",
      "location_note": null,
      "parameter_code": "00060",
      "parameter_description": "Discharge, cubic feet per second",
      "parameter_name": "Discharge (streamflow)",
      "primary": true,
      "statistic": "Mean",
      "time_series_id": "2cf409b0d9694c01828f5d4ff14586a5",
      "unit": "ft\u00b3/s"
    },
    {
      "active": true,
      "begin": "2007-10-01T05:00:00Z",
      "data_type": "Continuous",
      "end": "2026-10-22T07:50:00Z",
      "location_note": null,
      "parameter_code": "00065",
      "parameter_description": "Gage height, feet",
      "parameter_name": "Gage height (water level)",
      "primary": true,
      "statistic": "Instantaneous",
      "time_series_id": "8a83eb3a3cbc4087b0c201cf07c0c76d",
      "unit": "ft"
    }
  ],
  "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01646500/"
}

Look up parameter codes

Find the 5-digit codes USGS uses for what it measures, by code, by words in their name or description, or by group, with the unit each is reported in.

Inputs

Search forsearchtext
A code, or words such as nitrate or temperature.
Groupgrouptext
Only codes in this group. Leave empty for any group.One of: PHY (Physical), NUT (Nutrient), INM (Inorganics, Major, Metals), INN (Inorganics, Major, Non-metals), IMM (Inorganics, Minor, Metals), IMN (Inorganics, Minor, Non-metals), MBI (Microbiological), BIO (Biological), OPE (Organics, Pesticide), OPC (Organics, PCBs), and 7 more.
Number of codeslimitnumber
The most codes to list. Defaults to 50.From 1 to 1000. Default: 50.

Outputs

countnumber
How many codes are listed.
grouptext
The group searched.
parameterslist
The parameter codes found, by code.
searchtext
The text searched for.
totalnumber
How many codes matched in all.
truncatedtrue/false
True when more codes matched than were listed.
Example output
{
  "count": 2,
  "group": null,
  "parameters": [
    {
      "code": "00600",
      "description": "Total nitrogen [nitrate + nitrite + ammonia + organic-N], water, unfiltered, milligrams per liter",
      "group": "Nutrient",
      "medium": "Water",
      "name": "Total nitrogen, wu",
      "unit": "mg/l"
    },
    {
      "code": "00601",
      "description": "Total nitrogen [nitrate + nitrite + ammonia + organic-N], suspended sediment, milligrams per liter",
      "group": "Nutrient",
      "medium": "Water",
      "name": "Total nitrogen, ss",
      "unit": "mg/l"
    }
  ],
  "search": "nitrate",
  "total": 79,
  "truncated": true
}

On this page