Skip to main content
POST
Cancel an undelivered order
Some orders are delivered by hand: a person (or a slow desk) sends the Steam trade, and that can take up to 12 hours. Such an order shows delivery_type: "manual" in GET /v1/orders and GET /v1/orders/{id}, and it may sit in delivering with no trade offer for a long time. delivery_deadline_at tells you when the seller’s time runs out. If the seller misses it, the order is cancelled and refunded automatically. If you no longer want to wait, cancel the order yourself. No request body. Cancel is open for:
  • A manual-delivery order whose seller has sent nothing 31 minutes after purchase.
  • A held order before its unban, where the source allows it.
  • Any other order still undelivered 15 minutes after purchase, with no trade offer and nothing in flight upstream.
A player’s (P2P) lot cannot be cancelled here. It closes and refunds itself if the seller misses delivery_deadline_at.
  1. Place a buy with POST /v1/orders or POST /v1/market/buy.
  2. Poll GET /v1/orders/{id} (or listen for the order.updated webhook). Read delivery_type and delivery_deadline_at.
  3. If a manual order still has no trade offer and you no longer want it, POST /v1/orders/{id}/cancel once 31 minutes have passed.
  4. On 425 too_early, retry after retry_after_sec. On 200, the money is back on your balance. On 202, it lands within minutes, with the order’s next update.

Responses at a glance

Cancel is idempotent: calling it again on a cancelled order returns the same 200, never a second refund. Retrying after a network timeout or a 503 is safe.

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.

Path Parameters

id
string
required

CSBoard order id of the order to cancel.

Response

Cancelled and refunded to your balance. Also the answer for an order that was already cancelled.

order_id
string
required
cancelled
boolean
required
refunded
boolean
required

true: the money is already back on your balance. false: the cancel is placed and the refund lands with the order's next update.

detail
string

Present when the refund is still on its way (202).