# Obtenir un événement

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

Renvoie un événement dans la même structure, avec le même `id`, que celle transmise par les webhooks (charge utile allégée). L'`id` correspond aussi à l'en-tête `webhook-id` de la livraison, ce qui permet de récupérer l'événement annoncé par un webhook.

## Requête

| Paramètre | Emplacement | Obligatoire | Description |
|---|---|---|---|
| `event_id` | path | oui | Identifiant de l'événement, préfixé par `evt_`. |

## Réponse

`200 OK` et l'événement, dans la même structure qu'un élément de [Lister les événements](list.md).

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

## Erreurs

Chaque erreur est un corps `application/problem+json` accompagné d'un `code` stable.

| HTTP | `code` | Quand |
|---|---|---|
| 401 | `unauthenticated` | La clé d'API est absente, invalide ou révoquée. |
| 403 | `insufficient_permissions` | La clé ne possède pas `events:read`. |
| 404 | `not_found` | L'événement n'existe pas, appartient à un autre environnement, a plus de 30 jours, ou l'identifiant est mal formé. |
| 429 | `rate_limited` | La limite de débit a été dépassée ; respectez `Retry-After`. |
| 503 | `service_unavailable` | Une dépendance est temporairement indisponible ; réessayez plus tard. |

## Données personnelles

Cet endpoint traite des données personnelles : les événements. [Données personnelles dans les API KeenAuth](/docs/policies/personal-data) décrit ce qui est stocké, la durée de conservation et la manière dont elles sont supprimées. N'envoyez de données sensibles au sens du RGPD (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans aucun champ.