REST Web Services
This tool provides a simple way to generate syntactically correct URLs to use with the USGS Daily Values 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
URL argument name is huc. You can specify one major hydrologic unit code (2 digit code) and up to 10 minor hydrologic unit codes (8 digit codes). Separate HUCs with commas. For performance reasons, no more than one major HUC is allowed. Complete list of HUCs. Note: not all sites have been associated with a hydrologic unit. As such those sites cannot be retrieved with this method. Example: ?huc=01,02070010
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. Up to seven digits of precision are allowed. 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 format. Select the output format desired. If there is no format argument in the generated URL, the most currently supported version of USGS RDB format is returned. Example: &format=rdb. Note: GML will become the default output format once it is available. Formats available:
The version of the format wanted, if available, can be appended using the syntax: &format=<format_type>,<version_number>. The version number is optional but its use is encouraged because it means your application is less likely to break. If you do not specify the version number in your syntax, the most recently implemented version in that format will be returned instead. In some cases, if there is no known version of a format, 1.0 is used to distinguish it.
Optional filters, if used, further reduce the list of sites returned.
URL argument name is modifiedSince. For any retrieval, you can use this argument to request to return values for all requested 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. Do not specify ranges in months or years, as these time increments vary and are thus nondeterministic.
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.
The default is all (both active and inactive sites). Example: &siteStatus=active
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