Skip to content
HALOWERK

Ortwerk

plz to municipality

Postcode areas from OpenStreetMap (boundary=postal_code relations, extract yetzt/postleitzahlen release 2026.02, ODbL) were rasterised together with the BKG VG250 municipalities (01.01.2026) on a 50 m grid in the equal-area ETRS89-LAEA projection; each pair carries the share of the postcode area and the share of the municipal land area. Overlaps below min_share in both directions (default 1 %) are treated as boundary-generalisation slivers and summed separately. Also returns postcode area,.

POST https://ort.halowerk.com/v1/plz-to-municipality

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
plzstringNoFive-digit German postcode.
agsstringNoAmtlicher Gemeindeschlüssel (8 digits), e.g. 05315000 for Köln.
min_sharenumberNoPairs below this share of both the postcode and the municipality are reported only as slivers.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "plz": {
      "type": "string",
      "pattern": "^\\d{5}$",
      "description": "Five-digit German postcode."
    },
    "ags": {
      "type": "string",
      "pattern": "^\\d{8}$",
      "description": "Amtlicher Gemeindeschlüssel (8 digits), e.g. 05315000 for Köln."
    },
    "min_share": {
      "type": "number",
      "minimum": 0,
      "maximum": 0.5,
      "default": 0.01,
      "description": "Pairs below this share of both the postcode and the municipality are reported only as slivers."
    }
  }
}

Open original schema

Published input example

{
  "plz": "48599"
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →