Listar pedidos - Fire spark

{
  "data": [
    {
      "id": "ord-48291",
      "store_id": "downtown",
      "channel_id": "app",
      "fulfillment_id": "delivery",
      "status": "OPEN",
      "payment_status": "IDLE",
      "fulfillment_status": "IDLE",
      "totals": {
        "currency": "USD",
        "subtotal": 12.99,
        "discount_total": 0,
        "tax_total": 1.95,
        "total": 14.94
      },
      "issued_at": null
    }
  ],
  "pagination": {
    "next_cursor": null,
    "prev_cursor": null
  }
}

Devuelve los pedidos del cliente autenticado. Filtra por scope (store_id, channel_id, fulfillment_id), brand_id o status. Úsalo para retomar un carrito OPEN de una sesión anterior, o para paginar el historial.

Requiere un access token de la API Storefront obtenido mediante intercambio de token. El token delimita al cliente y al merchant autenticados.

Parámetros de consulta

Parámetro	Requerido	Descripción
`store_id`	No	Filtrar por id externo de la tienda.
`channel_id`	No	Filtrar por id externo del canal.
`fulfillment_id`	No	Filtrar por id externo del fulfillment.
`brand_id`	No	Filtrar por id externo de marca.
`status`	No	Filtrar por estado del pedido (por ejemplo `OPEN` para retomar un carrito).
`limit`	No	Tamaño de página. Por defecto `20`, mínimo `1`, máximo `100`.
`cursor`	No	`pagination.next_cursor` de una respuesta anterior (`created_at` ISO 8601). Omítelo en la primera página.

Para continuar comprando desde una sesión pasada, llama con status=OPEN&limit=1 y los mismos filtros de scope. El pedido abierto más reciente sale primero. Pasa pagination.next_cursor como cursor para páginas anteriores.

Solicitud

curl "https://firespark.cloud/api/storefront/v1/orders?store_id=downtown&channel_id=app&fulfillment_id=delivery&status=OPEN&limit=1" \
  -H "Authorization: Bearer ACCESS_TOKEN"

Respuesta

La respuesta envuelve una página de pedidos en data y metadatos de cursor en pagination. Los pedidos van del más reciente al más antiguo.

{
  "data": [
    {
      "id": "ord-48291",
      "store_id": "downtown",
      "channel_id": "app",
      "fulfillment_id": "delivery",
      "status": "OPEN",
      "payment_status": "IDLE",
      "fulfillment_status": "IDLE",
      "totals": {
        "currency": "USD",
        "subtotal": 12.99,
        "discount_total": 0,
        "tax_total": 1.95,
        "total": 14.94
      },
      "issued_at": null
    }
  ],
  "pagination": {
    "next_cursor": null,
    "prev_cursor": null
  }
}

Errores

Estado	Descripción
`400`	Parámetros de consulta inválidos
`401`	Token ausente o inválido