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

# Listar aluguéis com renovação automática

> Liste seus aluguéis de largura de banda contínuos

## Listar aluguéis com renovação automática

Retorna seus aluguéis com renovação automática, os mais recentes primeiro.

### Parâmetros de consulta

<ParamField query="status" type="string">
  Filtrar por status: `active`, `cancelled` ou `ended_insufficient_balance`
</ParamField>

### Resposta

Retorna `rentals` — um array de objetos de aluguel com `status`, `volume`, `daily_trx`, `total_charged_trx`, `next_billing_at` e carimbos de data/hora.

### Status do aluguel

| Status                       | Descrição                                                     |
| ---------------------------- | ------------------------------------------------------------- |
| `active`                     | Delegado e cobrando diariamente                               |
| `cancelled`                  | Cancelado pelo usuário (ou admin)                             |
| `ended_insufficient_balance` | Encerrado automaticamente — o saldo não cobriu o dia seguinte |

### Exemplo

```bash theme={null}
curl "https://api.tronrental.com/v1/bandwidth/rentals?status=active" \
  -H "X-API-Key: your_api_key"
```

```json Response theme={null}
{
  "rentals": [
    {
      "id": 4321,
      "address": "TYourRecipientAddress1234567890abc",
      "volume": 350,
      "status": "active",
      "daily_trx": "0.4205",
      "total_charged_trx": "1.2615",
      "billing_count": 3,
      "next_billing_at": "2026-06-11T04:30:00+00:00",
      "last_billed_at": "2026-06-10T04:30:00+00:00",
      "delegate_txid": "abc123...",
      "undelegate_txid": null,
      "ended_at": null,
      "created_at": "2026-06-08T04:30:00+00:00"
    }
  ]
}
```
