사용자 동의 목록 조회

GET /v1/users/{user_id}/consents · 권한 users:read

사용자가 애플리케이션에 부여한 OAuth 동의를 최신순으로 나열합니다. 활성 동의만 반환됩니다. 철회되었거나 같은 애플리케이션의 더 최신 동의로 대체된 동의는 목록에 포함되지 않습니다. 목록은 앞으로만 페이징되며 전체 개수는 반환하지 않습니다. 응답에는 사용자가 본 동의 화면의 텍스트가 포함되지 않습니다.

요청

매개변수 위치 필수 설명
user_id path 예 usr_ 접두사가 붙은 사용자 ID입니다.
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 cns_ 접두사가 붙은 동의 ID입니다.
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의 개인정보에서 저장되는 내용, 보관 기간, 삭제 방법을 확인하십시오. 어떤 필드에도 민감정보(건강, 생체 정보, 종교, 정치적 견해, 성적 지향)를 보내지 마십시오.