> ## Documentation Index
> Fetch the complete documentation index at: https://firespark.cloud/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar pedidos

> Lista los pedidos del cliente autenticado con filtros opcionales y paginación por cursor.

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.

> [!NOTE]
>
> Requiere un access token de la API Storefront obtenido mediante [intercambio de
> token](https://firespark.cloud/docs/es/storefront-api/oauth/exchange/post.md). 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. |

> [!TIP]
>
> 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

```bash theme={null}
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.

```json Success theme={null}
{
  "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 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.