Documentation

Country Data API provides detailed information about +200 different countries

HTTP GET

https://api.countrydataapi.com/v1/countries/city

Returns the state that contains the specified city.

Some examples of the structure

Country: USA, State: Colorado, City: Denver

Country: Spain, State: Valencian Community, City: Valencia

Relevant Information

Keep in mind that there are many cities with the same name.

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 city]. Each zip code will consume 1 token.

Query Params

Parameter	Type	Description
apikey	required, token	Authentication key for the account
city	required, string	Name of the city that is located in 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,
              ...
          ]
        }
      ]