API for postal codes, area codes and places
The postleitzahl.net JSON API returns the matching place, the country and all linked postal codes and area codes for postal codes, area codes or place names.
Authentication
An API key is required for every request. Pass it either in the X-Api-Token header, as Authorization: Bearer <TOKEN> or as the query parameter token.
Endpoint
You can pass the country and the search term in the path or as parameters. Both notations return the same response in JSON format.
https://www.postleitzahl.net/api/{country}/{query}
https://www.postleitzahl.net/api?country={country}&q={query}
Try it
Here you can try out the API without an API key. An API key is required for requests from your own application.
{
"status": "success",
"country": "Poland",
"countryCode": "PL",
"place": "Warszawa",
"postcode": [
"05075",
"00002",
"00003",
"00004",
"00005",
"00006",
"00007",
"00008",
"00009",
"00010",
"00011",
"00012",
"00013",
"00014",
"00015",
"00017",
"00018",
"00019",
"00020",
"00021",
"00022",
"00023",
"00024",
"00025",
"00026",
"00027",
"00028",
"00029",
"00030",
"00031",
"00032",
"00033",
"00034",
"00036",
"00038",
"00039",
"00040",
"00041",
"00042",
"00043",
"00044",
"00046",
"00047",
"00048",
"00049",
"00050",
"00051",
"00052",
"00054",
"00055",
"00056",
"00057",
"00058",
"00060",
"00061",
"00062",
"00063",
"00064",
"00065",
"00066",
"00067",
"00068",
"00070",
"00071",
"00072",
"00073",
"00074",
"00075",
"00076",
"00077",
"00078",
"00079",
"00080",
"00082",
"00084",
"00085",
"00086",
"00087",
"00088",
"00089",
"00090",
"00092",
"00093",
"00094",
"00095",
"00097",
"00098",
"00099",
"00100",
"00102",
"00103",
"00104",
"00105",
"00107",
"00108",
"00109",
"00110",
"00112",
"00113",
"00114",
"00115",
"00116",
"00118",
"00120",
"00121",
"00123",
"00124",
"00125",
"00127",
"00130",
"00131",
"00132",
"00133",
"00136",
"00137",
"00138",
"00139",
"00140",
"00141",
"00142",
"00143",
"00144",
"00145",
"00146",
"00147",
"00148",
"00149",
"00150",
"00151",
"00152",
"00153",
"00154",
"00155",
"00157",
"00158",
"00159",
"00160",
"00161",
"00162",
"00163",
"00164",
"00165",
"00167",
"00168",
"00169",
"00170",
"00172",
"00173",
"00174",
"00175",
"00176",
"00178",
"00179",
"00180",
"00181",
"00182",
"00183",
"00184",
"00185",
"00187",
"00188",
"00189",
"00190",
"00193",
"00194",
"00195",
"00196",
"00197",
"00199",
"00201",
"00202",
"00203",
"00204",
"00205",
"00206",
"00207",
"00208",
"00209",
"00210",
"00211",
"00213",
"00214",
"00215",
"00216",
"00217",
"00218",
"00219",
"00220",
"00221",
"00222",
"00223",
"00224",
"00225",
"00227",
"00228",
"00229",
"00230",
"00231",
"00232",
"00233",
"00234",
"00235",
"00236",
"00238",
"00240",
"00241",
"00242",
"00245",
"00246",
"00248",
"00249",
"00251",
"00252",
"00254",
"00255",
"00256",
"00257",
"00258",
"00259",
"00260",
"00261",
"00263",
"00264",
"00265",
"00266",
"00267",
"00268",
"00270",
"00271",
"00272",
"00277",
"00278",
"00279",
"00281",
"00285",
"00286",
"00287",
"00288",
"00301",
"00302",
"00303",
"00304",
"00305",
"00306",
"00307",
"00310",
"00311",
"00312",
"00314",
"00315",
"00316",
"00317",
"00318",
"00321",
"00322",
"00324",
"00325",
"00327",
"00328",
"00330",
"00331",
"00332",
"00333",
"00335",
"00336",
"00337",
"00338",
"00339",
"00340",
"00341",
"00342",
"00344",
"00345",
"00347",
"00348",
"00349",
"00350",
"00351",
"00353",
"00354",
"00355",
"00357",
"00358",
"00359",
"00360",
"00362",
"00363",
"00364",
"00366",
"00367",
"00368",
"00370",
"00372",
"00373",
"00374",
"00375",
"00377",
"00378",
"00379",
"00380",
"00381",
"00382",
"00384",
"00385",
"00386",
"00388",
"00389",
"00390",
"00391",
"00392",
"00393",
"00394",
"00401",
"00402",
"00403",
"00405",
"00406",
"00407",
"00409",
"00410",
"00411",
"00412",
"00413",
"00414",
"00415",
"00416",
"00418",
"00419",
"00420",
"00421",
"00422",
"00423",
"00424",
"00427",
"00428",
"00429",
"00430",
"00432",
"00433",
"00434",
"00435",
"00436",
"00438",
"00439",
"00440",
"00441",
"00442",
"00443",
"00444",
"00446",
"00447",
"00448",
"00449",
"00450",
"00451",
"00452",
"00453",
"00454",
"00457",
"00458",
"00459",
"00460",
"00461",
"00463",
"00464",
"00465",
"00466",
"00467",
"00468",
"00477",
"00478",
"00479",
"00480",
"00481",
"00482",
"00483",
"00484",
"00485",
"00486",
"00487",
"00488",
"00489",
"00490",
"00491",
"00492",
"00493",
"00495",
"00496",
"00497",
"00498",
"00499",
"00501",
"00502",
"00503",
"00505",
"00507",
"00508",
"00509",
"00510",
"00511",
"00512",
"00513",
"00514",
"00515",
"00516",
"00517",
"00519",
"00521",
"00522",
"00524",
"00525",
"00526",
"00528",
"00529",
"00530",
"00532",
"00533",
"00534",
"00535",
"00536",
"00537",
"00538",
"00539",
"00540",
"00542",
"00543",
"00544",
"00545",
"00546",
"00547",
"00548",
"00549",
"00550",
"00551",
"00552",
"00553",
"00554",
"00555",
"00556",
"00557",
"00558",
"00559",
"00560",
"00561",
"00562",
"00564",
"00565",
"00566",
"00567",
"00568",
"00569",
"00570",
"00571",
"00572",
"00573",
"00574",
"00575",
"00576",
"00578",
"00580",
"00581",
"00582",
"00583",
"00584",
"00585",
"00586",
"00588",
"00589",
"00590",
"00591",
"00592",
"00594",
"00608",
"00609",
"00610",
"00611",
"00613",
"00614",
"00620",
"00621",
"00622",
"00623",
"00624",
"00625",
"00626",
"00628",
"00629",
"00630",
"00631",
"00633",
"00634",
"00635",
"00637",
"00638",
"00639",
"00640",
"00641",
"00642",
"00643",
"00644",
"00645",
"00647",
"00648",
"00649",
"00650",
"00651",
"00653",
"00654",
"00655",
"00656",
"00657",
"00658",
"00659",
"00660",
"00661",
"00662",
"00663",
"00664",
"00665",
"00666",
"00667",
"00668",
"00669",
"00670",
"00671",
"00672",
"00673",
"00675",
"00676",
"00677",
"00678",
"00679",
"00680",
"00681",
"00682",
"00683",
"00684",
"00685",
"00686",
"00687",
"00688",
"00689",
"00691",
"00692",
"00693",
"00695",
"00696",
"00697",
"00698",
"00701",
"00702",
"00703",
"00704",
"00705",
"00706",
"00707",
"00708",
"00709",
"00710",
"00711",
"00712",
"00713",
"00714",
"00715",
"00716",
"00717",
"00718",
"00719",
"00720",
"00721",
"00722",
"00724",
"00725",
"00727",
"00728",
"00730",
"00731",
"00732",
"00733",
"00734",
"00735",
"00736",
"00737",
"00738",
"00739",
"00740",
"00742",
"00743",
"00745",
"00746",
"00748",
"00749",
"00752",
"00753",
"00754",
"00758",
"00759",
"00761",
"00762",
"00763",
"00764",
"00765",
"00766",
"00767",
"00768",
"00769",
"00770",
"00771",
"00772",
"00773",
"00774",
"00775",
"00777",
"00778",
"00780",
"00781",
"00783",
"00784",
"00785",
"00788",
"00789",
"00790",
"00791",
"00792",
"00793",
"00795",
"00801",
"00802",
"00803",
"00805",
"00806",
"00807",
"00808",
"00809",
"00810",
"00811",
"00814",
"00815",
"00817",
"00818",
"00819",
"00820",
"00821",
"00823",
"00825",
"00826",
"00827",
"00828",
"00830",
"00831",
"00832",
"00833",
"00834",
"00835",
"00836",
"00837",
"00838",
"00839",
"00841",
"00842",
"00843",
"00844",
"00845",
"00846",
"00849",
"00850",
"00851",
"00852",
"00853",
"00854",
"00855",
"00863",
"00864",
"00865",
"00866",
"00867",
"00869",
"00870",
"00871",
"00872",
"00873",
"00874",
"00875",
"00876",
"00877",
"00878",
"00879",
"00891",
"00892",
"00893",
"00894",
"00895",
"00896",
"00897",
"00898",
"00899",
"01001",
"01002",
"01003",
"01004",
"01005",
"01006",
"01008",
"01009",
"01010",
"01011",
"01012",
"01013",
"01014",
"01015",
"01016",
"01017",
"01018",
"01019",
"01022",
"01023",
"01024",
"01026",
"01027",
"01029",
"01030",
"01031",
"01032",
"01033",
"01034",
"01036",
"01037",
"01038",
"01040",
"01041",
"01042",
"01043",
"01044",
"01045",
"01046",
"01047",
"01048",
"01049",
"01050",
"01051",
"01052",
"01054",
"01056",
"01057",
"01058",
"01059",
"01060",
"01063",
"01064",
"01065",
"01066",
"01067",
"01068",
"01100",
"01101",
"01102",
"01103",
"01104",
"01105",
"01106",
"01107",
"01108",
"01109",
"01110",
"01111",
"01112",
"01113",
"01114",
"01115",
"01116",
"01117",
"01118",
"01119",
"01120",
"01121",
"01122",
"01123",
"01126",
"01128",
"01129",
"01130",
"01131",
"01132",
"01134",
"01136",
"01137",
"01138",
"01139",
"01140",
"01141",
"01142",
"01143",
"01144",
"01145",
"01146",
"01147",
"01148",
"01149",
"01150",
"01151",
"01152",
"01153",
"01154",
"01155",
"01156",
"01157",
"01158",
"01159",
"01160",
"01161",
"01162",
"01163",
"01164",
"01165",
"01167",
"01168",
"01170",
"01171",
"01172",
"01173",
"01174",
"01175",
"01176",
"01177",
"01178",
"01179",
"01180",
"01181",
"01182",
"01183",
"01184",
"01186",
"01187",
"01188",
"01189",
"01190",
"01191",
"01192",
"01193",
"01194",
"01195",
"01197",
"01198",
"01199",
"01201",
"01202",
"01203",
"01204",
"01205",
"01206",
"01207",
"01208",
"01209",
"01210",
"01211",
"01212",
"01213",
"01214",
"01216",
"01217",
"01218",
"01219",
"01220",
"01221",
"01222",
"01224",
"01225",
"01226",
"01227",
"01228",
"01229",
"01230",
"01231",
"01232",
"01233",
"01234",
"01235",
"01236",
"01237",
"01239",
"01240",
"01241",
"01242",
"01244",
"01246",
"01247",
"01248",
"01249",
"01250",
"01251",
"01252",
"01253",
"01254",
"01255",
"01258",
"01259",
"01262",
"01266",
"01267",
"01301",
"01302",
"01303",
"01304",
"01305",
"01307",
"01308",
"01309",
"01310",
"01312",
"01313",
"01314",
"01315",
"01317",
"01318",
"01319",
"01320",
"01321",
"01327",
"01328",
"01329",
"01330",
"01336",
"01337",
"01338",
"01339",
"01340",
"01341",
"01342",
"01343",
"01345",
"01346",
"01347",
"01348",
"01349",
"01350",
"01351",
"01352",
"01353",
"01354",
"01355",
"01356",
"01357",
"01359",
"01360",
"01361",
"01362",
"01364",
"01365",
"01366",
"01367",
"01368",
"01373",
"01376",
"01377",
"01378",
"01381",
"01382",
"01383",
"01384",
"01385",
"01386",
"01388",
"01389",
"01390",
"01391",
"01401",
"01402",
"01405",
"01406",
"01407",
"01408",
"01409",
"01410",
"01413",
"01416",
"01417",
"01418",
"01419",
"01420",
"01422",
"01423",
"01424",
"01425",
"01426",
"01428",
"01431",
"01432",
"01433",
"01434",
"01436",
"01437",
"01438",
"01439",
"01441",
"01442",
"01443",
"01444",
"01445",
"01446",
"01447",
"01448",
"01449",
"01450",
"01451",
"01452",
"01456",
"01457",
"01458",
"01459",
"01460",
"01461",
"01462",
"01464",
"01466",
"01468",
"01469",
"01470",
"01471",
"01472",
"01473",
"01474",
"01475",
"01476",
"01478",
"01479",
"01480",
"01481",
"01482",
"01483",
"01485",
"01486",
"01487",
"01488",
"01490",
"01491",
"01492",
"01493",
"01494",
"01495",
"01496",
"01497",
"01498",
"01501",
"01502",
"01503",
"01504",
"01505",
"01506",
"01507",
"01508",
"01510",
"01511",
"01512",
"01513",
"01514",
"01515",
"01517",
"01518",
"01519",
"01520",
"01521",
"01522",
"01523",
"01524",
"01526",
"01527",
"01528",
"01529",
"01530",
"01531",
"01532",
"01540",
"01541",
"01542",
"01548",
"01549",
"01551",
"01552",
"01553",
"01554",
"01555",
"01556",
"01557",
"01558",
"01560",
"01562",
"01563",
"01564",
"01565",
"01566",
"01567",
"01568",
"01569",
"01570",
"01571",
"01572",
"01573",
"01574",
"01576",
"01577",
"01578",
"01580",
"01581",
"01582",
"01584",
"01585",
"01586",
"01588",
"01589",
"01590",
"01592",
"01593",
"01595",
"01601",
"01602",
"01603",
"01604",
"01605",
"01606",
"01607",
"01608",
"01609",
"01610",
"01611",
"01612",
"01613",
"01614",
"01615",
"01616",
"01617",
"01618",
"01619",
"01620",
"01621",
"01622",
"01623",
"01624",
"01625",
"01626",
"01627",
"01629",
"01630",
"01631",
"01632",
"01633",
"01634",
"01635",
"01636",
"01637",
"01638",
"01639",
"01640",
"01641",
"01643",
"01644",
"01645",
"01646",
"01647",
"01648",
"01649",
"01650",
"01651",
"01652",
"01654",
"01656",
"01658",
"01670",
"01673",
"01674",
"01678",
"01680",
"01681",
"01682",
"01683",
"01684",
"01685",
"01687",
"01688",
"01689",
"01690",
"01691",
"01692",
"01693",
"01694",
"01695",
"01696",
"01697",
"01698",
"01699",
"01702",
"01703",
"01707",
"01708",
"01710",
"01711",
"01716",
"01728",
"01735",
"01736",
"01737",
"01738",
"01739",
"01740",
"01742",
"01743",
"01745",
"01747",
"01748",
"01755",
"01756",
"01769",
"01770",
"01771",
"01772",
"01773",
"01779",
"01780",
"01783",
"01784",
"01785",
"01786",
"01793",
"01794",
"01796",
"01797",
"01798",
"01801",
"01802",
"01803",
"01804",
"01805",
"01806",
"01807",
"01808",
"01809",
"01810",
"01811",
"01812",
"01813",
"01815",
"01817",
"01818",
"01819",
"01820",
"01821",
"01822",
"01823",
"01824",
"01825",
"01826",
"01827",
"01828",
"01829",
"01830",
"01831",
"01832",
"01833",
"01834",
"01835",
"01836",
"01838",
"01839",
"01840",
"01842",
"01843",
"01844",
"01845",
"01846",
"01848",
"01849",
"01850",
"01851",
"01852",
"01853",
"01854",
"01855",
"01856",
"01858",
"01859",
"01860",
"01861",
"01862",
"01863",
"01864",
"01865",
"01866",
"01867",
"01868",
"01869",
"01870",
"01871",
"01872",
"01873",
"01874",
"01875",
"01876",
"01877",
"01882",
"01883",
"01884",
"01885",
"01886",
"01887",
"01891",
"01892",
"01893",
"01903",
"01904",
"01905",
"01908",
"01909",
"01910",
"01911",
"01912",
"01913",
"01914",
"01915",
"01917",
"01918",
"01920",
"01921",
"01922",
"01923",
"01924",
"01925",
"01926",
"01927",
"01928",
"01929",
"01930",
"01931",
"01934",
"01943",
"01944",
"01946",
"01947",
"01948",
"01949",
"01950",
"01951",
"01952",
"01954",
"01956",
"01957",
"01958",
"01960",
"01961",
"01962",
"01963",
"01964",
"01966",
"01969",
"01971",
"01977",
"01991",
"01992",
"02001",
"02002",
"02004",
"02005",
"02006",
"02007",
"02008",
"02009",
"02010",
"02011",
"02012",
"02013",
"02014",
"02015",
"02017",
"02018",
"02019",
"02020",
"02021",
"02022",
"02023",
"02024",
"02025",
"02026",
"02027",
"02028",
"02029",
"02030",
"02031",
"02032",
"02033",
"02034",
"02036",
"02038",
"02041",
"02042",
"02044",
"02047",
"02049",
"02051",
"02052",
"02053",
"02054",
"02055",
"02056",
"02057",
"02061",
"02062",
"02063",
"02065",
"02066",
"02067",
"02068",
"02069",
"02070",
"02071",
"02072",
"02073",
"02074",
"02075",
"02078",
"02081",
"02082",
"02084",
"02085",
"02086",
"02087",
"02089",
"02090",
"02091",
"02092",
"02093",
"02094",
"02095",
"02096",
"02097",
"02098",
"02101",
"02103",
"02104",
"02106",
"02107",
"02109",
"02110",
"02111",
"02112",
"02114",
"02115",
"02116",
"02117",
"02118",
"02119",
"02120",
"02121",
"02122",
"02123",
"02124",
"02127",
"02128",
"02129",
"02130",
"02131",
"02132",
"02133",
"02134",
"02135",
"02136",
"02137",
"02139",
"02141",
"02142",
"02143",
"02145",
"02146",
"02147",
"02148",
"02149",
"02150",
"02151",
"02152",
"02153",
"02154",
"02155",
"02156",
"02157",
"02158",
"02159",
"02164",
"02165",
"02168",
"02169",
"02170",
"02172",
"02173",
"02174",
"02175",
"02178",
"02179",
"02180",
"02181",
"02182",
"02183",
"02186",
"02188",
"02189",
"02191",
"02194",
"02195",
"02196",
"02197",
"02198",
"02201",
"02202",
"02203",
"02204",
"02205",
"02206",
"02207",
"02209",
"02210",
"02211",
"02213",
"02214",
"02215",
"02216",
"02217",
"02219",
"02220",
"02221",
"02222",
"02223",
"02224",
"02225",
"02226",
"02227",
"02228",
"02229",
"02230",
"02231",
"02232",
"02233",
"02234",
"02235",
"02236",
"02237",
"02238",
"02239",
"02240",
"02241",
"02242",
"02244",
"02246",
"02247",
"02248",
"02249",
"02250",
"02252",
"02254",
"02255",
"02256",
"02257",
"02258",
"02259",
"02260",
"02261",
"02262",
"02263",
"02264",
"02265",
"02266",
"02267",
"02269",
"02270",
"02271",
"02272",
"02273",
"02274",
"02276",
"02277",
"02278",
"02279",
"02280",
"02281",
"02282",
"02283",
"02284",
"02285",
"02286",
"02287",
"02288",
"02290",
"02292",
"02293",
"02294",
"02295",
"02296",
"02298",
"02299",
"02301",
"02302",
"02304",
"02305",
"02306",
"02308",
"02309",
"02310",
"02312",
"02313",
"02314",
"02315",
"02316",
"02317",
"02318",
"02319",
"02320",
"02321",
"02323",
"02324",
"02325",
"02326",
"02327",
"02335",
"02336",
"02337",
"02338",
"02339",
"02340",
"02341",
"02342",
"02343",
"02344",
"02345",
"02347",
"02348",
"02349",
"02350",
"02351",
"02352",
"02353",
"02354",
"02359",
"02360",
"02361",
"02362",
"02364",
"02365",
"02366",
"02367",
"02368",
"02369",
"02370",
"02371",
"02372",
"02373",
"02374",
"02375",
"02376",
"02377",
"02378",
"02379",
"02380",
"02381",
"02382",
"02383",
"02384",
"02386",
"02387",
"02388",
"02389",
"02390",
"02391",
"02392",
"02393",
"02394",
"02395",
"02396",
"02397",
"02398",
"02400",
"02401",
"02402",
"02403",
"02404",
"02405",
"02406",
"02407",
"02408",
"02409",
"02410",
"02411",
"02412",
"02413",
"02414",
"02415",
"02416",
"02417",
"02419",
"02421",
"02422",
"02423",
"02424",
"02425",
"02426",
"02427",
"02428",
"02430",
"02431",
"02432",
"02433",
"02434",
"02435",
"02436",
"02437",
"02438",
"02439",
"02440",
"02441",
"02442",
"02443",
"02445",
"02446",
"02447",
"02448",
"02449",
"02450",
"02451",
"02452",
"02453",
"02454",
"02455",
"02456",
"02457",
"02458",
"02459",
"02460",
"02462",
"02463",
"02464",
"02465",
"02466",
"02467",
"02468",
"02469",
"02470",
"02471",
"02472",
"02473",
"02479",
"02480",
"02481",
"02482",
"02483",
"02484",
"02485",
"02486",
"02487",
"02488",
"02489",
"02490",
"02491",
"02492",
"02493",
"02494",
"02495",
"02497",
"02501",
"02502",
"02503",
"02504",
"02505",
"02506",
"02507",
"02508",
"02509",
"02510",
"02511",
"02512",
"02513",
"02515",
"02516",
"02517",
"02518",
"02519",
"02520",
"02521",
"02522",
"02524",
"02525",
"02526",
"02527",
"02528",
"02529",
"02530",
"02531",
"02532",
"02534",
"02535",
"02536",
"02537",
"02538",
"02539",
"02540",
"02541",
"02543",
"02544",
"02545",
"02546",
"02547",
"02548",
"02549",
"02550",
"02551",
"02552",
"02553",
"02554",
"02555",
"02556",
"02557",
"02558",
"02559",
"02560",
"02561",
"02562",
"02563",
"02564",
"02566",
"02567",
"02568",
"02569",
"02570",
"02571",
"02572",
"02574",
"02575",
"02577",
"02578",
"02579",
"02581",
"02582",
"02583",
"02584",
"02585",
"02586",
"02587",
"02589",
"02590",
"02591",
"02592",
"02593",
"02594",
"02595",
"02598",
"02601",
"02602",
"02603",
"02604",
"02605",
"02606",
"02607",
"02608",
"02609",
"02610",
"02611",
"02612",
"02613",
"02614",
"02615",
"02616",
"02617",
"02618",
"02619",
"02620",
"02621",
"02622",
"02624",
"02625",
"02626",
"02627",
"02628",
"02629",
"02630",
"02632",
"02633",
"02634",
"02635",
"02636",
"02637",
"02638",
"02639",
"02640",
"02641",
"02642",
"02643",
"02644",
"02645",
"02646",
"02647",
"02648",
"02649",
"02650",
"02651",
"02652",
"02653",
"02654",
"02655",
"02656",
"02657",
"02658",
"02659",
"02660",
"02661",
"02662",
"02663",
"02665",
"02666",
"02668",
"02670",
"02672",
"02673",
"02674",
"02675",
"02676",
"02677",
"02678",
"02679",
"02680",
"02681",
"02682",
"02683",
"02684",
"02685",
"02690",
"02691",
"02692",
"02693",
"02695",
"02697",
"02698",
"02699",
"02701",
"02702",
"02703",
"02704",
"02705",
"02707",
"02708",
"02709",
"02710",
"02711",
"02712",
"02713",
"02714",
"02715",
"02716",
"02717",
"02718",
"02720",
"02722",
"02724",
"02725",
"02726",
"02727",
"02728",
"02729",
"02730",
"02732",
"02733",
"02735",
"02736",
"02737",
"02738",
"02739",
"02740",
"02743",
"02744",
"02746",
"02747",
"02748",
"02749",
"02750",
"02751",
"02755",
"02757",
"02758",
"02759",
"02760",
"02761",
"02762",
"02763",
"02764",
"02765",
"02767",
"02768",
"02769",
"02775",
"02776",
"02777",
"02778",
"02780",
"02781",
"02784",
"02785",
"02786",
"02787",
"02790",
"02797",
"02801",
"02803",
"02804",
"02806",
"02807",
"02808",
"02809",
"02811",
"02812",
"02819",
"02820",
"02822",
"02823",
"02824",
"02825",
"02826",
"02827",
"02828",
"02829",
"02849",
"02851",
"02852",
"02854",
"02900",
"02901",
"02902",
"02903",
"02904",
"02905",
"02907",
"02908",
"02909",
"02910",
"02911",
"02912",
"02913",
"02914",
"02915",
"02916",
"02917",
"02918",
"02920",
"02921",
"02922",
"02923",
"02924",
"02925",
"02927",
"02928",
"02929",
"02930",
"02932",
"02933",
"02934",
"02935",
"02936",
"02937",
"02938",
"02939",
"02940",
"02941",
"02942",
"02943",
"02945",
"02946",
"02947",
"02948",
"02949",
"02950",
"02951",
"02952",
"02953",
"02954",
"02955",
"02956",
"02957",
"02958",
"02959",
"02960",
"02963",
"02964",
"02965",
"02967",
"02972",
"02977",
"02978",
"02979",
"02981",
"02982",
"02983",
"02984",
"02985",
"02987",
"02988",
"02989",
"02990",
"02999",
"03031",
"03041",
"03042",
"03174",
"03183",
"03184",
"03185",
"03186",
"03190",
"03191",
"03192",
"03193",
"03194",
"03195",
"03196",
"03197",
"03198",
"03199",
"03202",
"03203",
"03204",
"03206",
"03208",
"03209",
"03214",
"03215",
"03216",
"03219",
"03226",
"03228",
"03230",
"03231",
"03233",
"03236",
"03237",
"03238",
"03241",
"03242",
"03243",
"03244",
"03246",
"03251",
"03252",
"03254",
"03257",
"03259",
"03260",
"03262",
"03264",
"03265",
"03266",
"03272",
"03274",
"03276",
"03279",
"03284",
"03285",
"03286",
"03288",
"03291",
"03294",
"03301",
"03302",
"03303",
"03305",
"03307",
"03308",
"03309",
"03310",
"03315",
"03316",
"03317",
"03318",
"03320",
"03321",
"03322",
"03324",
"03325",
"03329",
"03331",
"03332",
"03334",
"03335",
"03337",
"03338",
"03340",
"03341",
"03343",
"03345",
"03349",
"03350",
"03352",
"03353",
"03357",
"03358",
"03360",
"03361",
"03362",
"03363",
"03365",
"03368",
"03369",
"03371",
"03374",
"03376",
"03377",
"03379",
"03380",
"03381",
"03382",
"03383",
"03385",
"03388",
"03390",
"03391",
"03392",
"03395",
"03397",
"03401",
"03402",
"03403",
"03406",
"03407",
"03408",
"03409",
"03410",
"03411",
"03412",
"03414",
"03416",
"03417",
"03418",
"03419",
"03420",
"03422",
"03423",
"03424",
"03425",
"03426",
"03427",
"03428",
"03429",
"03430",
"03431",
"03432",
"03433",
"03435",
"03436",
"03438",
"03439",
"03441",
"03442",
"03443",
"03444",
"03445",
"03446",
"03447",
"03448",
"03450",
"03451",
"03452",
"03454",
"03455",
"03456",
"03458",
"03459",
"03461",
"03462",
"03463",
"03464",
"03465",
"03468",
"03469",
"03470",
"03471",
"03472",
"03473",
"03474",
"03475",
"03476",
"03477",
"03480",
"03481",
"03482",
"03484",
"03485",
"03486",
"03488",
"03489",
"03490",
"03501",
"03502",
"03503",
"03504",
"03505",
"03506",
"03507",
"03509",
"03510",
"03511",
"03512",
"03514",
"03516",
"03517",
"03521",
"03522",
"03523",
"03524",
"03526",
"03528",
"03530",
"03531",
"03532",
"03533",
"03534",
"03535",
"03536",
"03538",
"03542",
"03543",
"03545",
"03547",
"03548",
"03549",
"03550",
"03551",
"03552",
"03553",
"03554",
"03556",
"03558",
"03560",
"03561",
"03562",
"03563",
"03565",
"03566",
"03567",
"03569",
"03571",
"03574",
"03575",
"03576",
"03578",
"03579",
"03580",
"03581",
"03582",
"03583",
"03584",
"03585",
"03586",
"03587",
"03588",
"03589",
"03590",
"03592",
"03593",
"03594",
"03595",
"03596",
"03597",
"03599",
"03601",
"03602",
"03603",
"03604",
"03605",
"03606",
"03607",
"03608",
"03609",
"03610",
"03611",
"03612",
"03613",
"03614",
"03616",
"03617",
"03618",
"03619",
"03620",
"03621",
"03622",
"03623",
"03624",
"03625",
"03626",
"03627",
"03628",
"03629",
"03630",
"03631",
"03632",
"03633",
"03634",
"03636",
"03637",
"03638",
"03639",
"03640",
"03641",
"03642",
"03643",
"03644",
"03645",
"03646",
"03647",
"03648",
"03649",
"03650",
"03652",
"03653",
"03654",
"03655",
"03656",
"03657",
"03658",
"03659",
"03660",
"03661",
"03662",
"03663",
"03664",
"03665",
"03666",
"03667",
"03668",
"03671",
"03672",
"03673",
"03674",
"03675",
"03676",
"03677",
"03678",
"03679",
"03680",
"03681",
"03682",
"03683",
"03684",
"03685",
"03686",
"03687",
"03689",
"03690",
"03691",
"03692",
"03693",
"03694",
"03695",
"03696",
"03697",
"03698",
"03699",
"03703",
"03704",
"03705",
"03707",
"03708",
"03709",
"03710",
"03711",
"03712",
"03713",
"03714",
"03715",
"03716",
"03717",
"03718",
"03719",
"03720",
"03721",
"03722",
"03724",
"03727",
"03728",
"03729",
"03730",
"03731",
"03732",
"03733",
"03734",
"03735",
"03736",
"03737",
"03738",
"03739",
"03740",
"03741",
"03742",
"03743",
"03744",
"03745",
"03746",
"03747",
"03748",
"03749",
"03750",
"03751",
"03752",
"03753",
"03754",
"03755",
"03756",
"03757",
"03758",
"03759",
"03761",
"03762",
"03763",
"03764",
"03766",
"03767",
"03768",
"03769",
"03770",
"03771",
"03772",
"03774",
"03775",
"03778",
"03779",
"03780",
"03781",
"03784",
"03785",
"03786",
"03787",
"03788",
"03789",
"03790",
"03791",
"03792",
"03793",
"03794",
"03795",
"03796",
"03797",
"03798",
"03801",
"03802",
"03803",
"03804",
"03805",
"03806",
"03807",
"03808",
"03809",
"03810",
"03811",
"03812",
"03813",
"03814",
"03815",
"03816",
"03821",
"03822",
"03823",
"03824",
"03825",
"03826",
"03828",
"03829",
"03831",
"03832",
"03833",
"03834",
"03835",
"03838",
"03839",
"03840",
"03841",
"03842",
"03844",
"03846",
"03847",
"03849",
"03866",
"03867",
"03872",
"03873",
"03874",
"03876",
"03877",
"03878",
"03879",
"03885",
"03886",
"03887",
"03888",
"03889",
"03890",
"03891",
"03892",
"03893",
"03901",
"03902",
"03903",
"03904",
"03905",
"03906",
"03907",
"03908",
"03909",
"03910",
"03911",
"03913",
"03914",
"03915",
"03916",
"03917",
"03918",
"03919",
"03920",
"03921",
"03922",
"03924",
"03925",
"03926",
"03927",
"03928",
"03929",
"03930",
"03931",
"03932",
"03933",
"03934",
"03935",
"03936",
"03937",
"03938",
"03939",
"03940",
"03941",
"03942",
"03943",
"03944",
"03945",
"03946",
"03947",
"03948",
"03949",
"03952",
"03954",
"03955",
"03956",
"03957",
"03963",
"03964",
"03965",
"03966",
"03968",
"03969",
"03970",
"03971",
"03972",
"03973",
"03974",
"03975",
"03976",
"03977",
"03978",
"03980",
"03982",
"03983",
"03984",
"03985",
"03986",
"03987",
"03988",
"03989",
"03990",
"03991",
"03992",
"03993",
"03994",
"03995",
"04001",
"04002",
"04003",
"04004",
"04005",
"04007",
"04008",
"04009",
"04010",
"04011",
"04013",
"04014",
"04015",
"04016",
"04017",
"04019",
"04020",
"04022",
"04023",
"04024",
"04025",
"04026",
"04027",
"04028",
"04029",
"04030",
"04031",
"04035",
"04036",
"04038",
"04039",
"04040",
"04041",
"04042",
"04044",
"04045",
"04046",
"04047",
"04048",
"04049",
"04050",
"04051",
"04052",
"04053",
"04057",
"04058",
"04059",
"04060",
"04062",
"04063",
"04065",
"04066",
"04068",
"04069",
"04072",
"04073",
"04074",
"04076",
"04077",
"04078",
"04079",
"04080",
"04081",
"04082",
"04083",
"04085",
"04086",
"04087",
"04088",
"04089",
"04090",
"04091",
"04092",
"04101",
"04102",
"04105",
"04109",
"04110",
"04111",
"04112",
"04113",
"04116",
"04118",
"04119",
"04120",
"04121",
"04123",
"04124",
"04125",
"04128",
"04129",
"04131",
"04133",
"04136",
"04137",
"04138",
"04139",
"04142",
"04143",
"04145",
"04146",
"04147",
"04148",
"04149",
"04151",
"04152",
"04154",
"04156",
"04157",
"04158",
"04160",
"04161",
"04163",
"04164",
"04167",
"04169",
"04170",
"04171",
"04172",
"04173",
"04174",
"04175",
"04180",
"04185",
"04186",
"04187",
"04188",
"04189",
"04190",
"04191",
"04192",
"04193",
"04194",
"04202",
"04203",
"04204",
"04205",
"04206",
"04207",
"04208",
"04210",
"04211",
"04212",
"04213",
"04214",
"04215",
"04216",
"04217",
"04218",
"04219",
"04221",
"04222",
"04223",
"04224",
"04226",
"04227",
"04228",
"04230",
"04231",
"04232",
"04233",
"04234",
"04235",
"04237",
"04238",
"04239",
"04240",
"04241",
"04242",
"04243",
"04244",
"04246",
"04247",
"04248",
"04252",
"04253",
"04254",
"04255",
"04256",
"04257",
"04258",
"04259",
"04260",
"04261",
"04262",
"04263",
"04266",
"04267",
"04268",
"04269",
"04270",
"04271",
"04272",
"04273",
"04274",
"04275",
"04276",
"04277",
"04280",
"04281",
"04282",
"04283",
"04284",
"04285",
"04287",
"04288",
"04289",
"04290",
"04291",
"04292",
"04293",
"04294",
"04301",
"04302",
"04303",
"04304",
"04305",
"04306",
"04307",
"04308",
"04309",
"04310",
"04311",
"04312",
"04313",
"04314",
"04316",
"04317",
"04319",
"04320",
"04321",
"04322",
"04323",
"04324",
"04325",
"04326",
"04327",
"04328",
"04329",
"04330",
"04331",
"04332",
"04333",
"04334",
"04335",
"04336",
"04337",
"04338",
"04339",
"04341",
"04342",
"04343",
"04344",
"04345",
"04346",
"04347",
"04348",
"04349",
"04350",
"04351",
"04352",
"04353",
"04354",
"04355",
"04356",
"04357",
"04359",
"04360",
"04361",
"04362",
"04363",
"04364",
"04365",
"04366",
"04367",
"04368",
"04369",
"04370",
"04371",
"04372",
"04373",
"04375",
"04376",
"04377",
"04378",
"04379",
"04381",
"04382",
"04384",
"04386",
"04387",
"04388",
"04389",
"04390",
"04391",
"04392",
"04393",
"04394",
"04395",
"04396",
"04397",
"04398",
"04458",
"04459",
"04461",
"04462",
"04463",
"04464",
"04465",
"04466",
"04468",
"04501",
"04502",
"04504",
"04505",
"04506",
"04507",
"04508",
"04510",
"04511",
"04512",
"04513",
"04514",
"04515",
"04516",
"04517",
"04519",
"04521",
"04522",
"04523",
"04524",
"04525",
"04526",
"04528",
"04529",
"04530",
"04532",
"04533",
"04534",
"04535",
"04536",
"04537",
"04538",
"04539",
"04540",
"04541",
"04542",
"04543",
"04544",
"04545",
"04549",
"04550",
"04551",
"04552",
"04555",
"04556",
"04557",
"04558",
"04559",
"04560",
"04561",
"04562",
"04563",
"04564",
"04565",
"04566",
"04567",
"04568",
"04601",
"04602",
"04603",
"04604",
"04605",
"04606",
"04607",
"04610",
"04617",
"04647",
"04648",
"04649",
"04650",
"04651",
"04652",
"04653",
"04654",
"04655",
"04656",
"04657",
"04658",
"04659",
"04660",
"04661",
"04662",
"04663",
"04664",
"04665",
"04666",
"04667",
"04668",
"04669",
"04671",
"04672",
"04673",
"04674",
"04675",
"04676",
"04678",
"04679",
"04680",
"04681",
"04682",
"04683",
"04684",
"04685",
"04686",
"04687",
"04688",
"04689",
"04690",
"04691",
"04692",
"04693",
"04694",
"04761",
"04765",
"04766",
"04791",
"04793",
"04794",
"04795",
"04796",
"05077"
],
"areacode": "022",
"query": "05075",
"type": "postcode"
}
Query types
The API detects the request type on its own: if the input matches the postal code format of the country, it first searches for a postal code. Other sequences of digits are treated as an area code, all other input as a place name. If the search returns no match, it checks the remaining types. Use the type parameter to set the type explicitly.
| Example | Type | Meaning |
|---|---|---|
/api/de/32423or/api?country=de&q=32423 | postcode | postal code |
/api/de/0571or/api?country=de&q=0571 | prefix | telephone area code |
/api/de/Mindenor/api?country=de&q=Minden | place | place name |
Parameters
| Parameter | Effect |
|---|---|
country | Required: two-letter country code, e.g. de, nl or gb – either in the path (/api/de/32423) or as a parameter (country=de) |
q | Search term as a parameter instead of in the path, e.g. /api?country=de&q=Minden |
type | Sets the request type: postcode, prefix or place |
fields | Comma-separated list of the desired fields, e.g. ?fields=place,postcode |
lang | language of the translatable fields, e.g. ?lang=en |
callback | Name of the callback function for JSONP |
token | API key as a query parameter, if you do not pass it in the header |
Localization
Use the lang parameter to set the language of the response. The name of the country is translated; place names keep their original spelling. If lang is missing, the Accept-Language header of your request applies. Unknown language codes 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 -H "X-Api-Token: plz_…" "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 | Result of the request: success or fail | "success" |
query | The submitted request | "05075" |
type | Detected request type: postcode, prefix or place | "postcode" |
country | Name of the country, translatable with lang | "Germany" |
countryCode | Country code according to ISO 3166-1 Alpha-2 | "PL" |
place | Place name; a list if there are several matches | "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: short description of the error | "not found" |
Usage limit
Each API key allows 20 requests per minute. Every response contains the number of requests still available in the current minute in the X-Rl header and the seconds until the start of the next minute in the X-Ttl header.
{
"status": "fail",
"code": 1008,
"message": "rate limit exceeded",
"query": "05075"
}
Error responses
If a request fails, the response contains "status": "fail", a unique error code in the code field and a short message in the message field. In your application, evaluate the error code, not the text of the message.
| HTTP | Code | message | Cause |
|---|---|---|---|
| 401 | 1001 | missing api token | The request does not contain an API key. |
| 401 | 1002 | invalid api token | The API key is unknown or invalid. |
| 400 | 1003 | missing or unknown country | The country code is missing or unknown. |
| 400 | 1004 | missing query | The request does not contain a search term. |
| 400 | 1005 | query too long | The search term is longer than 80 characters. |
| 404 | 1006 | not found | No entry was found for the search term. |
| 429 | 1007 | try-out limit exceeded | When trying it out on this page, at most 10 requests are possible in 5 minutes. |
| 429 | 1008 | rate limit exceeded | The limit of 20 requests per minute has been reached. Requests are possible again from the next minute. |
| 429 | 1009 | try-out banned for 60 minutes | The try-out limit was exceeded 3 times in a row. Trying it out is then blocked for 60 minutes. |
| 400 | 1010 | bad request | The request contains characters that are not allowed in the path. Send the search term URL-encoded or in the parameter q. |
| 503 | 1011 | service unavailable | The service is temporarily unavailable. Repeat the request after the number of seconds in the Retry-After header. |
| 404 | 1012 | no postcode system in this country | The country has no postcode system. Place names and area codes are still found; the field postcode stays empty. |
Examples
curl -H "X-Api-Token: plz_…" https://www.postleitzahl.net/api/pl/05075 curl -H "X-Api-Token: plz_…" "https://www.postleitzahl.net/api/gb/SW1A%201AA" curl -H "Authorization: Bearer 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
The data comes from the official directories of the respective countries and from open sources such as GeoNames, OpenStreetMap and Wikidata. In the EU member states, the NUTS classification of Eurostat and the TERCET table of the European Commission complement the assignment of postal codes to regions.
