Kuenta Docs

Appearance

Listar ciudades por país​

GET
/countries/{countryCode}/cities

Obtiene las ciudades disponibles para un país específico. Permite filtros adicionales por nombre de ciudad. Útil para formularios que requieren selección de ubicación por país.

Authorizations​

bearerAuth

JWT token de autenticación. Utilice este esquema para autenticar solicitudes con un token JWT.

TypeHTTP (bearer)

Parameters​

Path Parameters

countryCode*

Código ISO Alpha-2 del país

Typestring
Required
ExampleCO
pattern^[A-Z]{2}$

Query Parameters

q

Término de búsqueda para filtrar ciudades por nombre (mínimo 3 caracteres)

Typestring
Examplemedell
minLength3

Responses​

Ciudades del país obtenidas exitosamente
application/json
JSON
{
"data": {
"cities": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Medellín",
"daneCode": 5001,
"lat": "6.2442",
"long": "-75.5812",
"state": {
"id": "123e4567-e89b-12d3-a456-426614174001",
"name": "Antioquia",
"daneCode": 5,
"countryAlpha2": "CO"
},
"province": {
"id": "123e4567-e89b-12d3-a456-426614174002",
"name": "Valle de Aburrá"
},
"population": 2533424,
"timezone": "America/Bogota",
"createdAt": "2024-01-15T10:30:00Z"
},
{
"id": "123e4567-e89b-12d3-a456-426614174003",
"name": "Bogotá",
"daneCode": 11001,
"lat": "4.6097",
"long": "-74.0817",
"state": {
"id": "123e4567-e89b-12d3-a456-426614174004",
"name": "Cundinamarca",
"daneCode": 11,
"countryAlpha2": "CO"
},
"province": {
"id": "123e4567-e89b-12d3-a456-426614174005",
"name": "Sabana Centro"
},
"population": 7181469,
"timezone": "America/Bogota",
"createdAt": "2024-01-15T10:30:00Z"
}
]
}
}

Playground​

Server
Authorization
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI