---
title: "Hourly air quality forecast"
url: "https://devportal.jilson.dev/apis/open-meteo-air-quality/versions/4ad93d7c-8a21-4800-819a-5115d9921279/paths/v1-air-quality/get"
---

> Full API specification: https://devportal.jilson.dev/apis/open-meteo-air-quality/versions/4ad93d7c-8a21-4800-819a-5115d9921279.md

# Hourly air quality forecast

`GET` `/v1/air-quality`

Provides hourly air quality forecasts including PM2.5, PM10, ozone, nitrogen dioxide, pollen concentrations, and AQI indices from CAMS.

## Query parameters

- `latitude` (string, required)
- `longitude` (string, required)
- `hourly` (array, optional) - A list of air quality variables which should be returned.
- `current` (array, optional) - A list of variables to return for the current conditions.
- `timeformat` (string, optional)
- `timezone` (string, optional)
- `past_days` (integer, optional)
- `forecast_days` (integer, optional)
- `start_date` (string, date, optional) - Start date in ISO 8601 format.
- `end_date` (string, date, optional) - End date in ISO 8601 format.
- `domains` (string, optional) - CAMS domain: auto, cams_europe, or cams_global.
- `apikey` (string, optional) - Only required for commercial subscriptions.

## Responses

- `200` - OK
- `400` - Bad Request

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Open-Meteo Air Quality API
  version: "1.0"
paths:
  /v1/air-quality:
    get:
      tags:
        - Air Quality APIs
      summary: Hourly air quality forecast
      description: Provides hourly air quality forecasts including PM2.5, PM10, ozone,
        nitrogen dioxide, pollen concentrations, and AQI indices from CAMS.
      parameters:
        - name: latitude
          in: query
          required: true
          schema:
            type: string
        - name: longitude
          in: query
          required: true
          schema:
            type: string
        - name: hourly
          in: query
          description: A list of air quality variables which should be returned.
          explode: false
          schema:
            type: array
            items:
              type: string
              enum:
                - pm10
                - pm2_5
                - carbon_monoxide
                - carbon_dioxide
                - nitrogen_dioxide
                - sulphur_dioxide
                - ozone
                - aerosol_optical_depth
                - dust
                - uv_index
                - uv_index_clear_sky
                - ammonia
                - methane
                - alder_pollen
                - birch_pollen
                - grass_pollen
                - mugwort_pollen
                - olive_pollen
                - ragweed_pollen
                - formaldehyde
                - glyoxal
                - non_methane_volatile_organic_compounds
                - pm10_wildfires
                - peroxyacyl_nitrates
                - secondary_inorganic_aerosol
                - residential_elementary_carbon
                - total_elementary_carbon
                - pm2_5_total_organic_matter
                - sea_salt_aerosol
                - nitrogen_monoxide
                - european_aqi
                - european_aqi_pm2_5
                - european_aqi_pm10
                - european_aqi_nitrogen_dioxide
                - european_aqi_ozone
                - european_aqi_sulphur_dioxide
                - us_aqi
                - us_aqi_pm2_5
                - us_aqi_pm10
                - us_aqi_nitrogen_dioxide
                - us_aqi_carbon_monoxide
                - us_aqi_ozone
                - us_aqi_sulphur_dioxide
                - is_day
        - name: current
          in: query
          description: A list of variables to return for the current conditions.
          explode: false
          schema:
            type: array
            items:
              type: string
              enum:
                - european_aqi
                - us_aqi
                - pm10
                - pm2_5
                - carbon_monoxide
                - nitrogen_dioxide
                - sulphur_dioxide
                - ozone
                - aerosol_optical_depth
                - dust
                - uv_index
                - uv_index_clear_sky
                - ammonia
                - alder_pollen
                - birch_pollen
                - grass_pollen
                - mugwort_pollen
                - olive_pollen
                - ragweed_pollen
        - name: timeformat
          in: query
          schema:
            type: string
            default: iso8601
            enum:
              - iso8601
              - unixtime
        - name: timezone
          in: query
          schema:
            type: string
        - name: past_days
          in: query
          schema:
            type: integer
            default: 0
            minimum: 0
            maximum: 92
        - name: forecast_days
          in: query
          schema:
            type: integer
            default: 5
            minimum: 0
            maximum: 7
        - name: start_date
          in: query
          description: Start date in ISO 8601 format.
          schema:
            type: string
            format: date
        - name: end_date
          in: query
          description: End date in ISO 8601 format.
          schema:
            type: string
            format: date
        - name: domains
          in: query
          description: "CAMS domain: auto, cams_europe, or cams_global."
          schema:
            type: string
            enum:
              - auto
              - cams_europe
              - cams_global
        - name: apikey
          in: query
          description: Only required for commercial subscriptions.
          schema:
            type: string
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  latitude:
                    type: number
                    format: float
                  longitude:
                    type: number
                    format: float
                  elevation:
                    type: number
                    format: float
                  generationtime_ms:
                    type: number
                    format: float
                  utc_offset_seconds:
                    type: integer
                  timezone:
                    type: string
                  timezone_abbreviation:
                    type: string
                  hourly:
                    type: object
                    properties:
                      time:
                        type: array
                        items:
                          type: string
                      pm10:
                        type: array
                        items:
                          type: number
                          format: float
                      pm2_5:
                        type: array
                        items:
                          type: number
                          format: float
                      carbon_monoxide:
                        type: array
                        items:
                          type: number
                          format: float
                      carbon_dioxide:
                        type: array
                        items:
                          type: number
                          format: float
                      nitrogen_dioxide:
                        type: array
                        items:
                          type: number
                          format: float
                      sulphur_dioxide:
                        type: array
                        items:
                          type: number
                          format: float
                      ozone:
                        type: array
                        items:
                          type: number
                          format: float
                      aerosol_optical_depth:
                        type: array
                        items:
                          type: number
                          format: float
                      dust:
                        type: array
                        items:
                          type: number
                          format: float
                      uv_index:
                        type: array
                        items:
                          type: number
                          format: float
                      uv_index_clear_sky:
                        type: array
                        items:
                          type: number
                          format: float
                      ammonia:
                        type: array
                        items:
                          type: number
                          format: float
                      methane:
                        type: array
                        items:
                          type: number
                          format: float
                      alder_pollen:
                        type: array
                        items:
                          type: number
                          format: float
                      birch_pollen:
                        type: array
                        items:
                          type: number
                          format: float
                      grass_pollen:
                        type: array
                        items:
                          type: number
                          format: float
                      mugwort_pollen:
                        type: array
                        items:
                          type: number
                          format: float
                      olive_pollen:
                        type: array
                        items:
                          type: number
                          format: float
                      ragweed_pollen:
                        type: array
                        items:
                          type: number
                          format: float
                      formaldehyde:
                        type: array
                        items:
                          type: number
                          format: float
                      glyoxal:
                        type: array
                        items:
                          type: number
                          format: float
                      non_methane_volatile_organic_compounds:
                        type: array
                        items:
                          type: number
                          format: float
                      pm10_wildfires:
                        type: array
                        items:
                          type: number
                          format: float
                      peroxyacyl_nitrates:
                        type: array
                        items:
                          type: number
                          format: float
                      secondary_inorganic_aerosol:
                        type: array
                        items:
                          type: number
                          format: float
                      residential_elementary_carbon:
                        type: array
                        items:
                          type: number
                          format: float
                      total_elementary_carbon:
                        type: array
                        items:
                          type: number
                          format: float
                      pm2_5_total_organic_matter:
                        type: array
                        items:
                          type: number
                          format: float
                      sea_salt_aerosol:
                        type: array
                        items:
                          type: number
                          format: float
                      nitrogen_monoxide:
                        type: array
                        items:
                          type: number
                          format: float
                      european_aqi:
                        type: array
                        items:
                          type: integer
                      european_aqi_pm2_5:
                        type: array
                        items:
                          type: integer
                      european_aqi_pm10:
                        type: array
                        items:
                          type: integer
                      european_aqi_nitrogen_dioxide:
                        type: array
                        items:
                          type: integer
                      european_aqi_ozone:
                        type: array
                        items:
                          type: integer
                      european_aqi_sulphur_dioxide:
                        type: array
                        items:
                          type: integer
                      us_aqi:
                        type: array
                        items:
                          type: integer
                      us_aqi_pm2_5:
                        type: array
                        items:
                          type: integer
                      us_aqi_pm10:
                        type: array
                        items:
                          type: integer
                      us_aqi_nitrogen_dioxide:
                        type: array
                        items:
                          type: integer
                      us_aqi_carbon_monoxide:
                        type: array
                        items:
                          type: integer
                      us_aqi_ozone:
                        type: array
                        items:
                          type: integer
                      us_aqi_sulphur_dioxide:
                        type: array
                        items:
                          type: integer
                      is_day:
                        type: array
                        items:
                          type: integer
                  hourly_units:
                    type: object
                    properties:
                      time:
                        type: string
                      pm10:
                        type: string
                      pm2_5:
                        type: string
                      carbon_monoxide:
                        type: string
                      carbon_dioxide:
                        type: string
                      nitrogen_dioxide:
                        type: string
                      sulphur_dioxide:
                        type: string
                      ozone:
                        type: string
                      aerosol_optical_depth:
                        type: string
                      dust:
                        type: string
                      uv_index:
                        type: string
                      uv_index_clear_sky:
                        type: string
                      ammonia:
                        type: string
                      methane:
                        type: string
                      alder_pollen:
                        type: string
                      birch_pollen:
                        type: string
                      grass_pollen:
                        type: string
                      mugwort_pollen:
                        type: string
                      olive_pollen:
                        type: string
                      ragweed_pollen:
                        type: string
                      formaldehyde:
                        type: string
                      glyoxal:
                        type: string
                      non_methane_volatile_organic_compounds:
                        type: string
                      pm10_wildfires:
                        type: string
                      peroxyacyl_nitrates:
                        type: string
                      secondary_inorganic_aerosol:
                        type: string
                      residential_elementary_carbon:
                        type: string
                      total_elementary_carbon:
                        type: string
                      pm2_5_total_organic_matter:
                        type: string
                      sea_salt_aerosol:
                        type: string
                      nitrogen_monoxide:
                        type: string
                      european_aqi:
                        type: string
                      european_aqi_pm2_5:
                        type: string
                      european_aqi_pm10:
                        type: string
                      european_aqi_nitrogen_dioxide:
                        type: string
                      european_aqi_ozone:
                        type: string
                      european_aqi_sulphur_dioxide:
                        type: string
                      us_aqi:
                        type: string
                      us_aqi_pm2_5:
                        type: string
                      us_aqi_pm10:
                        type: string
                      us_aqi_nitrogen_dioxide:
                        type: string
                      us_aqi_carbon_monoxide:
                        type: string
                      us_aqi_ozone:
                        type: string
                      us_aqi_sulphur_dioxide:
                        type: string
                      is_day:
                        type: string
                  current:
                    type: object
                    properties:
                      time:
                        type: string
                      interval:
                        type: integer
                      european_aqi:
                        type: integer
                      us_aqi:
                        type: integer
                      pm10:
                        type: number
                        format: float
                      pm2_5:
                        type: number
                        format: float
                      carbon_monoxide:
                        type: number
                        format: float
                      nitrogen_dioxide:
                        type: number
                        format: float
                      sulphur_dioxide:
                        type: number
                        format: float
                      ozone:
                        type: number
                        format: float
                      aerosol_optical_depth:
                        type: number
                        format: float
                      dust:
                        type: number
                        format: float
                      uv_index:
                        type: number
                        format: float
                      uv_index_clear_sky:
                        type: number
                        format: float
                      ammonia:
                        type: number
                        format: float
                      alder_pollen:
                        type: number
                        format: float
                      birch_pollen:
                        type: number
                        format: float
                      grass_pollen:
                        type: number
                        format: float
                      mugwort_pollen:
                        type: number
                        format: float
                      olive_pollen:
                        type: number
                        format: float
                      ragweed_pollen:
                        type: number
                        format: float
                  current_units:
                    type: object
                    properties:
                      time:
                        type: string
                      european_aqi:
                        type: string
                      us_aqi:
                        type: string
                      pm10:
                        type: string
                      pm2_5:
                        type: string
                      carbon_monoxide:
                        type: string
                      nitrogen_dioxide:
                        type: string
                      sulphur_dioxide:
                        type: string
                      ozone:
                        type: string
                      aerosol_optical_depth:
                        type: string
                      dust:
                        type: string
                      uv_index:
                        type: string
                      uv_index_clear_sky:
                        type: string
                      ammonia:
                        type: string
                      alder_pollen:
                        type: string
                      birch_pollen:
                        type: string
                      grass_pollen:
                        type: string
                      mugwort_pollen:
                        type: string
                      olive_pollen:
                        type: string
                      ragweed_pollen:
                        type: string
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: boolean
                  reason:
                    type: string
```