Consultar ciudad por código

Retorna información detallada de una ciudad incluyendo cobertura, puntos de entrega y horarios.

GET /ciudades/{codigo} v1.0.0
Ambiente
Servidor principal

Descripción

Retorna información detallada de una ciudad incluyendo cobertura, puntos de entrega y horarios.

Quick Start

  1. Obtén tus credenciales de acceso.
  2. Selecciona el ambiente y completa los parámetros requeridos.
  3. Envía la solicitud y procesa la respuesta.

Ejemplo rápido

Generando ejemplo…

Endpoint

GET /ciudades/{codigo}

Base URL https://api.coordinadora.com/v1

Parámetros

Nombre Tipo Requerido Descripción
codigo path string Código interno de la ciudad (ej. BOG, MED, CAL)

Respuesta

200
Ciudad encontrada
{
    "codigo": "BOG",
    "nombre": "Bogotá D.C.",
    "departamento": "Cundinamarca",
    "codigo_dane": "11001",
    "servicios": [
        "ENVIO",
        "RECOLECCION",
        "PUNTO_ENTREGA"
    ],
    "zona_horaria": "America/Bogota",
    "horario_recoleccion": {
        "lunes_viernes": "8:00 - 17:00",
        "sabado": "8:00 - 12:00",
        "domingo": "No disponible"
    },
    "puntos_entrega": [
        {
            "nombre": "Sede Calle 80",
            "direccion": "Calle 80 # 68-15",
            "horario": "Lun-Sab 8:00-18:00"
        },
        {
            "nombre": "Sede Chapinero",
            "direccion": "Carrera 13 # 67-24",
            "horario": "Lun-Sab 8:00-18:00"
        }
    ]
}

Ejemplo de respuesta

200 Ciudad encontrada
{
    "codigo": "BOG",
    "nombre": "Bogotá D.C.",
    "departamento": "Cundinamarca",
    "codigo_dane": "11001",
    "servicios": [
        "ENVIO",
        "RECOLECCION",
        "PUNTO_ENTREGA"
    ],
    "zona_horaria": "America/Bogota",
    "horario_recoleccion": {
        "lunes_viernes": "8:00 - 17:00",
        "sabado": "8:00 - 12:00",
        "domingo": "No disponible"
    },
    "puntos_entrega": [
        {
            "nombre": "Sede Calle 80",
            "direccion": "Calle 80 # 68-15",
            "horario": "Lun-Sab 8:00-18:00"
        },
        {
            "nombre": "Sede Chapinero",
            "direccion": "Carrera 13 # 67-24",
            "horario": "Lun-Sab 8:00-18:00"
        }
    ]
}

Errores

404
Ciudad no encontrada o sin cobertura