ユーザーのメールアドレスを一覧表示

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

ユーザーのメールアドレスをすべて 1 ページで一覧表示します。プライマリアドレスが先頭に、その後は作成日時順に並びます。ユーザーが持てるアドレスは最大 10 件（プライマリを含む）のため、一覧には limit、after、before、order がなく、list_metadata は常に値が null です。id はメール行の内部 UUID で、他のメールエンドポイントで使用されます。

リクエスト

パラメータ	場所	必須	説明
`user_id`	path	はい	ユーザー ID。接頭辞は `usr_`。

リクエストにボディは不要です（空のボディや {} も受け付けます）。

レスポンス

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 における個人データでは、保存される内容、保持期間、削除方法を説明しています。いかなるフィールドにも、特別な種類の個人データ（健康、生体データ、宗教、政治的意見、性的指向）を送信しないでください。