セッションの取得
GET /v1/sessions/{session_id} · 権限 sessions:read
どのステータス（active、expired、revoked）のセッションでも、1 件を返します。IP アドレスは完全な形で表示され、この参照操作は管理監査ログに記録されます。Cookie、トークン、デバイスのフィンガープリントは返されません。
リクエスト
| パラメータ | 指定場所 | 必須 | 説明 |
|---|---|---|---|
session_id |
path | はい | セッション ID。接頭辞は ses_ です。 |
レスポンス
200 OK。空のフィールドは null になります。
{
"id": "ses_0a1b2c3d4e5f6g7h8j9k0m1n2p",
"user_id": "usr_0a1b2c3d4e5f6g7h8j9k0m1n2p",
"status": "revoked",
"login_host": "login.example.com",
"auth_time": "2026-02-01T08:00:00Z",
"acr": "1fa",
"amr": ["pwd"],
"created_at": "2026-02-01T08:00:00Z",
"last_seen_at": "2026-02-01T09:15:00Z",
"idle_expires_at": "2026-02-08T09:15:00Z",
"absolute_expires_at": "2026-03-03T08:00:00Z",
"org_id": "org_0a1b2c3d4e5f6g7h8j9k0m1n2p",
"ip_address": "203.0.113.10",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_0)",
"revoked_at": "2026-02-01T10:00:00Z",
"revoke_reason": "admin"
}
revoke_reason は revoked のセッションにのみ設定されます。値の例は admin、user_logout、idp_logout、refresh_reuse です。
エラー
すべてのエラーは、安定した code を含む application/problem+json ボディで返されます。
| HTTP | code |
発生条件 |
|---|---|---|
| 404 | not_found |
この環境にセッションが存在しないか、ID の形式が不正です。 |
| 401 | unauthenticated |
API キーが指定されていないか、不正であるか、取り消されています。 |
| 403 | insufficient_permissions |
このキーには sessions:read 権限がありません。 |
| 429 | rate_limited |
レート制限を超えました。Retry-After に従ってください。 |
| 503 | service_unavailable |
依存先が一時的に利用できません。しばらくしてから再試行してください。 |
例
curl https://api.eu.keenauth.com/v1/sessions/ses_0a1b2c3d4e5f6g7h8j9k0m1n2p \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
CLI: keenauth sessions get ses_0a1b2c3d4e5f6g7h8j9k0m1n2p
個人データ
このエンドポイントは個人データ（セッション）を扱います。KeenAuth API における個人データでは、保存される内容、保存期間、削除方法について説明しています。いずれのフィールドにも、特別な種類の個人データ（健康、生体情報、宗教、政治的意見、性的指向）を送信しないでください。