Consultar disponibilidad de agenda

Retorna los días y franjas horarias disponibles para recolección en una ciudad.

GET /recolecciones/agenda v1.0.0
Autenticación
API Key
Ambiente
Servidor principal

Descripción

Retorna los días y franjas horarias disponibles para recolección en una ciudad.

Quick Start

  1. Obtén tus credenciales de acceso (API Key).
  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 /recolecciones/agenda

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

Parámetros

Nombre Tipo Requerido Descripción
ciudad query string Sí Código DANE de la ciudad
fecha_desde query string Sí
fecha_hasta query string No

Respuesta

200
Agenda disponible
[
    {
        "fecha": "2026-05-27",
        "franjas": [
            {
                "codigo": "AM",
                "descripcion": "8:00 AM - 12:00 PM",
                "disponible": true,
                "cupos_restantes": 15
            },
            {
                "codigo": "PM",
                "descripcion": "1:00 PM - 5:00 PM",
                "disponible": false,
                "cupos_restantes": 0
            }
        ]
    },
    {
        "fecha": "2026-05-28",
        "franjas": [
            {
                "codigo": "AM",
                "disponible": true,
                "cupos_restantes": 8
            },
            {
                "codigo": "PM",
                "disponible": true,
                "cupos_restantes": 12
            }
        ]
    }
]

Ejemplo de respuesta

200 Agenda disponible 
[
    {
        "fecha": "2026-05-27",
        "franjas": [
            {
                "codigo": "AM",
                "descripcion": "8:00 AM - 12:00 PM",
                "disponible": true,
                "cupos_restantes": 15
            },
            {
                "codigo": "PM",
                "descripcion": "1:00 PM - 5:00 PM",
                "disponible": false,
                "cupos_restantes": 0
            }
        ]
    },
    {
        "fecha": "2026-05-28",
        "franjas": [
            {
                "codigo": "AM",
                "disponible": true,
                "cupos_restantes": 8
            },
            {
                "codigo": "PM",
                "disponible": true,
                "cupos_restantes": 12
            }
        ]
    }
]

Errores

400
Parámetros inválidos
422
Ciudad sin cobertura