Skip common site navigation and headers
United States Environmental Protection Agency
Begin Hierarchical Links EPA Home > Water > Wetlands, Oceans, & Watersheds > Monitoring and Assessing Water Quality > STORET > STORET Web Services End Hierarchical Links


STORET Web Services

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

Please Note: These services have been revised as of February 8, 2008. Revisions to the web services include enhancements in performance, additional web methods, and enhanced request parameters. Please refer to the revised STORET Web Services Consumption User Guide (see link below) for a description of the revised services.
What is a web service?
  • A web service is a computer-to-computer protocol that allows for the direct sharing of information.

  • With the STORET web services, applications may access data directly from the STORET Warehouse without needing an authorized database connection.

  • The STORET web services have different input parameters and pre-defined output formats.

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 269 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 End Point and Output Schema of the Web Service

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.

Watershed Summary Web Service Output Schema (1KB ZIP)

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.

Station Catalog Web Service Output Schema (2KB ZIP)

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

Project Catalog Web Service Output Schema (2KB ZIP)

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.

Station Web Service Output Schema (3KB ZIP)

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 February 8, 2008) to provide for faster data retrieval. Results may now 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 draft STORET Web Services Consumption User Guide (PDF 641 KB) for a full description of the STORET Result Web Service.

STORET Result Web Service (5KB ZIP)

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.


Begin Site Footer

EPA Home | Privacy and Security Notice | Contact Us