API for postal codes, area codes and places
A lean JSON interface — no registration, no API key, no rate limit. Send a postal code, an area code or a place name and receive the place, its country and all matching postal codes and area codes as structured JSON.
Entwickler-Token
Für jede Anfrage brauchen Sie einen Entwickler-Token. Sie erhalten ihn im Developer-Bereich Ihres Kontos für €9.90 pro Jahr inkl. MwSt. Übergeben Sie den Token im Header X-Api-Token, als Authorization: Bearer … oder als Parameter token.
Endpoint
Land und Anfrage stehen entweder im Pfad oder als Parameter in der URL. Beide Schreibweisen liefern dieselbe Antwort, immer im JSON-Format.
https://www.postleitzahl.net/api/{country}/{query}
https://www.postleitzahl.net/api?country={country}&q={query}
{
"status": "success",
"country": "Brazil",
"countryCode": "BR",
"place": "São Paulo",
"postcode": [
"04535",
"01000",
"01000-000",
"01001",
"01002",
"01003",
"01004",
"01005",
"01006",
"01007",
"01008",
"01009",
"01010",
"01011",
"01012",
"01013",
"01014",
"01015",
"01016",
"01017",
"01018",
"01019",
"01020",
"01021",
"01022",
"01023",
"01024",
"01025",
"01026",
"01027",
"01028",
"01029",
"01030",
"01031",
"01032",
"01033",
"01034",
"01035",
"01036",
"01037",
"01038",
"01039",
"01040",
"01041",
"01042",
"01043",
"01044",
"01045",
"01046",
"01047",
"01048",
"01049",
"01050",
"01101",
"01102",
"01103",
"01104",
"01105",
"01106",
"01107",
"01108",
"01109",
"01120",
"01121",
"01122",
"01123",
"01124",
"01125",
"01126",
"01127",
"01128",
"01129",
"01130",
"01131",
"01132",
"01133",
"01134",
"01135",
"01136",
"01137",
"01138",
"01139",
"01140",
"01141",
"01142",
"01144",
"01150",
"01151",
"01152",
"01153",
"01154",
"01155",
"01156",
"01201",
"01202",
"01203",
"01204",
"01205",
"01206",
"01207",
"01208",
"01209",
"01210",
"01211",
"01212",
"01213",
"01214",
"01215",
"01216",
"01217",
"01218",
"01219",
"01220",
"01221",
"01222",
"01223",
"01224",
"01225",
"01226",
"01227",
"01228",
"01229",
"01230",
"01231",
"01232",
"01233",
"01234",
"01235",
"01236",
"01237",
"01238",
"01239",
"01240",
"01241",
"01242",
"01243",
"01244",
"01245",
"01246",
"01247",
"01248",
"01249",
"01250",
"01251",
"01252",
"01253",
"01254",
"01255",
"01256",
"01257",
"01258",
"01259",
"01262",
"01301",
"01302",
"01303",
"01304",
"01305",
"01306",
"01307",
"01308",
"01309",
"01310",
"01311",
"01312",
"01313",
"01314",
"01315",
"01316",
"01317",
"01318",
"01319",
"01320",
"01321",
"01322",
"01323",
"01324",
"01325",
"01326",
"01327",
"01328",
"01329",
"01330",
"01331",
"01332",
"01333",
"01401",
"01402",
"01403",
"01404",
"01405",
"01406",
"01407",
"01408",
"01409",
"01410",
"01411",
"01412",
"01413",
"01414",
"01415",
"01416",
"01417",
"01418",
"01419",
"01420",
"01421",
"01422",
"01423",
"01424",
"01425",
"01426",
"01427",
"01428",
"01429",
"01430",
"01431",
"01432",
"01433",
"01434",
"01435",
"01436",
"01437",
"01438",
"01439",
"01440",
"01441",
"01442",
"01443",
"01444",
"01445",
"01446",
"01447",
"01448",
"01449",
"01450",
"01451",
"01452",
"01453",
"01454",
"01455",
"01456",
"01457",
"01501",
"01502",
"01503",
"01504",
"01505",
"01506",
"01507",
"01508",
"01509",
"01510",
"01511",
"01512",
"01513",
"01514",
"01515",
"01516",
"01517",
"01518",
"01519",
"01520",
"01521",
"01522",
"01523",
"01524",
"01525",
"01526",
"01527",
"01528",
"01529",
"01530",
"01531",
"01532",
"01533",
"01534",
"01535",
"01536",
"01537",
"01538",
"01539",
"01540",
"01541",
"01542",
"01543",
"01544",
"01545",
"01546",
"01547",
"01548",
"01549",
"01550",
"01551",
"01552",
"01553",
"02010",
"02011",
"02012",
"02013",
"02016",
"02017",
"02018",
"02019",
"02020",
"02021",
"02022",
"02028",
"02029",
"02030",
"02031",
"02032",
"02033",
"02034",
"02035",
"02036",
"02037",
"02038",
"02039",
"02040",
"02041",
"02042",
"02043",
"02044",
"02045",
"02046",
"02047",
"02049",
"02050",
"02051",
"02052",
"02053",
"02054",
"02055",
"02056",
"02060",
"02063",
"02064",
"02065",
"02066",
"02067",
"02068",
"02069",
"02071",
"02072",
"02073",
"02074",
"02075",
"02076",
"02077",
"02078",
"02079",
"02080",
"02081",
"02082",
"02083",
"02084",
"02085",
"02110",
"02111",
"02112",
"02113",
"02114",
"02115",
"02116",
"02117",
"02118",
"02119",
"02120",
"02121",
"02122",
"02123",
"02124",
"02125",
"02126",
"02127",
"02128",
"02129",
"02130",
"02131",
"02132",
"02133",
"02134",
"02135",
"02136",
"02137",
"02138",
"02139",
"02140",
"02141",
"02142",
"02143",
"02144",
"02145",
"02146",
"02147",
"02150",
"02151",
"02152",
"02161",
"02162",
"02165",
"02166",
"02167",
"02168",
"02169",
"02170",
"02174",
"02175",
"02176",
"02177",
"02178",
"02179",
"02180",
"02181",
"02185",
"02186",
"02187",
"02188",
"02189",
"02190",
"02201",
"02202",
"02203",
"02204",
"02205",
"02206",
"02207",
"02208",
"02209",
"02210",
"02211",
"02212",
"02213",
"02214",
"02215",
"02216",
"02217",
"02218",
"02219",
"02220",
"02221",
"02222",
"02223",
"02224",
"02225",
"02226",
"02227",
"02228",
"02229",
"02230",
"02231",
"02232",
"02233",
"02234",
"02235",
"02236",
"02237",
"02238",
"02239",
"02240",
"02241",
"02242",
"02243",
"02244",
"02245",
"02246",
"02247",
"02248",
"02249",
"02250",
"02251",
"02252",
"02253",
"02254",
"02255",
"02256",
"02257",
"02258",
"02259",
"02260",
"02261",
"02262",
"02263",
"02264",
"02265",
"02266",
"02267",
"02268",
"02269",
"02270",
"02271",
"02272",
"02273",
"02274",
"02275",
"02276",
"02277",
"02278",
"02279",
"02280",
"02281",
"02282",
"02283",
"02284",
"02285",
"02286",
"02287",
"02288",
"02289",
"02290",
"02301",
"02302",
"02303",
"02304",
"02305",
"02306",
"02307",
"02308",
"02309",
"02310",
"02311",
"02312",
"02313",
"02314",
"02315",
"02316",
"02317",
"02318",
"02319",
"02320",
"02321",
"02322",
"02323",
"02324",
"02325",
"02326",
"02327",
"02328",
"02329",
"02330",
"02331",
"02332",
"02333",
"02334",
"02335",
"02336",
"02337",
"02338",
"02339",
"02340",
"02341",
"02342",
"02343",
"02344",
"02345",
"02346",
"02347",
"02348",
"02349",
"02350",
"02351",
"02352",
"02353",
"02354",
"02355",
"02356",
"02357",
"02358",
"02359",
"02360",
"02361",
"02362",
"02363",
"02364",
"02365",
"02366",
"02367",
"02368",
"02370",
"02371",
"02372",
"02373",
"02374",
"02375",
"02376",
"02377",
"02378",
"02379",
"02401",
"02402",
"02403",
"02404",
"02405",
"02406",
"02407",
"02408",
"02409",
"02410",
"02411",
"02413",
"02415",
"02416",
"02417",
"02418",
"02419",
"02420",
"02421",
"02422",
"02423",
"02430",
"02431",
"02432",
"02433",
"02434",
"02435",
"02436",
"02440",
"02441",
"02442",
"02443",
"02450",
"02451",
"02452",
"02460",
"02461",
"02462",
"02463",
"02464",
"02465",
"02466",
"02467",
"02468",
"02469",
"02470",
"02471",
"02472",
"02473",
"02474",
"02475",
"02478",
"02479",
"02501",
"02508",
"02510",
"02511",
"02512",
"02513",
"02514",
"02515",
"02516",
"02517",
"02518",
"02519",
"02520",
"02521",
"02522",
"02523",
"02524",
"02525",
"02526",
"02530",
"02531",
"02532",
"02533",
"02534",
"02535",
"02536",
"02537",
"02538",
"02539",
"02540",
"02541",
"02542",
"02543",
"02544",
"02545",
"02546",
"02550",
"02551",
"02552",
"02553",
"02554",
"02555",
"02556",
"02557",
"02558",
"02559",
"02560",
"02561",
"02562",
"02563",
"02564",
"02565",
"02566",
"02567",
"02610",
"02611",
"02612",
"02613",
"02614",
"02615",
"02616",
"02617",
"02618",
"02630",
"02631",
"02632",
"02633",
"02634",
"02635",
"02636",
"02637",
"02639",
"02649",
"02650",
"02651",
"02652",
"02653",
"02670",
"02671",
"02672",
"02673",
"02674",
"02675",
"02676",
"02677",
"02678",
"02679",
"02680",
"02701",
"02710",
"02712",
"02713",
"02714",
"02715",
"02716",
"02717",
"02720",
"02721",
"02722",
"02723",
"02724",
"02725",
"02726",
"02727",
"02728",
"02729",
"02730",
"02731",
"02732",
"02733",
"02734",
"02735",
"02736",
"02737",
"02738",
"02739",
"02750",
"02751",
"02752",
"02753",
"02754",
"02755",
"02756",
"02757",
"02758",
"02759",
"02760",
"02762",
"02763",
"02764",
"02765",
"02801",
"02802",
"02803",
"02804",
"02805",
"02806",
"02807",
"02808",
"02809",
"02810",
"02811",
"02812",
"02813",
"02814",
"02815",
"02816",
"02817",
"02820",
"02831",
"02832",
"02833",
"02834",
"02835",
"02836",
"02837",
"02839",
"02840",
"02841",
"02842",
"02844",
"02845",
"02846",
"02847",
"02848",
"02849",
"02850",
"02851",
"02852",
"02853",
"02854",
"02855",
"02856",
"02857",
"02858",
"02859",
"02860",
"02861",
"02862",
"02863",
"02864",
"02865",
"02866",
"02867",
"02870",
"02871",
"02872",
"02873",
"02874",
"02875",
"02876",
"02877",
"02878",
"02879",
"02880",
"02881",
"02882",
"02883",
"02901",
"02910",
"02911",
"02912",
"02913",
"02914",
"02915",
"02916",
"02917",
"02918",
"02919",
"02920",
"02921",
"02924",
"02925",
"02926",
"02927",
"02928",
"02929",
"02930",
"02931",
"02932",
"02933",
"02934",
"02935",
"02936",
"02937",
"02938",
"02939",
"02940",
"02941",
"02942",
"02943",
"02944",
"02945",
"02950",
"02951",
"02952",
"02955",
"02956",
"02957",
"02959",
"02960",
"02961",
"02962",
"02963",
"02964",
"02965",
"02966",
"02967",
"02968",
"02969",
"02970",
"02971",
"02972",
"02975",
"02976",
"02977",
"02978",
"02979",
"02981",
"02982",
"02983",
"02984",
"02985",
"02986",
"02987",
"02988",
"02989",
"02990",
"02991",
"02992",
"02993",
"02994",
"02995",
"02996",
"02997",
"02998",
"03001",
"03002",
"03003",
"03004",
"03005",
"03006",
"03007",
"03008",
"03009",
"03010",
"03011",
"03012",
"03013",
"03014",
"03015",
"03016",
"03017",
"03018",
"03019",
"03020",
"03021",
"03022",
"03023",
"03024",
"03025",
"03026",
"03027",
"03028",
"03029",
"03030",
"03031",
"03032",
"03033",
"03034",
"03035",
"03036",
"03040",
"03041",
"03042",
"03043",
"03044",
"03045",
"03046",
"03047",
"03050",
"03051",
"03052",
"03053",
"03054",
"03055",
"03057",
"03058",
"03059",
"03060",
"03061",
"03062",
"03063",
"03064",
"03065",
"03066",
"03067",
"03068",
"03069",
"03070",
"03071",
"03072",
"03073",
"03074",
"03076",
"03077",
"03080",
"03081",
"03084",
"03085",
"03086",
"03087",
"03088",
"03089",
"03090",
"03101",
"03102",
"03103",
"03104",
"03105",
"03106",
"03107",
"03108",
"03109",
"03110",
"03111",
"03112",
"03113",
"03114",
"03115",
"03116",
"03117",
"03118",
"03119",
"03120",
"03121",
"03122",
"03123",
"03124",
"03125",
"03126",
"03127",
"03128",
"03129",
"03130",
"03131",
"03132",
"03133",
"03134",
"03135",
"03136",
"03137",
"03138",
"03139",
"03140",
"03141",
"03142",
"03143",
"03144",
"03145",
"03146",
"03147",
"03149",
"03150",
"03151",
"03152",
"03153",
"03154",
"03155",
"03156",
"03157",
"03158",
"03159",
"03160",
"03161",
"03162",
"03163",
"03164",
"03165",
"03166",
"03167",
"03168",
"03169",
"03170",
"03171",
"03172",
"03173",
"03174",
"03175",
"03176",
"03177",
"03178",
"03179",
"03180",
"03181",
"03182",
"03183",
"03184",
"03185",
"03186",
"03187",
"03188",
"03189",
"03190",
"03191",
"03192",
"03193",
"03194",
"03195",
"03201",
"03202",
"03203",
"03204",
"03205",
"03206",
"03207",
"03208",
"03209",
"03210",
"03211",
"03212",
"03213",
"03214",
"03215",
"03216",
"03220",
"03221",
"03222",
"03223",
"03224",
"03225",
"03226",
"03227",
"03236",
"03237",
"03238",
"03239",
"03240",
"03241",
"03242",
"03243",
"03244",
"03245",
"03249",
"03250",
"03251",
"03252",
"03253",
"03254",
"03255",
"03256",
"03257",
"03258",
"03259",
"03260",
"03261",
"03262",
"03263",
"03264",
"03265",
"03266",
"03267",
"03268",
"03269",
"03270",
"03271",
"03272",
"03273",
"03274",
"03275",
"03276",
"03277",
"03278",
"03279",
"03280",
"03281",
"03282",
"03283",
"03284",
"03286",
"03287",
"03288",
"03289",
"03294",
"03295",
"03301",
"03302",
"03303",
"03304",
"03305",
"03306",
"03307",
"03308",
"03309",
"03310",
"03311",
"03312",
"03313",
"03314",
"03315",
"03316",
"03317",
"03318",
"03319",
"03320",
"03321",
"03322",
"03323",
"03324",
"03325",
"03330",
"03331",
"03332",
"03333",
"03334",
"03335",
"03336",
"03337",
"03338",
"03340",
"03342",
"03343",
"03344",
"03345",
"03346",
"03347",
"03348",
"03349",
"03350",
"03351",
"03355",
"03356",
"03357",
"03358",
"03359",
"03360",
"03361",
"03362",
"03363",
"03364",
"03365",
"03366",
"03367",
"03370",
"03371",
"03372",
"03373",
"03374",
"03375",
"03376",
"03377",
"03378",
"03379",
"03380",
"03381",
"03382",
"03383",
"03384",
"03385",
"03386",
"03387",
"03388",
"03389",
"03390",
"03401",
"03402",
"03403",
"03404",
"03405",
"03406",
"03407",
"03408",
"03409",
"03410",
"03411",
"03412",
"03413",
"03414",
"03415",
"03416",
"03417",
"03420",
"03421",
"03422",
"03423",
"03424",
"03425",
"03426",
"03427",
"03428",
"03429",
"03430",
"03431",
"03432",
"03433",
"03434",
"03435",
"03436",
"03437",
"03438",
"03440",
"03441",
"03442",
"03443",
"03444",
"03445",
"03446",
"03447",
"03448",
"03449",
"03450",
"03451",
"03452",
"03453",
"03454",
"03455",
"03456",
"03460",
"03461",
"03462",
"03463",
"03470",
"03471",
"03472",
"03474",
"03475",
"03476",
"03477",
"03478",
"03479",
"03480",
"03490",
"03501",
"03502",
"03503",
"03504",
"03505",
"03506",
"03507",
"03508",
"03509",
"03510",
"03511",
"03512",
"03513",
"03514",
"03515",
"03516",
"03517",
"03518",
"03519",
"03520",
"03521",
"03522",
"03523",
"03524",
"03525",
"03526",
"03527",
"03530",
"03531",
"03532",
"03533",
"03534",
"03535",
"03540",
"03541",
"03542",
"03543",
"03544",
"03545",
"03546",
"03547",
"03548",
"03550",
"03551",
"03552",
"03553",
"03554",
"03555",
"03556",
"03557",
"03558",
"03559",
"03560",
"03561",
"03562",
"03563",
"03564",
"03565",
"03566",
"03567",
"03568",
"03569",
"03570",
"03571",
"03572",
"03573",
"03574",
"03575",
"03576",
"03577",
"03578",
"03579",
"03580",
"03581",
"03582",
"03583",
"03584",
"03585",
"03586",
"03587",
"03588",
"03589",
"03590",
"03591",
"03601",
"03602",
"03603",
"03604",
"03605",
"03606",
"03607",
"03608",
"03609",
"03610",
"03611",
"03612",
"03613",
"03614",
"03615",
"03616",
"03617",
"03618",
"03619",
"03620",
"03621",
"03622",
"03623",
"03624",
"03625",
"03626",
"03627",
"03630",
"03631",
"03632",
"03633",
"03634",
"03635",
"03636",
"03637",
"03638",
"03639",
"03640",
"03641",
"03642",
"03643",
"03644",
"03645",
"03646",
"03647",
"03648",
"03649",
"03650",
"03651",
"03652",
"03653",
"03654",
"03655",
"03656",
"03657",
"03658",
"03659",
"03660",
"03661",
"03662",
"03663",
"03664",
"03665",
"03666",
"03667",
"03668",
"03669",
"03670",
"03671",
"03672",
"03673",
"03674",
"03675",
"03676",
"03677",
"03678",
"03679",
"03680",
"03681",
"03682",
"03683",
"03685",
"03687",
"03688",
"03689",
"03690",
"03691",
"03692",
"03693",
"03694",
"03695",
"03701",
"03702",
"03703",
"03704",
"03707",
"03710",
"03711",
"03712",
"03713",
"03714",
"03715",
"03716",
"03717",
"03718",
"03719",
"03720",
"03721",
"03725",
"03726",
"03727",
"03728",
"03729",
"03730",
"03731",
"03732",
"03733",
"03734",
"03735",
"03736",
"03737",
"03738",
"03739",
"03755",
"03756",
"03757",
"03758",
"03759",
"03801",
"03802",
"03803",
"03804",
"03805",
"03806",
"03807",
"03808",
"03809",
"03810",
"03811",
"03812",
"03813",
"03814",
"03816",
"03817",
"03818",
"03819",
"03820",
"03821",
"03822",
"03823",
"03827",
"03828",
"03870",
"03871",
"03872",
"03873",
"03874",
"03875",
"03876",
"03877",
"03878",
"03880",
"03881",
"03882",
"03883",
"03884",
"03886",
"03887",
"03888",
"03889",
"03890",
"03891",
"03892",
"03893",
"03894",
"03895",
"03896",
"03901",
"03904",
"03905",
"03906",
"03907",
"03908",
"03909",
"03910",
"03911",
"03912",
"03916",
"03917",
"03918",
"03919",
"03920",
"03921",
"03922",
"03923",
"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",
"03950",
"03951",
"03952",
"03953",
"03958",
"03959",
"03960",
"03961",
"03962",
"03963",
"03964",
"03965",
"03966",
"03967",
"03968",
"03969",
"03970",
"03971",
"03972",
"03973",
"03974",
"03975",
"03976",
"03977",
"03978",
"03979",
"03980",
"03981",
"03982",
"03983",
"03984",
"03985",
"03986",
"03987",
"03988",
"03989",
"04001",
"04002",
"04003",
"04004",
"04005",
"04006",
"04007",
"04008",
"04009",
"04010",
"04011",
"04012",
"04013",
"04014",
"04015",
"04016",
"04017",
"04018",
"04019",
"04020",
"04021",
"04022",
"04023",
"04024",
"04025",
"04026",
"04027",
"04028",
"04029",
"04030",
"04031",
"04032",
"04035",
"04036",
"04037",
"04038",
"04039",
"04040",
"04041",
"04042",
"04043",
"04044",
"04045",
"04046",
"04047",
"04048",
"04049",
"04050",
"04051",
"04052",
"04053",
"04054",
"04055",
"04057",
"04058",
"04059",
"04060",
"04061",
"04062",
"04063",
"04064",
"04065",
"04066",
"04067",
"04068",
"04069",
"04070",
"04071",
"04072",
"04074",
"04075",
"04076",
"04077",
"04078",
"04079",
"04080",
"04081",
"04082",
"04083",
"04084",
"04085",
"04086",
"04087",
"04088",
"04089",
"04090",
"04094",
"04101",
"04102",
"04103",
"04104",
"04105",
"04106",
"04107",
"04108",
"04109",
"04110",
"04111",
"04112",
"04113",
"04114",
"04115",
"04116",
"04117",
"04118",
"04119",
"04120",
"04121",
"04122",
"04123",
"04124",
"04125",
"04126",
"04127",
"04128",
"04129",
"04130",
"04131",
"04132",
"04133",
"04134",
"04135",
"04136",
"04137",
"04138",
"04139",
"04140",
"04141",
"04142",
"04143",
"04144",
"04145",
"04146",
"04147",
"04148",
"04149",
"04150",
"04151",
"04152",
"04153",
"04154",
"04155",
"04156",
"04157",
"04158",
"04159",
"04160",
"04161",
"04162",
"04163",
"04164",
"04165",
"04166",
"04167",
"04168",
"04169",
"04170",
"04171",
"04173",
"04174",
"04176",
"04177",
"04180",
"04181",
"04182",
"04183",
"04184",
"04185",
"04186",
"04187",
"04190",
"04191",
"04193",
"04194",
"04195",
"04201",
"04202",
"04203",
"04204",
"04205",
"04206",
"04207",
"04208",
"04209",
"04210",
"04211",
"04212",
"04213",
"04214",
"04215",
"04216",
"04217",
"04218",
"04220",
"04221",
"04222",
"04223",
"04224",
"04225",
"04226",
"04229",
"04230",
"04231",
"04232",
"04233",
"04235",
"04236",
"04240",
"04241",
"04242",
"04243",
"04244",
"04246",
"04247",
"04248",
"04249",
"04250",
"04251",
"04252",
"04253",
"04254",
"04255",
"04256",
"04257",
"04258",
"04260",
"04261",
"04262",
"04263",
"04264",
"04265",
"04266",
"04267",
"04268",
"04269",
"04270",
"04271",
"04272",
"04273",
"04274",
"04275",
"04276",
"04277",
"04278",
"04279",
"04280",
"04281",
"04282",
"04283",
"04284",
"04285",
"04286",
"04287",
"04288",
"04289",
"04290",
"04291",
"04292",
"04293",
"04294",
"04295",
"04296",
"04297",
"04298",
"04301",
"04302",
"04303",
"04304",
"04305",
"04306",
"04307",
"04308",
"04309",
"04310",
"04311",
"04312",
"04313",
"04314",
"04315",
"04316",
"04317",
"04318",
"04319",
"04320",
"04321",
"04323",
"04324",
"04325",
"04326",
"04327",
"04328",
"04329",
"04330",
"04331",
"04332",
"04333",
"04334",
"04335",
"04336",
"04337",
"04338",
"04339",
"04340",
"04342",
"04343",
"04344",
"04345",
"04346",
"04347",
"04348",
"04349",
"04350",
"04351",
"04355",
"04356",
"04357",
"04358",
"04359",
"04360",
"04361",
"04362",
"04363",
"04364",
"04365",
"04366",
"04367",
"04368",
"04369",
"04370",
"04371",
"04372",
"04373",
"04374",
"04375",
"04376",
"04377",
"04378",
"04379",
"04381",
"04382",
"04383",
"04384",
"04385",
"04386",
"04387",
"04401",
"04402",
"04403",
"04404",
"04405",
"04406",
"04407",
"04408",
"04409",
"04410",
"04411",
"04412",
"04413",
"04414",
"04415",
"04416",
"04417",
"04419",
"04421",
"04423",
"04424",
"04425",
"04426",
"04427",
"04428",
"04429",
"04430",
"04431",
"04432",
"04433",
"04434",
"04436",
"04437",
"04438",
"04439",
"04444",
"04445",
"04446",
"04447",
"04455",
"04456",
"04457",
"04458",
"04459",
"04460",
"04461",
"04462",
"04463",
"04464",
"04466",
"04467",
"04468",
"04469",
"04470",
"04472",
"04473",
"04474",
"04475",
"04476",
"04477",
"04501",
"04502",
"04503",
"04504",
"04505",
"04506",
"04507",
"04508",
"04509",
"04510",
"04511",
"04512",
"04513",
"04514",
"04515",
"04516",
"04517",
"04518",
"04520",
"04521",
"04522",
"04523",
"04524",
"04530",
"04531",
"04532",
"04533",
"04534",
"04536",
"04537",
"04538",
"04542",
"04543",
"04544",
"04545",
"04546",
"04547",
"04548",
"04549",
"04550",
"04551",
"04552",
"04553",
"04555",
"04556",
"04557",
"04558",
"04559",
"04560",
"04561",
"04562",
"04563",
"04564",
"04565",
"04566",
"04567",
"04568",
"04569",
"04570",
"04571",
"04575",
"04576",
"04578",
"04580",
"04581",
"04582",
"04583",
"04601",
"04602",
"04603",
"04604",
"04605",
"04606",
"04607",
"04608",
"04609",
"04610",
"04611",
"04612",
"04613",
"04614",
"04615",
"04616",
"04617",
"04618",
"04619",
"04620",
"04621",
"04622",
"04623",
"04624",
"04625",
"04626",
"04627",
"04630",
"04631",
"04632",
"04633",
"04634",
"04635",
"04636",
"04637",
"04638",
"04639",
"04640",
"04641",
"04642",
"04643",
"04644",
"04645",
"04646",
"04647",
"04648",
"04649",
"04650",
"04651",
"04652",
"04653",
"04654",
"04655",
"04657",
"04658",
"04660",
"04661",
"04662",
"04663",
"04664",
"04671",
"04672",
"04673",
"04674",
"04675",
"04676",
"04677",
"04678",
"04679",
"04685",
"04686",
"04688",
"04689",
"04690",
"04691",
"04692",
"04693",
"04696",
"04701",
"04702",
"04703",
"04704",
"04705",
"04707",
"04708",
"04709",
"04710",
"04711",
"04713",
"04714",
"04715",
"04716",
"04717",
"04718",
"04719",
"04720",
"04721",
"04722",
"04723",
"04724",
"04725",
"04726",
"04727",
"04728",
"04729",
"04730",
"04733",
"04734",
"04735",
"04736",
"04737",
"04738",
"04739",
"04740",
"04741",
"04742",
"04743",
"04744",
"04745",
"04746",
"04747",
"04748",
"04750",
"04751",
"04752",
"04753",
"04754",
"04755",
"04756",
"04757",
"04760",
"04761",
"04762",
"04763",
"04764",
"04765",
"04766",
"04767",
"04768",
"04770",
"04771",
"04772",
"04773",
"04774",
"04775",
"04776",
"04777",
"04781",
"04782",
"04783",
"04784",
"04785",
"04786",
"04787",
"04788",
"04789",
"04792",
"04794",
"04795",
"04801",
"04802",
"04803",
"04805",
"04806",
"04807",
"04809",
"04810",
"04811",
"04812",
"04813",
"04814",
"04815",
"04816",
"04820",
"04821",
"04822",
"04823",
"04824",
"04826",
"04827",
"04828",
"04829",
"04830",
"04831",
"04832",
"04833",
"04835",
"04836",
"04837",
"04840",
"04841",
"04842",
"04843",
"04844",
"04845",
"04846",
"04847",
"04848",
"04849",
"04850",
"04851",
"04852",
"04853",
"04854",
"04855",
"04856",
"04857",
"04858",
"04859",
"04860",
"04861",
"04862",
"04863",
"04864",
"04865",
"04866",
"04867",
"04870",
"04872",
"04873",
"04874",
"04875",
"04877",
"04880",
"04881",
"04882",
"04883",
"04884",
"04886",
"04888",
"04889",
"04890",
"04891",
"04892",
"04893",
"04894",
"04895",
"04896",
"04897",
"04898",
"04902",
"04904",
"04905",
"04906",
"04909",
"04910",
"04911",
"04912",
"04913",
"04914",
"04915",
"04916",
"04917",
"04918",
"04920",
"04921",
"04922",
"04923",
"04925",
"04926",
"04928",
"04929",
"04930",
"04931",
"04932",
"04933",
"04935",
"04937",
"04938",
"04939",
"04940",
"04941",
"04942",
"04943",
"04944",
"04945",
"04946",
"04947",
"04948",
"04949",
"04950",
"04951",
"04952",
"04953",
"04956",
"04960",
"04961",
"04962",
"04963",
"04965",
"04966",
"04967",
"05001",
"05002",
"05003",
"05004",
"05005",
"05006",
"05007",
"05008",
"05009",
"05010",
"05011",
"05012",
"05013",
"05014",
"05015",
"05016",
"05017",
"05018",
"05019",
"05020",
"05021",
"05022",
"05023",
"05024",
"05025",
"05026",
"05027",
"05028",
"05029",
"05030",
"05033",
"05035",
"05036",
"05037",
"05038",
"05040",
"05041",
"05042",
"05043",
"05044",
"05045",
"05046",
"05047",
"05048",
"05049",
"05050",
"05051",
"05052",
"05053",
"05054",
"05055",
"05056",
"05057",
"05058",
"05059",
"05060",
"05061",
"05065",
"05068",
"05069",
"05072",
"05073",
"05074",
"05075",
"05076",
"05077",
"05078",
"05079",
"05080",
"05081",
"05082",
"05083",
"05084",
"05085",
"05086",
"05087",
"05088",
"05089",
"05092",
"05093",
"05094",
"05095",
"05101",
"05102",
"05103",
"05104",
"05105",
"05106",
"05107",
"05108",
"05109",
"05110",
"05112",
"05113",
"05114",
"05115",
"05116",
"05117",
"05118",
"05119",
"05120",
"05121",
"05122",
"05123",
"05124",
"05125",
"05126",
"05127",
"05128",
"05131",
"05132",
"05133",
"05134",
"05135",
"05136",
"05138",
"05139",
"05140",
"05141",
"05142",
"05143",
"05144",
"05145",
"05146",
"05154",
"05157",
"05158",
"05159",
"05160",
"05161",
"05162",
"05163",
"05164",
"05165",
"05170",
"05171",
"05172",
"05173",
"05174",
"05175",
"05176",
"05177",
"05180",
"05181",
"05182",
"05183",
"05184",
"05185",
"05186",
"05187",
"05201",
"05202",
"05203",
"05204",
"05205",
"05206",
"05207",
"05208",
"05209",
"05210",
"05211",
"05212",
"05215",
"05220",
"05223",
"05224",
"05230",
"05240",
"05245",
"05263",
"05264",
"05265",
"05266",
"05267",
"05268",
"05269",
"05270",
"05271",
"05272",
"05273",
"05274",
"05275",
"05276",
"05280",
"05281",
"05282",
"05283",
"05301",
"05302",
"05303",
"05304",
"05305",
"05307",
"05308",
"05310",
"05311",
"05312",
"05313",
"05314",
"05315",
"05317",
"05318",
"05319",
"05320",
"05321",
"05322",
"05323",
"05324",
"05325",
"05326",
"05327",
"05328",
"05329",
"05330",
"05331",
"05332",
"05333",
"05334",
"05335",
"05336",
"05337",
"05338",
"05339",
"05340",
"05343",
"05344",
"05345",
"05346",
"05347",
"05348",
"05350",
"05351",
"05352",
"05353",
"05356",
"05358",
"05359",
"05360",
"05361",
"05362",
"05363",
"05364",
"05365",
"05366",
"05367",
"05368",
"05371",
"05372",
"05373",
"05374",
"05376",
"05379",
"05381",
"05382",
"05386",
"05387",
"05388",
"05396",
"05397",
"05398",
"05399",
"05401",
"05402",
"05403",
"05404",
"05405",
"05406",
"05407",
"05408",
"05409",
"05410",
"05411",
"05412",
"05413",
"05414",
"05415",
"05416",
"05417",
"05418",
"05419",
"05420",
"05421",
"05422",
"05423",
"05424",
"05425",
"05426",
"05427",
"05428",
"05429",
"05432",
"05433",
"05434",
"05435",
"05436",
"05437",
"05438",
"05439",
"05440",
"05441",
"05442",
"05443",
"05444",
"05445",
"05446",
"05447",
"05448",
"05449",
"05450",
"05451",
"05452",
"05453",
"05454",
"05455",
"05458",
"05459",
"05460",
"05461",
"05462",
"05463",
"05464",
"05465",
"05466",
"05467",
"05468",
"05469",
"05470",
"05471",
"05472",
"05477",
"05501",
"05502",
"05503",
"05505",
"05506",
"05507",
"05508",
"05509",
"05510",
"05511",
"05512",
"05513",
"05514",
"05515",
"05516",
"05517",
"05518",
"05519",
"05520",
"05521",
"05522",
"05523",
"05524",
"05525",
"05526",
"05527",
"05528",
"05529",
"05530",
"05531",
"05532",
"05533",
"05534",
"05535",
"05536",
"05537",
"05538",
"05539",
"05540",
"05541",
"05542",
"05543",
"05544",
"05545",
"05546",
"05547",
"05548",
"05549",
"05550",
"05551",
"05560",
"05563",
"05564",
"05565",
"05566",
"05567",
"05568",
"05569",
"05570",
"05571",
"05572",
"05574",
"05576",
"05577",
"05578",
"05579",
"05580",
"05581",
"05582",
"05583",
"05584",
"05585",
"05586",
"05587",
"05588",
"05589",
"05590",
"05591",
"05592",
"05593",
"05594",
"05595",
"05596",
"05601",
"05602",
"05603",
"05604",
"05605",
"05606",
"05607",
"05608",
"05609",
"05610",
"05611",
"05612",
"05613",
"05614",
"05615",
"05616",
"05617",
"05618",
"05619",
"05620",
"05621",
"05622",
"05623",
"05624",
"05625",
"05626",
"05627",
"05628",
"05629",
"05630",
"05632",
"05633",
"05634",
"05635",
"05638",
"05639",
"05640",
"05641",
"05642",
"05650",
"05651",
"05652",
"05653",
"05654",
"05655",
"05656",
"05657",
"05658",
"05659",
"05660",
"05661",
"05662",
"05663",
"05664",
"05665",
"05670",
"05671",
"05672",
"05673",
"05674",
"05675",
"05676",
"05678",
"05679",
"05683",
"05684",
"05685",
"05686",
"05687",
"05688",
"05690",
"05691",
"05692",
"05704",
"05705",
"05706",
"05707",
"05709",
"05710",
"05711",
"05712",
"05713",
"05715",
"05716",
"05717",
"05718",
"05723",
"05724",
"05725",
"05726",
"05727",
"05728",
"05729",
"05730",
"05731",
"05734",
"05735",
"05736",
"05740",
"05741",
"05742",
"05743",
"05745",
"05749",
"05750",
"05752",
"05754",
"05755",
"05756",
"05757",
"05758",
"05759",
"05760",
"05761",
"05762",
"05763",
"05765",
"05766",
"05767",
"05772",
"05773",
"05774",
"05775",
"05776",
"05777",
"05778",
"05780",
"05781",
"05782",
"05783",
"05784",
"05785",
"05786",
"05787",
"05788",
"05789",
"05790",
"05791",
"05792",
"05793",
"05794",
"05795",
"05796",
"05797",
"05798",
"05801",
"05802",
"05804",
"05805",
"05812",
"05813",
"05814",
"05815",
"05816",
"05818",
"05819",
"05820",
"05821",
"05822",
"05823",
"05830",
"05831",
"05832",
"05833",
"05834",
"05835",
"05836",
"05840",
"05841",
"05842",
"05843",
"05844",
"05845",
"05846",
"05847",
"05848",
"05849",
"05850",
"05851",
"05852",
"05853",
"05854",
"05855",
"05856",
"05857",
"05858",
"05859",
"05860",
"05861",
"05862",
"05863",
"05864",
"05866",
"05867",
"05868",
"05869",
"05870",
"05871",
"05872",
"05873",
"05874",
"05875",
"05876",
"05877",
"05878",
"05879",
"05880",
"05881",
"05882",
"05883",
"05884",
"05885",
"05886",
"05887",
"05888",
"05889",
"05890",
"05891",
"05892",
"05893",
"05894",
"06755",
"06824",
"08010",
"08011",
"08020",
"08021",
"08022",
"08030",
"08031",
"08032",
"08040",
"08041",
"08042",
"08050",
"08051",
"08060",
"08061",
"08062",
"08070",
"08071",
"08072",
"08080",
"08081",
"08090",
"08110",
"08111",
"08115",
"08120",
"08121",
"08122",
"08130",
"08131",
"08132",
"08140",
"08141",
"08142",
"08143",
"08150",
"08151",
"08152",
"08160",
"08161",
"08180",
"08190",
"08191",
"08210",
"08215",
"08220",
"08223",
"08225",
"08226",
"08230",
"08235",
"08240",
"08241",
"08245",
"08246",
"08247",
"08248",
"08250",
"08253",
"08255",
"08257",
"08260",
"08265",
"08270",
"08275",
"08280",
"08285",
"08290",
"08295",
"08310",
"08311",
"08320",
"08321",
"08330",
"08331",
"08340",
"08341",
"08342",
"08343",
"08344",
"08345",
"08346",
"08347",
"08370",
"08371",
"08372",
"08373",
"08375",
"08380",
"08381",
"08382",
"08383",
"08390",
"08391",
"08395",
"08410",
"08411",
"08412",
"08420",
"08421",
"08430",
"08431",
"08440",
"08441",
"08450",
"08451",
"08452",
"08460",
"08461",
"08465",
"08466",
"08470",
"08471",
"08472",
"08473",
"08474",
"08475",
"08476",
"08485",
"08490",
"08491",
"08540",
"08542",
"09510"
],
"areacode": "11",
"query": "04535",
"type": "postcode"
}
Query types
The type is detected automatically. A numeric input with the country's postal code length is treated as a postal code, any other digit sequence as an area code, everything else as a place name. Use ?type= to force the type.
| Example | Type | Meaning |
|---|---|---|
https://www.postleitzahl.net/api/de/32423oderhttps://www.postleitzahl.net/api?country=de&q=32423 | postcode | postal code |
https://www.postleitzahl.net/api/de/0571oderhttps://www.postleitzahl.net/api?country=de&q=0571 | prefix | telephone area code |
https://www.postleitzahl.net/api/de/Mindenoderhttps://www.postleitzahl.net/api?country=de&q=Minden | place | place name |
Parameters
| Parameter | Effect |
|---|---|
country | Pflichtangabe: der zweistellige Ländercode, z. B. de, nl oder gb – im Pfad (/api/gb/SW1A 1AA) oder als Parameter (country=gb) |
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 query as a parameter instead of in the path: /api/json?q=Minden |
Localization
The country field is translated when the lang parameter is set. Place names always stay in the national language because they are proper nouns. Without lang the caller's Accept-Language header decides. An unknown value is 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 | "10000" |
type | detected query type: postcode, prefix or place | "postcode" |
country | country, translatable via lang | "Germany" |
countryCode | country code per ISO 3166-1 | "BR" |
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
Each IP address may send 20 requests per 10 minutes. Every response reports the remaining requests in the X-Rl header and the seconds until the reset in X-Ttl. Once the limit is exceeded the interface answers with status 429 until the rate limit window is reset. Going over the limit in 5 consecutive windows results in a 3 minute ban.
{
"status": "fail",
"code": 1008,
"message": "rate limit exceeded, 20 requests per minute",
"query": "10000"
}
Error responses
| HTTP | Code | message | Cause |
|---|---|---|---|
| 401 | 1001 | missing api token | kein Token übergeben |
| 401 | 1002 | invalid api token | Token unbekannt oder ungültig |
| 400 | 1003 | missing or unknown country | Der Ländercode fehlt oder ist unbekannt. |
| 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 | usage limit reached, applies until the end of the window |
| 429 | 1008 | rate limit exceeded, 20 requests per minute | Grenze für Anfragen mit Token erreicht, gilt nur bis zum Ende der 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/br/10000 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.
