¿Tiene eventos? (por entidad)
Referencia API
¿Tiene eventos? (por entidad)
Comprobación rápida booleana de si una entidad tiene eventos de usuario vinculados — mismo alcance que listar por entidad, sin devolver filas ni totales.
GET
¿Tiene eventos? (por entidad)
Descripción general
Usá este endpoint cuando solo necesitás saber si una entidad tiene eventos de usuario (badges en UI, visibilidad de pestañas, prechecks), no la línea de tiempo completa. Usa el mismo criterio de vinculación que Listar por entidad:entity_id, entity_external_id o tax_id dentro de tu organización.
Identificadores de entidad: podés consultar por query param sin conocer el UUID interno. Prioridad de búsqueda:
entity_id → entity_external_id → tax_id (si mandás más de uno, gana el de mayor prioridad). Para tax_id la comparación en DB normaliza caracteres no alfanuméricos (p. ej. 20-24245549-6 y 20242455496).La ruta legacy GET …/entity/{entityId}/has-events sigue disponible cuando ya tenés el UUID.Rendimiento
Pensado para baja latencia:| Aspecto | Comportamiento |
|---|---|
| Consultas | Dos viajes: lookup de entidad + una sonda LIMIT 1 en user_events |
| No hace | COUNT(*), ORDER BY, paginación ni devolver columnas completas de eventos/metadata |
| Índices | organization_id + entity_id usa idx_user_events_organization_entity_id; entity_external_id y tax_id tienen índices dedicados en sus ramas del OR |
Endpoint
Autenticación
Requiere API key válida en el header Authorization:Parámetros de consulta
Al menos uno es obligatorio. Si enviás varios, la prioridad esentity_id → entity_external_id → tax_id.
UUID de la entidad (máxima prioridad)Ejemplo:
?entity_id=550e8400-e29b-41d4-a716-446655440000Identificador externo de la entidad en tu sistemaEjemplo:
?entity_external_id=user_12345Documento fiscal (CUIT/CUIL/CPF/CNPJ, etc.). Comparación exacta y normalizada (solo alfanuméricos)Ejemplo:
?tax_id=20242455496Respuesta
Indica si la solicitud fue exitosa
true si existe al menos un evento vinculado (mismo alcance que listar por entidad); si no, falseUUID interno de la entidad resuelta (útil si consultaste por
entity_external_id o tax_id)Ejemplo — con eventos
Ejemplo — sin eventos
Errores
| Estado | Código | Cuándo |
|---|---|---|
| 400 | — | Falta cualquier identificador de entidad en query |
| 404 | ENTITY_NOT_FOUND | La entidad no existe en la org o está eliminada (soft delete) |
| 401 | — | API key ausente o inválida |
| 403 | — | Permisos insuficientes (events:read) |
Ejemplos
Próximos pasos
Listar por entidad
Línea de tiempo completa cuando
hasEvents es trueListar eventos
Consultar con filtros
Estadísticas
Conteos por tipo de evento
Overview
Overview de eventos de usuario