---
title: "Derived trend metrics for one postal code area"
method: GET
path: "/api/v1/postal-codes/{postalCode}/trends"
tags: ["Areas"]
---

# Derived trend metrics for one postal code area

`GET /api/v1/postal-codes/{postalCode}/trends`

## Request

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

Computed change metrics — population growth, income momentum, ageing velocity and so on — each with the window it was measured over in `windowYears`. Income and unemployment momentum use a fixed 5-year window.

Free, deliberately: the latest value of every trend metric is open. The per-year series behind them is the paid part, at `/derived-history`.

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

## Path parameters

- `postalCode` string, required

## Query parameters

- `year` integer

## Response `200`

Trend metrics.

- TrendMetrics
  - `postalCode` string, required
  - `year` integer, required
  - `metrics` TrendMetric[], required
    - `code` string, required
    - `name` string, required
    - `value` number, double, nullable, required
    - `unit` string, required
    - `windowYears` integer, required: How many years the change was measured over. Quote it: a 5-year figure is not an annual one.

## Other responses

- `404`: No such place, or no data for it. Also what a non-numeric `year` produces, because query-parameter conversion fails before the operation runs.

---

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