> ## Documentation Index
> Fetch the complete documentation index at: https://api.csboard.com/llms.txt
> Use this file to discover all available pages before exploring further.
# GET /v1/orders/{id} — получение одного заказа
> Получите один заказ CSBoard по его order id, включая статус доставки по каждому предмету и сведения о трейд-офере Steam.
Получите один заказ по его CSBoard order id. Ответ включает полную разбивку по предметам со статусом доставки, причинами возврата и сведениями о трейд-офере Steam.
**Требуется аутентификация.** Отправьте ключ как `Authorization: Bearer csb_pub_...`.
## Path-параметры
CSBoard order id, например `ord_01J9Z3K8Q2`.
## Поля ответа
Ответ представляет собой один объект `Order`, имеющий ту же структуру, что и элементы в [`GET /v1/orders`](/api-reference/get-orders):
Одно из: `completed`, `hold`, `delivering`, `pending`, `cancelled`, `failed`.
Всегда `"USD"`.
Разбивка по предметам. Каждый предмет содержит `market_hash_name`, `price_usd`, `status` (`hold` | `delivering` | `delivered` | `returned`), `tradable_at`, `return_reason`, `steam_trade_offer_id` и `steam_trade_offer_finished_at`.
## Пример запроса
```bash theme={null}
curl https://csboard.com/v1/orders/ord_01J9Z3K8Q2 \
-H "Authorization: Bearer csb_pub_..."
```
## Пример ответа
```json theme={null}
{
"order_id": "ord_01J9Z3K8Q2",
"steam_id": "76561198000000000",
"status": "completed",
"custom_id": "batch-2026-06-29-01",
"currency": "USD",
"charged_total_usd": 26.47,
"item_count": 2,
"hold_until": null,
"created_at": "2026-06-29T17:12:04Z",
"updated_at": "2026-06-29T17:15:40Z",
"items": [
{
"market_hash_name": "AK-47 | Redline (Minimal Wear)",
"price_usd": 14.37,
"status": "delivered",
"tradable_at": "2026-07-06T12:00:00Z",
"return_reason": null,
"steam_trade_offer_id": "5512345678",
"steam_trade_offer_finished_at": "2026-06-29T17:15:40Z"
}
]
}
```
## Коды ошибок
| HTTP-статус | Код | Значение |
| ----------- | ------------------------------------- | ----------------------------------------------------------------------------- |
| 401 | `missing_api_key` / `invalid_api_key` | Отсутствует или некорректный API-ключ. |
| 404 | `order_not_found` | Заказ с таким id не найден. |
| 429 | `rate_limit_exceeded` | Слишком много запросов. Подождите время, указанное в заголовке `Retry-After`. |
## OpenAPI
````yaml GET /orders/{id}
openapi: 3.1.0
info:
title: CSBoard API
version: 1.0.0
description: >-
Market data over the CSBoard marketplace — live listings, floats, stickers,
minAsk prices, FX rates — plus opt-in buying straight from your balance.
Free to read, key-gated, built for automation.
contact:
name: CSBoard
url: https://csboard.com/docs
servers:
- url: https://csboard.com/v1
description: Production
security:
- bearerAuth: []
tags:
- name: Status
description: Liveness and freshness probes.
- name: Market data
description: Read the live catalog, prices, and FX rates.
- name: Trading
description: Buy listings from your CSBoard balance. Opt-in, key-gated.
- name: Account
description: Your balance, settled funds, and trading status.
paths:
/orders/{id}:
get:
tags:
- Trading
summary: Get a single order
description: >-
Fetch one order by its CSBoard order id, including per-item delivery
status.
operationId: getOrder
parameters:
- name: id
in: path
required: true
description: CSBoard order id.
schema:
type: string
responses:
'200':
description: The order.
content:
application/json:
schema:
$ref: '#/components/schemas/Order'
example:
order_id: ord_01J9Z3K8Q2
steam_id: '76561198000000000'
status: completed
custom_id: batch-2026-06-29-01
currency: USD
charged_total_usd: 26.47
item_count: 2
hold_until: null
created_at: '2026-06-29T17:12:04Z'
updated_at: '2026-06-29T17:15:40Z'
items:
- market_hash_name: AK-47 | Redline (Minimal Wear)
price_usd: 14.37
status: delivered
tradable_at: '2026-07-06T12:00:00Z'
return_reason: null
steam_trade_offer_id: '5512345678'
steam_trade_offer_finished_at: '2026-06-29T17:15:40Z'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
description: No order with that id.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
code: order_not_found
detail: No order found for that id.
'429':
$ref: '#/components/responses/RateLimited'
components:
schemas:
Order:
type: object
properties:
order_id:
type: string
steam_id:
type:
- string
- 'null'
status:
type: string
enum:
- completed
- hold
- delivering
- pending
- cancelled
- failed
custom_id:
type:
- string
- 'null'
description: Your own id, if you set one at purchase time.
currency:
type: string
example: USD
charged_total_usd:
type: number
item_count:
type: integer
hold_until:
type:
- string
- 'null'
format: date-time
created_at:
type: string
format: date-time
updated_at:
type:
- string
- 'null'
format: date-time
items:
type: array
items:
$ref: '#/components/schemas/OrderItem'
required:
- order_id
- status
- currency
- charged_total_usd
- item_count
- created_at
- items
Error:
type: object
description: >-
All errors return { code, detail }. Some carry extra fields (e.g.
price_moved adds current_total_usd, insufficient_balance adds
required_usd/current_usd).
properties:
code:
type: string
description: >-
Machine-readable error code, e.g. rate_limit_exceeded,
trading_not_enabled, price_moved.
detail:
type: string
description: Human-readable explanation.
required:
- code
OrderItem:
type: object
properties:
market_hash_name:
type:
- string
- 'null'
price_usd:
type:
- number
- 'null'
status:
type: string
enum:
- hold
- delivering
- delivered
- returned
tradable_at:
type:
- string
- 'null'
format: date-time
description: When the item leaves Steam trade hold, or null.
return_reason:
type:
- string
- 'null'
enum:
- trade_timeout
- declined
- expired
- rolled_back
- unavailable
- null
description: Why the item was returned, if its status is `returned`.
steam_trade_offer_id:
type:
- string
- 'null'
steam_trade_offer_finished_at:
type:
- string
- 'null'
format: date-time
required:
- status
responses:
Unauthorized:
description: Missing or invalid API key.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
code: unauthorized
message: Missing or invalid API key.
RateLimited:
description: Rate limit exceeded. Includes a Retry-After header.
headers:
Retry-After:
description: Seconds to wait before retrying.
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
code: rate_limit_exceeded
message: Too many requests.
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: >-
Send your key as a Bearer token on every request: `Authorization: Bearer
csb_pub_...`. Generate keys in your CSBoard profile.
````