Get country states

GET /countries/{countryCode}/states

Get all states/districts for country

Path parameters

countryCode string Required

ISO-3166 Alpha2 or Alpha3 code for country

Responses

200 application/json

List of states in the specified country
Hide response attributes Show response attributes object
- result array[object]
  
  Hide result attributes Show result attributes object
  
  AK string
  
  AL string
  
  AR string
  
  CA string
  
  CO string
- count integer
  
  How many results returned
- time_taken_ms number
  
  Request Processing time in ms
404

Country not found
422

No or empty country/query specified
403

API key is missing or invalid
429

[FREE PLANS ONLY] Request Quota Exceeded

GET /countries/{countryCode}/states

curl \
 -X GET https://api.tellusdb.com/v1/countries/US/states?token=api_token_value

Response examples (200)

{
  "result": [
    {
      "AK": "Alaska",
      "AL": "Alabama",
      "AR": "Arkansas",
      "CA": "California",
      "CO": "Colorado"
    }
  ],
  "count": 5,
  "time_taken_ms": 1.3892211
}