APIActualizado: Agosto 2026

API — Pedidos

Consulta los pedidos de tu restaurante o tienda desde un sistema externo (POS, cocina, panel propio).

Nota

Este endpoint es de solo lectura. Los pedidos se crean por WhatsApp con el agente o desde el panel — la API pública sirve para que un sistema externo se entere de ellos, no para crearlos.

Endpoint

GET/api/v1/pedidos

Lista los pedidos del negocio, del más reciente al más antiguo.

Parámetros de consulta

Parámetro	Tipo	Descripción
`estado`	string	Filtra por estado exacto del pedido (opcional)
`limit`	número	Máximo de resultados, de 1 a 100. Default 50.

Response

json

{
  "pedidos": [
    {
      "id": "…",
      "items": [ /* items del pedido, tal como se guardaron */ ],
      "total": "300.00",
      "tipo": "domicilio",
      "direccion": "Av. Insurgentes 1234, Del Valle",
      "notas": null,
      "estado": "recibido",
      "clienteNombre": "Carlos López",
      "clienteTelefono": "+525598765432",
      "creadoEl": "2026-08-15T19:00:00.000Z"
    }
  ]
}

Ejemplo

bash

curl "https://app.xambee.com/api/v1/pedidos?estado=recibido&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).