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
| Action | What it does |
|---|---|
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
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 number
site_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 number
site_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.
- Measurement
parameter_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
- State
statetext - 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. - County
countytext - Only sites in this county of the state. Leave empty for the whole state.
- Site type
site_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. - Measures
parameter_codetext - Only sites that measure this. Pick a common one or type a 5-digit parameter code. Leave empty for sites measuring anything.
- Name contains
nametext - Only sites whose name contains these words, for example a river's name.
- Map area
bounding_boxtext - Only sites inside this box: west, south, east, north in decimal degrees.
- Which sites
activitytext - 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 sites
limitnumber - 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
- State
statetext - 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
- State
statetextRequired - 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 contains
nametext - 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
- Latitude
latitudenumberRequired - The point's latitude in decimal degrees (38.95).From -90 to 90.
- Longitude
longitudenumberRequired - 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 type
site_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. - Measures
parameter_codetext - Only sites that measure this. Pick a common one or type a 5-digit parameter code. Leave empty for sites measuring anything.
- Which sites
activitytext - 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 sites
limitnumber - 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 number
site_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 of
parameter_codetext - Discharge or gage height. Defaults to discharge.One of:
00060(Peak discharge (streamflow)),00065(Peak gage height (water level)). Default:00060. - Order
ordertext - Newest year first, or largest peak first.One of:
newest(Newest year first),largest(Largest peak first). Default:newest. - Number of peaks
limitnumber - 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 number
site_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.
- Measurement
parameter_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.
- From
start_datedate - The first day. Leave empty for 30 days before the last day.
- To
end_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 number
site_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.
- Measurement
parameter_codetext - Only this measurement. Leave empty for all of them.One of:
00060(Discharge (streamflow)),00065(Gage height (water level)). - From
start_datedate - The first day to include. Leave empty for no start.
- To
end_datedate - The last day to include. Leave empty for up to today.
- Number of measurements
limitnumber - 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 number
site_numbertextRequired - The well's USGS site number, usually 15 digits. Find wells with 'Find monitoring sites' and the site type Well.
- From
start_datedate - The first day to include. Leave empty for no start.
- To
end_datedate - The last day to include. Leave empty for up to today.
- Number of measurements
limitnumber - 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 number
site_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.
- Measurement
parameter_codetext - Only this measurement. Leave empty for every sensor at the site.
- Include discontinued sensors
include_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 number
site_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.
- Measurement
parameter_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 per
intervaltext - 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. - From
start_datedate - The first day of the range. Leave empty for a year before the end (ten years for yearly statistics).
- To
end_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 number
site_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.
- Measurement
parameter_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.
- From
start_timedate and time - The start of the range. Leave empty for 24 hours before the end.
- To
end_timedate and time - The end of the range. Leave empty for now.
- Number of readings
limitnumber - 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 number
site_numbertextRequired - The USGS site number. 'Find river cameras' lists the sites with one.
- Recent images
recent_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 number
site_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 number
site_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.
- Measurement
parameter_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 per
periodtext - 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. - From
start_datedate - The first day or month to include; only its month and day are used. Leave both dates empty for the whole year.
- To
end_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 number
site_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 result
grouptext - 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 code
parameter_codetext - Only results with this 5-digit USGS parameter code. Leave empty for all.
- From
start_datedate - The first day to include. Leave empty for a year before the last day.
- To
end_datedate - The last day to include. Leave empty for up to today.
- Number of results
limitnumber - 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 number
site_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 discontinued
include_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 for
searchtext - A code, or words such as nitrate or temperature.
- Group
grouptext - 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 codes
limitnumber - 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
}