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

> Retrieve a customer's order history for receipts, reorder, or support.

Returns orders placed by the authenticated customer. Use this endpoint for order history screens, support lookups, or reorder flows in your owned channel (app, web, kiosk).

<Note>
  Requires a Storefront API access token from [Token
  exchange](/docs/storefront-api/oauth/exchange/post). The token scopes requests to
  the authenticated customer and merchant.
</Note>

## Path parameters

| Parameter | Required | Description                                                                       |
| --------- | -------- | --------------------------------------------------------------------------------- |
| `id`      | Yes      | Customer identifier. Alphanumeric characters, `_`, and `-` only. 1–64 characters. |

## Query parameters

| Parameter | Required | Description                                                      |
| --------- | -------- | ---------------------------------------------------------------- |
| `from`    | No       | ISO 8601 datetime. Return orders created on or after this time.  |
| `to`      | No       | ISO 8601 datetime. Return orders created on or before this time. |

## Request

```bash theme={null}
curl "https://firespark.cloud/api/storefront/v1/customers/cust-001/orders?from=2026-06-01T00:00:00Z&to=2026-06-30T23:59:59Z" \
  -H "Authorization: Bearer ACCESS_TOKEN"
```

## Response

The response wraps an array of order objects in `data`, newest first.

<ResponseExample>
  ```json Success theme={null}
  {
    "data": [
      {
        "id": "ord-48291",
        "store_id": "downtown",
        "channel_id": "app",
        "fulfillment_id": "delivery",
        "fulfillment_type": "DELIVERY",
        "status": "COMPLETED",
        "payment_status": "PAID",
        "fulfillment_status": "DELIVERED",
        "totals": {
          "currency": "USD",
          "subtotal": 12.99,
          "discount_total": 0,
          "tax_total": 1.95,
          "total": 14.94
        },
        "issued_at": "2026-06-17T14:31:45.000Z"
      }
    ]
  }
  ```
</ResponseExample>

<Tip>
  For the full checkout flow from cart to Fire spark routing into the merchant
  POS, see [Placing orders](/docs/storefront-api/guides/placing-orders).
</Tip>

## Error responses

| Status | Description                     |
| ------ | ------------------------------- |
| `401`  | Missing or invalid access token |
| `404`  | Customer not found              |


## OpenAPI

````yaml GET /customers/{id}/orders
openapi: 3.0.1
info:
  title: Fire spark Storefront API
  description: Customer-facing channel endpoints for Fire spark.
  version: 1.0.0
servers:
  - url: https://firespark.cloud/api/storefront/v1
security:
  - bearerAuth: []
paths:
  /customers/{id}/orders:
    get:
      summary: List orders
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 64
            pattern: ^[a-zA-Z0-9_-]+$
          description: Customer identifier.
        - in: query
          name: from
          required: false
          schema:
            type: string
        - in: query
          name: to
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Order'
components:
  schemas:
    Order:
      type: object
      additionalProperties: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````