Documentación

Buscar estados segun su país

Country Data API proporciona información detallada sobre +200 paises diferentes

HTTP GET

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

Retorna el estado que tenga ese país.

Algunos ejemplos de la estructura

Pais: EEUU, Estado: Colorado, Ciudad: Denver

Pais: España, Estado: Comunidad Valenciana, Ciudad: Valencia

Segun los campos que se soliciten habrá 3 tipos de peticiones:

  • BASIC: Se retornan los campos id, state_name, lang Cada estado garstará 1 token

  • NORMAL: Se retorna el campo state_cities [Todos los id y nombre de las ciudades del estado] Cada ciudad gastará 1 token

  • ADVANCED: Se retorna el campo state_zip_codes [Todos los códigos postales de la ciudad] Cada codigo postal 1 token

Query Params


Parametro Tipo Descripción
apikey required, token Clave de autentificación de la cuenta
country required, string Nombre del país del que se desea los estados
limitToken opcional, number 1000 (default). Numero máximo de tokens que quieres gastar en esta petición
fields opcional, string id,lang,state_name (default). Campos esperados en la respuesta
lang opcional, lang en (default). Lenguaje esperado de la respuesta

Ejemplo de respuesta


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