セッションを一覧表示

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

認証済みユーザーの有効なセッションを、最後にアクセスされた順(新しいものが先)で返します。リクエストを行っているセッションには current: true が設定されます。認証済みユーザーの __Host-idp_session Cookie が必要です。Cookie がない、期限切れである、または取り消されている場合は 401 unauthenticated を返します。別のオリジンにある自社アプリは、代わりにフロント API アクセストークン(DPoP 証明付きの Authorization: DPoP <token>。フロント API アクセストークンを参照)を送信できます。直近での再検証は不要です。

リクエスト

ヘッダー:

ヘッダー 必須 説明
Idp-Client はい SDK の識別子です。

ボディはありません。

レスポンス

200 OK:

フィールド 型 説明
data[].id string セッション識別子(ses_…)です。
data[].current boolean リクエストを行っているセッションかどうかです。
data[].login_host string セッションが開始されたサインインホストです。
data[].browser_family string 判明している場合のブラウザファミリーです。
data[].os_family string 判明している場合のオペレーティングシステムファミリーです。
data[].device_type string 判明している場合のデバイスの種類です。
data[].country string 判明している場合に、セッションが開始された国です(ISO 3166-1 alpha-2)。
data[].ip_address string 最後に確認された IP アドレスです。ない場合はセッション開始時の IP アドレスです。保持期間を過ぎると存在しません。ユーザー本人にのみ表示されます。
data[].created_at string セッションが開始された日時です(RFC 3339、UTC)。
data[].last_seen_at string セッションが最後に使用された日時です(RFC 3339、UTC)。
{
  "data": [
    {
      "id": "ses_01jbz6x8kq3m2n4p5r6s7t8v9w",
      "current": true,
      "login_host": "example.keenauth.app",
      "browser_family": "firefox",
      "os_family": "linux",
      "device_type": "desktop",
      "country": "DE",
      "ip_address": "192.0.2.10",
      "created_at": "2026-10-01T09:30:00Z",
      "last_seen_at": "2026-10-12T08:15:00Z"
    }
  ]
}

エラー

ステータス コード 発生条件
401 unauthenticated 有効なセッション Cookie がありません。

例

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

個人データ

このエンドポイントは個人データ(セッション)を扱います。KeenAuth API における個人データでは、保存される内容、保存期間、削除方法を説明しています。どのフィールドにも特別な種類の個人データ(健康、生体データ、宗教、政治的意見、性的指向)を送信しないでください。