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

# Get order fulfillment

> Read the fulfillment snapshot and annotated workflow for a closed order.

Returns the `order_fulfillments` row for the authenticated customer when the order is no longer `OPEN`. Use this to render visited states and milestone progress.

> [!NOTE]
>
> Requires a Storefront API access token from [Token
> exchange](https://firespark.cloud/docs/storefront-api/oauth/exchange/post.md).

## Path parameters

| Parameter | Required | Description |
| - | - | - |
| `id` | Yes | External order identifier |

## Request

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

## Response

The response wraps the fulfillment row in `data`, including `current_node_ids` (the walker frontier; more than one id after a fork), `checkout_state` (`pending` | `released` | `failed`), `error`, and `workflow` with `entered_at` / `exited_at` on visited nodes and `taken_at` on edges. See [Fulfillment workflows](https://firespark.cloud/docs/guides/fulfillment-workflows.md).

## Error responses

| Status | Description |
| - | - |
| `401` | Missing or invalid access token |
| `404` | Order is still `OPEN`, missing, or has no fulfillment row |


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