Documentation

Search postal codes by country

Country Data API provides detailed information about +200 different countries

HTTP GET

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

Returns all postal codes from the searched country

Each returned postal code will cost 1 token

Query Params

Parameter Type Description
apikey required, token Account authentication key
country required, string or ID Country ID, ISO code or name
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",
            ...
          ]
        }
      ]
    }
]