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

> Todas las suscripciones de Bandwidth automático de tu cuenta

## Listar suscripciones

Devuelve todas las suscripciones de Bandwidth automático de tu cuenta, con tu saldo y si se pueden crear suscripciones nuevas en este momento. Las suscripciones eliminadas no se incluyen. Requiere el alcance `view`.

### Respuesta

**subscriptions** `array`

Tus suscripciones.

**objeto de suscripción**

**id** `number`

ID de la suscripción — úsalo en las rutas de edición y eliminación

**address** `string`

La dirección en la que la suscripción mantiene ancho de banda

**label** `string | null`

Tu nombre para la suscripción

**token** `string`

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

**contract** `object | null`

El contrato del token de una suscripción `CUSTOM` u `OWN`: `address`, `symbol` y `name` (`symbol` y `name` tal como los informó la red, `null` si se desconocen). `null` cuando no hay ninguno.

**volume** `number`

Ancho de banda que se mantiene en la dirección

**auto\_pause** `boolean`

Si la pausa automática está activada

**threshold** `number`

Nivel de ancho de banda gratuito para la pausa automática y para la notificación de ancho de banda gratuito

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

Si la siguiente transferencia del token de la suscripción la pausa

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

Si te avisamos cuando el ancho de banda gratuito de la dirección se recupera hasta `threshold`

**status** `string`

`active`, `free_bw`, `paused` o `stopped_balance` — ver [Estado](https://docs.tronrental.com/es/api-reference/auto-bandwidth/overview.md#estado)

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

`insufficient_balance`, `transfer` o `admin`; `null` cuando no hay ninguno

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

La nueva dirección mientras hay un cambio en curso; `null` en caso contrario

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

Ancho de banda gratuito de la dirección en la última comprobación. `null` antes de la primera comprobación.

**delegated\_bw** `number`

Ancho de banda que tenemos delegado ahora mismo a la dirección; `0` cuando no hay ninguno

**transfers** `number`

Transferencias cubiertas hasta ahora — delegaciones que se agotaron y se renovaron

**delivery\_state** `string`

`ok`, `waiting_stake` o `failed` — ver [Estado](https://docs.tronrental.com/es/api-reference/auto-bandwidth/overview.md#estado)

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

Fin de las 24 horas pagadas (ISO 8601, UTC). `null` si todavía no se ha pagado ningún día.

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

TRX cobrados por esta suscripción, en total

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

Comisión actual cada 24 horas. `null` si el precio no está disponible temporalmente.

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

Comisión actual por transferencia: `transfer_bw_trx` + `transfer_fee_trx`. `null` si el precio no está disponible temporalmente.

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

La parte de ancho de banda de la comisión por transferencia

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

La parte de comisión fija de la comisión por transferencia

**created\_at** `string`

Cuándo se creó la suscripción (ISO 8601, UTC)

**balance\_trx** `string`

El saldo de tu cuenta

**enabled** `boolean`

`false` mientras Bandwidth automático está desactivado temporalmente: crear una suscripción o activar una devuelve entonces `503 AUTO_BW_DISABLED`

Los precios de una suscripción son los de esa suscripción: calculados según la clave API con la que se creó, o como una compra en el sitio web.

### Ejemplo

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

### Errores

| Estado | Código | Cuándo |
| - | - | - |
| `403` | `FORBIDDEN` | La clave API carece del alcance `view` |


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