> ## Documentation Index
> Fetch the complete documentation index at: https://api.csboard.com/llms.txt
> Use this file to discover all available pages before exploring further.
# GET /v1/sell/orders/{id}: One Instant Sell Order
> Read one of your sell orders: every Steam trade offer, the status of each item, and how much has been credited so far.
One of your sell orders. A sale that ships as several trade offers is still one order: `offers[]` has an entry per offer, each with its own `status`, and `trade_offer_ids` lists every Steam offer the seller should expect.
Reads work for every key, even while Instant Sell is switched off.
**Authentication required.** Send your key as `Authorization: Bearer csb_pub_...`.
## Path parameters
The order `id` from [`POST /v1/sell/orders`](/api-reference/post-sell-orders).
## Response fields
The sell order, in the shape described on [`POST /v1/sell/orders`](/api-reference/post-sell-orders#response-fields).
Read the offers, not only the top-level `status`. When one offer of a split sale is declined and the others go through, the order keeps a non-final `status` while `credited_usd` and each offer's `status` show exactly what happened.
## Example request
```bash theme={null}
curl https://csboard.com/v1/sell/orders/cmgk2x9a10001qs01sell0001 \
-H "Authorization: Bearer csb_pub_..."
```
## Error codes
| HTTP status | Code | Meaning |
| - | - | - |
| 401 | `invalid_api_key` | Missing or invalid API key. |
| 404 | `order_not_found` | No such sell order on your account. |
## OpenAPI
````yaml GET /sell/orders/{id}
openapi: 3.1.0
info:
title: CSBoard API
version: 1.0.0
description: >-
Market data over the CSBoard marketplace — live listings, floats, stickers,
minAsk prices, FX rates — plus opt-in buying straight from your balance.
Free to read, key-gated, built for automation.
contact:
name: CSBoard
url: https://csboard.com/docs
servers:
- url: https://csboard.com/v1
description: Production
security:
- bearerAuth: []
tags:
- name: Status
description: Liveness and freshness probes.
- name: Market data
description: Read the live catalog, prices, and FX rates.
- name: Trading
description: Buy listings from your CSBoard balance. Opt-in, key-gated.
- name: Instant Sell
description: >-
Sell CS2, Dota 2 and Rust items from any Steam inventory to the CSBoard
network and get paid to your balance. Invite-only.
- name: P2P
description: >-
List your own CS2 skins on the CSBoard P2P market. Free — any valid key,
no balance requirement.
- name: Account
description: Your balance, settled funds, and trading status.
- name: Webhooks
description: Register an endpoint and receive signed order updates instead of polling.
paths:
/sell/orders/{id}:
get:
tags:
- Instant Sell
summary: Get a sell order
description: >-
One of your sell orders, with every trade offer and the status of each
item.
operationId: getSellOrder
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: The order.
content:
application/json:
schema:
$ref: '#/components/schemas/SellOrder'
example:
id: cmgk2x9a10001qs01sell0001
external_id: my-shop-order-1017
app_id: 730
status: offer_sent
currency: USD
total_usd: 61.42
credited_usd: 0
created_at: '2026-10-06T14:02:11Z'
unhold_at: null
trade_offer_ids:
- '7654321098'
- '7654321111'
offers:
- offer_group: a
trade_offer_id: '7654321098'
status: offer_sent
amount_usd: 48.3
expires_at: '2026-10-06T14:17:11Z'
items:
- asset_id: '41165110534'
market_hash_name: AK-47 | Redline (Field-Tested)
price_usd: 48.3
status: offer_sent
bot:
name: 'CSBoard Bot #4'
avatar: https://avatars.steamstatic.com/abc_full.jpg
steam_id: '76561199000000004'
profile_url: https://steamcommunity.com/profiles/76561199000000004
level: 30
- offer_group: b
trade_offer_id: '7654321111'
status: offer_sent
amount_usd: 13.12
expires_at: '2026-10-06T14:17:40Z'
items:
- asset_id: '41165110599'
market_hash_name: Glock-18 | Water Elemental (Minimal Wear)
price_usd: 13.12
status: offer_sent
bot:
name: 'CSBoard Bot #9'
avatar: https://avatars.steamstatic.com/def_full.jpg
steam_id: '76561199000000009'
profile_url: https://steamcommunity.com/profiles/76561199000000009
level: 24
fail_reason: null
'401':
$ref: '#/components/responses/Unauthorized'
'404':
description: No such sell order on this account.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
code: order_not_found
detail: No such sell order on this account.
components:
schemas:
SellOrder:
type: object
required:
- id
- app_id
- status
- currency
- total_usd
- credited_usd
- created_at
- trade_offer_ids
- offers
properties:
id:
type: string
external_id:
type:
- string
- 'null'
app_id:
type: integer
description: 'Steam app of the sale: `730`, `570` or `252490`.'
status:
type: string
enum:
- pending
- offer_sent
- received
- completed
- cancelled
- failed
currency:
type: string
enum:
- USD
total_usd:
type: number
description: What the whole order books, in USD.
credited_usd:
type: number
description: What has already reached your balance. Grows offer by offer.
created_at:
type: string
format: date-time
unhold_at:
type:
- string
- 'null'
format: date-time
description: Latest expected credit time across the offers, once known.
trade_offer_ids:
type: array
items:
type: string
description: >-
Every Steam trade offer the seller should expect. Offers that never
went out are not listed.
offers:
type: array
items:
$ref: '#/components/schemas/SellOffer'
fail_reason:
type:
- string
- 'null'
description: >-
`cancelled_by_merchant`, `offer_declined`, `offer_expired`,
`invalid_trade_url`, `item_not_tradable`, `reversed`, `price_drift`
or `failed`.
Error:
type: object
description: >-
All errors return { code, detail }. Some carry extra fields (e.g.
price_moved adds current_total_usd, insufficient_balance adds
required_usd/current_usd).
properties:
code:
type: string
description: >-
Machine-readable error code, e.g. rate_limit_exceeded,
trading_not_enabled, price_moved.
detail:
type: string
description: Human-readable explanation.
required:
- code
SellOffer:
type: object
properties:
offer_group:
type: string
description: >-
`a`, `b`, and so on, in the order the offers were created. Matches
the quote's `offer_group` when you sell the whole quoted inventory.
trade_offer_id:
type:
- string
- 'null'
description: Steam trade offer id, once the offer exists.
status:
type: string
enum:
- pending
- offer_sent
- received
- completed
- cancelled
- failed
amount_usd:
type: number
description: What this offer books, in USD.
expires_at:
type:
- string
- 'null'
format: date-time
items:
type: array
items:
$ref: '#/components/schemas/SellOrderItem'
bot:
$ref: '#/components/schemas/SellBot'
SellOrderItem:
type: object
properties:
asset_id:
type:
- string
- 'null'
market_hash_name:
type:
- string
- 'null'
price_usd:
type:
- number
- 'null'
description: What this item books, in USD.
status:
type: string
enum:
- pending
- offer_sent
- received
- completed
- cancelled
- failed
description: The status of the offer this item rides in.
SellBot:
type:
- object
- 'null'
description: >-
The Steam account sending this offer. Show it to the seller so they can
check the incoming offer.
properties:
name:
type:
- string
- 'null'
avatar:
type:
- string
- 'null'
steam_id:
type:
- string
- 'null'
profile_url:
type:
- string
- 'null'
level:
type:
- integer
- 'null'
responses:
Unauthorized:
description: Missing or invalid API key (`missing_api_key` or `invalid_api_key`).
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
code: missing_api_key
detail: >-
Provide your API key via `Authorization: Bearer csb_pub_…`.
Generate one at https://csboard.com/profile?tab=api
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: >-
Send your key as a Bearer token on every request: `Authorization: Bearer
csb_pub_...`. Generate keys in your CSBoard profile.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.