> ## 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.

# List orders

> List the authenticated customer's orders with optional filters and cursor pagination.

Returns orders for the authenticated customer. Filter by scope (`store_id`, `channel_id`, `fulfillment_id`), `brand_id`, or `status`. Use this to resume an `OPEN` cart from a previous session, or to page through order history.

> [!NOTE]
>
> Requires a Storefront API access token from [Token
> exchange](https://firespark.cloud/docs/storefront-api/oauth/exchange/post.md). The token scopes requests to
> the authenticated customer and merchant.

## Query parameters

| Parameter | Required | Description |
| - | - | - |
| `store_id` | No | Filter by store external id. |
| `channel_id` | No | Filter by channel external id. |
| `fulfillment_id` | No | Filter by fulfillment external id. |
| `brand_id` | No | Filter by brand external id. |
| `status` | No | Filter by order status (for example `OPEN` to resume a cart). |
| `limit` | No | Page size. Default `20`, minimum `1`, maximum `100`. |
| `cursor` | No | `pagination.next_cursor` from a previous response (`created_at` ISO 8601). Omit on the first page. |

> [!TIP]
>
> To continue shopping from a past session, call with
> `status=OPEN&limit=1` and the same scope filters. The newest open order is
> returned first. Pass `pagination.next_cursor` as `cursor` to fetch older pages.

## Request

```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"
```

## Response

The response wraps a page of order objects in `data` and cursor metadata in `pagination`. Orders are newest first.

```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
  }
}
```

## Error responses

| Status | Description |
| - | - |
| `400` | Invalid query parameters |
| `401` | Missing or invalid access token |


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