Participações Societárias do CPF (base Receita Federal)

Name: FonteData
Author: FonteData

GET https://app.fontedata.com/api/v1/consulta/vinculos-societarios-bases

R$ 0,54 por consulta

Debitado do seu saldo a cada chamada cobrada. Autenticação pelo header X-API-Key. Veja como obter a chave.

Este endpoint mapeia as participações societárias de uma pessoa física a partir do CPF, consultando o Quadro de Sócios e Administradores (QSA) da Receita Federal. Retorna todas as empresas em que a pessoa figura como sócia ou administradora, com a qualificação do vínculo, a data de entrada na sociedade, a situação cadastral da empresa e a UF.

É uma consulta essencial para:

Diligência e KYC/KYB: entender a exposição societária de um indivíduo antes de contratar ou conceder crédito.
Análise de risco: identificar empresas ligadas a um sócio e sua situação cadastral (ativa, baixada, etc.).
Prevenção a fraudes: cruzar identidade e vínculos empresariais em onboarding.
Mapeamento de grupos econômicos: descobrir a rede de empresas de uma pessoa.

Requisição

curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/vinculos-societarios-bases?cpf=SEU_CPF"

Parâmetros

Nome	Tipo	Descrição	Exemplo
cpf obrigatório	CPF	CPF da pessoa física. Aceita com ou sem pontuação. É o único parâmetro necessário.	000.000.000-00

Resposta

A consulta retorna os seguintes campos:

Campo	Tipo	Descrição
`cpfConsultado`	string	CPF consultado (parcialmente mascarado).
`nomeConsultado`	string	Nome do titular do CPF.
`totalVinculos`	number	Quantidade de vínculos societários encontrados.
`vinculos`	array	Lista das empresas em que a pessoa participa.
`vinculos[].cnpj`	string	CNPJ da empresa.
`vinculos[].razaoSocial`	string	Razão social da empresa.
`vinculos[].nomeFantasia`	string	Nome fantasia da empresa, quando houver.
`vinculos[].qualificacao`	string	Qualificação do vínculo (ex.: Sócio, Sócio-Administrador, Administrador).
`vinculos[].qualificacaoCodigo`	string	Código oficial da qualificação do sócio.
`vinculos[].dataEntrada`	string	Data de entrada na sociedade (AAAA-MM-DD).
`vinculos[].situacaoCadastral`	string	Situação cadastral da empresa (ATIVA, BAIXADA, etc.).
`vinculos[].uf`	string	UF da empresa.
`safra`	string	Data de referência (safra) da base da Receita Federal utilizada na consulta.

Exemplo — 200 OK

{
  "safra": "string",
  "vinculos": [
    {
      "uf": "string",
      "cnpj": "string",
      "dataEntrada": "string",
      "razaoSocial": "string",
      "nomeFantasia": "string",
      "qualificacao": "string",
      "situacaoCadastral": "string",
      "qualificacaoCodigo": "string"
    }
  ],
  "cpfConsultado": "string",
  "totalVinculos": "number",
  "nomeConsultado": "string"
}

Schema da resposta (JSON Schema)

JSON Schema

{
  "type": "object",
  "properties": {
    "safra": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data de referência (safra) da base da Receita Federal utilizada na consulta."
    },
    "vinculos": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "uf": {
            "type": [
              "string",
              "null"
            ],
            "description": "UF da empresa."
          },
          "cnpj": {
            "type": [
              "string",
              "null"
            ],
            "description": "CNPJ da empresa."
          },
          "dataEntrada": {
            "type": [
              "string",
              "null"
            ],
            "description": "Data de entrada na sociedade (AAAA-MM-DD)."
          },
          "razaoSocial": {
            "type": [
              "string",
              "null"
            ],
            "description": "Razão social da empresa."
          },
          "nomeFantasia": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nome fantasia da empresa, quando houver."
          },
          "qualificacao": {
            "type": [
              "string",
              "null"
            ],
            "description": "Qualificação do vínculo (ex.: Sócio, Sócio-Administrador, Administrador)."
          },
          "situacaoCadastral": {
            "type": [
              "string",
              "null"
            ],
            "description": "Situação cadastral da empresa (ATIVA, BAIXADA, etc.)."
          },
          "qualificacaoCodigo": {
            "type": [
              "string",
              "null"
            ],
            "description": "Código oficial da qualificação do sócio."
          }
        }
      },
      "description": "Lista das empresas em que a pessoa participa."
    },
    "cpfConsultado": {
      "type": [
        "string",
        "null"
      ],
      "description": "CPF consultado (parcialmente mascarado)."
    },
    "totalVinculos": {
      "type": [
        "number",
        "null"
      ],
      "description": "Quantidade de vínculos societários encontrados."
    },
    "nomeConsultado": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome do titular do CPF."
    }
  }
}

Códigos de erro

Código	Mensagem	Quando acontece
400	CPF inválido	O CPF informado é inválido ou está ausente. Envie um CPF com 11 dígitos (com ou sem pontuação).
401	Não autenticado	Chave de API ausente ou inválida. Verifique o header X-API-Key.
403	Acesso negado	Saldo insuficiente ou sua chave não tem permissão para esta consulta.
404	CPF não encontrado	O CPF consultado não foi localizado para enriquecimento do nome do titular.
408	Tempo esgotado	A consulta demorou mais que o esperado para responder. Tente novamente em alguns instantes.
500	Falha na consulta	Não foi possível concluir a consulta. Se o problema persistir, entre em contato com o suporte.
503	Consulta em manutenção	Esta consulta está temporariamente em manutenção. Tente novamente mais tarde.

Observações

O dado tem uma safra de referência, identificada pelo campo safra.
Quando não há vínculos, o endpoint retorna totalVinculos: 0 e vinculos: [] com HTTP 200 (não é erro).

Integrar

OpenAPI (JSON) ↗ — importe a URL no Postman ou no Insomnia para gerar a coleção com todos os endpoints. Também dá para consultar pelo chat: conecte via MCP. Esta página em Markdown.