跳转到主要内容
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 订单 id）。两者至少需提供一个，且两者总和不得超过 200 个 id。 需要身份验证。 请将密钥作为 Authorization: Bearer csb_pub_... 发送。

​
查询参数

​
custom_ids
string
以逗号分隔的、您在下单时分配的自定义 id。
​
order_ids
string
以逗号分隔的 CSBoard 订单 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_keyAPI 密钥缺失或无效。
422invalid_request未提供任何 id，或 id 总数超过 200。
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[]
必填