Lister les enregistrements de consentement d'un utilisateur

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

Liste les enregistrements de consentement d'un utilisateur (une piste de preuves en ajout seul), du plus récent occurred_at au plus ancien, en pages à curseur. Seule la pagination vers l'avant (after) est disponible. Un identifiant d'utilisateur mal formé renvoie 404 not_found ; un utilisateur sans enregistrement, ou absent de cet environnement, obtient une liste vide. Les enregistrements ne contiennent ni adresse IP, ni user agent, ni données de session.

Requête

Paramètres de chemin :

Champ Type Requis Description
user_id string oui Identifiant de l'utilisateur (usr_…).

Paramètres de requête :

Champ Type Requis Description
limit integer non De 1 à 100, 20 par défaut.
after string non Curseur opaque issu de list_metadata.after.

Réponse

200 OK avec data (enregistrements de consentement) et list_metadata (before vaut toujours null). Aucun nombre total n'est renvoyé.

{
  "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
  }
}

Erreurs

HTTP code Cas
400 invalid_cursor Le curseur est mal formé ou a été émis pour un autre filtre.
404 not_found L'identifiant de l'utilisateur est mal formé.
422 validation_failed Un paramètre de requête est invalide.
401 unauthenticated L'identifiant d'accès est absent, invalide ou révoqué.
403 insufficient_permissions L'identifiant d'accès ne dispose pas de l'autorisation requise.
429 rate_limited La limite de débit a été dépassée ; réessayez après le délai indiqué par Retry-After.
503 service_unavailable Une dépendance est temporairement indisponible ; réessayez après le délai indiqué par Retry-After.

Exemple

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

Données personnelles

Cet endpoint traite des données personnelles : des enregistrements de consentement. Données personnelles dans les API KeenAuth décrit ce qui est stocké, la durée de conservation et la manière dont elles sont supprimées. N'envoyez pas de catégories particulières de données personnelles (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans un champ quelconque.