# Ein Ereignis abrufen

`GET /v1/events/{event_id}` · Berechtigung `events:read`

Gibt ein Ereignis in derselben Form zurück, mit derselben `id`, die Webhooks ausliefern (Thin Payload). Die `id` ist außerdem der Header `webhook-id` der Zustellung, sodass Sie das Ereignis abrufen können, das ein Webhook angekündigt hat.

## Anfrage

| Parameter | In | Pflicht | Beschreibung |
|---|---|---|---|
| `event_id` | path | ja | Ereignis-ID, mit dem Präfix `evt_`. |

## Antwort

`200 OK` und das Ereignis in derselben Form wie ein Eintrag unter [Ereignisse auflisten](list.md).

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

## Fehler

Jeder Fehler ist ein Body vom Typ `application/problem+json` mit einem stabilen `code`.

| HTTP | `code` | Wann |
|---|---|---|
| 401 | `unauthenticated` | Der API-Schlüssel fehlt, ist ungültig oder widerrufen. |
| 403 | `insufficient_permissions` | Der Schlüssel besitzt nicht `events:read`. |
| 404 | `not_found` | Das Ereignis existiert nicht, gehört zu einer anderen Umgebung, ist älter als 30 Tage, oder die ID ist fehlerhaft. |
| 429 | `rate_limited` | Das Ratenlimit wurde überschritten; beachten Sie `Retry-After`. |
| 503 | `service_unavailable` | Eine Abhängigkeit ist vorübergehend nicht verfügbar; wiederholen Sie die Anfrage später. |

## Personenbezogene Daten

Dieser Endpunkt verarbeitet personenbezogene Daten: Ereignisse. [Personenbezogene Daten in den KeenAuth-APIs](/docs/policies/personal-data) beschreibt, was gespeichert wird, wie lange es aufbewahrt wird und wie es gelöscht wird. Senden Sie in keinem Feld besondere Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung).