E-Mail-Adressen eines Benutzers auflisten

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

Listet alle E-Mail-Adressen des Benutzers auf einer Seite auf: zuerst die primäre Adresse, danach nach Erstellungszeitpunkt. Ein Benutzer hat höchstens 10 Adressen (einschließlich der primären), daher gibt es keine limit-, after-, before- oder order-Parameter, und list_metadata ist immer mit null belegt. id ist die interne UUID des E-Mail-Eintrags und wird von den anderen E-Mail-Endpunkten verwendet.

Anfrage

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

Die Anfrage enthält keinen Body (ein leerer Body oder {} wird akzeptiert).

Antwort

200 OK. Ohne die Berechtigung users:read_pii wird die Adresse maskiert (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
  }
}

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, wird gerade gelöscht, 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/emails \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

Personenbezogene Daten

Dieser Endpunkt verarbeitet personenbezogene Daten: Profil des Endbenutzers. 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.