Metadata

One metric's value for every area

Every postal code area's value for a single metric and year — roughly 3,000 entries, intended for painting a choropleth. For the question "which areas score highest", /api/v1/rankings is the better fit.

Composite metrics are paid: a composite code returns 402 without Pro. Everything else, including crime and dwelling prices, is free. Nulls are Statistics Finland suppression, not withholding.

Example request: https://suomiatlas.com/api/v1/variable-values?variableCode=hr_mtu&year=2024

get/api/v1/variable-values

Request

  • Base URL: https://suomiatlas.com
  • URL: https://suomiatlas.com/api/v1/variable-values
  • Auth: one of:
    • none
    • HTTP bearer

Query parameters

variableCodestring required

Missing or blank is a 400.

yearinteger required

Missing is a 400. A non-numeric value is a 404.

Response

Postal code to value.

variableCodestring required
yearinteger required
valuesNullableNumberMap required

Metric code to value. A key may be present with a null value — Statistics Finland suppresses figures resting on too few people or dwellings.

Changes

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