> ## Documentation Index
> Fetch the complete documentation index at: https://userepass.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Events

> Event store: log de auditoria append-only com a taxonomia de tipos.

`repass.events` lê o [event store](/docs/conceitos/event-store), o log de auditoria **append-only** da organização, com todos os eventos de domínio emitidos a cada mudança de estado.

## Leitura

```ts theme={null}
// Listar (filtros opcionais por agregado e tipos)
await repass.events.list({
  aggregate_type: "conversion",
  types: ["conversion.created"],
}); // → RepassPage<DomainEvent>

await repass.events.retrieve("evt_…"); // → DomainEvent
```

## Taxonomia

`types()` retorna a taxonomia de tipos de evento disponíveis, um array (não paginado).

```ts theme={null}
await repass.events.types(); // → EventType[] (taxonomia de tipos, array)
```

<Note>
  Para o schema completo de cada corpo (filtros de listagem, formato do evento, tipos de agregado), consulte a [Referência da API](/docs/convencoes/ids-e-recursos). As regras de negócio estão em [Event store](/docs/conceitos/event-store).
</Note>