Saltar al contenido principal

Listar dispositivos asociados al usuario

Endpoint para obtener la lista de dispositivos (sesiones activas) asociados al usuario autenticado, ordenados por fecha de último acceso.

💻 Sesiones y dispositivos

Cada dispositivo representa una sesión activa del usuario.
La información permite identificar accesos recientes, detectar actividad sospechosa y administrar la confianza de los dispositivos.

GET/users/devices

Obtiene la lista de dispositivos asociados al usuario autenticado

📤 Respuesta

[
{
  "id": "662fb6d27a13a91234567890",
  "ip": "190.100.50.123",
  "region": "Buenos Aires, Argentina",
  "trusted": true,
  "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)",
  "lastAccess": "2025-06-18T14:25:30.000Z",
  "createdAt": "2025-04-10T12:03:45.000Z",
  "current": true
}
]

Requiere autenticación​

JWT requerido

Debes enviar un token JWT válido en la cabecera:

Authorization: Bearer <token>

Respuesta exitosa​

Dispositivos obtenidos correctamente

[
  {
    "id": "662fb6d27a13a91234567890",
    "ip": "190.100.50.123",
    "region": "Buenos Aires, Argentina",
    "trusted": true,
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)",
    "lastAccess": "2025-06-18T14:25:30.000Z",
    "createdAt": "2025-04-10T12:03:45.000Z",
    "current": true
  },
  {
    "id": "662fb6d27a13a91234567891",
    "ip": "181.60.45.98",
    "region": "Córdoba, Argentina",
    "trusted": false,
    "userAgent": "Mozilla/5.0 (Android 11; Mobile)",
    "lastAccess": "2025-06-10T08:40:12.000Z",
    "createdAt": "2025-04-08T09:15:23.000Z",
    "current": false
  }
]

Campos importantes:

  • current: indica si corresponde a la sesión actual
  • trusted: indica si el dispositivo fue marcado como confiable
  • lastAccess: último acceso registrado para esa sesión

Errores​

Error interno

500 – Internal Server Error

Error inesperado al obtener la lista de dispositivos.

Notas​

Consideraciones

  • La lista está ordenada por último acceso (más reciente primero).
  • Útil para mostrar sesiones activas en el panel de seguridad del usuario.
  • Permite detectar accesos desde ubicaciones o dispositivos desconocidos.

Enlaces relacionados​