Para que serve
Monta a rede de vínculos societários da pessoa ou empresa: sociedades em que participa, sócios e empresas ligadas, em níveis, com tipo e grau do vínculo, se está ativo e o histórico de cargos. Mostra grupos econômicos e laranjas que uma consulta de CNPJ isolada não revela.
Ideal para
Por que usar
Grupo econômico à vista
Veja empresas ligadas ao mesmo sócio e sócios em comum.
Histórico de cargos
Entrada e saída de cada pessoa nas sociedades.
Pronto para o seu sistema
Resposta em JSON estruturado, com os mesmos campos em toda consulta, para entrar direto no seu motor de regras.
Parâmetros
| Parâmetro | Descrição | Regra |
|---|---|---|
cpf | CPFCPF da pessoa (informe CPF ou CNPJ). | Um de: cpf · cnpj |
cnpj | CNPJCNPJ da empresa (informe CPF ou CNPJ). | Um de: cpf · cnpj |
O que você recebe
5 campos no retorno, como o seu sistema recebe.
documentoConsultadoDado pessoalDocumento consultado
CPF ou CNPJ pesquisado, como a fonte o devolveu.
nomeEntidadeDado pessoalNome ou razão social
Nome da pessoa ou razão social da empresa pesquisada.
detalhesPessoaFisicaDado pessoalDados da pessoa física
Situação cadastral, nascimento, indicador de PEP, óbito e endereço. Preenchido quando o documento é CPF.
detalhesPessoaJuridicaDados da pessoa jurídica
Matriz ou filial, situação, abertura, encerramento, recuperação judicial e endereço. Preenchido quando o documento é CNPJ.
relacionamentosDado pessoalVínculos societários
Árvore de pessoas e empresas ligadas, com tipo, grau, nível, status e histórico de cargos; cada item repete a estrutura no nível seguinte.
Opções da chamada
assincrono=trueProcessa em segundo plano e devolve 202 com o consultaId.comprovante=trueEsta API não emite comprovante em PDF.
Códigos de resposta
200Sucesso — Consulta concluída; o retorno traz os dados da fonte.202Em processamento — Recupere em GET /api/Marketplace/Consulta/Resultado/{consultaId}. Recuperar não é cobrado.422Requisição inválida — Parâmetros validados antes de qualquer cobrança.429Limite simultâneo — Até 5 consultas simultâneas por cliente.503Em manutenção — A consulta está temporariamente indisponível; nada é cobrado.
Como é cobrado
- Débito por chamada — do saldo pré-pago ou do contrato pós-pago
- Preço exibido na plataforma antes de executar
- Falhas estornadas automaticamente
- Mesmo preço na plataforma e na API
curl "https://api.agrolitics.com.br/api/Marketplace/Consulta/vinculos-societarios?cpf=00000000000" \ -H "X-Api-Key: $AGROLITICS_API_KEY"{ "metaDados": { "consultaId": "3f9c2a71-5b8e-4d1a-9c07-1e6b2f8a4d90", "apiIdentificador": "vinculos-societarios", "apiNome": "Vínculos Societários", "fonte": "Quadro societário · Receita Federal do Brasil", "status": "Concluída", "resultado": "Sucesso", "tempoExecucaoMs": 1840, "assincrono": false, "urlComprovante": null }, "retorno": { /* dados da fonte — variam por consulta */ }}Perguntas frequentes sobre Vínculos Societários
Outras APIs para combinar
Ver catálogo completoPEP — Pessoa Exposta Politicamente
Verifica se o CPF é de Pessoa Exposta Politicamente: função, órgão e período de exposição.
PEP Estendida — Parentescos
PEP com rede de parentesco: além do titular, aponta vínculos familiares com pessoas expostas politicamente.
Polícia Civil - Antecedentes Criminais
Atestado de antecedentes criminais da Polícia Civil da UF informada (AC, CE, GO, MG, MT, RR ou RS): indica se há antecedentes, com número e validade do atestado.
Comece a integrar
Leve as fontes oficiais do agro para dentro do seu sistema
Crie sua conta e teste qualquer API na plataforma — ou fale com um especialista para desenhar a integração e o contrato ideais para o seu volume.
- APIs de fontes oficiais, com resposta padronizada
- Pague por chamada — sem mensalidade, falhas estornadas
- API do Dossiê BNIR com lotes de até 1.000 CARs
- Webhooks assinados e comprovante em PDF
- Conformidade LGPD — fontes oficiais, log auditável
Solicite uma Demonstração
Nossa equipe entrará em contato em breve.