> ## 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. # POST /v1/orders/:id/cancel — отменить недоставленный заказ > Отменяет заказ, который ещё никто не отправил, и возвращает деньги на баланс. Доступна через 31 минуту после покупки при ручной доставке, через 15 минут — в остальных случаях. Часть заказов доставляется вручную: Steam-трейд отправляет человек (или медленный деск), и это может занять до 12 часов. Такой заказ виден как `delivery_type: "manual"` в `GET /v1/orders` и `GET /v1/orders/{id}` и может долго висеть в `delivering` без трейд-оффера. `delivery_deadline_at` показывает, когда у продавца кончается время. Если продавец не успел, заказ отменяется и деньги возвращаются автоматически. Если ждать больше не хотите — отмените заказ сами. Тело запроса не нужно. Отмена доступна для: * **Заказа с ручной доставкой**, по которому продавец ничего не отправил за 31 минуту после покупки. * **Заказа в холде** до снятия блокировки, если источник это позволяет. * **Любого другого заказа**, который не доставлен через 15 минут после покупки: трейд-оффера нет и на стороне маркета ничего не в процессе. Лот игрока (P2P) здесь отменить нельзя. Он закрывается и возвращает деньги сам, если продавец пропустил `delivery_deadline_at`. ## Рекомендуемый флоу 1. Создайте покупку через `POST /v1/orders` или `POST /v1/market/buy`. 2. Поллите `GET /v1/orders/{id}` (или слушайте вебхук `order.updated`). Смотрите `delivery_type` и `delivery_deadline_at`. 3. Если у заказа `manual` всё ещё нет трейд-оффера и он вам больше не нужен — через 31 минуту вызовите `POST /v1/orders/{id}/cancel`. 4. При `425 too_early` повторите через `retry_after_sec`. При `200` деньги уже на балансе. При `202` они придут в течение нескольких минут вместе со следующим обновлением заказа. ## Ответы кратко | Статус | Значение | | - | - | | `200` `refunded: true` | Заказ отменён, деньги вернулись на баланс. Для уже отменённого заказа ответ тот же. | | `202` `refunded: false` | Отмена принята. Возврат придёт в течение нескольких минут со следующим обновлением заказа (вебхук или `GET /v1/orders/{id}`). | | `425 too_early` | Отмена ещё не открыта (31 мин при ручной доставке, 15 мин в остальных случаях). Повторить через возвращённый `retry_after_sec`. | | `409 offer_sent` | Steam-трейд уже отправлен. Примите или отклоните его в Steam. | | `409 in_progress` | Доставка или отмена уже идёт. Если доставка сорвётся, деньги вернутся автоматически. | | `409 not_cancellable` | Заказ больше нельзя отменить: доставлен, завершён, это P2P-лот или не подходит под условия. | | `429 cancel_limit_reached` | Слишком много отмен за последнее время. Попробуйте позже. | | `503 cancel_unavailable` | Сейчас не удалось проверить заказ на стороне маркета. Ничего не изменено, повторите чуть позже. | | `404 order_not_found` | Такого заказа на этом аккаунте нет. | > [!WARNING] > > Отмена идемпотентна: повторный вызов для отменённого заказа вернёт тот же `200`, а не второй возврат. Ретрай после сетевого таймаута или `503` безопасен. ## OpenAPI ````yaml POST /orders/{id}/cancel 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: /orders/{id}/cancel: post: tags: - Trading summary: Cancel an undelivered order description: >- Cancel an order nobody has shipped yet; the money goes back to your balance. No request body. Cancel opens 31 minutes after purchase for a `manual` delivery order whose seller has sent nothing, before the unban for a held order (where the source allows it), and 15 minutes after purchase for any other order that is still undelivered, with no trade offer and nothing in flight upstream. A player's (P2P) lot cannot be cancelled here; it is cancelled and refunded automatically if the seller misses `delivery_deadline_at`. Idempotent: calling it on an already cancelled order returns the same `200`. operationId: cancelOrder parameters: - name: id in: path required: true description: CSBoard order id of the order to cancel. schema: type: string responses: '200': description: >- Cancelled and refunded to your balance. Also the answer for an order that was already cancelled. content: application/json: schema: type: object properties: order_id: type: string cancelled: type: boolean refunded: type: boolean description: >- `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: type: string description: Present when the refund is still on its way (`202`). required: - order_id - cancelled - refunded example: order_id: ord_01J9Z3K8Q2 cancelled: true refunded: true '202': description: >- Cancel placed. The refund lands on your balance within minutes and shows up with the order's next update (`order.updated` webhook, `GET /orders/{id}`). content: application/json: schema: type: object properties: order_id: type: string cancelled: type: boolean refunded: type: boolean description: >- `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: type: string description: Present when the refund is still on its way (`202`). required: - order_id - cancelled - refunded example: order_id: ord_01J9Z3K8Q2 cancelled: true refunded: false detail: >- Cancel placed; the refund lands on your balance within minutes. '401': $ref: '#/components/responses/Unauthorized' '404': description: No order with that id on this account. content: application/json: schema: $ref: '#/components/schemas/Error' example: code: order_not_found detail: No such order on this account. '409': description: >- The order cannot be cancelled. `offer_sent`: the Steam trade offer is already out — accept or decline it in Steam. `in_progress`: delivery or a cancel is already running; if delivery fails the order is refunded automatically. `not_cancellable`: the order is delivered, finished, a player's (P2P) lot, or not eligible. content: application/json: schema: $ref: '#/components/schemas/Error' examples: offer_sent: summary: Trade offer already sent value: code: offer_sent detail: >- The Steam trade offer is already out; accept or decline it in Steam. in_progress: summary: Delivery or cancel already running value: code: in_progress detail: >- Delivery is in progress; if it fails, the order is refunded automatically. not_cancellable: summary: No longer cancellable value: code: not_cancellable detail: This order can no longer be cancelled. '425': description: >- Cancel is not open yet: 31 minutes after purchase for `manual` delivery, 15 minutes otherwise. Retry after `retry_after_sec`. content: application/json: schema: type: object properties: code: type: string detail: type: string retry_after_sec: type: integer description: Seconds until cancel opens. example: code: too_early detail: Cancel opens 15 minutes after purchase. retry_after_sec: 540 '429': description: >- `cancel_limit_reached`: too many cancels for now — try again later. `rate_limit_exceeded`: the per-key trading budget is spent — wait `Retry-After` seconds. headers: Retry-After: description: Seconds to wait before retrying (on `rate_limit_exceeded`). schema: type: integer content: application/json: schema: $ref: '#/components/schemas/Error' examples: cancel_limit_reached: summary: Too many cancels value: code: cancel_limit_reached detail: Cancel limit reached for now; try again later. rate_limit_exceeded: summary: Rate limit value: code: rate_limit_exceeded detail: Trading rate limit of 10000 requests/min exceeded. '503': description: >- The order could not be checked upstream right now. Nothing was changed; retry shortly. content: application/json: schema: $ref: '#/components/schemas/Error' example: code: cancel_unavailable detail: >- The order could not be checked upstream right now and nothing was changed; retry shortly. components: 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 schemas: 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 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.