Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

EPA — U.S. Environmental Protection Agency Safe Drinking Water API

The Safe Drinking Water API from EPA — U.S. Environmental Protection Agency — 3 operation(s) for safe drinking water.

EPA — U.S. Environmental Protection Agency Safe Drinking Water API is one of 137 APIs that EPA — U.S. Environmental Protection Agency publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1242 JSON Schema definitions.

Tagged areas include Safe Drinking Water. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 1242 JSON Schemas.

This API exposes 6 operations across 3 paths, and defines 3 schemas. It is described by OpenAPI 3.0.3, at version 1.0.

Requests are made against a single base URL, https://aqs.epa.gov/data/api.

6 operations 3 paths 3 schemas 3 GET3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0
Base URL
https://aqs.epa.gov/data/api
Authentication
API Key
Resource Areas
1

Authentication & Security 1

EPA — U.S. Environmental Protection Agency Safe Drinking Water API declares 1 security scheme for authenticating requests. An API key is passed in the query as key (emailKey). By default, every request must be authenticated.

  • emailKey — AQS requires email and key query parameters on every request. Register at /signup?email=YOUREMAIL to receive a key by email.

Paths & Operations 6

Across 3 paths, the API surfaces 6 operations — 3 GET, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Safe Drinking Water 6
GET
/sdw_rest_services.get_download
Safe Drinking Water Act (SDWA) Download Data Service
3 params → 200
POST
/sdw_rest_services.get_download
Safe Drinking Water Act (SDWA) Download Data Service
3 params → 200
GET
/sdw_rest_services.get_qid
Safe Drinking Water Act (SDWA) Paginated Results Service
7 params → 200
POST
/sdw_rest_services.get_qid
Safe Drinking Water Act (SDWA) Paginated Results Service
7 params → 200
GET
/sdw_rest_services.get_systems
Safe Drinking Water Act (SDWA) Systems Search Service
57 params → 200
POST
/sdw_rest_services.get_systems
Safe Drinking Water Act (SDWA) Systems Search Service
57 params → 200

Schemas 3

The contract defines 3 schemas that model the data the API accepts and returns. The most detailed are sdw04 (77 properties), sdw03 (14 properties), sdw02 (5 properties). Each schema is shown below with its type and property counts.

sdw04
object
Safe Drinking Water Search Results Object
77 properties 77 required
sdw02
object
Results Object
5 properties 4 required
sdw03
object
Results Object
14 properties 13 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

epa-safe-drinking-water-api-openapi.yml Raw ↑

Other APIs EPA — U.S. Environmental Protection Agency publishes across the network.

EPA Facility Registry Service (FRS) API
EPA TRI (Toxics Release Inventory) Web Service
EPA ATTAINS Web Services
EPA WATERS — Watershed Assessment, Tracking & Environmental Results
EPA Grants API
EPA Insect Repellents API
EPA e-Manifest Hazardous Waste Tracking
EPA System of Registries (SoR)
CTX — Center for Computational Toxicology and Exposure APIs
EPA — U.S. Environmental Protection Agency Account Type Codes API
EPA — U.S. Environmental Protection Agency Accounts API
EPA — U.S. Environmental Protection Agency Air Emission Testing API