---
title: "Catalogue of every available metric"
method: GET
path: "/api/v1/variables"
tags: ["Metadata"]
---

# Catalogue of every available metric

`GET /api/v1/variables`

## Request

- Base URL: `https://suomiatlas.com`
- URL: `https://suomiatlas.com/api/v1/variables`
- Auth: one of:
  - none
  - HTTP bearer

A bare object keyed by group name, each value an array of metric definitions. This is the source of the `variableCode` values the other operations take.

The catalogue is complete regardless of tier: it lists paid metrics too, so a composite appears here even though ranking by it needs Pro. `type` is `composite` for the four composite indices and `crime` for the four municipality-level crime rates.

Example request: https://suomiatlas.com/api/v1/variables

What each group actually counts, when Statistics Finland withholds it, and the misreading it invites is documented at https://suomiatlas.com/en/metrics (Finnish: https://suomiatlas.com/mittarit). Read that before describing any figure from this API: `hr_mtu` is not a salary, and the income-category variables count people rather than euros.

## Response `200`

Metrics, grouped.

- object: Group name to the metrics in that group.

---

[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)