Ottieni una sessione

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

Restituisce una sessione in qualsiasi stato (active, expired, revoked). Viene mostrato l'indirizzo IP completo e la visualizzazione viene registrata nel log di audit della gestione. Cookie, token e impronte del dispositivo non vengono mai restituiti.

Richiesta

Parametro In Obbligatorio Descrizione
session_id path sì ID della sessione, con prefisso ses_.

Risposta

200 OK. I campi vuoti sono 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 è impostato solo per le sessioni revoked, per esempio admin, user_logout, idp_logout o refresh_reuse.

Errori

Ogni errore è un corpo application/problem+json con un code stabile.

HTTP code Quando
404 not_found La sessione non esiste in questo ambiente (oppure l'ID è malformato).
401 unauthenticated La chiave API manca, non è valida o è stata revocata.
403 insufficient_permissions La chiave non ha l'autorizzazione sessions:read.
429 rate_limited È stato superato il limite di richieste; rispetta Retry-After.
503 service_unavailable Una dipendenza non è temporaneamente disponibile; riprova più tardi.

Esempio

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

CLI: keenauth sessions get ses_0a1b2c3d4e5f6g7h8j9k0m1n2p

Dati personali

Questo endpoint contiene dati personali: sessioni. Dati personali nelle API di KeenAuth descrive cosa viene memorizzato, per quanto tempo viene conservato e come viene eliminato. Non inviare in nessun campo categorie particolari di dati personali (salute, dati biometrici, religione, opinioni politiche, orientamento sessuale).