Skip to main content
GET
/
listings
/
availability
Bulk availability check
curl --request GET \
  --url https://csboard.com/v1/listings/availability \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "available": {
      "itm_8841201": 1,
      "itm_8841340": 3
    },
    "unavailable_ids": [
      "itm_8841999"
    ]
  }
}
Before placing a batch order, confirm the listings you intend to buy are still available. Pass up to 100 listing ids as a comma-separated ids parameter; the response tells you how many of each id are currently available and which ids are gone. Authentication required. Send your key as Authorization: Bearer csb_pub_....

​
Query parameters

​
ids
string
required
Comma-separated listing ids, e.g. itm_8841201,itm_8841340. Required. Maximum 100 ids per request.

​
Response fields

​
data
object
required

​
Example request

curl "https://csboard.com/v1/listings/availability?ids=itm_8841201,itm_8841340,itm_8841999" \
  -H "Authorization: Bearer csb_pub_..."

​
Example response

{
  "data": {
    "available": {
      "itm_8841201": 1,
      "itm_8841340": 3
    },
    "unavailable_ids": ["itm_8841999"]
  }
}

​
Error codes

HTTP statusCodeMeaning
401missing_api_key / invalid_api_keyMissing or invalid API key.
422invalid_requestids was omitted, or more than 100 ids were supplied.
429rate_limit_exceededToo many requests. Back off for the Retry-After header value.
Availability is a point-in-time snapshot. An id reported as available can still sell out before your purchase executes — always send max_price_usd and handle item_unavailable on the buy call.

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

​
ids
string
required

Comma-separated listing ids. Required. Maximum 100 ids per request.

Response

Availability map for the requested ids.

​
data
object
required