---
title: "Boundary of one postal code area"
method: GET
path: "/api/v1/postal-codes/{postalCode}/geometry"
tags: ["Places"]
---

# Boundary of one postal code area

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

## Request

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

A `FeatureCollection` holding exactly one feature.

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

## Path parameters

- `postalCode` string, required

## Response `200`

One boundary.

- GeoJsonFeatureCollection
  - `type` 'FeatureCollection', required
  - `features` GeoJsonFeature[], required
    - `type` 'Feature', required
    - `geometry` object, required: A GeoJSON geometry object, in practice a Polygon or MultiPolygon in WGS84. Left free-form deliberately: the API applies no geometry-type validation, so a stricter schema here would promise a guarantee that does not exist.
    - `properties` GeoJsonProperties, required
      - `postalCode` string, required
      - `name` string, required
      - `municipalityCode` string, required
      - `maakuntaCode` string, nullable, required: Nullable, unlike its siblings: the municipality-to-region mapping is ingested separately from the geometry, so an area can legitimately have no region yet.

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