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-municipalityInputs
| Field | Type | Required | Description |
|---|---|---|---|
| plz | string | No | Five-digit German postcode. |
| ags | string | No | Amtlicher Gemeindeschlüssel (8 digits), e.g. 05315000 for Köln. |
| min_share | number | No | Pairs 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."
}
}
}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
- Ortwerk0.01 USDC
area coverage
POSThttps://ort.halowerk.com/v1/area-coverageRuns one multi-source Dijkstra from all origins (Routing runs on HALOWERK's own graph of the German road and path network built from OpenStreetMap (Geofabrik germany-latest.osm.pbf, data until 2026-11-12, ODbL 1.0; 25 million nodes, edges a
- Ortwerk0.004 USDC
autobahn roadworks
POSThttps://ort.halowerk.com/v1/autobahn-roadworksFetches live roadworks (long- and short-term) and closures per motorway from the public Autobahn App API of Die Autobahn GmbH des Bundes (no key; https://verkehr.autobahn.de/o/autobahn). The free-text periods are parsed into concrete interv
- Ortwerk0.004 USDC
avalanche bulletin
POSThttps://ort.halowerk.com/v1/avalanche-bulletinFresh official WSL SLF CAAMLv6 JSON for one Swiss warning region, in de/en/fr/it with explicit actual-language fallback. Includes the complete unmodified bulletin, all elevation/aspect/time distinctions, publication and validity times, sour