Перейти к основному содержанию
GET
/
orders
/
info
Batch order lookup
curl --request GET \
  --url https://csboard.com/v1/orders/info \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "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": []
    }
  ]
}
Используйте этот эндпоинт, чтобы за один вызов опросить статус сразу нескольких заказов. Передайте custom_ids (id, которые вы назначили при покупке) и/или order_ids (CSBoard order id) в виде списков через запятую. Нужно передать хотя бы один из двух параметров и в сумме не более 200 id. Требуется аутентификация. Отправьте ключ как Authorization: Bearer csb_pub_....

​
Query-параметры

​
custom_ids
string
Назначенные вами при покупке custom id через запятую.
​
order_ids
string
CSBoard order id через запятую.
Передайте хотя бы один из параметров custom_ids или order_ids. Суммарное количество id по обоим параметрам не должно превышать 200.

​
Поля ответа

​
data
Order[]
обязательно
Массив подходящих заказов. Каждый Order имеет ту же структуру, что и в GET /v1/orders — включая order_id, status, charged_total_usd и разбивку по предметам items.

​
Пример запроса

curl "https://csboard.com/v1/orders/info?custom_ids=batch-2026-06-29-01,batch-2026-06-29-02" \
  -H "Authorization: Bearer csb_pub_..."

​
Пример ответа

{
  "data": [
    {
      "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": []
    }
  ]
}

​
Коды ошибок

HTTP-статусКодЗначение
401missing_api_key / invalid_api_keyОтсутствует или некорректный API-ключ.
422invalid_requestНе передано ни одного id или в сумме передано более 200 id.
429rate_limit_exceededСлишком много запросов. Подождите время, указанное в заголовке Retry-After.

Авторизации

​
Authorization
string
header
обязательно

Send your key as a Bearer token on every request: Authorization: Bearer csb_pub_.... Generate keys in your CSBoard profile.

Параметры запроса

​
custom_ids
string

Comma-separated custom ids you assigned at purchase time.

​
order_ids
string

Comma-separated CSBoard order ids.

Ответ

Matching orders.

​
data
object[]
обязательно