Zustimmungsnachweise eines Benutzers auflisten

GET /v1/users/{user_id}/consent-records · Berechtigung consent-records:read

Listet die Zustimmungsnachweise eines Benutzers (ein nur anhängbares Nachweisprotokoll) auf, neueste occurred_at zuerst, in Cursor-Seiten. Nur das Blättern vorwärts (after) ist verfügbar. Eine fehlerhafte Benutzer-ID liefert 404 not_found; ein Benutzer ohne Einträge oder ein Benutzer, der nicht in dieser Umgebung existiert, erhält eine leere Liste. Die Einträge enthalten keine IP-Adresse, keinen User-Agent und keine Sitzungsdaten.

Anfrage

Pfadparameter:

Feld Typ Erforderlich Beschreibung
user_id string ja Benutzer-ID (usr_…).

Abfrageparameter:

Feld Typ Erforderlich Beschreibung
limit integer nein 1–100, Standard 20.
after string nein Undurchsichtiger Cursor aus list_metadata.after.

Antwort

200 OK mit data (Zustimmungsnachweise) und list_metadata (before hat immer den Wert null). Es wird keine Gesamtanzahl zurückgegeben.

{
  "data": [
    {
      "id": "crec_01j9xk3m7q8r2s4t6v8w0y2z4b",
      "user_id": "usr_01j9xk3m7q8r2s4t6v8w0y2z4c",
      "subject_type": "document",
      "subject_id": "ldoc_01j9xk3m7q8r2s4t6v8w0y2z4a",
      "subject_version": "2026-10",
      "content_sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
      "locale": "en",
      "state": "accepted",
      "method": "management_api",
      "application_id": null,
      "occurred_at": "2026-10-05T09:31:12.004211Z"
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

Fehler

HTTP code Wann
400 invalid_cursor Der Cursor ist fehlerhaft oder wurde für einen anderen Filter ausgestellt.
404 not_found Die Benutzer-ID ist fehlerhaft.
422 validation_failed Ein Abfrageparameter ist ungültig.
401 unauthenticated Die Anmeldedaten fehlen, sind ungültig oder widerrufen.
403 insufficient_permissions Den Anmeldedaten fehlt die erforderliche Berechtigung.
429 rate_limited Das Rate-Limit wurde überschritten; versuchen Sie es nach Ablauf von Retry-After erneut.
503 service_unavailable Eine Abhängigkeit ist vorübergehend nicht verfügbar; versuchen Sie es nach Ablauf von Retry-After erneut.

Beispiel

curl "https://api.eu.keenauth.com/v1/users/usr_01j9xk3m7q8r2s4t6v8w0y2z4c/consent-records?limit=20" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

Personenbezogene Daten

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