# NLBS.AI — API do Motor de Cálculo de Risco > Documentação da API externa do Motor de Cálculo de Risco NLBS.AI — busca de entidades, análises de risco PLD/FT e relatórios regulatórios. ## Docs - [Consultar análise](https://docs.nlbs.ai/api-reference/analyses/consultar-análise.md): Retorna o status e o resultado da análise. Faça polling enquanto `status` for `queued`/`running`; leia sempre o campo único `result` (nulo no início, preenchido progressivamente durante a execução, completo quando `status` for `completed`) e use `progress.milestone` pra acompanhar a completude. Veja… - [Consultar detalhes de depuração da análise](https://docs.nlbs.ai/api-reference/analyses/consultar-detalhes-de-depuração-da-análise.md): Retorna dados internos de workflow/depuração, incluindo identificadores do Agno e registros de auditoria das etapas. Requer o escopo analyses:debug. - [Criar análise](https://docs.nlbs.ai/api-reference/analyses/criar-análise.md): Cria uma execução de análise para uma entidade canônica e enfileira o processamento assíncrono. O endpoint retorna imediatamente com status accepted. - [Analysis completed](https://docs.nlbs.ai/api-reference/analysis-completed.md): Sent once the analysis finishes successfully, with the full `data.result`. - [Analysis failed](https://docs.nlbs.ai/api-reference/analysis-failed.md): Sent if the analysis fails. Carries a stable public reason, no technical detail. - [Analysis partial](https://docs.nlbs.ai/api-reference/analysis-partial.md): Sent at each incremental milestone (identification, verdict) while still running. - [Analysis queued](https://docs.nlbs.ai/api-reference/analysis-queued.md): Sent when an analysis is accepted and enqueued. - [Analysis running](https://docs.nlbs.ai/api-reference/analysis-running.md): Sent when the worker starts executing the analysis. - [Analysis step completed](https://docs.nlbs.ai/api-reference/analysis-step-completed.md): Sent when a workflow step completes. Status/timing only, never step I/O. - [Analysis step failed](https://docs.nlbs.ai/api-reference/analysis-step-failed.md): Sent when a workflow step fails. Carries a stable public reason, no technical detail. - [Analysis step started](https://docs.nlbs.ai/api-reference/analysis-step-started.md): Sent when a workflow step begins. Status/timing only, never step I/O. - [Buscar entidades canônicas](https://docs.nlbs.ai/api-reference/entities/buscar-entidades-canônicas.md): Busca entidades canônicas por nome, documento, ou ambos. É necessário informar ao menos um dos dois. Buscas parciais por documento exigem também o nome. - [Listar atualização das fontes](https://docs.nlbs.ai/api-reference/health/listar-atualização-das-fontes.md): Retorna o timestamp da última sincronização bem-sucedida de cada fonte de dados canônica ativa. - [Verificar liveness do processo](https://docs.nlbs.ai/api-reference/health/verificar-liveness-do-processo.md): Sonda pública que confirma que o processo da API está em execução. - [Verificar readiness do serviço](https://docs.nlbs.ai/api-reference/health/verificar-readiness-do-serviço.md): Sonda pública que verifica a prontidão do banco de dados, do Redis e do armazenamento de objetos. - [Consultar catálogo regulatório atual](https://docs.nlbs.ai/api-reference/regulatory/consultar-catálogo-regulatório-atual.md): Retorna o snapshot ativo do catálogo de referências regulatórias. - [Consultar uma versão do catálogo regulatório](https://docs.nlbs.ai/api-reference/regulatory/consultar-uma-versão-do-catálogo-regulatório.md): Retorna o manifesto e o conteúdo do catálogo de uma versão regulatória específica. - [Listar versões do catálogo regulatório](https://docs.nlbs.ai/api-reference/regulatory/listar-versões-do-catálogo-regulatório.md): Retorna os manifestos de todas as versões congeladas do catálogo de referências regulatórias. - [Consultar detalhes de depuração do relatório regulatório](https://docs.nlbs.ai/api-reference/reports/consultar-detalhes-de-depuração-do-relatório-regulatório.md): Retorna dados internos de workflow/depuração, incluindo identificadores do Agno e registros de auditoria das etapas. Requer o escopo reports:debug. - [Consultar relatório regulatório](https://docs.nlbs.ai/api-reference/reports/consultar-relatório-regulatório.md): Retorna o status do relatório voltado ao usuário e o resultado final do produto, quando disponível. - [Criar relatório regulatório](https://docs.nlbs.ai/api-reference/reports/criar-relatório-regulatório.md): Cria uma execução de relatório regulatório (Motor 2) a partir de uma análise concluída e enfileira o processamento assíncrono. O endpoint retorna imediatamente com status accepted. Pela regra do COAF, a análise de origem deve ter sido criada nas últimas 24 horas. - [Consultar catálogo de regras atual](https://docs.nlbs.ai/api-reference/rules/consultar-catálogo-de-regras-atual.md): Retorna o snapshot ativo do catálogo de regras determinísticas. - [Consultar uma versão do catálogo de regras](https://docs.nlbs.ai/api-reference/rules/consultar-uma-versão-do-catálogo-de-regras.md): Retorna o manifesto e o conteúdo do catálogo de uma versão congelada específica das regras. - [Listar versões do catálogo de regras](https://docs.nlbs.ai/api-reference/rules/listar-versões-do-catálogo-de-regras.md): Retorna os manifestos de todas as versões congeladas do catálogo de regras determinísticas. - [Atualizar endpoint de webhook](https://docs.nlbs.ai/api-reference/webhooks/atualizar-endpoint-de-webhook.md): Atualiza nome, URL, inscrições de eventos ou status. Mudanças de URL disparam validação de SSRF antes de persistir. - [Consultar endpoint de webhook](https://docs.nlbs.ai/api-reference/webhooks/consultar-endpoint-de-webhook.md): Retorna um endpoint de webhook pelo UUID, se pertencer ao cliente autenticado. - [Criar endpoint de webhook](https://docs.nlbs.ai/api-reference/webhooks/criar-endpoint-de-webhook.md): Registra um novo endpoint de webhook pro cliente autenticado. O segredo de assinatura em texto puro só é retornado nesta resposta. - [Enviar evento de teste de webhook](https://docs.nlbs.ai/api-reference/webhooks/enviar-evento-de-teste-de-webhook.md): Cria um evento webhook.test pra esse endpoint e enfileira a entrega. - [Listar endpoints de webhook](https://docs.nlbs.ai/api-reference/webhooks/listar-endpoints-de-webhook.md): Lista os endpoints de webhook pertencentes ao cliente autenticado. - [Listar eventos de webhook da análise](https://docs.nlbs.ai/api-reference/webhooks/listar-eventos-de-webhook-da-análise.md): Lista os eventos de entrega de webhook de uma análise pertencente ao cliente autenticado. - [Reprocessar evento de webhook](https://docs.nlbs.ai/api-reference/webhooks/reprocessar-evento-de-webhook.md): Reprocessa manualmente um evento de webhook com falha. Só eventos com falha são elegíveis. - [Rotacionar segredo do webhook](https://docs.nlbs.ai/api-reference/webhooks/rotacionar-segredo-do-webhook.md): Rotaciona o segredo de assinatura. O novo segredo em texto puro só é retornado uma vez. - [Autenticação](https://docs.nlbs.ai/authentication.md): Como gerar e usar sua apikey - [Análises de risco](https://docs.nlbs.ai/concepts/analyses.md): Como o veredito é composto e onde encontrar cada dado - [Erros](https://docs.nlbs.ai/concepts/errors.md): Formato de erro e códigos de status usados pela API - [Relatórios regulatórios](https://docs.nlbs.ai/concepts/reports.md): Como gerar o relatório técnico de suporte (COAF/SUSEP) - [Introdução](https://docs.nlbs.ai/introduction.md): Visão geral da API externa do Motor de Cálculo de Risco - [Guia rápido](https://docs.nlbs.ai/quickstart.md): Da busca de uma entidade ao veredito de risco em 3 chamadas ## OpenAPI Specs - [openapi](https://api.nlbs.ai/api/openapi.json)