Início rápido

{
  "dado": {
    "id": "12345678",
    "nome": "EMPRESA EXEMPLO LTDA",
    "estabelecimentos": { "valor": 1, "conferido": true, "procedencia": "ambas" },
    "contratos":        { "valor": 0, "conferido": true, "procedencia": "ambas" },
    "socios": [{ "id": "***000000**::PESSOA EXEMPLO", "nome": "PESSOA EXEMPLO", "papel": "consta no QSA" }],
    "endereco": { "vizinhos": 417, "comSocioComum": 0, "comContratoPublico": 0 },
    "sancoes": []
  },
  "avisos": ["mesmo endereço é indício, não vínculo…"],
  "fonte": { "atualizadoEm": "2026-08-06", "cacheSegundos": 3600 }
}

import requests

r = requests.get(
    "https://brain.pandoragraph.com/api/v1/entidades/12345678",
    params={"incluir": "socios,endereco,sancoes"},
    headers={"Authorization": f"Bearer {CHAVE}"},
    timeout=10,
)
r.raise_for_status()
d = r.json()["dado"]

contratos = d["contratos"]
if not contratos["conferido"]:
    # as bases discordaram: use como aproximado, não some com outros números
    ...

const r = await fetch(
  "https://brain.pandoragraph.com/api/v1/entidades/12345678?incluir=socios,endereco",
  { headers: { Authorization: `Bearer ${chave}` } },
);
if (r.status === 503) throw new Error("base indisponível — NÃO grave como ausência");
const { dado, avisos } = await r.json();