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

`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`).

```json
{
  "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` | 종속 서비스를 일시적으로 사용할 수 없습니다. 나중에 다시 시도하십시오. |

## 예제

```bash
curl https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p/emails \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```

## 개인정보

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