APIActualizado: Agosto 2026

API — Citas

Consulta las citas de tu negocio desde un sistema externo (ERP, dashboard propio, hoja de cálculo sincronizada).

Nota

Este endpoint es de solo lectura. La API pública sirve para que un sistema externo consulte lo que ya pasó por Xambee — crear, mover o cancelar una cita sigue haciéndose desde el panel o por WhatsApp con el agente.

Endpoint

GET/api/v1/citas

Lista las citas del negocio, de la más reciente a la más antigua.

Parámetros de consulta

Parámetro	Tipo	Descripción
`estado`	string	Filtra por estado exacto de la cita (opcional)
`desde`	ISO 8601	Solo citas cuya fecha de inicio sea igual o posterior (opcional)
`limit`	número	Máximo de resultados, de 1 a 100. Default 50.

Response

json

{
  "citas": [
    {
      "id": "…",
      "servicioId": "…",
      "clienteNombre": "María García",
      "clienteTelefono": "+525512345678",
      "fechaInicio": "2026-08-20T10:00:00.000Z",
      "fechaFin": "2026-08-20T10:45:00.000Z",
      "estado": "confirmada",
      "notas": null,
      "pagoConfirmado": false,
      "creadoEl": "2026-08-15T18:30:00.000Z"
    }
  ]
}

Ejemplo

bash

curl "https://app.xambee.com/api/v1/citas?estado=confirmada&limit=20" \
  -H "Authorization: Bearer xmb_live_tu_api_key"

Ver Autenticación para el formato de la API Key y los errores comunes (401, 429).