Jump to main content or area navigation.

Contact Us

STORET/WQX: Web Services

STORET Warehouse Web Services

Table of Content

WQX Domain value Services

STORET Web Services
    Watershed Summary Web Service
    Station Catalog Web Service
    Project Catalog Web Service
    Station Web Service
    Result Web Service

EPA-USGS Water Quality Portal Web Services    

    National Water Quality Monitoring Council (NWQMC) Water Quality Portal

STORET Spatial Web Service
    ArcGIS mapping services for STORET
    Station Download End Point
    Indexed Station Download End Point
    Waters /RAD End Point
    EPA's Office of Water, WATERS geospatial data

WQX / WQX Web Domain Values Services: click here

** Updated Daily **: WQX Domain Values are referenced for data submission (mapping STORET/WQX standards)
A zip file containing the WQX domain values / List as zipped XML documents.
This output of the WQX domain values is cached files with a nightly refresh cycle.

WQX Web Domain Values Services (SOAP): click here

The following operations are supported. For a formal definition, please review the Service Description .

Retrieve a comma separated list of domain names that can be used in the GetDomainValues methods.

Retrieve all allowed values for a specific domain. When domainValue is an empty string or 'ALL', then all values for all domains will be returned. Return value is a zip file in the form of a byte array. The zip file always contains just one XML document inside it.

Retrieve the allowed values that have changed since a specific date and time (for a specific domain).
Return value is an XML document in the form of a string.
This output of the WQX domain values is real-time accessing the WQX Database via SOAP services

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

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.



    Top of Page

The Water Quality Portal (WQP) is a cooperative service sponsored by the United States Geological Survey (USGS), the Environmental Protection Agency (EPA), and the National Water Quality Monitoring Council.
Name and Description of Web Service Service End Point and WSDL location

National Water Quality Monitoring Council (NWQMC) Water Quality Portal (WQP) Mini Portal
The NWQMC Water Quality 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 NWQMC Water Quality Portal web service is still in beta testing stage, so results may not be provided for both agencies.


http://www.waterqualitydata.us/Station?wsdl (Soap STATION End Point)

http://www.waterqualitydata.us/Results?wsdl (Soap RESULT End Point)

National Water Quality Monitoring Council (NWQMC) Water Quality Portal (WQP) Web Service

Technical Documentation

Water Quality Portal Web Services Guide:link.

Water Quality Portal User Guide:link

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

Water Quality Portal Contributing Organizations link || Portal FAQs


    Top of Page

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 with the release of NHDPlus v2.1 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)

https://watersgeo.epa.gov/arcgis/rest/services/OWRAD_NP21/STORET_NP21/MapServer (Indexed STATION End Point)

https://watersgeo.epa.gov/arcgis/rest/services/OWPROGRAM/STORET_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.

    Top of Page

Jump to main content.