Documentation

Search postal codes by region

Country Data API provides detailed information about +200 different countries

HTTP GET

https://api.countrydataapi.com/v1/zipcodes/region

Returns a list of all postal codes from a region

Each returned postal code will cost 1 token

Query Params

Parameter Type Description
apikey required, token Account authentication key
region required, string Name of the region being searched. Ex: "Africa"
lang optional, lang en (default). Expected language of the response
limitToken optional, number 1000 (default). Maximum number of tokens you want to spend on this request

Sample Response

[
    {
      "id":"8dd25479-067a-43b0-ac4a-8e7faf2bcaf",
      "country_name":"Algeria",
      "state_names": [
        {
          id: "8dd25479-067a-43b0-ac4a-8e7faf2bcad",
          name: "Oran",
          postal_code: [
            "31004",
            "31016",
            "31019",
            "31020",
            ...
          ]
        }
      ]
    }
]