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

> Recuperar el ancho de banda de una orden antes de que termine su plazo

## Recuperar orden

Retira de inmediato la delegación del ancho de banda de tu orden —por ejemplo, cuando la dirección ya hizo la transferencia para la que se alquiló— sin esperar al final del plazo. **El tiempo no usado no se reembolsa.** Solo las órdenes de ancho de banda se pueden recuperar antes de tiempo.

### Parámetros de ruta

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

ID de la orden: el `id` que devuelve Buy Bandwidth.

### Respuesta

Devuelve el objeto de la orden, igual que Get Order. `status` indica lo que pasó:

| Estado | Significado |
| - | - |
| `reclaimed` | El ancho de banda se retiró mientras la solicitud esperaba (espera hasta unos 10 segundos); `undelegate_txid` es la transacción en la cadena |
| `filled` | La retirada no terminó durante la solicitud; la completa el siguiente ciclo de recuperación, normalmente en menos de 30 segundos. El resultado llega en el webhook `order.updated`, o consulta Get Order |
| `reclaiming` | Ya hay una recuperación de esta orden en curso |
| `reclaim_failed` | La retirada no se completó de nuestro lado tras los reintentos. No tiene que hacer nada |

Una llamada repetida para una orden que ya está en `reclaiming`, `reclaimed` o `reclaim_failed` devuelve la orden sin cambios, así que reintentar es seguro. La clave de API necesita el permiso `buy_bandwidth`.

### Errores

| Código | Estado | Cuándo |
| - | - | - |
| `ORDER_NOT_FOUND` | `404` | No existe esa orden en tu cuenta |
| `ORDER_NOT_RECLAIMABLE` | `409` | La orden aún no se ha entregado (`filled`) o falló |
| `BAD_REQUEST` | `400` | No es una orden de ancho de banda |
| `FORBIDDEN` | `403` | La clave de API no tiene el permiso `buy_bandwidth` |

### Ejemplo

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