Documentation

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.

There are 3 types of operations:

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

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

• ADVANCED: Returns the field state_zip_codes [All zip codes of the cities]. Each zip code will consume 1 token.

Query Params

Parameter	Type	Description
apikey	required, token	Authentication key for the account
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
type	optional, string	basic (default), normal, advanced

Example 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,
              ...
          ]
        }
      ]