> ## 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 (CLI)

> Event store: log de auditoria append-only da organização, com a taxonomia de tipos.

O grupo `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. Só tem comandos de leitura.

## Leitura

```bash theme={null}
# Listar (paginado; filtros por agregado, tipo(s), ator e período)
repass events list --aggregate-type conversion --type conversion.created --json

# Vários tipos combinados por OU (repita a flag)
repass events list --types conversion.created --types conversion.voided --json

# Buscar o envelope completo de um evento
repass events get evt_xxx --json
```

`events list` é paginado. Veja [Paginação](/docs/cli/paginacao) para `--all` e cursores.

```json repass events get evt_xxx --json theme={null}
{
  "id": "evt_01J9Z…",
  "type": "conversion.created",
  "aggregateType": "conversion",
  "aggregateId": "conv_xxx",
  "occurredAt": "2026-07-01T12:00:00Z",
  "actorType": "api_key",
  "payload": { … },
  …
}
```

## Taxonomia

`events types` retorna a taxonomia de tipos de evento reconhecidos pela API: um array simples, **não paginado**.

```bash theme={null}
repass events types --json
```

<Note>
  Para o schema completo de cada corpo (filtros de listagem, formato do evento, tipos de agregado), consulte a página SDK equivalente ([Events](/docs/sdk/recursos/events)) e 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>