Documentación

Buscar estados segun su codigo postal

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

HTTP GET

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

Retorna una lista de todos los stados segun su codigo postal

Información relevante

Ten en cuenta que hay muchos estados de diferentes paises que tienen codigos postales iguales

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
zipcode required, string Codigo postal del estado que se desea
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,
              ...
          ]
        }
      ]