Documentation

All data from a state

Country Data API provides detailed information about +200 different countries

HTTP GET

https://api.countrydataapi.com/v1/state/all

Returns a list of all states

According to the requested fields, there will be 3 types of requests:

  • BASIC: Returns the fields id, state_name, lang Each state will cost 1 token

  • NORMAL: Returns the field state_cities [All IDs and names of cities in the state] Each city will cost 1 token

  • ADVANCED: Returns the field state_zip_codes [All postal codes of the city] Each postal code costs 1 token

Query Params

Parameter Type Description
apikey required, token Account authentication key
lang optional, lang en (default). Expected language of the response
limitToken optional, number 1000 (default). Maximum number of tokens you want to spend on this request
limitStates optional, number 10 (default). Maximum number of states you want to return
fields optional, string id,lang,state_name (default). Expected fields in the response

Sample Response

[
  {
    "id": "8dd25479-067a-43b0-ac4a-8e7faf2bcafb",
    "state_name":"Takhar",
    "lang":"en",
    "state_cities":[
      {
        id: "8dd25476-067a-43b0-ac4b-8e7faf2bcbfb",
        "city_name":"City",
      }
      ...
    ],
    "state_zip_codes": [
      00000,
      000001,
      ...
    ]
  }
]