Skip to main content
GET
/
admin
/
users
Gestión de usuarios
curl --request GET \
  --url https://api.example.com/admin/users \
  --header 'Content-Type: application/json' \
  --data '
{
  "status": "<string>",
  "kycStatus": "<string>",
  "reason": "<string>"
}
'
{
  "data": [
    {
      "id": "usr_abc123",
      "name": "Juan Pérez",
      "email": "juan@ejemplo.com",
      "status": "active",
      "kycStatus": "approved",
      "createdAt": "2026-01-10T08:00:00Z"
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 1
}
Requiere autenticación con Bearer token y rol ADMIN.

​
Listar usuarios

​
page
integer
Número de página. Por defecto 1.
​
limit
integer
Cantidad de resultados por página. Por defecto 20.
​
search
string
Texto de búsqueda por nombre o email.
​
status
string
Filtrar por estado del usuario: active, inactive, suspended.
​
kycStatus
string
Filtrar por estado de KYC: pending, approved, rejected.

​
Respuesta

​
data
array
Lista paginada de usuarios.
​
page
integer
Página actual.
​
limit
integer
Cantidad de resultados por página.
​
total
integer
Total de usuarios que coinciden con los filtros.
{
  "data": [
    {
      "id": "usr_abc123",
      "name": "Juan Pérez",
      "email": "juan@ejemplo.com",
      "status": "active",
      "kycStatus": "approved",
      "createdAt": "2026-01-10T08:00:00Z"
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 1
}

​
Obtener usuario por ID

GET /admin/users/{id}
​
id
string
required
Identificador único del usuario.
Retorna el detalle completo de un usuario específico. 
{
  "id": "usr_abc123",
  "name": "Juan Pérez",
  "email": "juan@ejemplo.com",
  "status": "active",
  "kycStatus": "approved",
  "createdAt": "2026-01-10T08:00:00Z",
  "lastLoginAt": "2026-03-30T12:00:00Z"
}

​
Actualizar estado de usuario

PUT /admin/users/{id}/status
​
id
string
required
Identificador único del usuario.
​
status
string
required
Nuevo estado del usuario: ACTIVE, SUSPENDED, BANNED.
{
  "message": "Estado del usuario actualizado exitosamente.",
  "status": "SUSPENDED"
}

​
Actualizar estado de KYC

PUT /admin/users/{id}/kyc
​
id
string
required
Identificador único del usuario.
​
kycStatus
string
required
Nuevo estado de KYC: APPROVED, REJECTED, PENDING, NOT_STARTED.
​
reason
string
Razón del cambio de estado (requerido si se rechaza).
{
  "message": "Estado de KYC actualizado exitosamente.",
  "kycStatus": "APPROVED"
}