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
  • 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
}