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.

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"
        }
    ]
    }
}