---
title: "Key figures per municipality and year (Kolada)"
method: GET
path: "/v1/municipalities/figures"
---

# Key figures per municipality and year (Kolada)

`GET /v1/municipalities/figures`

## Request

- Base URL: `https://api.aleva.se`
- URL: `https://api.aleva.se/v1/municipalities/figures`
- Auth: one of:
  - none
  - HTTP bearer
  - API key in header `X-API-Key`

## Query parameters

- `kpi` string, required
- `kpi.in` string
- `municipality_id` string
- `municipality_id.in` string
- `year` integer
- `year.gte` integer
- `year.lte` integer
- `limit` integer
- `cursor` string

## Response `200`

OK

- object
  - `_meta` Meta, required
    - `attribution` string
    - `build_run_id` integer
    - `built_at` string, date-time
    - `endpoint` string
    - `fetched_at` string, date-time
    - `licenses` string[]
    - `sources` object[]
    - `usage_mode` string
    - `version` integer
  - `data` object[], required
    - `kpi` string: Kolada key figure id
    - `kpi_title` string
    - `municipality` string
    - `municipality_id` string
    - `municipality_type` string: K municipality, L region
    - `value` number
    - `year` integer
  - `next_cursor` string: Present when there are more rows

## Other responses

- `400`: Invalid parameters
- `401`: Missing or invalid API key
- `404`: Not found
- `429`: Rate limit reached

---

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