API for postal codes, area codes and places
The JSON API for postal codes, area codes and places. Send a postal code, an area code or a place name and get back the place, the country and all related postal codes and area codes.
Every request needs an API key. Pass the API key in the X-Api-Token header, as Authorization: Bearer … or as the token parameter.
Endpoint
Country and search term go either in the path or as URL parameters. Both forms return the same JSON response.
https://www.postleitzahl.net/api/{country}/{query}
https://www.postleitzahl.net/api?country={country}&q={query}
{
"status": "success",
"country": "Japan",
"countryCode": "JP",
"place": "Nagoya",
"postcode": [
"4580039",
"4500001",
"4500002",
"4500003",
"4500004",
"4500005",
"4500006",
"4500007",
"4506001",
"4506002",
"4506003",
"4506004",
"4506005",
"4506006",
"4506007",
"4506008",
"4506009",
"4506010",
"4506011",
"4506012",
"4506013",
"4506014",
"4506015",
"4506016",
"4506017",
"4506018",
"4506019",
"4506020",
"4506021",
"4506022",
"4506023",
"4506024",
"4506025",
"4506026",
"4506027",
"4506028",
"4506029",
"4506030",
"4506031",
"4506032",
"4506033",
"4506034",
"4506035",
"4506036",
"4506037",
"4506038",
"4506039",
"4506040",
"4506041",
"4506042",
"4506043",
"4506044",
"4506045",
"4506046",
"4506047",
"4506048",
"4506049",
"4506050",
"4506051",
"4506090",
"4506201",
"4506202",
"4506203",
"4506204",
"4506205",
"4506206",
"4506207",
"4506208",
"4506209",
"4506210",
"4506211",
"4506212",
"4506213",
"4506214",
"4506215",
"4506216",
"4506217",
"4506218",
"4506219",
"4506220",
"4506221",
"4506222",
"4506223",
"4506224",
"4506225",
"4506226",
"4506227",
"4506228",
"4506229",
"4506230",
"4506231",
"4506232",
"4506233",
"4506234",
"4506235",
"4506236",
"4506237",
"4506238",
"4506239",
"4506240",
"4506241",
"4506242",
"4506243",
"4506244",
"4506245",
"4506246",
"4506247",
"4506290",
"4506301",
"4506302",
"4506303",
"4506304",
"4506305",
"4506306",
"4506307",
"4506308",
"4506309",
"4506310",
"4506311",
"4506312",
"4506313",
"4506314",
"4506315",
"4506316",
"4506317",
"4506318",
"4506319",
"4506320",
"4506321",
"4506322",
"4506323",
"4506324",
"4506325",
"4506326",
"4506327",
"4506328",
"4506329",
"4506330",
"4506331",
"4506332",
"4506333",
"4506334",
"4506335",
"4506336",
"4506337",
"4506338",
"4506339",
"4506340",
"4506390",
"4506401",
"4506402",
"4506403",
"4506404",
"4506405",
"4506406",
"4506407",
"4506408",
"4506409",
"4506410",
"4506411",
"4506412",
"4506413",
"4506414",
"4506415",
"4506416",
"4506417",
"4506418",
"4506419",
"4506420",
"4506421",
"4506422",
"4506423",
"4506424",
"4506425",
"4506426",
"4506427",
"4506428",
"4506429",
"4506430",
"4506431",
"4506432",
"4506433",
"4506434",
"4506490",
"4506601",
"4506602",
"4506603",
"4506604",
"4506605",
"4506606",
"4506607",
"4506608",
"4506609",
"4506610",
"4506611",
"4506612",
"4506613",
"4506614",
"4506615",
"4506616",
"4506617",
"4506618",
"4506619",
"4506620",
"4506621",
"4506622",
"4506623",
"4506624",
"4506625",
"4506626",
"4506627",
"4506628",
"4506629",
"4506630",
"4506631",
"4506632",
"4506633",
"4506634",
"4506635",
"4506636",
"4506637",
"4506638",
"4506639",
"4506640",
"4506641",
"4506642",
"4506643",
"4506644",
"4506645",
"4506646",
"4506690",
"4510000",
"4510011",
"4510012",
"4510013",
"4510014",
"4510015",
"4510016",
"4510021",
"4510022",
"4510023",
"4510024",
"4510025",
"4510026",
"4510027",
"4510031",
"4510032",
"4510033",
"4510034",
"4510035",
"4510041",
"4510042",
"4510043",
"4510044",
"4510045",
"4510046",
"4510051",
"4510052",
"4510053",
"4510054",
"4510055",
"4510061",
"4510062",
"4510063",
"4510064",
"4510065",
"4510066",
"4510071",
"4510072",
"4510073",
"4510074",
"4510075",
"4510076",
"4510077",
"4510081",
"4510082",
"4510083",
"4510084",
"4516001",
"4516002",
"4516003",
"4516004",
"4516005",
"4516006",
"4516007",
"4516008",
"4516009",
"4516010",
"4516011",
"4516012",
"4516013",
"4516014",
"4516015",
"4516016",
"4516017",
"4516018",
"4516019",
"4516020",
"4516021",
"4516022",
"4516023",
"4516024",
"4516025",
"4516026",
"4516027",
"4516028",
"4516029",
"4516030",
"4516031",
"4516032",
"4516033",
"4516034",
"4516035",
"4516036",
"4516037",
"4516038",
"4516039",
"4516040",
"4516090",
"4520801",
"4520802",
"4520803",
"4520804",
"4520805",
"4520806",
"4520807",
"4520808",
"4520809",
"4520811",
"4520812",
"4520813",
"4520814",
"4520815",
"4520816",
"4520817",
"4520818",
"4520821",
"4520822",
"4520823",
"4520824",
"4520831",
"4520832",
"4520833",
"4520834",
"4520835",
"4520836",
"4520837",
"4520838",
"4520839",
"4520841",
"4520842",
"4520843",
"4520844",
"4520845",
"4520846",
"4520847",
"4520848",
"4530000",
"4530002",
"4530011",
"4530012",
"4530013",
"4530014",
"4530015",
"4530016",
"4530017",
"4530018",
"4530021",
"4530022",
"4530023",
"4530024",
"4530025",
"4530026",
"4530027",
"4530028",
"4530029",
"4530031",
"4530032",
"4530033",
"4530034",
"4530035",
"4530036",
"4530037",
"4530038",
"4530041",
"4530042",
"4530043",
"4530044",
"4530045",
"4530046",
"4530047",
"4530051",
"4530052",
"4530053",
"4530054",
"4530055",
"4530056",
"4530057",
"4530058",
"4530061",
"4530062",
"4530063",
"4530064",
"4530065",
"4530066",
"4530067",
"4530068",
"4530069",
"4530801",
"4530802",
"4530803",
"4530804",
"4530805",
"4530806",
"4530807",
"4530808",
"4530809",
"4530811",
"4530812",
"4530813",
"4530814",
"4530815",
"4530816",
"4530817",
"4530818",
"4530819",
"4530821",
"4530822",
"4530823",
"4530824",
"4530825",
"4530826",
"4530827",
"4530828",
"4530831",
"4530832",
"4530833",
"4530834",
"4530835",
"4530836",
"4530837",
"4530838",
"4530839",
"4530841",
"4530842",
"4530843",
"4530844",
"4530845",
"4530846",
"4530847",
"4530848",
"4530849",
"4530851",
"4530852",
"4530853",
"4530854",
"4530855",
"4530856",
"4530857",
"4530858",
"4530859",
"4530861",
"4530862",
"4530863",
"4530864",
"4530865",
"4530866",
"4530867",
"4530871",
"4530872",
"4530873",
"4536101",
"4536102",
"4536103",
"4536104",
"4536105",
"4536106",
"4536107",
"4536108",
"4536109",
"4536110",
"4536111",
"4536112",
"4536113",
"4536114",
"4536115",
"4536116",
"4536117",
"4536118",
"4536119",
"4536120",
"4536121",
"4536122",
"4536123",
"4536124",
"4536125",
"4536126",
"4536127",
"4536128",
"4536129",
"4536130",
"4536131",
"4536132",
"4536133",
"4536134",
"4536135",
"4536136",
"4536190",
"4540000",
"4540001",
"4540002",
"4540003",
"4540004",
"4540005",
"4540006",
"4540007",
"4540011",
"4540012",
"4540013",
"4540014",
"4540015",
"4540016",
"4540021",
"4540022",
"4540023",
"4540024",
"4540025",
"4540026",
"4540027",
"4540028",
"4540031",
"4540032",
"4540033",
"4540034",
"4540035",
"4540036",
"4540037",
"4540041",
"4540042",
"4540043",
"4540044",
"4540045",
"4540046",
"4540047",
"4540048",
"4540049",
"4540051",
"4540052",
"4540053",
"4540054",
"4540055",
"4540056",
"4540057",
"4540058",
"4540059",
"4540801",
"4540802",
"4540803",
"4540804",
"4540805",
"4540806",
"4540807",
"4540808",
"4540811",
"4540812",
"4540813",
"4540814",
"4540815",
"4540816",
"4540817",
"4540818",
"4540819",
"4540821",
"4540822",
"4540823",
"4540824",
"4540825",
"4540826",
"4540827",
"4540828",
"4540829",
"4540831",
"4540832",
"4540833",
"4540834",
"4540835",
"4540836",
"4540837",
"4540838",
"4540839",
"4540841",
"4540842",
"4540843",
"4540844",
"4540845",
"4540846",
"4540847",
"4540848",
"4540849",
"4540851",
"4540852",
"4540853",
"4540854",
"4540855",
"4540856",
"4540857",
"4540858",
"4540859",
"4540860",
"4540861",
"4540862",
"4540863",
"4540864",
"4540865",
"4540866",
"4540867",
"4540868",
"4540869",
"4540871",
"4540872",
"4540873",
"4540874",
"4540875",
"4540876",
"4540877",
"4540901",
"4540902",
"4540903",
"4540904",
"4540905",
"4540906",
"4540907",
"4540911",
"4540912",
"4540913",
"4540914",
"4540915",
"4540916",
"4540917",
"4540921",
"4540922",
"4540923",
"4540924",
"4540925",
"4540926",
"4540927",
"4540931",
"4540932",
"4540933",
"4540934",
"4540935",
"4540936",
"4540937",
"4540941",
"4540942",
"4540943",
"4540944",
"4540945",
"4540946",
"4540947",
"4540951",
"4540952",
"4540953",
"4540954",
"4540955",
"4540956",
"4540957",
"4540958",
"4540959",
"4540961",
"4540962",
"4540963",
"4540964",
"4540965",
"4540966",
"4540967",
"4540971",
"4540972",
"4540973",
"4540974",
"4540975",
"4540976",
"4540977",
"4540978",
"4540981",
"4540982",
"4540983",
"4540984",
"4540985",
"4540986",
"4540991",
"4540992",
"4540993",
"4540994",
"4540995",
"4540996",
"4540997",
"4550000",
"4550001",
"4550002",
"4550003",
"4550004",
"4550005",
"4550006",
"4550007",
"4550008",
"4550011",
"4550012",
"4550013",
"4550014",
"4550015",
"4550016",
"4550017",
"4550018",
"4550021",
"4550022",
"4550023",
"4550024",
"4550025",
"4550026",
"4550027",
"4550028",
"4550031",
"4550032",
"4550033",
"4550034",
"4550035",
"4550036",
"4550037",
"4550041",
"4550042",
"4550043",
"4550044",
"4550045",
"4550046",
"4550047",
"4550051",
"4550052",
"4550053",
"4550054",
"4550055",
"4550056",
"4550057",
"4550061",
"4550062",
"4550063",
"4550064",
"4550065",
"4550066",
"4550067",
"4550068",
"4550069",
"4550071",
"4550072",
"4550073",
"4550074",
"4550075",
"4550076",
"4550077",
"4550078",
"4550801",
"4550802",
"4550803",
"4550804",
"4550805",
"4550806",
"4550811",
"4550812",
"4550813",
"4550814",
"4550815",
"4550821",
"4550822",
"4550823",
"4550824",
"4550825",
"4550831",
"4550832",
"4550833",
"4550834",
"4550835",
"4550841",
"4550842",
"4550843",
"4550844",
"4550845",
"4550846",
"4550847",
"4550848",
"4550851",
"4550852",
"4550853",
"4550854",
"4550855",
"4550856",
"4550857",
"4550858",
"4550861",
"4550862",
"4550863",
"4550864",
"4550865",
"4550866",
"4550867",
"4550868",
"4550869",
"4550871",
"4550872",
"4550873",
"4550874",
"4550875",
"4550876",
"4550877",
"4550878",
"4550879",
"4550881",
"4550882",
"4550883",
"4550884",
"4550885",
"4550886",
"4550887",
"4560000",
"4560001",
"4560002",
"4560003",
"4560004",
"4560005",
"4560006",
"4560011",
"4560012",
"4560013",
"4560014",
"4560015",
"4560016",
"4560017",
"4560018",
"4560021",
"4560022",
"4560023",
"4560024",
"4560025",
"4560026",
"4560027",
"4560031",
"4560032",
"4560033",
"4560034",
"4560035",
"4560036",
"4560037",
"4560041",
"4560042",
"4560043",
"4560044",
"4560045",
"4560046",
"4560047",
"4560048",
"4560051",
"4560052",
"4560053",
"4560054",
"4560055",
"4560056",
"4560057",
"4560058",
"4560059",
"4560061",
"4560062",
"4560063",
"4560064",
"4560065",
"4560066",
"4560067",
"4560068",
"4560069",
"4560071",
"4560072",
"4560073",
"4560074",
"4560075",
"4560076",
"4560077",
"4560078",
"4570000",
"4570001",
"4570002",
"4570003",
"4570004",
"4570005",
"4570006",
"4570007",
"4570008",
"4570011",
"4570012",
"4570013",
"4570014",
"4570015",
"4570016",
"4570021",
"4570022",
"4570023",
"4570024",
"4570025",
"4570026",
"4570027",
"4570028",
"4570031",
"4570032",
"4570033",
"4570034",
"4570035",
"4570036",
"4570037",
"4570038",
"4570039",
"4570041",
"4570042",
"4570043",
"4570044",
"4570045",
"4570046",
"4570047",
"4570048",
"4570049",
"4570051",
"4570052",
"4570053",
"4570054",
"4570055",
"4570056",
"4570057",
"4570058",
"4570061",
"4570062",
"4570063",
"4570064",
"4570065",
"4570066",
"4570067",
"4570068",
"4570069",
"4570071",
"4570072",
"4570073",
"4570074",
"4570075",
"4570076",
"4570077",
"4570078",
"4570801",
"4570802",
"4570803",
"4570804",
"4570805",
"4570806",
"4570807",
"4570808",
"4570811",
"4570812",
"4570813",
"4570814",
"4570815",
"4570816",
"4570817",
"4570818",
"4570819",
"4570821",
"4570822",
"4570823",
"4570824",
"4570825",
"4570826",
"4570827",
"4570828",
"4570831",
"4570832",
"4570833",
"4570834",
"4570835",
"4570836",
"4570837",
"4570841",
"4570842",
"4570843",
"4570844",
"4570845",
"4570846",
"4570847",
"4570851",
"4570852",
"4570853",
"4570854",
"4570855",
"4570856",
"4570861",
"4570862",
"4570863",
"4570864",
"4570865",
"4570866",
"4580000",
"4580001",
"4580002",
"4580003",
"4580004",
"4580005",
"4580006",
"4580007",
"4580008",
"4580009",
"4580011",
"4580012",
"4580013",
"4580014",
"4580015",
"4580016",
"4580021",
"4580022",
"4580023",
"4580024",
"4580025",
"4580031",
"4580032",
"4580033",
"4580034",
"4580035",
"4580036",
"4580037",
"4580038",
"4580041",
"4580042",
"4580043",
"4580044",
"4580045",
"4580046",
"4580047",
"4580801",
"4580802",
"4580803",
"4580804",
"4580805",
"4580806",
"4580807",
"4580808",
"4580809",
"4580810",
"4580811",
"4580812",
"4580813",
"4580814",
"4580815",
"4580816",
"4580817",
"4580818",
"4580819",
"4580820",
"4580821",
"4580822",
"4580823",
"4580824",
"4580825",
"4580826",
"4580827",
"4580828",
"4580829",
"4580830",
"4580831",
"4580832",
"4580833",
"4580834",
"4580835",
"4580836",
"4580837",
"4580838",
"4580841",
"4580842",
"4580843",
"4580844",
"4580845",
"4580846",
"4580847",
"4580848",
"4580849",
"4580851",
"4580852",
"4580901",
"4580902",
"4580903",
"4580910",
"4580911",
"4580912",
"4580913",
"4580915",
"4580916",
"4580917",
"4580918",
"4580919",
"4580920",
"4580921",
"4580922",
"4580924",
"4580925",
"4580926",
"4580927",
"4580928",
"4580929",
"4598001",
"4598002",
"4598003",
"4598004",
"4598005",
"4598006",
"4598007",
"4598008",
"4598009",
"4598011",
"4598012",
"4598013",
"4598014",
"4598015",
"4598016",
"4598017",
"4600000",
"4600001",
"4600002",
"4600003",
"4600004",
"4600005",
"4600006",
"4600007",
"4600008",
"4600011",
"4600012",
"4600013",
"4600014",
"4600015",
"4600016",
"4600017",
"4600018",
"4600021",
"4600022",
"4600023",
"4600024",
"4600025",
"4600026",
"4600031",
"4600032",
"4610000",
"4610001",
"4610002",
"4610003",
"4610004",
"4610005",
"4610006",
"4610007",
"4610008",
"4610009",
"4610011",
"4610012",
"4610013",
"4610014",
"4610015",
"4610016",
"4610017",
"4610018",
"4610019",
"4610021",
"4610022",
"4610023",
"4610024",
"4610025",
"4610026",
"4610027",
"4610031",
"4610032",
"4610033",
"4610034",
"4610035",
"4610036",
"4610037",
"4610038",
"4610040",
"4610043",
"4610044",
"4610045",
"4610046",
"4610047",
"4610048",
"4610049",
"4620000",
"4620001",
"4620002",
"4620003",
"4620004",
"4620005",
"4620006",
"4620007",
"4620008",
"4620009",
"4620011",
"4620012",
"4620013",
"4620014",
"4620015",
"4620016",
"4620017",
"4620018",
"4620021",
"4620022",
"4620023",
"4620024",
"4620025",
"4620026",
"4620031",
"4620032",
"4620033",
"4620034",
"4620035",
"4620036",
"4620037",
"4620038",
"4620041",
"4620042",
"4620043",
"4620044",
"4620045",
"4620046",
"4620047",
"4620051",
"4620052",
"4620053",
"4620054",
"4620055",
"4620056",
"4620057",
"4620058",
"4620059",
"4620061",
"4620062",
"4620063",
"4620064",
"4620065",
"4620066",
"4620801",
"4620802",
"4620803",
"4620804",
"4620805",
"4620807",
"4620808",
"4620809",
"4620810",
"4620811",
"4620812",
"4620813",
"4620814",
"4620816",
"4620818",
"4620819",
"4620823",
"4620824",
"4620825",
"4620826",
"4620827",
"4620828",
"4620829",
"4620831",
"4620832",
"4620833",
"4620834",
"4620835",
"4620836",
"4620837",
"4620838",
"4620841",
"4620842",
"4620843",
"4620844",
"4620845",
"4620846",
"4620847",
"4620851",
"4620852",
"4620853",
"4620854",
"4620855",
"4620856",
"4620857",
"4620858",
"4620859",
"4620861",
"4620862",
"4620863",
"4620864",
"4620865",
"4620866",
"4620867",
"4620868",
"4620869",
"4630000",
"4630001",
"4630002",
"4630003",
"4630004",
"4630005",
"4630006",
"4630007",
"4630008",
"4630009",
"4630010",
"4630011",
"4630012",
"4630013",
"4630014",
"4630015",
"4630016",
"4630017",
"4630018",
"4630019",
"4630021",
"4630022",
"4630023",
"4630024",
"4630025",
"4630026",
"4630027",
"4630028",
"4630029",
"4630031",
"4630032",
"4630033",
"4630034",
"4630035",
"4630036",
"4630037",
"4630038",
"4630041",
"4630042",
"4630043",
"4630044",
"4630045",
"4630046",
"4630047",
"4630048",
"4630051",
"4630052",
"4630053",
"4630054",
"4630055",
"4630056",
"4630057",
"4630061",
"4630062",
"4630063",
"4630064",
"4630065",
"4630066",
"4630067",
"4630068",
"4630069",
"4630070",
"4630071",
"4630072",
"4630073",
"4630074",
"4630075",
"4630076",
"4630077",
"4630078",
"4630079",
"4630080",
"4630081",
"4630082",
"4630083",
"4630084",
"4630085",
"4630086",
"4630087",
"4630088",
"4630089",
"4630090",
"4630091",
"4630092",
"4630093",
"4630094",
"4630095",
"4630096",
"4630097",
"4630098",
"4630801",
"4630802",
"4630803",
"4630804",
"4630805",
"4630806",
"4630807",
"4630808",
"4630809",
"4630811",
"4630812",
"4630813",
"4630814",
"4630815",
"4640000",
"4640001",
"4640002",
"4640003",
"4640004",
"4640005",
"4640006",
"4640007",
"4640008",
"4640011",
"4640012",
"4640013",
"4640014",
"4640015",
"4640016",
"4640017",
"4640018",
"4640019",
"4640021",
"4640022",
"4640023",
"4640024",
"4640025",
"4640026",
"4640027",
"4640028",
"4640029",
"4640031",
"4640032",
"4640033",
"4640034",
"4640035",
"4640036",
"4640037",
"4640038",
"4640039",
"4640041",
"4640042",
"4640043",
"4640044",
"4640045",
"4640046",
"4640051",
"4640052",
"4640053",
"4640054",
"4640055",
"4640056",
"4640057",
"4640061",
"4640062",
"4640063",
"4640064",
"4640065",
"4640066",
"4640067",
"4640071",
"4640072",
"4640073",
"4640074",
"4640075",
"4640076",
"4640077",
"4640081",
"4640082",
"4640083",
"4640084",
"4640085",
"4640086",
"4640087",
"4640091",
"4640092",
"4640093",
"4640094",
"4640095",
"4640096",
"4640097",
"4640801",
"4640802",
"4640803",
"4640804",
"4640805",
"4640806",
"4640807",
"4640808",
"4640811",
"4640812",
"4640813",
"4640814",
"4640815",
"4640816",
"4640817",
"4640818",
"4640819",
"4640821",
"4640822",
"4640823",
"4640824",
"4640825",
"4640826",
"4640827",
"4640831",
"4640832",
"4640833",
"4640834",
"4640835",
"4640836",
"4640837",
"4640841",
"4640842",
"4640843",
"4640844",
"4640845",
"4640846",
"4640847",
"4640848",
"4640850",
"4640851",
"4640852",
"4640853",
"4640854",
"4640855",
"4640856",
"4640857",
"4640858",
"4640859",
"4640871",
"4650000",
"4650002",
"4650003",
"4650004",
"4650005",
"4650006",
"4650007",
"4650008",
"4650009",
"4650011",
"4650012",
"4650013",
"4650014",
"4650015",
"4650016",
"4650017",
"4650018",
"4650021",
"4650022",
"4650023",
"4650024",
"4650025",
"4650026",
"4650027",
"4650028",
"4650031",
"4650032",
"4650033",
"4650034",
"4650035",
"4650036",
"4650037",
"4650041",
"4650042",
"4650043",
"4650044",
"4650045",
"4650046",
"4650047",
"4650048",
"4650051",
"4650052",
"4650053",
"4650054",
"4650055",
"4650056",
"4650057",
"4650058",
"4650061",
"4650062",
"4650063",
"4650064",
"4650065",
"4650066",
"4650067",
"4650068",
"4650069",
"4650071",
"4650072",
"4650073",
"4650074",
"4650075",
"4650076",
"4650077",
"4650078",
"4650081",
"4650082",
"4650083",
"4650084",
"4650085",
"4650086",
"4650087",
"4650088",
"4650091",
"4650092",
"4650093",
"4650094",
"4650095",
"4650096",
"4650097",
"4660000",
"4660001",
"4660002",
"4660003",
"4660004",
"4660005",
"4660006",
"4660011",
"4660012",
"4660013",
"4660014",
"4660015",
"4660016",
"4660021",
"4660022",
"4660023",
"4660024",
"4660025",
"4660026",
"4660027",
"4660031",
"4660032",
"4660033",
"4660034",
"4660035",
"4660036",
"4660037",
"4660041",
"4660042",
"4660043",
"4660044",
"4660045",
"4660046",
"4660047",
"4660051",
"4660052",
"4660053",
"4660054",
"4660055",
"4660056",
"4660057",
"4660058",
"4660059",
"4660061",
"4660062",
"4660063",
"4660064",
"4660065",
"4660801",
"4660802",
"4660803",
"4660804",
"4660805",
"4660806",
"4660807",
"4660811",
"4660812",
"4660814",
"4660815",
"4660821",
"4660822",
"4660823",
"4660824",
"4660825",
"4660826",
"4660827",
"4660828",
"4660829",
"4660831",
"4660832",
"4660833",
"4660834",
"4660835",
"4660836",
"4660837",
"4660838",
"4660841",
"4660842",
"4660843",
"4660844",
"4660845",
"4660846",
"4660847",
"4660848",
"4660849",
"4660851",
"4660852",
"4660853",
"4660854",
"4660855",
"4660856",
"4660857",
"4660858",
"4670000",
"4670001",
"4670002",
"4670003",
"4670004",
"4670005",
"4670006",
"4670007",
"4670008",
"4670011",
"4670012",
"4670013",
"4670014",
"4670015",
"4670016",
"4670017",
"4670021",
"4670022",
"4670023",
"4670024",
"4670025",
"4670026",
"4670027",
"4670028",
"4670031",
"4670032",
"4670033",
"4670034",
"4670035",
"4670036",
"4670037",
"4670038",
"4670039",
"4670041",
"4670042",
"4670043",
"4670044",
"4670045",
"4670046",
"4670047",
"4670048",
"4670049",
"4670051",
"4670052",
"4670053",
"4670054",
"4670055",
"4670056",
"4670057",
"4670058",
"4670059",
"4670061",
"4670062",
"4670063",
"4670064",
"4670065",
"4670066",
"4670067",
"4670068",
"4670801",
"4670802",
"4670803",
"4670804",
"4670805",
"4670806",
"4670807",
"4670808",
"4670811",
"4670812",
"4670813",
"4670814",
"4670815",
"4670816",
"4670821",
"4670822",
"4670823",
"4670824",
"4670825",
"4670826",
"4670827",
"4670828",
"4670831",
"4670832",
"4670833",
"4670834",
"4670835",
"4670836",
"4670837",
"4670841",
"4670842",
"4670843",
"4670844",
"4670845",
"4670846",
"4670847",
"4670851",
"4670852",
"4670853",
"4670854",
"4670855",
"4670856",
"4670861",
"4670862",
"4670863",
"4670864",
"4670865",
"4670866",
"4670867",
"4670868",
"4670871",
"4670872",
"4670873",
"4670874",
"4670875",
"4670876",
"4670877",
"4670878",
"4670879",
"4680000",
"4680001",
"4680002",
"4680003",
"4680004",
"4680005",
"4680006",
"4680007",
"4680008",
"4680009",
"4680011",
"4680012",
"4680013",
"4680014",
"4680015",
"4680020",
"4680021",
"4680022",
"4680023",
"4680024",
"4680025",
"4680026",
"4680027",
"4680028",
"4680029",
"4680030",
"4680031",
"4680032",
"4680033",
"4680034",
"4680035",
"4680037",
"4680038",
"4680039",
"4680041",
"4680042",
"4680043",
"4680044",
"4680045",
"4680046",
"4680047",
"4680048",
"4680049",
"4680051",
"4680052",
"4680053",
"4680054",
"4680055",
"4680056",
"4680058",
"4680061",
"4680062",
"4680063",
"4680064",
"4680065",
"4680066",
"4680067",
"4680068",
"4680069",
"4680071",
"4680072",
"4680073",
"4680074",
"4680075",
"4680076",
"4680077",
"4680836"
],
"areacode": [
"052",
"52"
],
"query": "4580039",
"type": "postcode"
}
Query types
The API detects what you are looking for: input in the postal code format of the country is searched as a postal code first, other digits as an area code, everything else as a place name. If there is no match, the other types are checked. Use the type parameter to set the type yourself.
| Example | Type | Meaning |
|---|---|---|
https://www.postleitzahl.net/api/de/32423orhttps://www.postleitzahl.net/api?country=de&q=32423 | postcode | postal code |
https://www.postleitzahl.net/api/de/0571orhttps://www.postleitzahl.net/api?country=de&q=0571 | prefix | telephone area code |
https://www.postleitzahl.net/api/de/Mindenorhttps://www.postleitzahl.net/api?country=de&q=Minden | place | place name |
Parameters
| Parameter | Effect |
|---|---|
country | Required: the two-letter country code, e.g. de, nl or gb – in the path (/api/de/32423) or as a parameter (country=de) |
fields | comma separated list of the desired fields, e.g. ?fields=place,postcode |
type | sets the query type: postcode, prefix or place |
lang | language of the translatable fields, e.g. ?lang=en |
callback | JSONP function name |
q | the search term as a parameter instead of in the path: /api?country=de&q=Minden |
Localization
Use the lang parameter to choose the language of the response. The country name is translated; place names stay in their original form. Without lang, the Accept-Language header of your request applies; unknown values are ignored.
de ar be bg bs ca cs da el en es et fa fi fr ga he hi hr hu hy id is it ja ka km ko lo lt lv mk mn ms mt ne nl no pl pt ro ru sk sl sq sr sv th tr uk vi zh
curl "https://www.postleitzahl.net/api/de/32423?lang=en"
{ "status": "success", "country": "Germany", "countryCode": "DE", "place": "Minden", "postcode": "32423", "query": "32423", "type": "postcode" }
Response fields
| Field | Content | Example |
|---|---|---|
status | success or fail | "success" |
query | the submitted query | "0010000" |
type | detected query type: postcode, prefix or place | "postcode" |
country | country, translatable via lang | "Germany" |
countryCode | country code per ISO 3166-1 | "JP" |
place | place name, a list if there are several | "Minden" |
postcode | postal code of the place, a list if there are several | ["32423","32425","32427","32429"] |
areacode | telephone area code of the place, a list if there are several | "0571" |
message | only with status fail: reason | "not found" |
Usage limit
With an API key you can send 20 requests per minute. Every response shows in its headers how many requests are left in the current minute (X-Rl) and in how many seconds the next minute starts (X-Ttl).
{
"status": "fail",
"code": 1008,
"message": "rate limit exceeded, 20 requests per minute",
"query": "0010000"
}
Error responses
| HTTP | Code | message | Cause |
|---|---|---|---|
| 401 | 1001 | missing api token | no API key sent |
| 401 | 1002 | invalid api token | API key unknown or invalid |
| 400 | 1003 | missing or unknown country | The country code is missing or unknown. |
| 400 | 1004 | missing query | no query supplied |
| 400 | 1005 | query too long | more than 80 characters |
| 404 | 1006 | not found | no match |
| 429 | 1007 | try-out limit exceeded, 10 requests per 5 minutes without api token | Try-out limit reached |
| 429 | 1008 | rate limit exceeded, 20 requests per minute | Request limit reached – available again from the next minute |
| 429 | 1009 | try-out banned for 60 minutes, limit exceeded repeatedly | limit exceeded repeatedly |
Examples
curl -H "X-Api-Token: plz_…" https://www.postleitzahl.net/api/jp/0010000 curl -H "X-Api-Token: plz_…" "https://www.postleitzahl.net/api/gb/SW1A%201AA" curl -H "X-Api-Token: plz_…" "https://www.postleitzahl.net/api/de/Minden?fields=place,postcode" curl "https://www.postleitzahl.net/api?country=de&q=0571&type=prefix&token=plz_…"
Data sources
Municipality keys, NUTS codes and population figures come from the municipality register and the NUTS classification of Eurostat. The assignment of postal codes to regions follows the official TERCET table of the European Commission.
