REST Web Services
This tool provides a simple way to generate syntactically correct URLs to use with the USGS Instantaneous Values REST web service. Use it to get comfortable with the service before creating your own applications. Press the question mark icon for help with a particular field.
URL argument names and values are not case sensitive, ex: ?stateCd=ny, ?STATECD=ny, ?statecd=NY can all be used and are equivalent. See the full service description for details.
Simply enter the values you want in the fields below. Press Generate the URL button at the bottom to get the resulting URL. To see the results in your browser, next press the Run the Generated URL button.
List of sites
(or just a single site)
State or Territory
Hydrologic Unit Codes
State or Territory
Dist. of Columbia
Northern Mariana Islands
Hydrologic Unit Codes (HUC)
URL argument name is bBox for bounding box. The argument is a pair of four numbers separated by commas, beginning with the western longitude, then the southern latitude, then the eastern longitude, then the northern latitude. Note: to ensure fair access, the product of the range of latitude and longitude cannot exceed 25 degrees. Use decimal degrees rather than degrees, minutes and seconds. Decimals are not required, but only six decimals of precision will be used. Longitude is in the range of -180 to 180, latitude from -90 to 90. Remember, in the Western hemisphere, longitude is expressed in negative numbers. Example: ?bBox=-83,36.5,-81,38.5
Note: many sites outside the continental US do not have latitude and longitude referenced to NAD83 and therefore can not be found using these arguments. Certain sites are not associated with latitude and longitude due to homeland security concerns and cannot be found using this filter.
URL argument name is modifiedSince. For any retrieval, you can use this argument to request to return values for those sites only if any the values in the modifiedSince date range. This is useful if you periodically need to poll a site but are only interested in processing data if some of it has changed. Use the ISO-8601 duration format . If the modifiedSince argument is not specified in the generated URL, it has no effect on the query.
Partial URL examples:
If it does not meet these criteria, it is considered inactive. Some exceptions apply. If a site is flagged by a USGS water science center as discontinued, it will show as inactive. A USGS science center can also flag a new site as active even if it has not collected any data.
Minimum site altitude in feet:
Maximum site altitude in feet:
Caution: queries that return large sets of data may cause your browser to slow down or lock as it attempts to download and format large sets of data for display. When testing services in a browser, it is suggested that you create queries that should return relatively small sets of data. When creating an application you will typically use a program like curl , wget or the Windows task scheduler to retrieve data, which should acquire data more quickly than a browser.
Generate the URL
Run the Generated URL
(Note: if you do not see the XML in the output, please View Source.)
Water Home :: Water Data Home
Accessibility FOIA Privacy Policies and Notices
U.S. Department of the Interior | U.S. Geological Survey
Page Contact Information: Water Webserver Team
Page Last Modified:
December 6, 2013