Air quality

Air quality for one postal code area

PM2.5, PM10, NO2 and O3 from the nearest FMI measuring station, with WHO and EU benchmarks and the station's identity and distance.

All four pollutant blocks are always present. Per block, exactly one of data or gap is non-null: data when a station is close enough, gap when none is (reason is TOO_FAR or NO_STATION; the threshold is 15 km for NO2 and PM10, 30 km otherwise). When data is present so is provenance. For O3 the whole benchmarks object is null — not its individual numbers.

Free-tier limit: without Pro or an Area Pass for this exact area, every data.series is an empty array while data.latest, the benchmarks and the station provenance stay, and locked names pollutants[].data.series (requires: area-pass). So the current reading is free and the history is not. An empty series with a locked entry means withheld; without one it is genuinely empty.

Example request: https://suomiatlas.com/api/v1/postal-codes/00120/air-quality

get/api/v1/postal-codes/{postalCode}/air-quality

Request

  • Base URL: https://suomiatlas.com
  • URL: https://suomiatlas.com/api/v1/postal-codes/{postalCode}/air-quality
  • Auth: one of:
    • none
    • HTTP bearer

Path parameters

postalCodestring required

A 5-digit Finnish postal code. Not format-checked on this operation: an invalid code produces a 404 rather than a 400.

Response

Air quality, series possibly emptied.

areaCodestring nullable required

The postal code asked for; null on the municipality endpoint.

kuntaCodestring required
kuntaNamestring required

Example response

{
  "pollutants": [
    {
      "unit": "µg/m³"
    }
  ],
  "locked": [
    {
      "upgrade": "https://suomiatlas.com/hinnat"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.