Skip to main content
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": []
    }
  ]
}
Use this endpoint to poll the status of many orders in one call. Supply custom_ids (the ids you assigned at purchase time) and/or order_ids (CSBoard order ids) as comma-separated lists. You must provide at least one of the two, and no more than 200 ids in total across both. Authentication required. Send your key as Authorization: Bearer csb_pub_....

​
Query parameters

​
custom_ids
string
Comma-separated custom ids you assigned at purchase time.
​
order_ids
string
Comma-separated CSBoard order ids.
Provide at least one of custom_ids or order_ids. The combined total across both parameters must not exceed 200 ids.

​
Response fields

​
data
Order[]
required
Array of matching orders. Each Order has the same shape as in GET /v1/orders — including order_id, status, charged_total_usd, and the per-item items breakdown.

​
Example request

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

​
Example response

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

​
Error codes

HTTP statusCodeMeaning
401missing_api_key / invalid_api_keyMissing or invalid API key.
422invalid_requestNo ids supplied, or more than 200 ids in total.
429rate_limit_exceededToo many requests. Back off for the Retry-After header value.

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
custom_ids
string

Comma-separated custom ids you assigned at purchase time.

​
order_ids
string

Comma-separated CSBoard order ids.

Response

Matching orders.

​
data
object[]
required