> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nlbs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Guia rápido

> Da busca de uma entidade ao veredito de risco em 3 chamadas

Este guia cobre o fluxo mais comum: localizar uma entidade, rodar a análise
de risco e ler o veredito. Requer uma [apikey](/authentication) já gerada.

<Steps>
  <Step title="Busque a entidade por documento">
    ```bash theme={null}
    curl "https://api.qa.nlbs.ai/api/entities?document=12345678900" \
      -H "X-API-Key: nlbs_sua_chave_aqui"
    ```

    A resposta traz os `items` encontrados, cada um com um `id` canônico —
    é esse `id` que alimenta o próximo passo.
  </Step>

  <Step title="Rode a análise">
    ```bash theme={null}
    curl -X POST "https://api.qa.nlbs.ai/api/analyses" \
      -H "X-API-Key: nlbs_sua_chave_aqui" \
      -H "Content-Type: application/json" \
      -d '{"entity_id": 410752090310337379, "source": "minha-integracao"}'
    ```

    <Info>
      A análise roda **de forma síncrona** — a chamada fica aberta até o
      workflow terminar (pode levar até alguns minutos para entidades mais
      complexas) e a resposta já vem com o veredito completo, sem
      necessidade de polling.
    </Info>

    A resposta traz `uuid` (identificador da análise), `subject` (dados
    cadastrais), `risk` (score, banda, composição por pilar) e `links` —
    URLs dos sub-recursos (grafo de relacionamentos, sinais identificados,
    eventos relevantes, explicação operacional sob demanda).
  </Step>

  <Step title="Consulte o grafo de relacionamentos (opcional)">
    ```bash theme={null}
    curl "https://api.qa.nlbs.ai/api/analyses/{uuid}/graph" \
      -H "X-API-Key: nlbs_sua_chave_aqui"
    ```

    Retorna os nós e arestas da rede de relacionamentos da entidade — útil
    para visualizar sócios, processos, sanções e demais vínculos que
    sustentam o score.
  </Step>
</Steps>

## Próximo passo: relatório regulatório

Com uma análise concluída, você pode gerar o relatório técnico de suporte
(COAF/SUSEP) — veja [Relatórios](/concepts/reports).

## Referência completa

Todos os endpoints, parâmetros e formatos de resposta estão documentados
com exemplos testáveis em [Referência da API](/api-reference).