Skip to main content
GET
Entidades
string
required
CNPJ em qualquer formato — 12.345.678/0001-95, 12345678000195 ou 12345678 — ou um id de pessoa devolvido por outra chamada.Você nunca precisa saber como chaveamos internamente: mandar a raiz ou o estabelecimento chega na mesma empresa. Quando você manda o CNPJ completo, a gente entende que a filial importa e usa ela nas expansões.
string
Lista separada por vírgula: socios, endereco, doacoes, sancoes. Expansão desconhecida é ignorada, não quebra a chamada.

Expansões e custo

sancoes varre outra base e conta no teto de 60/min em vez de 600/min. A resposta traz X-Latencia-Estimada-Ms para você dimensionar lotes.

Como ler endereco

vizinhos sozinho não indica nada. Caso real e medido: 417 empresas no mesmo endereço, com comSocioComum: 0 e comContratoPublico: 0 — é escritório de contabilidade.O sinal está nos outros dois campos: vizinho que repete sócio ou que toca dinheiro público. Prédio comercial acende a contagem e zera os dois.

Como ler socios

Constar no quadro societário é o que o registro afirma — não é titularidade, não é controle. O casamento é por nome, com CPF mascarado na origem, então homônimo é possível.

Como ler sancoes

Cada linha traz evidencia, e a forma carrega a diferença antes da palavra:
decisãouma autoridade decidiu e publicou. É fato, e é publicável.
acusaçãoa empresa é ré num processo. Não é prova de nada.
Misturar os dois é como uma lista de suspeitos vira difamação. Se o seu sistema exibe esse dado, exiba o campo junto.

Ficha de pessoa

GET /api/v1/entidades/***000000**::NOME devolve sociedades, candidaturas e mandato.
Todo acesso a ficha de pessoa é registrado com a chave que pediu. Se não conseguirmos gravar o registro, a consulta é recusada com 503 — não existe caminho de leitura sem rastro.
Uma pessoa sem vínculo devolve 200 com listas vazias. Nunca 404: “não achei nada sobre ela” é resposta, “não existe essa pessoa” seria conclusão.