Skip to main content
GET
List sub-accounts
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. 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

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

Autorizaciones

X-API-Key
string
header
requerido

API key for authentication. Keys are prefixed with nxr_live_.

Respuesta

Sub-accounts and family usage.

period
object | null
requerido

The main account's current usage period. null when the usage meter could not be read.

family
object | null
requerido

Usage of the main account plus all its sub-accounts. null when the usage meter could not be read.

items
object[]
requerido
Última modificación el 1 de octubre de 2026