# 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.

```json
{
  "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

```bash
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](/docs/policies/personal-data) 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.