Tem eventos? (por entidade)
Referência API
Tem eventos? (por entidade)
Verificação booleana rápida se uma entidade tem eventos de usuário vinculados — mesmo escopo de listar por entidade, sem retornar linhas ou totais.
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.
Identificadores de entidade: você pode consultar por query param sem o UUID interno. Prioridade de busca:
entity_id → entity_external_id → tax_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_id → entity_external_id → tax_id.
string
UUID da entidade (maior prioridade)Exemplo:
?entity_id=550e8400-e29b-41d4-a716-446655440000string
Identificador externo da entidade no seu sistemaExemplo:
?entity_external_id=user_12345string
Documento fiscal (CUIT/CUIL/CPF/CNPJ, etc.). Comparação exata e normalizada (somente alfanuméricos)Exemplo:
?tax_id=20242455496Resposta
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 falsestring
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 é trueListar eventos
Consultar com filtros
Estatísticas
Contagens por tipo de evento
Overview
Overview de eventos de usuário