Get Provinces Endpoint

On this page, we'll dive into the provinces endpoint you can use to get a list of all states or provinces for a country.

This endpoint is free and does not consume any credits.

GET/v1/country/province

Get Country Provinces

This endpoint returns a list of all states or provinces available for a specified country in our database.

Required attributes

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

Request

GET

/v1/country/province

curl -G https://api.zipcodestack.com/v1/country/province?country=us \
    -H "apikey: YOUR-API-KEY"

Full Response

{
    "query": {
        "country": "us"
    },
    "results": [
        "Alaska",
        "Alabama",
        "Arkansas",
        "Arizona",
        "California",
        "Colorado",
        "..."
    ]
}