# Lister les adresses e-mail

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

Renvoie les adresses e-mail de l'utilisateur authentifié, la principale en premier, puis par date d'ajout. Un utilisateur détient au maximum 10 adresses, la principale comprise. 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 propriétaire sur une autre origine peut à la place envoyer son jeton d'accès à l'API frontale (`Authorization: DPoP <token>` avec une preuve DPoP ; voir [Jeton d'accès à l'API frontale](/docs/api/fapi/front-api-token)).

## Requête

En-têtes :

| En-tête | Obligatoire | Description |
| --- | --- | --- |
| `Idp-Client` | oui | Identifiant du SDK. |
| `Origin` | oui | Doit être exactement `https://<hôte de connexion>`. |

Aucun corps.

## Réponse

`200 OK` :

| Champ | Type | Description |
| --- | --- | --- |
| `data[].id` | string | Identifiant de l'adresse e-mail (UUID en minuscules). |
| `data[].email` | string | L'adresse. |
| `data[].verified` | boolean | Indique si l'utilisateur a prouvé qu'il possède l'adresse. |
| `data[].primary` | boolean | Indique s'il s'agit de l'adresse principale. |
| `data[].created_at` | string | Date d'ajout de l'adresse (RFC 3339, UTC). |

```json
{
  "data": [
    {
      "id": "0190a5c4-1b2c-7d3e-8f40-516273849abc",
      "email": "ada@example.com",
      "verified": true,
      "primary": true,
      "created_at": "2026-10-01T09:30:00Z"
    }
  ]
}
```

## Erreurs

| Statut | Code | Quand |
| --- | --- | --- |
| 401 | `unauthenticated` | Aucun cookie de session valide. |
| 403 | `origin_not_allowed` | `Origin` est absent ou incorrect. |

## Exemple

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

## Données personnelles

Ce point de terminaison traite des données personnelles : profil de l'utilisateur final. [Données personnelles dans les API KeenAuth](/docs/policies/personal-data) décrit ce qui est stocké, pendant combien de temps et comment elles sont supprimées. N'envoyez aucune catégorie particulière de données personnelles (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans aucun champ.