> ## 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.

# Recuperar pedido

> Recuperar a largura de banda de um pedido antes do fim do prazo

## Recuperar pedido

Remove na hora a delegação da largura de banda do seu pedido — por exemplo, quando o endereço já fez a transferência para a qual o recurso foi alugado — sem esperar o fim do prazo. **O tempo não usado não é reembolsado.** Somente pedidos de largura de banda podem ser recuperados antes do prazo.

### Parâmetros de caminho

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

ID do pedido — o `id` retornado por Buy Bandwidth.

### Resposta

Retorna o objeto do pedido, igual ao Get Order. `status` mostra o que aconteceu:

| Status | Significado |
| - | - |
| `reclaimed` | A largura de banda foi removida enquanto a requisição aguardava (ela aguarda até cerca de 10 segundos); `undelegate_txid` é a transação na blockchain |
| `filled` | A remoção não terminou durante a requisição; o próximo ciclo de recuperação a conclui, normalmente em até 30 segundos. O resultado chega no webhook `order.updated`, ou consulte Get Order |
| `reclaiming` | Uma recuperação deste pedido já está em andamento |
| `reclaim_failed` | A remoção não foi concluída do nosso lado após as tentativas. Nada a fazer da sua parte |

Uma chamada repetida para um pedido que já está em `reclaiming`, `reclaimed` ou `reclaim_failed` retorna o pedido sem alterações, então repetir é seguro. A chave de API precisa da permissão `buy_bandwidth`.

### Erros

| Código | Status | Quando |
| - | - | - |
| `ORDER_NOT_FOUND` | `404` | Não existe esse pedido na sua conta |
| `ORDER_NOT_RECLAIMABLE` | `409` | O pedido ainda não foi entregue (`filled`) ou falhou |
| `BAD_REQUEST` | `400` | Não é um pedido de largura de banda |
| `FORBIDDEN` | `403` | A chave de API não tem a permissão `buy_bandwidth` |

### Exemplo

```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.