Quickstart - NL Labs AI

Requer uma chave de API válida.

1. Resolva o subject

curl -G https://api.nlbs.ai/entities \
  -H "Authorization: Bearer nll_production_..." \
  --data-urlencode "name=Maria Silva"

{
  "items": [
    {
      "id": 410752090310337379,
      "entity_type": "person",
      "display_name": "Maria Silva",
      "legal_name": "Maria Silva",
      "identifiers": [
        { "identifier_type": "CPF", "value": "***.123.456-**", "is_masked": true }
      ],
      "aliases": ["M. Silva"]
    }
  ],
  "total": 1,
  "limit": 20,
  "offset": 0
}

Use o id retornado como entity_id no passo seguinte.

2. Crie a análise

curl -X POST https://api.nlbs.ai/analyses \
  -H "Authorization: Bearer nll_production_..." \
  -H "Content-Type: application/json" \
  -d '{"entity_id": 410752090310337379, "source": "quickstart"}'

Síncrono: a resposta já traz o veredito e o uuid que alimenta todo o resto da API.

{
  "uuid": "018ffd38-6d94-7c0c-a6dd-2d9690a118f8",
  "subject": { "...": "..." },
  "risk": {
    "score": 12,
    "risk_level": "low",
    "review_recommended": false,
    "review_required": false,
    "escalation_required": false,
    "escalation_reasons": []
  },
  "versions": { "...": "..." },
  "links": {
    "self": "/analyses/018ffd38-6d94-7c0c-a6dd-2d9690a118f8",
    "graph": "/analyses/018ffd38-6d94-7c0c-a6dd-2d9690a118f8/graph",
    "signals": "/analyses/018ffd38-6d94-7c0c-a6dd-2d9690a118f8/signals",
    "events": "/analyses/018ffd38-6d94-7c0c-a6dd-2d9690a118f8/events",
    "snapshot": "/analyses/018ffd38-6d94-7c0c-a6dd-2d9690a118f8/snapshot",
    "explanation": "/analyses/018ffd38-6d94-7c0c-a6dd-2d9690a118f8/explanation",
    "legal_cases": "/analyses/018ffd38-6d94-7c0c-a6dd-2d9690a118f8/legal-cases"
  }
}

3. Use o `uuid`

Sub-recursos em links (grafo, sinais, eventos, processos, snapshot) e o dossiê PDF em GET /analyses/{uuid}/dossier — ver Análises.
POST /reports com analysis_uuid gera o relatório regulatório — ver Relatórios.
POST /adverse-media com analysis_uuid dispara a triagem de imprensa — ver Mídia adversa.