# Get an order (/docs/api-reference/orders/get-by-id)

`GET /v1/orders/{id}`

Gets the current state of one order.

Returns the same shape as order creation: `id`, `referenceId`, `origin`, `status`,
`total`, `payment`, `items`, `timeline`, `createdAt`, `updatedAt` and
`fulfillmentVersion`. This is the source of truth for the order: webhooks are snapshots of an event, so
read the order again after a missed or out-of-order delivery. `updatedAt` moves whenever anything in
the order changes: its status, an item's fulfillment, a refund or an amendment.
            
Order `status` is `processing` from the moment the wallet is charged until every item has an
outcome, then `completed` (every item fulfilled), `partiallyFulfilled` (some items fulfilled,
the rest rejected) or `fulfillmentFailed` (no item fulfilled). Cancelling delivered items makes it
`partiallyRefunded` (some delivered items cancelled and refunded) or `refunded` (every delivered
item cancelled and refunded). Every order's `timeline` starts with `paymentPending`. An order
reads `paymentPending` as its status while a dashboard order awaits its payment, and, rarely, when a
wallet charge was taken but could not be confirmed. Sending the order request again with the same
`Idempotency-Key` and body completes such an order from that charge, and OpenRoam also completes it
automatically, usually within two hours; the wallet is never charged twice. `cancelled` is
an unpaid order that expired. A rejected item is refunded automatically when
nothing is held for it; its `refund` shows the release. Each item reports its own
`fulfillment.status`: `pending`, `fulfilled` with a typed `result`, or
`rejected` with a safe `failure` (`11001`, `FULFILLMENT_REJECTED`).
`items[].actions` say whether amendment, cancellation and update are available now.
            
An order of another partner, or an unknown id, returns `404` with code `10004`.

## Parameters

| Name | In | Required | Type | Description |
|---|---|---|---|---|
| `id` | path | yes | `string` | Order id (`id` from the order response). |

## Responses

### 200

OK

- `text/plain`: `Order`
- `application/json`: `Order`
- `text/json`: `Order`

### 400

Invalid partner request or model validation failure.

- `application/json`: `ErrorResponse`

### 401

Unauthorized

- `text/plain`: `ErrorResponse`
- `application/json`: `ErrorResponse`
- `text/json`: `ErrorResponse`

### 404

Not Found

- `text/plain`: `ErrorResponse`
- `application/json`: `ErrorResponse`
- `text/json`: `ErrorResponse`

### 429

Too many requests from this IP address. Wait for Retry-After seconds, then send the same request again; an order keeps its Idempotency-Key and body.

- `application/json`: `ErrorResponse`

### 500

Internal Server Error

- `text/plain`: `ErrorResponse`
- `application/json`: `ErrorResponse`
- `text/json`: `ErrorResponse`

The full schemas are in the OpenAPI specification at /openapi.json.