Jump to main content or area navigation.

Contact Us

STORET/WQX: Web Services

WQX / WQX Web Domain Values Services: click here

STORET/WQX Web Services & STORET-NWIS Web Services

STORET now provides a suite of web services which provide direct access to data in the STORET Warehouse.

Please Note: BETA Version AND DISCLAIMER

Beta testing software is a great way to experience and help shape the development of new software programs. It often gives you access to tools you may need months before they are available to the general public, and it gives you a way to influence the development of that software by having direct access to the developers during the creation process.

This is your opportunity to try some great new software and to help shape the development of that software. With this opportunity, however, comes some responsibilities.

First, you must remember that this software is under development. The software is stable, but there is the possibility that not all functionality is in tact and that it may even crash. We don't think so, but that is where we need your input, ideas, and the diversity of your experience and equipment.

THE SOFTWARE IS PROVIDED "AS IS". Each beta software package is fully functional. The software accesses the production STORET Warehouse and data submissions.

STORET HELPDESK may provide you with support services related to the Software ("Support Services") in the form of email support through the list serve associated with that software. Any supplemental software code provided to you as part of the Support Services will be considered part of the Software and subject to the terms and conditions of this Agreement. With respect to technical information you provide to STORET HELPDESK in connection with the Support Services, STORET HELPDESK may use such information for its business purposes, including for product support and development.

The STORET Result Service have been revised as of March 3, 2010. Revisions to the STORET Result Web Service include additional schema elements in the Result Measure section of the outbound schema. See service description below for more information.

The following list describes the most current web services available and each service's endpoint and output schema. The service endpoints provide the WSDL (Web Service Definition Language) for each service as well as the different operations and web methods each service supports. The output schemas are a machine readable formal definition of the schemas that each service will return as output. Please refer to the revised STORET Web Services Consumption User Guide (PDF 641 KB) for a full description of the services, including the required input parameters, as well as examples of how to consume them from other applications. Please note this document is draft and may be changed as the services are further tested and used.

Example Tool

This spreadsheet tool (ZIP 304 KB) allows users to interact dynamically with the STORET web services. When opening the tool in Excel, make sure to enable macros in order for the tool to function.

Name and Description of Web Service Service End Point and WSDL location

Watershed Summary Web Service
The Watershed Summary Web Service provides summary information for the types of data (Organizations with data, number of stations, result counts by characteristic type, etc) available within a given watershed (8-digit HUC).

*The Watershed Summary Tool is an example of an application that uses the Watershed Summary Web Service.



Station Catalog Web Service
The Station Catalog Web Service provides station summary information such as station name, period of record, and result counts by characteristic type.

*The Watershed Summary Tool is an example of an application that uses the Station Catalog Web Service.



Project Catalog Web Service
The Project Catalog Web Service provides project summary information such as the period of record, characteristics monitored, and station names.



Station Web Service
The Station Web Service provides information for all monitoring locations within a given geographic area (geographic bounding box).

*Please Note: The Station Web Service has been revised (as of February 8, 2008) into multiple web methods that provide enhanced data return. These new methods allow users to quickly pull station locations for mapping, return station counts for a given geographic area, or obtain detailed station information if desired.



STORET Result Web Service
The STORET Result Web Service provides direct access to STORET results.

*Please Note: The Result Web Service has been revised (as of March 3, 2010) to provide additional data elements in the outbound schema, as requested by users. Additional data elements include: Result Measure Qualifier Code and Activity Start Time. The service also returns all data element tags within the Result Measure block even if results are not present. Per previous versions of the services, results can be requested via latitude/longitude parameters, or by the type of characteristic a user is searching for. Please note that to ensure good scalability and availability, the result output returned by the Web Service is configured to be restricted by a maximum number of results (20,000). If the number of results requested exceeds the maximum limit, then the web method will notify the end user to narrow down the search criteria in order to reduce the number of results requested. Please refer to the STORET Web Services Consumption User Guide (PDF 641 KB) for a full description of the STORET Result Web Service.



Name and Description of Web Service Service End Point and WSDL location

The STORET-NWIS Mini Portal provides a form for submitting parameters to the outbound web services via SOAP and RESTLike service calls to download Staions (Site) and Results Data.

Soap End point of the STATION Web Service
Soap End point of the RESULT Web Service

*Please Note: The STORET-NWIS Mini Portal web service is still in beta testing stage, so results may not be provided for both agencies.


http://storetnwis.epa.gov/storetqw/Station?wsdl (Soap STATION End Point)

http://storetnwis.epa.gov/storetqw/Result?wsdl (Soap RESULT End Point)


Technical Documentation

How to use the web service:link.

USGS domains of WQX-Outbound data delements:link

USGS NWIS Parameter Code to EPA SRS Name mapping:html || Excel


Description of Spatial Web Service Service End Point

ArcGIS mapping services for STORET
The STORET mapping service provides three end points. One mapping service provides access to the raw data in the warehouse (non-indexed - aka no reach/measure) and the other two mapping services provide access to the indexed data stored in WATERS/RAD which is based on a snapshot of data in the warehouse at a particular point in time.

STATION Download End Point
End point of the STATION Mapping Service (Raw Data Source/Non-indexed)

Indexed STATION End Point
End point of the STORET-RAD Mapping Service (Indexed - snapshot)
(Web Mercator and Tiled)

Waters/RAD End Point
End point of the WATERS/RAD Mapping Service (Indexed - snapshot)
(contains all RAD programs - non-tiled)

http://watersgeo.epa.gov/ArcGIS/rest/services/OWPROGRAM/STORET_NAD83/MapServer(STATION Download End Point)

http://watersgeo.epa.gov/ArcGIS/rest/services/OWRAD/STORET_WMERC/MapServer (Indexed STATION End Point)

http://watersgeo.epa.gov/ArcGIS/rest/services/OWRAD/ALL_OWRAD_NAD83/MapServer (Waters/RAD End Point)

Geospatial Data Downloads

Click Here: State and Watershed Geospatial Data, National Geospatial Datasets,
ATTAINS Program,
Impaired Waters with TMDLs,
BEACH Program,
Water Quality Standards Program,
303(c) Water Quality Standards

Geospatial data for EPA’s Office of Water Programs, including 303(d) Impaired Waters, 305(b) Assessed Waters and Total Maximum Daily Loads (TMDLs) are available for download by state or watershed, as well as at a national extent. Generally, state-level geospatial data represents the most recent data submitted to EPA by states. EPA provides WATERS geospatial data in a variety of formats including Geographical Information Systems (GIS) compatible shapefiles and geodatabases, as well as both vector and raster keyhole markup language (KML) and KMZ files for viewing WATERS data in Google Earth.

You will need Adobe Acrobat Reader to view the Adobe PDF files on this page. See EPA's PDF page for more information about getting and using the free Acrobat Reader.

Jump to main content.