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

# Obtener pedido

> Consulta un pedido del cliente por id externo.

Devuelve un pedido del cliente autenticado. Usa este endpoint para detalle, seguimiento de estado o confirmación post-checkout.

> [!NOTE]
>
> Requiere un access token de la API Storefront obtenido mediante [intercambio de
> token](https://firespark.cloud/docs/es/storefront-api/oauth/exchange/post.md).

## Parámetros de ruta

| Parámetro | Requerido | Descripción |
| - | - | - |
| `id` | Sí | Identificador externo del pedido |

## Solicitud

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

La respuesta envuelve el pedido en `data`, con `lines`, `customer`, `payment_intents`, `totals` y los estados.

| Campo | Descripción |
| - | - |
| `status` | `OPEN`, `CLOSED`, `COMPLETED`, `VOIDED`, `REVERSED`, `REFUNDED` o `CANCELLED` (legado; las cancelaciones nuevas escriben `VOIDED`) |
| `payment_status` | `IDLE`, `PENDING`, `PAID`, `FAILED`, `CANCELLED` o `REFUNDED`. Se deriva de los tenders vivos. |
| `payment_intents` | Intents del pedido. Cada uno tiene `status` (`DRAFT`, `LOCKED`, `COMPLETED`, `ABANDONED`), `is_mixed`, `primary_tender_id`, `totals` y `tenders[]`. Un tender tiene `method`, `provider`, `collect_at`, `status`, `amount`, `allocation` y `details`. |
| `metadata.reopen` | Tras [reabrir](https://firespark.cloud/docs/es/storefront-api/orders/\[id]/reopen/post): `as_order_id` es el reemplazo de este pedido, `from_order_id` es el pedido que este reemplazó. Pueden estar los dos en una cadena. |
| `fulfillment_status` | Progreso de cocina y entrega (`PREPARING`, `PREPARED`, `DELIVERING`, `DELIVERED`, …) |

## Errores

| Estado | Descripción |
| - | - |
| `401` | Token ausente o inválido |
| `404` | Pedido no encontrado |


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