Skip to main content
GET
Air Quality
Fetch an air-quality forecast (CAMS European or global model) for any coordinate. Request pollutants and indices with hourly and/or current variable lists — e.g. pm10, pm2_5, carbon_monoxide, nitrogen_dioxide, ozone, dust, uv_index, european_aqi, us_aqi — plus pollen species such as birch_pollen or grass_pollen. Control span with forecast_days (up to 7) and past_days, or pin domains to cams_europe / cams_global. The response returns grid-cell metadata and an hourly (and optional current) block with a time array, one array per variable, and a matching *_units object. Example: GET /apis/v1/openmeteo/air-quality?latitude=52.52&longitude=13.41&hourly=pm10,pm2_5,european_aqi&forecast_days=5&timezone=Europe/Berlin. Billing: $0.00015 per call (150 micros USD), metered per request. All Open-Meteo endpoints are GET pass-through — authenticate with your AIsa API key as a bearer token (the same key used across every AIsa /apis/* endpoint); AIsa handles provider access.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

latitude
string
required

WGS84 latitude of the location. Multiple coordinates can be comma-separated.

Example:

"52.52"

longitude
string
required

WGS84 longitude of the location (negative for the Americas). Multiple coordinates can be comma-separated.

Example:

"13.41"

hourly
string

Comma-separated list of hourly variables to return. Common values: pm10, pm2_5, carbon_monoxide, nitrogen_dioxide, sulphur_dioxide, ozone, aerosol_optical_depth, dust, uv_index, ammonia, european_aqi, us_aqi, and pollen (alder_pollen, birch_pollen, grass_pollen, mugwort_pollen, olive_pollen, ragweed_pollen).

Example:

"pm10,pm2_5,european_aqi"

current
string

Comma-separated list of current-condition variables to return. Same variable set as hourly.

Example:

"european_aqi,pm2_5"

domains
enum<string>
default:auto

Model domain. Default auto.

Available options:
auto,
cams_europe,
cams_global
forecast_days
integer
default:5

Number of forecast days to return (0-7). Default 5.

Example:

7

past_days
integer
default:0

Number of past days to include (0-92). Default 0.

forecast_hours
integer

Limit forecast to a given number of hours.

past_hours
integer

Include a given number of past hours.

start_date
string<date>

Start of the interval, yyyy-mm-dd (ISO 8601).

Example:

"2024-01-01"

end_date
string<date>

End of the interval, yyyy-mm-dd (ISO 8601).

Example:

"2024-01-07"

timeformat
enum<string>
default:iso8601

Time output format. Default iso8601.

Available options:
iso8601,
unixtime
timezone
string

IANA time zone name (e.g. Europe/Berlin) or auto to resolve from coordinates. Defaults to GMT.

Example:

"Europe/Berlin"

cell_selection
enum<string>
default:nearest

Grid-cell preference for the coordinate. Default nearest.

Available options:
land,
sea,
nearest

Response

200 - application/json

Air-quality forecast for the coordinate.

The response is of type object.