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 Facilities API

The Facilities API from EPA — U.S. Environmental Protection Agency — 12 operation(s) for facilities.

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

This API exposes 19 operations across 12 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.

19 operations 12 paths 3 schemas 12 GET7 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 Facilities 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 19

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

Facilities 19
GET
/facilities-mgmt/facilities
FacilitiesController_getFacilities 4 params → 200400404
GET
/facilities-mgmt/facilities/attributes
FacilitiesController_getAllFacilityAttributes 10 params → 200400404
GET
/facilities-mgmt/facilities/attributes/applicable
FacilitiesController_getApplicableFacilityAttributes 1 param → 200400404
GET
/facilities-mgmt/facilities/{id}
FacilitiesController_getFacilityById 1 param → 200400404
GET
/streaming-services/facilities/attributes
FacilitiesController_streamAttributes 9 params → 200400404
GET
/air_rest_services.get_download
Clean Air Act Download Data Service
4 params → 200
POST
/air_rest_services.get_download
Clean Air Act Download Data Service
4 params → 200
GET
/air_rest_services.get_facilities
Clean Air Act Facility Search
113 params → 200
POST
/air_rest_services.get_facilities
Clean Air Act Facility Search
113 params → 200
GET
/air_rest_services.get_facility_info
Clean Air Act Facility Enhanced Search
112 params → 200
POST
/air_rest_services.get_facility_info
Clean Air Act Facility Enhanced Search
112 params → 200
GET
/air_rest_services.get_geojson
Clean Air Act GeoJSON Service
7 params → 200
POST
/air_rest_services.get_geojson
Clean Air Act GeoJSON Service
7 params → 200
GET
/air_rest_services.get_info_clusters
Clean Air Act Info Clusters Service
3 params → 200
POST
/air_rest_services.get_info_clusters
Clean Air Act Info Clusters Service
3 params → 200
GET
/air_rest_services.get_map
Clean Air Act Map Service
9 params → 200
POST
/air_rest_services.get_map
Clean Air Act Map Service
9 params → 200
GET
/air_rest_services.get_qid
Clean Air Act Search by Query ID
7 params → 200
POST
/air_rest_services.get_qid
Clean Air Act Search by Query ID
7 params → 200

Schemas 3

The contract defines 3 schemas that model the data the API accepts and returns. The most detailed are FacilityAttributesDTO (30 properties), ApplicableFacilityAttributesDTO (8 properties), FacilityDTO (5 properties). Each schema is shown below with its type and property counts.

ApplicableFacilityAttributesDTO
object
8 properties 8 required
FacilityDTO
object
5 properties 5 required
FacilityAttributesDTO
object
30 properties 25 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

epa-facilities-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