APIActualizado: Agosto 2026

API — Mesas

Consulta las reservas de mesa de tu restaurante desde un sistema externo (por ejemplo, tu TPV, para saber a quién esperar esta noche).

Nota

Este endpoint es de solo lectura y lista las reservas de mesa, no el catálogo de mesas del salón (eso se configura en el panel y cambia con poca frecuencia).

Endpoint

GET/api/v1/mesas

Lista las reservas de mesa del negocio, ordenadas por fecha de la reservación (no por fecha de creación).

Parámetros de consulta

Parámetro	Tipo	Descripción
`estado`	string	Filtra por estado exacto de la reserva (opcional)
`desde`	YYYY-MM-DD	Solo reservas a partir de esta fecha (opcional)
`hasta`	YYYY-MM-DD	Solo reservas hasta esta fecha (opcional)
`limit`	número	Máximo de resultados, de 1 a 100. Default 50.

Una fecha con formato inválido se ignora en vez de rechazar la petición completa.

Response

json

{
  "mesas": [
    {
      "id": "…",
      "clienteNombre": "Familia Pérez",
      "clienteTelefono": "+525511122233",
      "fechaInicio": "2026-08-20T21:00:00.000Z",
      "fechaFin": "2026-08-20T22:30:00.000Z",
      "personas": 4,
      "zonaSolicitada": "terraza",
      "mesa": "Mesa 7",
      "zona": "terraza",
      "estado": "confirmada",
      "notas": null,
      "creadoEl": "2026-08-15T16:00:00.000Z"
    }
  ]
}

Ejemplo

bash

curl "https://app.xambee.com/api/v1/mesas?desde=2026-08-20&hasta=2026-08-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).