# 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](/docs/api/fapi/front-api-token)). 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). |

```json
{
  "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

```bash
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](/docs/policies/personal-data) 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.