---
title: "Municipalities ranked by one pollutant"
method: GET
path: "/api/v1/air-quality/kunta-ranking"
tags: ["Air quality"]
---

# Municipalities ranked by one pollutant

`GET /api/v1/air-quality/kunta-ranking`

## Request

- Base URL: `https://suomiatlas.com`
- URL: `https://suomiatlas.com/api/v1/air-quality/kunta-ranking`
- Auth: one of:
  - none
  - HTTP bearer

Every municipality with a served reading, **cleanest first** (ascending). Free and uncapped.

Example request: https://suomiatlas.com/api/v1/air-quality/kunta-ranking?pollutant=aq_pm25_avg&year=2024

## Query parameters

- `pollutant` 'aq_pm25_avg' | 'aq_pm10_avg' | 'aq_no2_avg' | 'aq_o3_avg', required
- `year` integer, required

## Response `200`

Ranking, cleanest first.

- AirQualityRanking
  - `pollutant` string, required
  - `year` integer, required
  - `entries` AirQualityRankingEntry[], required: Ascending — cleanest air first, so rank 1 is the lowest concentration.
    - `kuntaCode` string, required
    - `name` string, required
    - `value` number, double, required
    - `rank` integer, required

## Other responses

- `400`: A parameter was missing, malformed, or outside what this operation accepts. The message names the parameter.

---

[API](https://skmtc.dev/suomiatlas/apis/suomiatlas-read-api.md) · [All operations](https://skmtc.dev/suomiatlas/apis/suomiatlas-read-api/llms.txt) · [OpenAPI document](https://skmtc.dev/suomiatlas/apis/suomiatlas-read-api/revisions/b2627414938d?raw)