Lister les sessions

GET /fapi/v1/me/sessions · appelé depuis l'hôte de connexion de l'environnement

Renvoie les sessions actives de l'utilisateur authentifié, les plus récemment vues en premier. La session qui effectue la requête a current: true. Nécessite le cookie __Host-idp_session de l'utilisateur authentifié ; si le cookie est absent, expiré ou révoqué, renvoie 401 unauthenticated. Une application de première partie sur une autre origine peut à la place envoyer son jeton d'accès à l'API front (Authorization: DPoP <token> avec une preuve DPoP ; voir Jeton d'accès à l'API front). Aucune vérification récente n'est nécessaire.

Requête

En-têtes :

En-tête Obligatoire Description
Idp-Client oui Identifiant du SDK.

Aucun corps.

Réponse

200 OK :

Champ Type Description
data[].id string Identifiant de session (ses_…).
data[].current boolean Indique s'il s'agit de la session qui effectue la requête.
data[].login_host string Hôte de connexion sur lequel la session a été ouverte.
data[].browser_family string Famille du navigateur, lorsqu'elle est connue.
data[].os_family string Famille du système d'exploitation, lorsqu'elle est connue.
data[].device_type string Type d'appareil, lorsqu'il est connu.
data[].country string Pays depuis lequel la session a été ouverte (ISO 3166-1 alpha-2), lorsqu'il est connu.
data[].ip_address string Dernière adresse IP vue, sinon celle depuis laquelle la session a été ouverte ; absente une fois la durée de conservation écoulée. Affichée uniquement à l'utilisateur lui-même.
data[].created_at string Date d'ouverture de la session (RFC 3339, UTC).
data[].last_seen_at string Date de la dernière utilisation de la session (RFC 3339, UTC). 
{
  "data": [
    {
      "id": "ses_01jbz6x8kq3m2n4p5r6s7t8v9w",
      "current": true,
      "login_host": "example.keenauth.app",
      "browser_family": "firefox",
      "os_family": "linux",
      "device_type": "desktop",
      "country": "DE",
      "ip_address": "192.0.2.10",
      "created_at": "2026-10-01T09:30:00Z",
      "last_seen_at": "2026-10-12T08:15:00Z"
    }
  ]
}

Erreurs

Statut Code Quand
401 unauthenticated Aucun cookie de session valide.

Exemple

curl https://example.keenauth.app/fapi/v1/me/sessions \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -b cookies.txt

Données personnelles

Ce point de terminaison traite des données personnelles : sessions. Données personnelles dans les API KeenAuth décrit ce qui est stocké, combien de temps il est conservé et comment il est supprimé. N'envoyez pas de catégories particulières de données personnelles (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans aucun champ.