Documentation

Country Data API provides detailed information about +200 different countries

HTTP GET

https://api.countrydataapi.com/v1/states

Returns all data of that state.

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
state	required, id or string	ID of the state or name of the state
limitToken	optional, number	1000 (default). Maximum number of tokens you want to spend on this request
type	optional, string	basic (default), normal, advanced
lang	optional, lang	en (default). Expected language of the response

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