# Obtener un evento

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

Devuelve un evento en el mismo formato, con el mismo `id`, que entregan los webhooks (carga reducida). El `id` también es el encabezado `webhook-id` de la entrega, por lo que puede obtener el evento que anunció un webhook.

## Solicitud

| Parámetro | En | Obligatorio | Descripción |
|---|---|---|---|
| `event_id` | path | sí | Id del evento, con el prefijo `evt_`. |

## Respuesta

`200 OK` y el evento, en el mismo formato que un elemento de [Listar eventos](list.md).

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

## Errores

Cada error es un cuerpo `application/problem+json` con un `code` estable.

| HTTP | `code` | Cuándo |
|---|---|---|
| 401 | `unauthenticated` | La clave de API falta, no es válida o fue revocada. |
| 403 | `insufficient_permissions` | La clave no tiene `events:read`. |
| 404 | `not_found` | El evento no existe, pertenece a otro entorno, tiene más de 30 días o el id tiene un formato incorrecto. |
| 429 | `rate_limited` | Se superó el límite de solicitudes; respete `Retry-After`. |
| 503 | `service_unavailable` | Una dependencia no está disponible temporalmente; reintente más tarde. |

## Datos personales

Este endpoint contiene datos personales: eventos. [Datos personales en las API de KeenAuth](/docs/policies/personal-data) describe qué se almacena, durante cuánto tiempo se conserva y cómo se elimina. No envíe categorías especiales de datos personales (salud, datos biométricos, religión, opiniones políticas, orientación sexual) en ningún campo.