# イベントを取得する

`GET /v1/events/{event_id}` · 権限 `events:read`

Webhook が配信するものと同じ形式、同じ `id` で 1 件のイベントを返します（シンペイロード）。この `id` は配信時の `webhook-id` ヘッダーにもなっているため、Webhook が通知したイベントを取得できます。

## リクエスト

| パラメーター | 場所 | 必須 | 説明 |
|---|---|---|---|
| `event_id` | パス | はい | イベント ID。`evt_` で始まります。 |

## レスポンス

`200 OK` とイベントを返します。形式は [イベントの一覧取得](list.md) の項目と同じです。

```bash
curl -sS https://api.keenauth.com/v1/events/evt_01j9xk3m7q8r2s4t6v8w0y2z4a \
  -H "Authorization: Bearer $KEENAUTH_API_KEY"
```

## エラー

すべてのエラーは、安定した `code` を含む `application/problem+json` の本文で返されます。

| HTTP | `code` | 発生条件 |
|---|---|---|
| 401 | `unauthenticated` | API キーがない、無効である、または取り消されています。 |
| 403 | `insufficient_permissions` | キーに `events:read` がありません。 |
| 404 | `not_found` | イベントが存在しない、別の環境に属している、30 日より古い、または ID の形式が不正です。 |
| 429 | `rate_limited` | レート制限を超えました。`Retry-After` に従ってください。 |
| 503 | `service_unavailable` | 依存先が一時的に利用できません。後ほど再試行してください。 |

## 個人データ

このエンドポイントはイベントという個人データを扱います。[KeenAuth API における個人データ](/docs/policies/personal-data)では、保存される内容、保存期間、削除方法を説明しています。いかなるフィールドにも、特別な種類の個人データ（健康、生体情報、宗教、政治的意見、性的指向）を送信しないでください。