/api/v6/account/usersUsuarios
Miembros de la organización, con rol, centro de costo y estado.
Alcance y límites
API key con la capacidad directory concedida
30 solicitudes por minuto
- Paginación con
limit(por defecto 20, máximo 100) yoffset(por defecto 0). La respuesta traedata.itemsydata.pagination.
Usuarios (miembros) de la organización, con su rol, centro de costo y estado. Contiene datos personales: trátalos como tales en tus propios sistemas.
Paginación con limit (por defecto 20, máximo 100) y offset (por defecto 0). La respuesta trae data.items y data.pagination.
Incluye datos personales
La API key debe tener habilitada explícitamente la capacidad directory. Tener acceso a todos los servicios NO la concede. Una key sin la capacidad recibe 403.
Parámetros de consulta
limitPor defecto: 20
offsetPor defecto: 0
statusRespuestas
Página de usuarios.
{
"success": true,
"data": {
"items": [
{
"userId": 10000,
"firstName": "Diego",
"lastName": "Pérez",
"email": "dev@acme.co",
"roles": ["owner"],
"costCenterId": 17,
"status": "active",
"joinedAt": "2026-05-14 11:31:56",
"lastUsedAt": "2026-06-02 09:00:00"
}
],
"pagination": { "limit": 20, "offset": 0, "returned": 1, "hasMore": false }
},
"meta": {
"requestId": "b9b1704baffab21150213c02fd853975",
"timestamp": "2026-06-02T19:43:59+00:00",
"responseTimeMs": 4.1
}
}Credenciales inválidas o faltantes.
La API key no tiene la capacidad requerida, o la organización no puede ejecutar la solicitud.
Se excedió el límite de solicitudes.
Errores posibles
Códigos que este endpoint puede devolver en error.code. El detalle completo está en el catálogo.
AUTH_REQUIREDNo se envió un token Bearer y cada llamada lo requiere.401AUTH_INVALID_KEYLa API key no se reconoce: formato equivocado, revocada o vencida.401AUTH_SERVICE_NOT_ALLOWEDLa key no tiene permitido el servicio detrás de este endpoint.403ACCOUNT_NOT_ACTIVETu organización está suspendida o cerrada.403ACCOUNT_BLOCKEDHay un bloqueo total activo: cada llamada se rechaza.403ACCOUNT_CONFIG_NOT_FOUNDNo pudimos cargar la organización de tu key.403FORBIDDEN403 genérico: alternativa cuando no aplica un `ACCOUNT_*`.429RATE_TPS_EXCEEDEDExcediste el cupo de tu organización para este endpoint.