Skip to main content
Uma análise (POST /analyses) roda o workflow de risco PLD/FT completo para uma entidade e devolve o veredito na mesma resposta — não há fila nem necessidade de consultar o status depois.

​
Veredito (POST /analyses e GET /analyses/{uuid})

A resposta principal é enxuta de propósito — dados mais pesados (grafo, sinais, eventos) ficam em sub-recursos separados, listados em links:

​
Sub-recursos

Grafo de relacionamentos

GET /analyses/{uuid}/graph — nós e arestas da rede (sócios, processos, sanções, vínculos societários e familiares).

Sinais identificados

GET /analyses/{uuid}/signals — cada sinal identificado, com evidências e o quanto contribuiu para o score.

Eventos relevantes

GET /analyses/{uuid}/events — linha do tempo dos fatos que embasaram a análise.

Explicação operacional

POST ou GET /analyses/{uuid}/explanation — resumo executivo em linguagem natural, gerado sob demanda (não vem pronto no veredito).
A explicação operacional é gerada por LLM e tem custo — por isso é sob demanda. Chame GET primeiro; se retornar 404 (nunca foi gerada), aí sim chame POST para gerar.

​
Score e banda de risco

risk.score é um número de 0 a 100. risk.risk_level classifica esse score em low, medium, high ou critical. Quando um sinal específico ou uma regra de acumulação impõe um piso (band_floors_applied), o score final nunca fica abaixo desse piso, mesmo que a soma dos sinais individuais desse menos.