> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tronrental.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Досрочный отзыв заказа

> Забрать bandwidth заказа до конца срока

## Досрочный отзыв заказа

Сразу отзывает делегированный bandwidth вашего заказа — например, когда адрес уже сделал перевод, ради которого брали ресурс, — не дожидаясь конца срока. **Неиспользованное время не возвращается.** Досрочно отозвать можно только заказы bandwidth.

### Параметры пути

**order\_id** `number` *required*

ID заказа — значение `id`, которое возвращает Buy Bandwidth.

### Ответ

Возвращает объект заказа, как Get Order. Поле `status` показывает, что произошло:

| Статус | Значение |
| - | - |
| `reclaimed` | Bandwidth отозван, пока запрос ждал (запрос ждёт до \~10 секунд); `undelegate_txid` — транзакция в сети |
| `filled` | Отзыв не завершился за время запроса; его доделает следующий цикл отзыва, обычно до 30 секунд. Итог придёт вебхуком `order.updated`, либо опрашивайте Get Order |
| `reclaiming` | Отзыв этого заказа уже идёт |
| `reclaim_failed` | Отозвать на нашей стороне не удалось после повторов. Вам ничего делать не нужно |

Повторный вызов для заказа в статусе `reclaiming`, `reclaimed` или `reclaim_failed` возвращает заказ без изменений, поэтому повторять запрос безопасно. Ключу API нужно право `buy_bandwidth`.

### Ошибки

| Код | Статус | Когда |
| - | - | - |
| `ORDER_NOT_FOUND` | `404` | У аккаунта нет такого заказа |
| `ORDER_NOT_RECLAIMABLE` | `409` | Заказ ещё не доставлен (`filled`) или завершился ошибкой |
| `BAD_REQUEST` | `400` | Это не заказ bandwidth |
| `FORBIDDEN` | `403` | У ключа API нет права `buy_bandwidth` |

### Пример

```bash theme={null}
curl -X POST https://api.tronrental.com/v1/orders/12345/reclaim \
  -H "X-API-Key: your_api_key"
```

```json Response theme={null}
{
  "id": 12345,
  "type": "bandwidth",
  "target_address": "TRecipientAddress...",
  "volume": 350,
  "duration": "1h",
  "price_trx": "0.42",
  "fixed_fee_trx": "0.2",
  "status": "reclaimed",
  "delegate_txid": "a1b2c3d4e5f6...",
  "undelegate_txid": "f6e5d4c3b2a1...",
  "reclaim_at": "2026-11-11T11:00:00Z",
  "source": "api",
  "activation_id": null,
  "activation_cost_trx": null,
  "fail_reason": null,
  "refunded_trx": null,
  "created_at": "2026-11-11T10:00:00Z"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.