Zustimmungen eines Benutzers auflisten

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

Listet die OAuth-Zustimmungen auf, die der Benutzer Anwendungen erteilt hat, neueste zuerst. Es werden nur aktive Zustimmungen zurückgegeben: Eine Zustimmung, die widerrufen wurde oder durch eine neuere Zustimmung derselben Anwendung ersetzt wurde, wird nicht aufgelistet. Die Liste wird nur vorwärts paginiert und liefert keine Gesamtanzahl. Die Antwort enthält nicht den Text des Zustimmungsdialogs, den der Benutzer gesehen hat.

Anfrage

Parameter In Erforderlich Beschreibung
user_id path ja Benutzer-ID mit Präfix usr_.
limit query nein Einträge pro Seite, 1–100 (Standard 20).
after query nein Cursor aus list_metadata.after der vorherigen Seite desselben Benutzers.

before und order=asc werden nicht unterstützt und liefern 422.

Antwort

200 OK. Leere Felder sind null.

{
  "data": [
    {
      "id": "cns_01jb2k8m5c3f6t9w2y4b7d0g3k",
      "user_id": "usr_0a1b2c3d4e5f6g7h8j9k0m1n2p",
      "application_id": "app_0a1b2c3d4e5f6g7h8j9k0m1n2p",
      "api_id": "api_0a1b2c3d4e5f6g7h8j9k0m1n2p",
      "org_id": null,
      "scopes": ["openid", "profile", "orders:read"],
      "authorization_details_types": [],
      "granted_at": "2026-10-20T09:00:00Z",
      "consent_screen_version": "3",
      "locale": "en",
      "prompt_reason": "scope_expansion"
    }
  ],
  "list_metadata": {"before": null, "after": null}
}
Feld Beschreibung
id Zustimmungs-ID mit Präfix cns_.
application_id Die Anwendung, der die Zustimmung erteilt wurde.
api_id Die API, an die die Zustimmung gebunden ist, falls vorhanden.
org_id Der Organisationskontext, in dem die Zustimmung erteilt wurde, falls vorhanden.
scopes Die erteilten Scopes, sortiert und eindeutig.
authorization_details_types Erteilte Typen für Rich Authorization Requests; leer, wenn keine vorhanden sind.
consent_screen_version, locale Version und Sprache des Zustimmungsdialogs, den der Benutzer akzeptiert hat.
prompt_reason Grund, warum eine Zustimmung angefragt wurde: first, scope_expansion, prompt_consent oder skip_consent (Erstanbieter-Anwendung ohne Zustimmungsdialog).

Fehler

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

HTTP code Wann
400 invalid_cursor Der Cursor ist fehlerhaft oder gehört zu einer anderen Liste.
422 validation_failed limit liegt außerhalb des gültigen Bereichs, oder before bzw. eine aufsteigende order wurde gesendet.
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/consents?limit=50" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

CLI: keenauth users consents list usr_0a1b2c3d4e5f6g7h8j9k0m1n2p --limit 50

Personenbezogene Daten

Dieser Endpunkt verarbeitet personenbezogene Daten: Zustimmungsdatensätze. 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.