AirData AQS REST API

The AirData AQS REST API (https://edg.epa.gov/metadata/catalog/search/resource/details.page?uuid=%7B9A27C77A-495A-4E82-B4B9-BDA6F63F9E59%7D ) enables the retrieval of historical air quality data from EPA. AQS contains the data that the US EPA has collected via the national ambient air monitoring program. It also includes the associated aggregate values calculated by EPA (8-hour, daily, annual, etc.).

Multiple endpoints are available depending upon the operation to be performed. They are:

/rawData
A synchronous request that returns raw data that matches your query criteria

    https://aqs.epa.gov/aqsweb/documents/ramltohtml.html#rawData_get

/rawDataNotify
Same as /rawData but performed asynchronously. A Transaction ID number is returned which can be used later to retrieve the data once the data becomes available.

    https://aqs.epa.gov/aqsweb/documents/ramltohtml.html#rawDataNotify_get

/profile
The purpose of this service is to give users a "profile" of the available data in the system before they construct other queries to retrieve the data. It returns a list of monitors that match your selection criteria and a profile of the data available from those monitors. Any monitor that matches your selection criteria will be returned. Particular attention should be paid to the time window. If the monitor operated between the years of the begin date and end date (only full years are considered), the monitor will be included in the returned list. However, information about the entire operational history of the monitor will be included in the returned file.

    https://aqs.epa.gov/aqsweb/documents/ramltohtml.html#profile_get

/profileNotify
Same as /profile but performed asynchronously. A Transaction ID number is returned which can be used later to retrieve the data once the data becomes available.

    https://aqs.epa.gov/aqsweb/documents/ramltohtml.html#profileNotify_get

/status
Returns the status of a previously submitted asynchronous request

    https://aqs.epa.gov/aqsweb/documents/ramltohtml.html#status_get

/retrieve
Retrieves the data created with a previously submitted asynchronous request.

    https://aqs.epa.gov/aqsweb/documents/ramltohtml.html#retrieve_get

/list
Returns a list of valid values for a variable.

    https://aqs.epa.gov/aqsweb/documents/ramltohtml.html#list_get

/serviceAvailable
Returns a response if the service is available

    https://aqs.epa.gov/aqsweb/documents/ramltohtml.html#serviceAvailable_get

Registration required.

https://aqs.epa.gov/aqsweb/documents/ramltohtml.html , https://aqs.epa.gov/api

The AirData AQS REST API is REST web service. Requests to the service are of the following form:

    https://aqs.epa.gov/api/EndPoint?parms

Where:
    Endpoint => The endpoint represents the operation to be performed
    parms => URL parameters specific to the end point

Operation	Description
N/A