Obtener una sesión

GET /v1/sessions/{session_id} · permiso sessions:read

Devuelve una sesión en cualquier estado (active, expired, revoked). Se muestra la dirección IP completa y la consulta se registra en el registro de auditoría de gestión. Las cookies, los tokens y las huellas digitales de los dispositivos nunca se devuelven.

Solicitud

Parámetro En Obligatorio Descripción
session_id ruta sí ID de la sesión, con el prefijo ses_.

Respuesta

200 OK. Los campos vacíos son null.

{
  "id": "ses_0a1b2c3d4e5f6g7h8j9k0m1n2p",
  "user_id": "usr_0a1b2c3d4e5f6g7h8j9k0m1n2p",
  "status": "revoked",
  "login_host": "login.example.com",
  "auth_time": "2026-02-01T08:00:00Z",
  "acr": "1fa",
  "amr": ["pwd"],
  "created_at": "2026-02-01T08:00:00Z",
  "last_seen_at": "2026-02-01T09:15:00Z",
  "idle_expires_at": "2026-02-08T09:15:00Z",
  "absolute_expires_at": "2026-03-03T08:00:00Z",
  "org_id": "org_0a1b2c3d4e5f6g7h8j9k0m1n2p",
  "ip_address": "203.0.113.10",
  "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_0)",
  "revoked_at": "2026-02-01T10:00:00Z",
  "revoke_reason": "admin"
}

revoke_reason solo se establece en las sesiones revoked, por ejemplo admin, user_logout, idp_logout o refresh_reuse.

Errores

Cada error es un cuerpo application/problem+json con un code estable.

HTTP code Cuándo
404 not_found La sesión no existe en este entorno (o el ID tiene un formato incorrecto).
401 unauthenticated La clave de API falta, no es válida o fue revocada.
403 insufficient_permissions La clave no tiene el permiso sessions:read.
429 rate_limited Se superó el límite de frecuencia; respete Retry-After.
503 service_unavailable Una dependencia no está disponible temporalmente; reintente más tarde.

Ejemplo

curl https://api.eu.keenauth.com/v1/sessions/ses_0a1b2c3d4e5f6g7h8j9k0m1n2p \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

CLI: keenauth sessions get ses_0a1b2c3d4e5f6g7h8j9k0m1n2p

Datos personales

Este endpoint contiene datos personales: sesiones. Datos personales en las API de KeenAuth describe qué se almacena, durante cuánto tiempo se conserva y cómo se elimina. No envíe categorías especiales de datos personales (salud, datos biométricos, religión, opiniones políticas, orientación sexual) en ningún campo.