사용자 이메일 주소 목록 조회

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

사용자의 모든 이메일 주소를 한 페이지에 나열합니다. 기본 주소가 먼저 나오고, 그다음 생성 시간순입니다. 사용자는 기본 주소를 포함해 최대 10개의 주소를 가질 수 있으므로, 목록에는 limit, after, before, order가 없으며 list_metadata는 항상 null 값입니다. id는 이메일 행의 내부 UUID이며 다른 이메일 엔드포인트에서 사용합니다.

요청

매개변수	위치	필수	설명
`user_id`	path	예	`usr_` 접두사가 붙은 사용자 ID입니다.

요청에는 본문이 필요하지 않습니다(빈 본문 또는 {}를 허용합니다).

응답

200 OK. users:read_pii 권한이 없으면 주소가 마스킹됩니다(a***@e***.com).

{
  "data": [
    {
      "id": "0191f0a0-3333-7444-8555-666666666661",
      "email": "ada@example.com",
      "verified": true,
      "primary": true,
      "created_at": "2026-01-15T09:30:00Z"
    },
    {
      "id": "0191f0a0-3333-7444-8555-666666666666",
      "email": "ada.work@example.com",
      "verified": false,
      "primary": false,
      "created_at": "2026-02-01T08:00:00Z"
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

오류

모든 오류는 안정적인 code가 포함된 application/problem+json 본문으로 반환됩니다.

HTTP	`code`	발생 조건
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/emails \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

개인정보

이 엔드포인트는 개인정보인 최종 사용자 프로필을 포함합니다. KeenAuth API의 개인정보에서 저장되는 내용, 보관 기간, 삭제 방법을 확인하십시오. 어떤 필드에도 민감정보(건강, 생체 정보, 종교, 정치적 견해, 성적 지향)를 보내지 마십시오.