Lister les adresses e-mail d'un utilisateur

GET /v1/users/{user_id}/emails · autorisation users:read

Liste toutes les adresses e-mail de l'utilisateur dans une seule page : l'adresse principale en premier, puis par date de création. Un utilisateur possède au maximum 10 adresses (adresse principale comprise), donc la liste n'a pas de limit, after, before ni order, et list_metadata vaut toujours null. id est l'UUID interne de la ligne d'adresse e-mail, utilisé par les autres endpoints e-mail.

Requête

Paramètre	Dans	Obligatoire	Description
`user_id`	path	oui	Identifiant de l'utilisateur, préfixé `usr_`.

La requête ne prend aucun corps (un corps vide ou {} est accepté).

Réponse

200 OK. Sans l'autorisation users:read_pii, l'adresse est masquée (a***@e***.com).

{
  "data": [
    {
      "id": "0191f0a0-3333-7444-8555-666666666661",
      "email": "ada@example.com",
      "verified": true,
      "primary": true,
      "created_at": "2026-01-15T09:30:00Z"
    },
    {
      "id": "0191f0a0-3333-7444-8555-666666666666",
      "email": "ada.work@example.com",
      "verified": false,
      "primary": false,
      "created_at": "2026-02-01T08:00:00Z"
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

Erreurs

Chaque erreur est un corps application/problem+json avec un code stable.

HTTP	`code`	Quand
404	`not_found`	L'utilisateur n'existe pas dans cet environnement, est en cours de suppression, ou l'identifiant est mal formé.
401	`unauthenticated`	La clé d'API est absente, invalide ou révoquée.
403	`insufficient_permissions`	La clé ne dispose pas de l'autorisation `users:read`.
429	`rate_limited`	La limite de débit a été dépassée ; respectez `Retry-After`.
503	`service_unavailable`	Une dépendance est temporairement indisponible ; réessayez plus tard.

Exemple

curl https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p/emails \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

Données personnelles

Cet endpoint traite des données personnelles : le profil de l'utilisateur final. Données personnelles dans les API KeenAuth décrit ce qui est stocké, la durée de conservation et la manière dont 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.