GET /v1/orders/info — Batch Order Lookup

GET

orders

info

Batch order lookup

curl --request GET \
  --url https://csboard.com/v1/orders/info \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://csboard.com/v1/orders/info', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://csboard.com/v1/orders/info",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://csboard.com/v1/orders/info"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://csboard.com/v1/orders/info")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

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

{
  "code": "unauthorized",
  "message": "Missing or invalid API key."
}

{
  "code": "invalid_request",
  "detail": "Provide custom_ids and/or order_ids, up to 200 ids total."
}

{
  "code": "rate_limit_exceeded",
  "message": "Too many requests."
}

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

string

Comma-separated custom ids you assigned at purchase time.

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

Order[]

required

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

Polling this endpoint by custom_id is the cheapest way to follow a batch. An order that ends cancelled or failed has already been refunded — refund.amount_usd tells you how much came back and refund.refunded_at when.

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,
      "refund": null,
      "created_at": "2026-06-29T17:12:04Z",
      "updated_at": "2026-06-29T17:15:40Z",
      "items": []
    },
    {
      "order_id": "ord_01J9Z3M0F1",
      "steam_id": "76561198000000000",
      "status": "cancelled",
      "custom_id": "batch-2026-06-29-02",
      "currency": "USD",
      "charged_total_usd": 1.28,
      "item_count": 1,
      "hold_until": null,
      "refund": {
        "amount_usd": 1.28,
        "refunded_at": "2026-06-29T17:20:11Z",
        "partial": false
      },
      "created_at": "2026-06-29T17:20:10Z",
      "updated_at": "2026-06-29T17:20:11Z",
      "items": []
    }
  ]
}

Error codes

HTTP status	Code	Meaning
401	`missing_api_key` / `invalid_api_key`	Missing or invalid API key.
422	`invalid_request`	No ids supplied, or more than 200 ids in total.
429	`rate_limit_exceeded`	Too 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

Show child attributes

Batch order lookup

curl --request GET \
  --url https://csboard.com/v1/orders/info \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://csboard.com/v1/orders/info', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://csboard.com/v1/orders/info",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://csboard.com/v1/orders/info"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://csboard.com/v1/orders/info")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

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

{
  "code": "unauthorized",
  "message": "Missing or invalid API key."
}

{
  "code": "invalid_request",
  "detail": "Provide custom_ids and/or order_ids, up to 200 ids total."
}

{
  "code": "rate_limit_exceeded",
  "message": "Too many requests."
}

Market Data

Trading

Account

Webhooks

Status

GET /v1/orders/info — Batch Order Lookup

Query parameters

Response fields

Example request

Example response

Error codes

Authorizations

Query Parameters

Response

​Query parameters

​Response fields

​Example request

​Example response

​Error codes

Authorizations

Query Parameters

Response

Query parameters

Response fields

Example request

Example response

Error codes