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

`GET /v1/order-items/{id}`

Gets an order item: what was bought, its delivery, its refund and what you can do next.

Requires the `read` order permission. Returns the item exactly as it appears in `items[]` of the
order response, including `orderId`, the order it belongs to. `fulfillment.status` and
`refund.status` give its state; `actions.cancellation` says whether it can be cancelled now,
`actions.amendment` whether it can be amended and `actions.update` whether it can be updated. An
item of another partner, or an unknown id, returns
`404` with code `10004`; a malformed id or an unknown query parameter returns `400` with code
`10001`.

## Parameters

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

## Responses

### 200

OK

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

### 400

Invalid partner request or model validation failure.

- `application/json`: `ErrorResponse`

### 401

Unauthorized

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

### 403

Forbidden

- `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`

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