Lister les identités liées d'un utilisateur

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

Liste les identités liées d'un utilisateur (mot de passe, réseaux sociaux, SAML, OIDC et héritées) dans une seule page, triées par date de création. Le nombre d'identités par utilisateur est borné, donc la liste n'a pas de limit, after, before ni order, et list_metadata vaut toujours null. Le sujet externe d'une identité (sub OIDC, NameID SAML), l'adresse e-mail transmise par le fournisseur d'identité et la référence d'identifiant ne sont jamais renvoyés. Les clés d'accès et les méthodes à code à usage unique sont des authentificateurs et sont listés par GET /v1/users/{user_id}/authenticators.

Requête

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

Réponse

200 OK. data contient les identités triées par date de création ; list_metadata vaut toujours null car la liste n'est pas paginée. connection_id vaut null pour password ; provider n'est renseigné que pour social.

Les identifiants d'identité portent le préfixe idn_.

{
  "data": [
    {
      "id": "idn_0a1b2c3d4e5f6g7h8j9k0m1n2q",
      "type": "password",
      "connection_id": null,
      "provider": null,
      "linked_via": "primary",
      "created_at": "2026-01-15T09:30:00Z"
    },
    {
      "id": "idn_0a1b2c3d4e5f6g7h8j9k0m1n2r",
      "type": "social",
      "connection_id": "conn_0a1b2c3d4e5f6g7h8j9k0m1n2s",
      "provider": "google",
      "linked_via": "manual_link",
      "created_at": "2026-02-01T08:00:00Z"
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

type : password, social, saml, oidc, legacy · linked_via : primary, auto_verified_email, user_confirmed, admin_api, import, jit, auto_domain, invite_proof, manual_link, scim_match

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 (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/identities \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

Données personnelles

Cet endpoint traite des données personnelles : les identités liées. 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.