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 Utility Services API

The Utility Services API from EPA — U.S. Environmental Protection Agency — 5 operation(s) for utility services.

EPA — U.S. Environmental Protection Agency Utility Services 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 Utility Services. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 1242 JSON Schemas.

This API exposes 5 operations across 5 paths, and defines 30 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.

5 operations 5 paths 30 schemas 5 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 Utility Services 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 5

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

Utility Services 5
POST
/rpc/randomcatchment
CIP-service Utility Random Catchment
randomcatchment body → 200
POST
/rpc/randomhuc12
CIP-service Utility Random HUC12
randomhuc12 body → 200
POST
/rpc/randomnav
CIP-service Utility Random Nav Location
randomnav body → 200
POST
/rpc/randompoint
CIP-service Utility Random Point
randompoint body → 200
POST
/rpc/randomppnav
CIP-service Utility Random PP Nav Locations
randomppnav body → 200

Schemas 30

The contract defines 30 schemas that model the data the API accepts and returns. The most detailed are navigated_flowline_properties (20 properties), event_feature_properties (8 properties), indexed_flowline_properties (6 properties), geojson_feature (5 properties). Each schema is shown below with its type and property counts.

globalid
string
randomppnav_resp
object
2 properties
measure
number
randomnav_resp
object
1 property
delineated_area_properties
object
4 properties
hydroseq
integer
NHDPlus int64 hydro sequence identifier.
randomhuc12_resp
object
1 property
reachcode
string
randomhuc12_rb
object
1 property
geojson_feature
objectnull
5 properties 3 required
ordinate
number
geojson_bbox
array
navigated_flowline_properties
object
20 properties
randomcatchment_rb
object
1 property
randompoint_rb
object
1 property
event_feature_properties
object
8 properties
indexing_line_properties
object
1 property
end_point_properties
object
3 properties
randompoint_resp
object
1 property
randomnav_rb
object
1 property
coordinates2
array
nhdplus_version
string
NHDPlus version used in CIP indexing.
randomppnav_rb
object
1 property
randomcatchment_resp
object
1 property
indexed_catchment_properties
object
4 properties
nhdplusid
integer
NHDPlus int64 nhdplus identifier.
geojson_geometry
objectnull
2 properties
coordinates1
array
indexed_flowline_properties
object
6 properties
coordinates3
array

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

epa-utility-services-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