OpenPLZ API

App · 9 actions

Look up postal codes, places and streets in Germany, Austria, Switzerland and Liechtenstein: find the town for a postal code or the postal codes of a town, check that a street exists, search addresses, and list states, districts and municipalities with their official keys. Open data, no account or API key needed.

Actions

ActionWhat it does
Find places by postal code or nameFind the towns, cities and villages for a postal code, or the postal codes of a place, in Germany, Austria, Switzerland or Liechtenstein.
Find streetsFind streets by name, postal code or place, or any mix, to check an address or find a street's postal code.
List districtsList the districts (Kreise or Bezirke) of a German federal state, an Austrian province or a Swiss canton, with their keys and types.
List government regionsList the government regions (Regierungsbezirke) of a German federal state, with their keys and seats.
List municipal associationsList Germany's municipal associations (Gemeindeverbände, such as an Amt or a Verwaltungsgemeinschaft) in a federal state or district, with their keys and seats.
List municipalitiesList the municipalities (Gemeinden or communes) of a state, province, canton or district, or all of Liechtenstein's, with their official keys, types and postal codes.
List places in an areaList every place and postal code in a state, province, canton or district, with the municipality each belongs to.
List states, provinces or cantonsList Germany's 16 federal states, Austria's 9 federal provinces or Switzerland's 26 cantons, with their official keys (and each canton's abbreviation).
Search addressesSearch streets with free text: a street, postal code and place in any order, such as Pariser Platz Berlin.

Find places by postal code or name

Find the towns, cities and villages for a postal code, or the postal codes of a place, in Germany, Austria, Switzerland or Liechtenstein. Each place comes with its municipality, district and state. Give a postal code, a name or both.

Inputs

Countrycountrytext
The country to look in. Defaults to Germany.One of: de (Germany), at (Austria), ch (Switzerland), li (Liechtenstein). Default: de.
Postal codepostal_codetext
A postal code, or its first digits to find every code that starts with them. D-10117 and 10 117 work too.
Placenametext
The town, city or village, such as München.
Matchmatchtext
How names and postal codes are compared with what you type, ignoring upper and lower case. Defaults to Starts with. Pattern reads your text as a regular expression.One of: starts_with (Starts with), exact, contains, pattern (Pattern (regular expression)). Default: starts_with.
Pagepagenumber
Which page of results to get, from 1. Defaults to the first.At least 1. Default: 1.
Page sizepage_sizenumber
How many results a page holds, 1 to 50. Defaults to 50.From 1 to 50. Default: 50.
Get every pageall_pagestrue/false
Get every result at once, up to 1,000, instead of one page. Page and Page size are then ignored.Default: false.

Outputs

countnumber
How many are in this result.
countrytext
The country's code, e.g. 'DE'.
country_nametext
The country's name, e.g. 'Germany'.
has_moretrue/false
True when more match than this result holds.
next_pagenumber
The page to ask for next with the same page size; empty on the last page.
pagenumber
The page returned, from 1.
page_sizenumber
How many a page holds.
placeslist
The matching places
summarytext
One line saying what was found, e.g. 'Found 1 place in Germany'.
totalnumber
How many match in all, across every page.
total_pagesnumber
How many pages there are at this page size.
Example output
{
  "count": 1,
  "country": "DE",
  "country_name": "Germany",
  "has_more": false,
  "next_page": null,
  "page": 1,
  "page_size": 50,
  "places": [
    {
      "district": null,
      "district_key": null,
      "label": "10117 Berlin",
      "municipality": "Berlin, Stadt",
      "municipality_key": "11000000",
      "municipality_type": "Kreisfreie Stadt",
      "name": "Berlin",
      "postal_code": "10117",
      "state": "Berlin",
      "state_key": "11",
      "state_short_name": null
    }
  ],
  "summary": "Found 1 place in Germany for postal code '10117' (exact).",
  "total": 1,
  "total_pages": 1
}

Find streets

Find streets by name, postal code or place, or any mix, to check an address or find a street's postal code. Each street comes with its place, borough (Germany), municipality, district and state.

Inputs

Countrycountrytext
The country to look in. Defaults to Germany.One of: de (Germany), at (Austria), ch (Switzerland), li (Liechtenstein). Default: de.
Streetstreettext
The street's name, such as Hauptstraße. In Germany, Straße, Strasse and Str. all match.
Postal codepostal_codetext
A postal code, or its first digits to find every code that starts with them. D-10117 and 10 117 work too.
Placelocalitytext
The town, city or village the street is in, such as Köln.
Matchmatchtext
How names and postal codes are compared with what you type, ignoring upper and lower case. Defaults to Starts with. Pattern reads your text as a regular expression.One of: starts_with (Starts with), exact, contains, pattern (Pattern (regular expression)). Default: starts_with.
Pagepagenumber
Which page of results to get, from 1. Defaults to the first.At least 1. Default: 1.
Page sizepage_sizenumber
How many results a page holds, 1 to 50. Defaults to 50.From 1 to 50. Default: 50.
Get every pageall_pagestrue/false
Get every result at once, up to 1,000, instead of one page. Page and Page size are then ignored.Default: false.

Outputs

countnumber
How many are in this result.
countrytext
The country's code, e.g. 'DE'.
country_nametext
The country's name, e.g. 'Germany'.
has_moretrue/false
True when more match than this result holds.
next_pagenumber
The page to ask for next with the same page size; empty on the last page.
pagenumber
The page returned, from 1.
page_sizenumber
How many a page holds.
streetslist
The matching streets
summarytext
One line saying what was found, e.g. 'Found 1 place in Germany'.
totalnumber
How many match in all, across every page.
total_pagesnumber
How many pages there are at this page size.
Example output
{
  "count": 1,
  "country": "DE",
  "country_name": "Germany",
  "has_more": false,
  "next_page": null,
  "page": 1,
  "page_size": 50,
  "streets": [
    {
      "borough": "Mitte",
      "district": null,
      "district_key": null,
      "label": "Pariser Platz, 10117 Berlin",
      "locality": "Berlin",
      "municipality": "Berlin, Stadt",
      "municipality_key": "11000000",
      "municipality_type": "Kreisfreie Stadt",
      "name": "Pariser Platz",
      "postal_code": "10117",
      "state": "Berlin",
      "state_key": "11",
      "state_short_name": null,
      "status": null,
      "street_key": null,
      "suburb": "Mitte"
    }
  ],
  "summary": "Found 1 street in Germany for street 'Pariser Platz' and place 'Berlin' (exact).",
  "total": 1,
  "total_pages": 1
}

List districts

List the districts (Kreise or Bezirke) of a German federal state, an Austrian province or a Swiss canton, with their keys and types. In Germany, a government region's key lists only that region's districts.

Inputs

Countrycountrytext
The country to look in. Defaults to Germany.One of: de (Germany), at (Austria), ch (Switzerland). Default: de.
State, province or cantonstatetextRequired
Pick one, or type its name, abbreviation (such as BY or ZH) or key.
Pagepagenumber
Which page of results to get, from 1. Defaults to the first.At least 1. Default: 1.
Page sizepage_sizenumber
How many results a page holds, 1 to 50. Defaults to 50.From 1 to 50. Default: 50.
Get every pageall_pagestrue/false
Get every result at once, up to 1,000, instead of one page. Page and Page size are then ignored.Default: false.

Outputs

countnumber
How many are in this result.
countrytext
The country's code, e.g. 'DE'.
country_nametext
The country's name, e.g. 'Germany'.
districtslist
The districts
has_moretrue/false
True when more match than this result holds.
next_pagenumber
The page to ask for next with the same page size; empty on the last page.
pagenumber
The page returned, from 1.
page_sizenumber
How many a page holds.
summarytext
One line saying what was found, e.g. 'Found 1 place in Germany'.
totalnumber
How many match in all, across every page.
total_pagesnumber
How many pages there are at this page size.
Example output
{
  "count": 1,
  "country": "DE",
  "country_name": "Germany",
  "districts": [
    {
      "administrative_headquarters": "Starnberg",
      "government_region": "Oberbayern",
      "government_region_key": "091",
      "key": "09188",
      "name": "Starnberg",
      "short_name": null,
      "state": "Bayern",
      "state_key": "09",
      "state_short_name": null,
      "type": "Landkreis"
    }
  ],
  "has_more": true,
  "next_page": 2,
  "page": 1,
  "page_size": 1,
  "summary": "Found 96 districts in Bayern; showing 1 to 1.",
  "total": 96,
  "total_pages": 96
}

List government regions

List the government regions (Regierungsbezirke) of a German federal state, with their keys and seats. Only some states have them, such as Bayern, Hessen and Nordrhein-Westfalen.

Inputs

Federal statestatetextRequired
Pick a German federal state, or type its name or key (such as Bayern or 09).
Pagepagenumber
Which page of results to get, from 1. Defaults to the first.At least 1. Default: 1.
Page sizepage_sizenumber
How many results a page holds, 1 to 50. Defaults to 50.From 1 to 50. Default: 50.
Get every pageall_pagestrue/false
Get every result at once, up to 1,000, instead of one page. Page and Page size are then ignored.Default: false.

Outputs

countnumber
How many are in this result.
countrytext
The country's code, e.g. 'DE'.
country_nametext
The country's name, e.g. 'Germany'.
has_moretrue/false
True when more match than this result holds.
next_pagenumber
The page to ask for next with the same page size; empty on the last page.
pagenumber
The page returned, from 1.
page_sizenumber
How many a page holds.
regionslist
The state's government regions
summarytext
One line saying what was found, e.g. 'Found 1 place in Germany'.
totalnumber
How many match in all, across every page.
total_pagesnumber
How many pages there are at this page size.
Example output
{
  "count": 1,
  "country": "DE",
  "country_name": "Germany",
  "has_more": true,
  "next_page": 2,
  "page": 1,
  "page_size": 1,
  "regions": [
    {
      "administrative_headquarters": "M\u00fcnchen",
      "key": "091",
      "name": "Oberbayern",
      "state": "Bayern",
      "state_key": "09"
    }
  ],
  "summary": "Bayern has 7 government regions; showing 1 to 1.",
  "total": 7,
  "total_pages": 7
}

List municipal associations

List Germany's municipal associations (Gemeindeverbände, such as an Amt or a Verwaltungsgemeinschaft) in a federal state or district, with their keys and seats.

Inputs

Federal statestatetext
Pick a German federal state, or type its name or key (such as Bayern or 09). Not needed when a district is given as a key.
Districtdistricttext
Leave empty for the whole state. Pick a district or government region, or give its key (such as 09171) or name.
Pagepagenumber
Which page of results to get, from 1. Defaults to the first.At least 1. Default: 1.
Page sizepage_sizenumber
How many results a page holds, 1 to 50. Defaults to 50.From 1 to 50. Default: 50.
Get every pageall_pagestrue/false
Get every result at once, up to 1,000, instead of one page. Page and Page size are then ignored.Default: false.

Outputs

associationslist
The municipal associations
countnumber
How many are in this result.
countrytext
The country's code, e.g. 'DE'.
country_nametext
The country's name, e.g. 'Germany'.
has_moretrue/false
True when more match than this result holds.
next_pagenumber
The page to ask for next with the same page size; empty on the last page.
pagenumber
The page returned, from 1.
page_sizenumber
How many a page holds.
summarytext
One line saying what was found, e.g. 'Found 1 place in Germany'.
totalnumber
How many match in all, across every page.
total_pagesnumber
How many pages there are at this page size.
Example output
{
  "associations": [
    {
      "administrative_headquarters": "Emmerting",
      "district": "Alt\u00f6tting",
      "district_key": "09171",
      "key": "091715101",
      "name": "Emmerting (VGem)",
      "state": "Bayern",
      "state_key": "09",
      "type": "Verwaltungsgemeinschaft"
    }
  ],
  "count": 1,
  "country": "DE",
  "country_name": "Germany",
  "has_more": true,
  "next_page": 2,
  "page": 1,
  "page_size": 1,
  "summary": "Found 5 municipal associations in Alt\u00f6tting; showing 1 to 1.",
  "total": 5,
  "total_pages": 5
}

List municipalities

List the municipalities (Gemeinden or communes) of a state, province, canton or district, or all of Liechtenstein's, with their official keys, types and postal codes.

Inputs

Countrycountrytext
The country to look in. Defaults to Germany.One of: de (Germany), at (Austria), ch (Switzerland), li (Liechtenstein). Default: de.
State, province or cantonstatetext
Pick one, or type its name, abbreviation (such as BY or ZH) or key. Not needed when a district is given as a key.Only when Country is Germany, Austria or Switzerland.
Districtdistricttext
Leave empty for the whole state, province or canton. Pick a district (in Germany, a government region too), or give its key or name.Only when Country is Germany, Austria or Switzerland.
Pagepagenumber
Which page of results to get, from 1. Defaults to the first.At least 1. Default: 1.
Page sizepage_sizenumber
How many results a page holds, 1 to 50. Defaults to 50.From 1 to 50. Default: 50.
Get every pageall_pagestrue/false
Get every result at once, up to 1,000, instead of one page. Page and Page size are then ignored.Default: false.

Outputs

countnumber
How many are in this result.
countrytext
The country's code, e.g. 'DE'.
country_nametext
The country's name, e.g. 'Germany'.
has_moretrue/false
True when more match than this result holds.
municipalitieslist
The municipalities
next_pagenumber
The page to ask for next with the same page size; empty on the last page.
pagenumber
The page returned, from 1.
page_sizenumber
How many a page holds.
summarytext
One line saying what was found, e.g. 'Found 1 place in Germany'.
totalnumber
How many match in all, across every page.
total_pagesnumber
How many pages there are at this page size.
Example output
{
  "count": 1,
  "country": "DE",
  "country_name": "Germany",
  "has_more": true,
  "municipalities": [
    {
      "association": null,
      "association_key": null,
      "code": null,
      "district": "Starnberg",
      "district_key": "09188",
      "electoral_district": null,
      "government_region": "Oberbayern",
      "government_region_key": "091",
      "key": "09188113",
      "multiple_postal_codes": true,
      "name": "Berg",
      "postal_code": "82335",
      "short_name": null,
      "state": "Bayern",
      "state_key": "09",
      "state_short_name": null,
      "type": "Kreisangeh\u00f6rige Gemeinde"
    }
  ],
  "next_page": 2,
  "page": 1,
  "page_size": 1,
  "summary": "Found 15 municipalities in Starnberg; showing 1 to 1.",
  "total": 15,
  "total_pages": 15
}

List places in an area

List every place and postal code in a state, province, canton or district, with the municipality each belongs to.

Inputs

Countrycountrytext
The country to look in. Defaults to Germany.One of: de (Germany), at (Austria), ch (Switzerland). Default: de.
State, province or cantonstatetext
Pick one, or type its name, abbreviation (such as BY or ZH) or key. Not needed when a district is given as a key.Only when Country is Germany, Austria or Switzerland.
Districtdistricttext
Leave empty for the whole state, province or canton. Pick a district (in Germany, a government region too), or give its key or name.Only when Country is Germany, Austria or Switzerland.
Pagepagenumber
Which page of results to get, from 1. Defaults to the first.At least 1. Default: 1.
Page sizepage_sizenumber
How many results a page holds, 1 to 50. Defaults to 50.From 1 to 50. Default: 50.
Get every pageall_pagestrue/false
Get every result at once, up to 1,000, instead of one page. Page and Page size are then ignored.Default: false.

Outputs

countnumber
How many are in this result.
countrytext
The country's code, e.g. 'DE'.
country_nametext
The country's name, e.g. 'Germany'.
has_moretrue/false
True when more match than this result holds.
next_pagenumber
The page to ask for next with the same page size; empty on the last page.
pagenumber
The page returned, from 1.
page_sizenumber
How many a page holds.
placeslist
The places
summarytext
One line saying what was found, e.g. 'Found 1 place in Germany'.
totalnumber
How many match in all, across every page.
total_pagesnumber
How many pages there are at this page size.
Example output
{
  "count": 1,
  "country": "DE",
  "country_name": "Germany",
  "has_more": true,
  "next_page": 2,
  "page": 1,
  "page_size": 1,
  "places": [
    {
      "district": "Starnberg",
      "district_key": "09188",
      "label": "82131 Gauting",
      "municipality": "Gauting",
      "municipality_key": "09188120",
      "municipality_type": "Kreisangeh\u00f6rige Gemeinde",
      "name": "Gauting",
      "postal_code": "82131",
      "state": "Bayern",
      "state_key": "09",
      "state_short_name": null
    }
  ],
  "summary": "Found 18 places with postal codes in Starnberg; showing 1 to 1.",
  "total": 18,
  "total_pages": 18
}

List states, provinces or cantons

List Germany's 16 federal states, Austria's 9 federal provinces or Switzerland's 26 cantons, with their official keys (and each canton's abbreviation).

Inputs

Countrycountrytext
The country to look in. Defaults to Germany.One of: de (Germany), at (Austria), ch (Switzerland). Default: de.

Outputs

countnumber
How many there are.
countrytext
The country's code, e.g. 'DE'.
country_nametext
The country's name, e.g. 'Germany'.
stateslist
The states, provinces or cantons
summarytext
One line saying what was found, e.g. 'Found 1 place in Germany'.
Example output
{
  "count": 2,
  "country": "CH",
  "country_name": "Switzerland",
  "states": [
    {
      "key": "1",
      "name": "Z\u00fcrich",
      "seat_of_government": null,
      "short_name": "ZH"
    },
    {
      "key": "2",
      "name": "Bern / Berne",
      "seat_of_government": null,
      "short_name": "BE"
    }
  ],
  "summary": "Switzerland has 26 cantons."
}

Search addresses

Search streets with free text: a street, postal code and place in any order, such as Pariser Platz Berlin. Accents and word order don't matter. Returns the matching streets with their postal codes and places.

Inputs

Search forquerytextRequired
Street, postal code and place in any order, such as Pariser Platz 10117 Berlin. Accents can be left out. Put words in quotes to find them side by side.
Countrycountrytext
The country to look in. Defaults to Germany.One of: de (Germany), at (Austria), ch (Switzerland), li (Liechtenstein). Default: de.
Pagepagenumber
Which page of results to get, from 1. Defaults to the first.At least 1. Default: 1.
Page sizepage_sizenumber
How many results a page holds, 1 to 50. Defaults to 50.From 1 to 50. Default: 50.
Get every pageall_pagestrue/false
Get every result at once, up to 1,000, instead of one page. Page and Page size are then ignored.Default: false.

Outputs

countnumber
How many are in this result.
countrytext
The country's code, e.g. 'DE'.
country_nametext
The country's name, e.g. 'Germany'.
has_moretrue/false
True when more match than this result holds.
next_pagenumber
The page to ask for next with the same page size; empty on the last page.
pagenumber
The page returned, from 1.
page_sizenumber
How many a page holds.
streetslist
The matching streets
summarytext
One line saying what was found, e.g. 'Found 1 place in Germany'.
totalnumber
How many match in all, across every page.
total_pagesnumber
How many pages there are at this page size.
Example output
{
  "count": 1,
  "country": "DE",
  "country_name": "Germany",
  "has_more": false,
  "next_page": null,
  "page": 1,
  "page_size": 50,
  "streets": [
    {
      "borough": "Mitte",
      "district": null,
      "district_key": null,
      "label": "Pariser Platz, 10117 Berlin",
      "locality": "Berlin",
      "municipality": "Berlin, Stadt",
      "municipality_key": "11000000",
      "municipality_type": "Kreisfreie Stadt",
      "name": "Pariser Platz",
      "postal_code": "10117",
      "state": "Berlin",
      "state_key": "11",
      "state_short_name": null,
      "status": null,
      "street_key": null,
      "suburb": "Mitte"
    }
  ],
  "summary": "Found 1 street in Germany for 'Pariser Platz Berlin'.",
  "total": 1,
  "total_pages": 1
}

On this page