ログを取得
GET /v1/logs/{log_id} · 権限 logs:read
details を含む 1 件のログレコードを返します。
リクエスト
| パラメーター | 場所 | 必須 | 説明 |
|---|---|---|---|
log_id |
path | はい | ログレコードの ID。接頭辞は evt_ です。 |
レスポンス
レコードを含む 200 OK を返します。空のフィールドは null になります。
ip、ip_asn、user_agent、user_agent_family は、キーが audit-events:read_ip 権限を持つ場合にのみ含まれ、identifier_hint は users:read_pii 権限を持つ場合にのみ含まれます。権限がない場合、そのフィールドは (マスクされた値も含めて) 完全に省略されます。ip_country は常に返されます。
{
"id": "evt_01j9xk3m7q8r2s4t6v8w0y2z4a",
"occurred_at": "2026-10-01T08:15:42.120Z",
"type": "authentication.password.failed",
"outcome": "failure",
"reason_code": "invalid_credentials",
"user_id": "usr_0a1b2c3d4e5f6g7h8j9k0m1n2p",
"org_id": null,
"application_id": "app_01j9xk3m7q8r2s4t6v8w0y2z4b",
"connection_id": "conn_01j9xk3m7q8r2s4t6v8w0y2z4c",
"directory_id": null,
"session_id": null,
"identifier_hint": "a***@e***.com",
"ip": "203.0.113.7",
"ip_country": "DE",
"ip_asn": 64500,
"user_agent": "Mozilla/5.0 (X11; Linux x86_64)",
"user_agent_family": "Firefox",
"risk": null,
"auth_context": null,
"act_chain": null,
"details": {"attempt": 3},
"request_id": "0192a6c1-7d3e-7a10-9b2c-3d4e5f607182",
"correlation_id": null,
"trace_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
エラー
すべてのエラーは、安定した code を含む application/problem+json ボディで返されます。
| HTTP | code |
発生条件 |
|---|---|---|
| 401 | unauthenticated |
API キーが存在しない、無効、または取り消されています。 |
| 403 | insufficient_permissions |
キーに logs:read 権限がありません。 |
| 404 | not_found |
レコードが存在しないか、別の環境に属しているか、保持期間の外にあります。 |
| 429 | rate_limited |
レート制限を超えました。Retry-After に従ってください。 |
| 503 | service_unavailable |
依存先が一時的に利用できません。後で再試行してください。 |
例
curl https://api.eu.keenauth.com/v1/logs/log_01j9xk3m7q8r2s4t6v8w0y2z4a \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
個人データ
このエンドポイントは個人データ(環境のログ)を扱います。KeenAuth API における個人データでは、保存される内容、保持期間、削除方法について説明しています。いかなるフィールドにも、特別な種類の個人データ(健康、生体情報、宗教、政治的意見、性的指向)を送信しないでください。