Municipalities

Statistics for one municipality

One municipality's population, crime, dwelling price medians and the list of postal code areas inside it.

Free-tier limits, Pro-only — an Area Pass never helps here, because a municipality aggregates all of its areas. Each one that actually applied is named in locked with requires: pro; a municipality with 3 or fewer published years, or no dwelling-price history, gets no entry for that field because nothing was withheld:

  • populationSeries is cut to its last 3 entries.
  • housingPriceSeries is null — not an empty array, and not an error — when it was withheld; a municipality without any such history returns an empty array to every tier. The latest-year medians in housingPrices stay free.

Example request: https://suomiatlas.com/api/v1/kunta/091/stats

get/api/v1/kunta/{kuntaCode}/stats

Request

  • Base URL: https://suomiatlas.com
  • URL: https://suomiatlas.com/api/v1/kunta/{kuntaCode}/stats
  • Auth: one of:
    • none
    • HTTP bearer

Path parameters

kuntaCodestring required

A 3-digit, zero-padded municipality code — Helsinki is 091. Resolve one with /api/v1/search?kind=municipality.

Response

Municipality statistics, series possibly trimmed or withheld.

kuntaCodestring required
namestring required
maakuntaNamestring nullable required

Example response

{
  "crime": {
    "metrics": [
      {
        "unit": "per 1,000 inhab."
      }
    ]
  },
  "locked": [
    {
      "upgrade": "https://suomiatlas.com/hinnat"
    }
  ]
}

Changes

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