Menu

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 in a region.

Each returned postal code will consume 1 token.

Query Params

ParameterTypeDescription
apikeyrequired, tokenAuthentication key for the account
regionrequired, stringName of the region being searched. Eg: “Africa”
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",
                ...
              ]
            }
          ]
        }
    ]