> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getnexor.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar subcuentas

> Lista tus subcuentas con su estado, dueño, tareas, leads y los leads que cada una contactó este período dentro de tu plan.

Una subcuenta es una cuenta de Nexor separada que pertenece a tu cuenta. Tiene su propio equipo, agentes, números, conversaciones y leads, y cada lead que contacta cuenta para tu plan. Consulta [Subcuentas](/docs/es/guides/account/sub-accounts).

La cuenta principal siempre es la cuenta dueña de la clave de API. No hay un parámetro para actuar en nombre de otra cuenta.

## Cómo leer la respuesta

| `state` | Significado |
| - | - |
| `active` | La subcuenta funciona con normalidad. |
| `invited` | El dueño todavía no se une. `owner.invitation_expires_at` indica cuándo vence la invitación. |
| `paused` | La subcuenta tiene tareas y ninguna está activa. |
| `inactive` | La subcuenta fue desactivada. Su equipo no puede verla. |

* `agents_active` y `agents_total` cuentan tareas (`workflow` en la API), no agentes.
* `contacted_period` es lo que contactó una subcuenta en este período. `family.used` suma la cuenta principal y todas sus subcuentas, y es el número que se compara con `family.quota`.
* `null` en `period`, `family` o `contacted_period` significa que no se pudo leer el medidor de consumo. No significa cero.

## Antes de empezar

* Las subcuentas son una función opcional que Nexor habilita a solicitud. Sin ella, todos los endpoints de esta sección responden 403 `sub_accounts_not_enabled`. Contacta a Soporte de Nexor para solicitarla.
* Usa una clave de API de la cuenta principal. Una clave que pertenece a una subcuenta recibe 403 `sub_account_cannot_manage_sub_accounts`, porque una subcuenta no puede tener subcuentas propias.
* Las claves MCP necesitan `sub-accounts:read` para listar y `sub-accounts:write` para todas las demás operaciones. Las claves de API con acceso completo no necesitan nada más.
* Todo cambio exige `"confirm": true` en el cuerpo. Sin eso, la API responde 400 `confirmation_required` y no cambia nada.
* Un ID que no es una de tus subcuentas responde 403 `not_parent_of_client`.
* Los errores devuelven un código estable en `error`, como `owner_email_invalid`. Traduce ese código a tu propio mensaje.


## API Specification

The full API specification for this endpoint is available in the [documentation index](https://docs.getnexor.ai/llms.txt).