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

> Load fulfillment snapshots for up to 20 closed orders in one request.

Returns `order_fulfillments` rows the authenticated customer owns. Use this on order history instead of calling [Get order fulfillment](https://firespark.cloud/docs/storefront-api/orders/\[id]/fulfillment/get) once per order.

> [!NOTE]
>
> Requires a Storefront API access token from [Token
> exchange](https://firespark.cloud/docs/storefront-api/oauth/exchange/post.md). Only closed orders for the
> authenticated customer are returned. Missing or still-`OPEN` ids are omitted.

## Query parameters

| Parameter | Required | Description |
| - | - | - |
| `ids` | Yes | Comma-separated order ids. 1–20 ids. |

## Request

```bash theme={null}
curl "https://firespark.cloud/api/storefront/v1/orders/fulfillments?ids=ord-48291,ord-48292" \
  -H "Authorization: Bearer ACCESS_TOKEN"
```

## Response

The response wraps an array of fulfillment rows in `data`. Each row includes `order_id`, `current_node_ids`, and the annotated `workflow`.

In `@fire-spark/storefront`, call `services.orders.listFulfillments(ids)`. The SDK chunks batches larger than 20.

## Error responses

| Status | Description |
| - | - |
| `400` | Missing `ids` or more than 20 ids |
| `401` | Missing or invalid access token |


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