Menu

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 of the searched country.

Each returned postal code will consume 1 token.

Query Params

ParameterTypeDescription
apikeyrequired, tokenAuthentication key for the account
countryrequired, string or IDCountry ID, ISO code, or name
langoptional, langen (default). Expected language of the response
limitTokenoptional, number1000 (default). Maximum number of tokens you want to spend on this request

Example Response


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