Verknüpfte Identitäten eines Benutzers auflisten

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

Listet die verknüpften Identitäten eines Benutzers (Passwort, Social, SAML, OIDC und Legacy) auf einer Seite auf, sortiert nach Erstellungszeitpunkt. Die Anzahl der Identitäten pro Benutzer ist begrenzt, daher gibt es keine limit-, after-, before- oder order-Parameter, und list_metadata ist immer mit null belegt. Der externe Subject-Wert einer Identität (OIDC sub, SAML NameID), die vom Identitätsanbieter gemeldete E-Mail-Adresse und die Referenz auf die Anmeldedaten werden nie zurückgegeben. Passkeys und Einmalcode-Verfahren sind Authentifikatoren und werden über GET /v1/users/{user_id}/authenticators aufgelistet.

Anfrage

Parameter In Erforderlich Beschreibung
user_id path ja Benutzer-ID mit Präfix usr_.

Antwort

200 OK. data enthält die Identitäten, sortiert nach Erstellungszeitpunkt; list_metadata ist immer mit null belegt, weil die Liste nicht paginiert ist. connection_id ist für password null; provider ist nur für social gesetzt.

Identitäts-IDs tragen das Präfix 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

Fehler

Jeder Fehler ist ein application/problem+json-Body mit einem stabilen code.

HTTP code Wann
404 not_found Der Benutzer existiert in dieser Umgebung nicht (oder die ID ist fehlerhaft).
401 unauthenticated Der API-Schlüssel fehlt, ist ungültig oder wurde widerrufen.
403 insufficient_permissions Der Schlüssel hat nicht die Berechtigung users:read.
429 rate_limited Das Ratenlimit wurde überschritten; beachten Sie Retry-After.
503 service_unavailable Eine Abhängigkeit ist vorübergehend nicht verfügbar; versuchen Sie es später erneut.

Beispiel

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

Personenbezogene Daten

Dieser Endpunkt verarbeitet personenbezogene Daten: verknüpfte Identitäten. Personenbezogene Daten in den KeenAuth-APIs beschreibt, was gespeichert wird, wie lange es aufbewahrt wird und wie es gelöscht wird. Übermitteln Sie keine besonderen Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung) in irgendeinem Feld.