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

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

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

リクエスト

ヘッダー:

ヘッダー	必須	説明
`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）。

{
  "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` がない、または誤っている。

例

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