Skip to main content
GET
Tem eventos? (por entidade)

Visão geral

Use este endpoint quando você só precisa saber se uma entidade tem eventos de usuário (badges na UI, visibilidade de abas, pré-checagens), não a linha do tempo completa. Usa o mesmo escopo de vínculo que Listar por entidade: entity_id, entity_external_id ou tax_id na sua organização.
Prefira este endpoint em vez de listar com limit=1 quando só precisar de sim/não — evita COUNT(*), ordenação e serializar payloads de eventos.
Identificadores de entidade: você pode consultar por query param sem o UUID interno. Prioridade de busca: entity_identity_external_idtax_id (se enviar mais de um, vence o de maior prioridade). Para tax_id, a comparação no DB normaliza caracteres não alfanuméricos (ex.: 20-24245549-6 e 20242455496).A rota legada GET …/entity/{entityId}/has-events continua disponível quando você já tem o UUID.

Desempenho

Projetado para baixa latência: A latência típica é dominada por rede e autenticação, não por varrer históricos grandes.

Endpoint

Autenticação

Requer API key válida no header Authorization:

Parâmetros de consulta

Pelo menos um é obrigatório. Se enviar vários, a prioridade é entity_identity_external_idtax_id.
string
UUID da entidade (maior prioridade)Exemplo: ?entity_id=550e8400-e29b-41d4-a716-446655440000
string
Identificador externo da entidade no seu sistemaExemplo: ?entity_external_id=user_12345
string
Documento fiscal (CUIT/CUIL/CPF/CNPJ, etc.). Comparação exata e normalizada (somente alfanuméricos)Exemplo: ?tax_id=20242455496

Resposta

boolean
Indica se a requisição foi bem-sucedida
boolean
true se existir pelo menos um evento vinculado (mesmo escopo de listar por entidade); caso contrário false
string
UUID interno da entidade resolvida (útil quando consultou por entity_external_id ou tax_id)

Exemplo — com eventos

Exemplo — sem eventos

Erros

Exemplos

Próximos passos

Listar por entidade

Linha do tempo completa quando hasEvents é true

Listar eventos

Consultar com filtros

Estatísticas

Contagens por tipo de evento

Overview

Overview de eventos de usuário