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:| Aspecto | Comportamento |
|---|---|
| Consultas | Duas idas: lookup da entidade + uma sonda LIMIT 1 em user_events |
| Não faz | COUNT(*), ORDER BY, paginação nem colunas completas de evento/metadata |
| Índices | organization_id + entity_id usa idx_user_events_organization_entity_id; entity_external_id e tax_id têm índices dedicados nas ramas do OR |
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.
UUID da entidade (maior prioridade)Exemplo:
?entity_id=550e8400-e29b-41d4-a716-446655440000Identificador externo da entidade no seu sistemaExemplo:
?entity_external_id=user_12345Documento fiscal (CUIT/CUIL/CPF/CNPJ, etc.). Comparação exata e normalizada (somente alfanuméricos)Exemplo:
?tax_id=20242455496Resposta
Indica se a requisição foi bem-sucedida
true se existir pelo menos um evento vinculado (mesmo escopo de listar por entidade); caso contrário falseUUID interno da entidade resolvida (útil quando consultou por
entity_external_id ou tax_id)Exemplo — com eventos
Exemplo — sem eventos
Erros
| Estado | Código | Quando |
|---|---|---|
| 400 | — | Falta qualquer identificador de entidade na query |
| 404 | ENTITY_NOT_FOUND | A entidade não existe na org ou está excluída (soft delete) |
| 401 | — | API key ausente ou inválida |
| 403 | — | Permissões insuficientes (events:read) |
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