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

> Todas as assinaturas de Bandwidth automático da sua conta

## Listar assinaturas

Retorna todas as assinaturas de Bandwidth automático da sua conta, com o seu saldo e se novas assinaturas podem ser criadas agora. As assinaturas excluídas não são incluídas. Exige o escopo `view`.

### Resposta

**subscriptions** `array`

As suas assinaturas.

**objeto da assinatura**

**id** `number`

ID da assinatura — use-o nos caminhos de edição e exclusão

**address** `string`

O endereço onde a assinatura mantém largura de banda

**label** `string | null`

O seu nome para a assinatura

**token** `string`

`USDT`, `TRX`, `USDD`, `CUSTOM` ou `OWN` — veja [Token](https://docs.tronrental.com/pt/api-reference/auto-bandwidth/overview.md#opções)

**contract** `object | null`

O contrato do token de uma assinatura `CUSTOM` ou `OWN`: `address`, `symbol` e `name` (`symbol` e `name` como a rede os informou, `null` se desconhecidos). `null` quando não há contrato.

**volume** `number`

Largura de banda mantida no endereço

**auto\_pause** `boolean`

Se a pausa automática está ligada

**threshold** `number`

Nível de largura de banda gratuita para a pausa automática e para a notificação de largura de banda gratuita

**stop\_after\_transfer** `boolean`

Se a próxima transferência do token da assinatura a pausa

**notify\_free\_bw** `boolean`

Se avisamos você quando a largura de banda gratuita do endereço volta a `threshold`

**status** `string`

`active`, `free_bw`, `paused` ou `stopped_balance` — veja [Status](https://docs.tronrental.com/pt/api-reference/auto-bandwidth/overview.md#status)

**stopped\_reason** `string | null`

`insufficient_balance`, `transfer` ou `admin`; `null` quando não há motivo

**address\_change\_to** `string | null`

O novo endereço enquanto uma mudança está em andamento; `null` caso contrário

**free\_bw** `number | null`

Largura de banda gratuita do endereço na última verificação. `null` antes da primeira verificação.

**delegated\_bw** `number`

Largura de banda que delegamos ao endereço neste momento; `0` quando não há

**transfers** `number`

Transferências cobertas até agora — delegações que foram esgotadas e renovadas

**delivery\_state** `string`

`ok`, `waiting_stake` ou `failed` — veja [Status](https://docs.tronrental.com/pt/api-reference/auto-bandwidth/overview.md#status)

**paid\_until** `string | null`

Fim das 24 horas pagas (ISO 8601, UTC). `null` se nenhum dia foi pago ainda.

**total\_charged\_trx** `string`

TRX cobrados desta assinatura, no total

**daily\_trx** `string | null`

Tarifa atual por 24 horas. `null` se o preço está temporariamente indisponível.

**transfer\_trx** `string | null`

Tarifa atual por transferência: `transfer_bw_trx` + `transfer_fee_trx`. `null` se o preço está temporariamente indisponível.

**transfer\_bw\_trx** `string | null`

A parte de largura de banda da tarifa de transferência

**transfer\_fee\_trx** `string | null`

A parte de taxa fixa da tarifa de transferência

**created\_at** `string`

Quando a assinatura foi criada (ISO 8601, UTC)

**balance\_trx** `string`

O saldo da sua conta

**enabled** `boolean`

`false` enquanto o Bandwidth automático está temporariamente desligado: criar uma assinatura ou ligar uma retorna então `503 AUTO_BW_DISABLED`

Os preços de uma assinatura valem para ela: calculados pela chave de API com a qual foi criada, ou como uma compra no site.

### Exemplo

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

```python Python theme={null}
import requests

resp = requests.get(
    "https://api.tronrental.com/v1/bandwidth/auto",
    headers={"X-API-Key": "your_api_key"},
)
print(resp.json())
```

```javascript JavaScript theme={null}
const resp = await fetch("https://api.tronrental.com/v1/bandwidth/auto", {
  headers: { "X-API-Key": "your_api_key" },
});
console.log(await resp.json());
```

```json Response theme={null}
{
  "subscriptions": [
    {
      "id": 42,
      "address": "TYourSenderAddress12345678901234ab",
      "label": "Payouts",
      "token": "USDT",
      "contract": null,
      "volume": 350,
      "auto_pause": false,
      "threshold": 600,
      "stop_after_transfer": false,
      "notify_free_bw": false,
      "status": "active",
      "stopped_reason": null,
      "address_change_to": null,
      "free_bw": 330,
      "delegated_bw": 350,
      "transfers": 12,
      "delivery_state": "ok",
      "paid_until": "2026-11-14T08:15:04Z",
      "total_charged_trx": "5.100000",
      "daily_trx": "0.340000",
      "transfer_trx": "0.340000",
      "transfer_bw_trx": "0.140000",
      "transfer_fee_trx": "0.200000",
      "created_at": "2026-11-10T08:15:00Z"
    }
  ],
  "balance_trx": "48.250000",
  "enabled": true
}
```

### Erros

| Status | Código | Quando |
| - | - | - |
| `403` | `FORBIDDEN` | A chave de API não tem o escopo `view` |


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