Areas

Per-year series for composite scores and trend metrics

The history behind /composites and /trends: up to 10 years per metric, index-aligned to years.

Paid outright. Without Pro or an Area Pass for this exact area the whole request is rejected with 402, and that check runs before the area is looked up — so an unknown postal code also answers 402 to a free caller rather than 404. Do not read a 402 here as evidence the area exists. /history tells such a caller in advance, via a derivedHistory entry in its locked list, that this endpoint will answer 402; an entitled caller may still get 404 for an area with no derived rows.

Example request: https://suomiatlas.com/api/v1/postal-codes/00120/derived-history

get/api/v1/postal-codes/{postalCode}/derived-history

Request

  • Base URL: https://suomiatlas.com
  • URL: https://suomiatlas.com/api/v1/postal-codes/{postalCode}/derived-history
  • Auth: one of:
    • none
    • HTTP bearer

Path parameters

postalCodestring required

A 5-digit Finnish postal code. Not format-checked on this operation: an invalid code produces a 404 rather than a 400.

Response

Derived series.

postalCodestring required
yearsinteger[] required

Ascending, at most 10.

seriesobject required

Composite id or trend metric code to values, index-aligned to years.

namesStringMap required
unitsStringMap required

Changes

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