Saltar al contenido
Developer Docs

Búsqueda de ubicación

GET
/location/v1/locations

Resuelve una ubicación completa a partir de un país, estado, ciudad y código postal, devolviendo las cuatro
entidades normalizadas en una sola respuesta. Úsalo para validar una dirección sin recorrer la
jerarquía nivel a nivel; responde 404 cuando la combinación no existe.

Autorizaciones

OAuth2

Esquema de seguridad OAuth2

clientCredentials Flow
URL del token"/api/v2/auth/token"
Scopes:
  • "zertiban-api"Access to the API

Parámetros

Query Parameters

country*

Código de país ISO 3166 alpha-2.

Tipo
string
Requerido
Ejemplo"ES"
postal_code*

Código postal de la ciudad.

Tipo
string
Requerido
Ejemplo"33010"
state_code*

Código de estado, tal como lo devuelve el endpoint de lista de estados.

Tipo
string
Requerido
Ejemplo"ES-AS"
city_code*

Código de ciudad, tal como lo devuelve el endpoint de lista de ciudades.

Tipo
string
Requerido
Ejemplo"ES-AS-OV"

Respuestas

Información de la ubicación

application/json
JSON
{
  
"country": {
  
  
"code": "ES",
  
  
"name": "España"
  
},
  
"state": {
  
  
"code": "ES-AS",
  
  
"name": "Asturias"
  
},
  
"city": {
  
  
"code": "ES-AS-OV",
  
  
"name": "Oviedo"
  
},
  
"postalCode": {
  
  
"code": "33010"
  
}
}

Playground

Servidor
Autorización
Variables
Key
Value

Ejemplos