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

# Listar fulfillments de pedidos

> Carga snapshots de fulfillment de hasta 20 pedidos cerrados en una sola petición.

Devuelve filas de `order_fulfillments` del cliente autenticado. Úsalo en el historial en lugar de llamar [Obtener fulfillment](https://firespark.cloud/docs/es/storefront-api/orders/\[id]/fulfillment/get) una vez por pedido.

> [!NOTE]
>
> Requiere un access token de Storefront API de [Intercambio de
> token](https://firespark.cloud/docs/es/storefront-api/oauth/exchange/post.md). Solo se devuelven pedidos
> cerrados del cliente autenticado. Los ids que faltan o siguen `OPEN` se
> omiten.

## Parámetros de consulta

| Parámetro | Requerido | Descripción |
| - | - | - |
| `ids` | Sí | Ids de pedido separados por coma. 1–20 ids. |

## Solicitud

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

## Respuesta

La respuesta envuelve un array de filas en `data`. Cada fila incluye `order_id`, `current_node_ids` y el `workflow` anotado.

En `@fire-spark/storefront`, llama `services.orders.listFulfillments(ids)`. El SDK parte lotes de más de 20.

## Errores

| Estado | Descripción |
| - | - |
| `400` | Falta `ids` o hay más de 20 ids |
| `401` | Token ausente o inválido |


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