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).
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). |
{
"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
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 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.