Zip Code Search Endpoint

On this page, we'll dive into the zip code search endpoint you can use to validate any given zip code and retrieve its location information.

This endpoint costs 1 credit per postal code found. For example, searching 5 codes that all exist = 5 credits, searching 10 codes where only 7 are found = 7 credits.

GET/v1/search

Search A Zip Code

This zip code search endpoint provides information about location information for the specified postal codes.

Required attributes

Name
codes
Type
string
Description
string. Comma-separated list of zip codes. Example: 99501,90210

Optional attributes

Name
country
Type
string
Description
Two letter country code. Example: us

Request

GET

/v1/search

curl -G https://api.zipcodestack.com/v1/search?codes=1010&country=AT \
    -H "apikey: YOUR-API-KEY"

Full Response

{
    "query": {
        "codes": [
        "1010"
        ],
        "country": "AT"
    },
    "results": {
        "1010": [
        {
            "postal_code": "1010",
            "country_code": "AT",
            "latitude": 48.2077,
            "longitude": 16.3705,
            "city": "Wien, Innere Stadt",
            "state": "Wien",
            "city_en": "Wien, Innere Stadt",
            "state_en": "Wien",
            "state_code": "09"
        }
    ]
    }
}