---
title: "Returns 72 hour (hourly) Air Quality forecast - Given a geolocation."
method: GET
path: "/forecast/airquality"
tags: ["Air Quality Forecast"]
---

# Returns 72 hour (hourly) Air Quality forecast - Given a geolocation.

`GET /forecast/airquality`

Returns 72 hour (hourly) Air Quality forecast, where each point represents a one hour period.

## Query parameters

- `lat` number, double, required
- `lon` number, double, required
- `city` string, string
- `postal_code` string, string
- `country` string, string
- `key` string, string, required
- `hours` integer

## Response `200`

A forecast object.

- AQHourly
  - `city_name` string — Nearest city name
  - `state_code` string — State Abbreviation
  - `country_code` string — Country Abbreviation
  - `lat` number — Latitude
  - `lon` number — Longitude
  - `timezone` string — Local IANA time zone
  - `data` AQHour[]
    - `ts` number — Unix Timestamp
    - `timestamp_local` string — Timestamp in local time
    - `timestamp_utc` string — Timestamp UTC
    - `datetime` string — [DEPRECATED] Deprecated - use 'timestamp_utc'
    - `aqi` integer — Cloud cover as a percentage (%)
    - `co` number — Concentration of CO (µg/m³)
    - `so2` number — Concentration of SO2 (µg/m³)
    - `no2` number — Concentration of NO2 (µg/m³)
    - `o3` number — Concentration of O3 (µg/m³)
    - `pm25` number — Concentration of PM 2.5 (µg/m³)
    - `pm10` number — Concentration of PM 10 (µg/m³)

## Other responses

- `204` — No Data Found
- `400` — Client Error
- `403` — Unauthorized/No Access for current plan level
- `429` — Daily or Velocity limit exceeded
- `500` — Internal Server Error

---

[API](https://skmtc.dev/weatherbit/apis/weatherbit-interactive-swagger-ui-documentation.md) · [All operations](https://skmtc.dev/weatherbit/apis/weatherbit-interactive-swagger-ui-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/weatherbit/weatherbit-interactive-swagger-ui-documentation/revisions/31cff6bde48b/schema)