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

# List Subscriptions

> All Auto Bandwidth subscriptions on your account

## List Subscriptions

Returns every Auto Bandwidth subscription on your account, with your balance and whether new subscriptions can be created right now. Deleted subscriptions are not included. Requires the `view` scope.

### Response

**subscriptions** `array`

Your subscriptions.

**subscription object**

**id** `number`

Subscription ID — use it in the edit and delete paths

**address** `string`

The address the subscription keeps bandwidth on

**label** `string | null`

Your name for the subscription

**token** `string`

`USDT`, `TRX`, `USDD`, `CUSTOM` or `OWN` — see [Token](https://docs.tronrental.com/api-reference/auto-bandwidth/overview.md#options)

**contract** `object | null`

The token contract of a `CUSTOM` or `OWN` subscription: `address`, `symbol` and `name` (`symbol` and `name` as the network reported them, `null` if unknown). `null` when there is none.

**volume** `number`

Bandwidth kept on the address

**auto\_pause** `boolean`

Whether auto-pause is on

**threshold** `number`

Free bandwidth level for auto-pause and for the free bandwidth notification

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

Whether the next transfer of the subscription's token pauses it

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

Whether we notify you when the address's free bandwidth recovers to `threshold`

**status** `string`

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

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

`insufficient_balance`, `transfer` or `admin`; `null` when there is none

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

The new address while a move is in progress; `null` otherwise

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

Free bandwidth on the address at the last check. `null` before the first check.

**delegated\_bw** `number`

Bandwidth we have delegated to the address right now; `0` when none

**transfers** `number`

Transfers covered so far — delegations that were used up and renewed

**delivery\_state** `string`

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

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

End of the paid 24 hours (ISO 8601, UTC). `null` if no day has been paid yet.

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

TRX charged for this subscription, in total

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

Current fee per 24 hours. `null` if the price is temporarily unavailable.

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

Current fee per transfer: `transfer_bw_trx` + `transfer_fee_trx`. `null` if the price is temporarily unavailable.

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

The bandwidth part of the transfer fee

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

The fixed fee part of the transfer fee

**created\_at** `string`

When the subscription was created (ISO 8601, UTC)

**balance\_trx** `string`

Your account balance

**enabled** `boolean`

`false` while Auto Bandwidth is temporarily switched off: creating a subscription or switching one on then returns `503 AUTO_BW_DISABLED`

Prices in a subscription are for that subscription: priced by the API key it was created with, or as a website purchase.

### Example

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

### Errors

| Status | Code | When |
| - | - | - |
| `403` | `FORBIDDEN` | The API key lacks the `view` scope |


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