# メールアドレスの一覧取得

`GET /fapi/v1/me/emails` · 環境のサインインホストから呼び出します

認証済みユーザーのメールアドレスを返します。主要なアドレスが先頭に来て、その後は追加された日時の順に並びます。ユーザーが保持できるアドレスは、主要なアドレスを含めて最大 10 件です。認証済みユーザーの `__Host-idp_session` Cookie が必要です。Cookie がない、期限切れ、または取り消されている場合は、`401 unauthenticated` を返します。別のオリジンにある自社アプリは、代わりにフロント API のアクセストークンを送信できます（DPoP プルーフを添えた `Authorization: DPoP <token>`。[フロント API アクセストークン](/docs/api/fapi/front-api-token)を参照してください）。

## リクエスト

ヘッダー:

| ヘッダー | 必須 | 説明 |
| --- | --- | --- |
| `Idp-Client` | はい | SDK の識別子。 |
| `Origin` | はい | 正確に `https://<sign-in host>` である必要があります。 |

ボディなし。

## レスポンス

`200 OK`:

| フィールド | 型 | 説明 |
| --- | --- | --- |
| `data[].id` | string | メールアドレスの識別子（小文字の UUID）。 |
| `data[].email` | string | アドレス。 |
| `data[].verified` | boolean | ユーザーがそのアドレスの所有を証明済みかどうか。 |
| `data[].primary` | boolean | 主要なアドレスかどうか。 |
| `data[].created_at` | string | アドレスが追加された日時（RFC 3339、UTC）。 |

```json
{
  "data": [
    {
      "id": "0190a5c4-1b2c-7d3e-8f40-516273849abc",
      "email": "ada@example.com",
      "verified": true,
      "primary": true,
      "created_at": "2026-10-01T09:30:00Z"
    }
  ]
}
```

## エラー

| ステータス | コード | 発生条件 |
| --- | --- | --- |
| 401 | `unauthenticated` | 有効なセッション Cookie がない。 |
| 403 | `origin_not_allowed` | `Origin` がない、または誤っている。 |

## 例

```bash
curl https://example.keenauth.app/fapi/v1/me/emails \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -H "Origin: https://example.keenauth.app" \
  -b cookies.txt
```

## 個人データ

このエンドポイントは個人データ（エンドユーザーのプロフィール）を扱います。[KeenAuth API における個人データ](/docs/policies/personal-data)では、保存される内容、保管期間、削除方法を説明しています。いかなるフィールドにも、特別な種類の個人データ（健康、生体情報、宗教、政治的意見、性的指向）を送信しないでください。