List orders - 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
  }
}

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.

Requires a Storefront API access token from Token exchange. 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.

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

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.

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