APIActualizado: Agosto 2026

API — Reservas

Consulta las reservas de hospedaje de tu negocio desde un sistema externo (PMS, panel propio).

Nota

Este endpoint es de solo lectura. Las reservas se crean por WhatsApp con el agente o desde el panel — la API pública sirve para que un sistema externo se entere de ellas, no para crearlas. Para sincronizar un calendario externo de disponibilidad, ve a Conexiones (Google Calendar, Outlook).

Endpoint

GET/api/v1/reservas

Lista las reservas 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 reserva (opcional)
`limit`	número	Máximo de resultados, de 1 a 100. Default 50.

Response

json

{
  "reservas": [
    {
      "id": "…",
      "servicioId": "…",
      "clienteNombre": "Roberto Torres",
      "clienteTelefono": "+525534567890",
      "fechaEntrada": "2026-08-20T00:00:00.000Z",
      "fechaSalida": "2026-08-23T00:00:00.000Z",
      "personas": 2,
      "estado": "pendiente_admin",
      "pagoConfirmado": false,
      "notas": null,
      "creadoEl": "2026-08-15T20:00:00.000Z"
    }
  ]
}

Las fechas son inclusivas en la entrada y exclusivas en la salida — ver Reservas para el detalle de cómo se cuentan las noches.

Ejemplo

bash

curl "https://app.xambee.com/api/v1/reservas?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).