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

# Список подписок

> Все подписки Авто-bandwidth в вашем аккаунте

## Список подписок

Возвращает все подписки Авто-bandwidth в вашем аккаунте, а также ваш баланс и признак того, можно ли прямо сейчас создавать новые подписки. Удалённые подписки не включаются. Нужен скоуп `view`.

### Ответ

**subscriptions** `array`

Ваши подписки.

**объект подписки**

**id** `number`

ID подписки — используется в путях изменения и удаления

**address** `string`

Адрес, на котором подписка держит bandwidth

**label** `string | null`

Ваше название подписки

**token** `string`

`USDT`, `TRX`, `USDD`, `CUSTOM` или `OWN` — см. [Токен](https://docs.tronrental.com/ru/api-reference/auto-bandwidth/overview.md#параметры)

**contract** `object | null`

Контракт токена подписки `CUSTOM` или `OWN`: `address`, `symbol` и `name` (`symbol` и `name` — как их сообщила сеть, `null`, если неизвестны). `null`, если контракта нет.

**volume** `number`

Bandwidth, который держится на адресе

**auto\_pause** `boolean`

Включена ли авто-пауза

**threshold** `number`

Уровень бесплатного bandwidth для авто-паузы и для уведомления о бесплатном bandwidth

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

Ставит ли следующий перевод токена подписки её на паузу

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

Уведомляем ли мы вас, когда бесплатный bandwidth адреса восстанавливается до `threshold`

**status** `string`

`active`, `free_bw`, `paused` или `stopped_balance` — см. [Статус](https://docs.tronrental.com/ru/api-reference/auto-bandwidth/overview.md#статус)

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

`insufficient_balance`, `transfer` или `admin`; `null`, если причины нет

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

Новый адрес, пока идёт перенос; иначе `null`

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

Бесплатный bandwidth на адресе при последней проверке. `null` до первой проверки.

**delegated\_bw** `number`

Bandwidth, который мы сейчас делегировали на адрес; `0`, если делегации нет

**transfers** `number`

Покрытых переводов на данный момент — делегаций, которые были израсходованы и обновлены

**delivery\_state** `string`

`ok`, `waiting_stake` или `failed` — см. [Статус](https://docs.tronrental.com/ru/api-reference/auto-bandwidth/overview.md#статус)

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

Конец оплаченных 24 часов (ISO 8601, UTC). `null`, если ни одни сутки ещё не оплачены.

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

Всего списано TRX по этой подписке

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

Текущая комиссия за 24 часа. `null`, если цена временно недоступна.

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

Текущая комиссия за перевод: `transfer_bw_trx` + `transfer_fee_trx`. `null`, если цена временно недоступна.

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

Часть комиссии за перевод, приходящаяся на bandwidth

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

Часть комиссии за перевод, приходящаяся на фиксированную комиссию

**created\_at** `string`

Когда подписка создана (ISO 8601, UTC)

**balance\_trx** `string`

Баланс вашего аккаунта

**enabled** `boolean`

`false`, пока Авто-bandwidth временно выключен: создание подписки или её включение тогда возвращает `503 AUTO_BW_DISABLED`

Цены в подписке относятся к этой подписке: они рассчитаны по API-ключу, с которым она создана, либо как покупка на сайте.

### Пример

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

### Ошибки

| Статус | Код | Когда |
| - | - | - |
| `403` | `FORBIDDEN` | У API-ключа нет скоупа `view` |


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