Skip to main content
GET
/
intelligence
/
alerts
Listar Alertas
curl --request GET \
  --url http://api.gu1.ai/intelligence/alerts \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "alerts": [
    {}
  ],
  "count": 123
}

​
Visão Geral

Recupera alertas para entidades específicas ou em toda a organização. Os alertas são gerados automaticamente pelas regras quando as condições são atendidas.

​
Endpoint

GET http://api.gu1.ai/intelligence/alerts

​
Autenticação

Requer uma chave API válida no cabeçalho de Autorização: 
Authorization: Bearer YOUR_API_KEY

​
Parâmetros de Consulta

​
entityId
string
required
ID da entidade para filtrar alertas (pessoa, empresa ou transação)
​
status
string
Filtrar por status: PENDING, ACKNOWLEDGED, RESOLVED
​
severity
string
Filtrar por severidade: LOW, MEDIUM, HIGH, CRITICAL
​
category
string
Filtrar por categoria de alerta

​
Resposta

​
success
boolean
Se a requisição foi bem-sucedida
​
alerts
array
Array de objetos de alerta
​
count
number
Número total de alertas que correspondem aos filtros

​
Exemplos de Requisições

​
Obter Alertas para Entidade

curl -X GET "http://api.gu1.ai/intelligence/alerts?entityId=550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Exemplo de Resposta

{
  "success": true,
  "alerts": [
    {
      "id": "alert-uuid-123",
      "name": "Padrão de Transação de Alto Risco",
      "category": "transaction_monitoring",
      "severity": "CRITICAL",
      "status": "PENDING",
      "createdAt": "2024-12-23T10:00:00.000Z",
      "riskContribution": 25,
      "miniAnalysis": "Múltiplas transações de alto valor detectadas em curto período",
      "targetEntityId": "550e8400-e29b-41d4-a716-446655440000"
    }
  ],
  "count": 1
}

​
Níveis de Severidade de Alertas

  • LOW: Informativo, requer revisão
  • MEDIUM: Risco moderado, deve ser investigado
  • HIGH: Risco significativo, requer atenção imediata
  • CRITICAL: Risco severo, ação urgente necessária

​
Fluxo de Status de Alertas

  1. PENDING: Alerta recém-criado, aguardando revisão
  2. ACKNOWLEDGED: O alerta foi revisado pela equipe de compliance
  3. RESOLVED: O alerta foi tratado e fechado

​
Veja Também