ユーザーの同意を一覧表示

GET /v1/users/{user_id}/consents · 権限 users:read

ユーザーがアプリケーションに付与した OAuth の同意を、新しいものから順に一覧表示します。返されるのは有効な同意のみです。取り消された同意や、同じアプリケーションの新しい同意に置き換えられた同意は一覧に含まれません。一覧は前方へのみページングでき、総件数は返しません。レスポンスには、ユーザーが表示した同意画面のテキストは含まれません。

リクエスト

パラメータ 場所 必須 説明
user_id path はい ユーザー ID。接頭辞は usr_。
limit query いいえ ページあたりの件数。1～100（既定値は 20）。
after query いいえ 同じユーザーの前のページの list_metadata.after から取得したカーソル。

before と order=asc はサポートされておらず、422 を返します。

レスポンス

200 OK。空のフィールドは 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}
}
フィールド 説明
id 同意 ID。接頭辞は cns_。
application_id 同意が付与されたアプリケーション。
api_id 同意の紐付け先の API（ある場合）。
org_id 同意が付与された組織のコンテキスト（ある場合）。
scopes 付与されたスコープ。ソート済みで重複はありません。
authorization_details_types 付与されたリッチ認可リクエストの種類。ない場合は空です。
consent_screen_version, locale ユーザーが承諾した同意画面のバージョンと言語。
prompt_reason 同意を求めた理由: first, scope_expansion, prompt_consent, skip_consent（同意画面のない自社アプリケーション）。

エラー

すべてのエラーは、安定した code を含む application/problem+json 本文です。

HTTP code 発生条件
400 invalid_cursor カーソルの形式が不正か、別の一覧に属しています。
422 validation_failed limit が範囲外か、before または昇順の order が送信されました。
404 not_found この環境にユーザーが存在しない（または ID の形式が不正）。
401 unauthenticated API キーがないか、無効または取り消されています。
403 insufficient_permissions キーに users:read 権限がありません。
429 rate_limited レート制限を超えました。Retry-After に従ってください。
503 service_unavailable 依存先が一時的に利用できません。後でリトライしてください。

例

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

個人データ

このエンドポイントは個人データ（同意の記録）を扱います。KeenAuth API における個人データでは、保存される内容、保持期間、削除方法を説明しています。いかなるフィールドにも、特別な種類の個人データ（健康、生体データ、宗教、政治的意見、性的指向）を送信しないでください。