O plano Grátis da CPFHub.io dá 50 créditos por mês, sem cartão, e o mesmo saldo vale para CPF e CNPJ. Para verificar sócios, consulte primeiro o CNPJ da empresa na Consulta de CNPJ, que mostra o quadro de sócios com nome e qualificação (o CPF vem mascarado). Depois, com o CPF completo que o próprio sócio informa, a consulta de CPF confirma nome, data de nascimento e gênero. Cada consulta encontrada custa 1 crédito, e CPF ou CNPJ não encontrado não consome crédito.
Introdução
Antes de formalizar uma sociedade, assinar um contrato social ou estabelecer uma parceria comercial, é fundamental verificar os dados cadastrais dos sócios envolvidos. Erros no CPF, nomes divergentes ou dados inconsistentes podem gerar problemas na junta comercial, em cartórios, no sistema bancário e junto à Receita Federal. Uma verificação simples antes da assinatura dos documentos pode evitar complicações que levariam semanas para resolver.
Por que verificar o CPF dos sócios
Registro na junta comercial
O contrato social de uma empresa exige que os dados dos sócios estejam corretos e consistentes. Nomes grafados de forma diferente do CPF, datas de nascimento divergentes ou CPFs inválidos resultam em exigências da junta comercial e atraso no registro.
Abertura de conta bancária PJ
Bancos verificam os dados dos sócios ao abrir contas para a empresa. Se os dados informados não conferem com os registros do CPF, o processo é paralisado até a correção.
Due diligence em parcerias
Em processos de due diligence para fusões, aquisições ou parcerias estratégicas, a verificação dos CPFs dos sócios é uma etapa básica que confirma a identidade dos envolvidos.
Prevenção contra fraudes societárias
Casos de uso de CPFs de terceiros (falecidos, sem consentimento) para abrir empresas de fachada são mais comuns do que se imagina. A verificação prévia ajuda a detectar essas situações. Para confirmar se o CPF está regular ou se o titular faleceu, use a Consulta em Tempo Real na Receita, que exige CPF e data de nascimento e retorna a situação cadastral e o ano do óbito (1,5 crédito por consulta bem-sucedida).
Antes do CPF: consulte o CNPJ e veja quem são os sócios
Quando a empresa já existe (numa alteração contratual, numa parceria ou numa due diligence), o ponto de partida é o CNPJ. A Consulta de CNPJ da CPFHub.io usa a mesma chave de API e os mesmos 50 créditos grátis:
curl https://api.cpfhub.io/cnpj/11222333000181 \
-H "x-api-key: SUA_CHAVE_DE_API"
A resposta traz razão social, situação cadastral, CNAE, endereço, porte e o quadro de sócios em QSA, com nome e qualificação de cada sócio. Três pontos importam aqui:
- O CPF do sócio pessoa física vem mascarado (
***.456.789-**). Use o QSA para saber quem deve ser verificado e peça o CPF completo ao próprio sócio. - Custo: 1 crédito por CNPJ encontrado, do mesmo saldo da consulta de CPF. CNPJ não encontrado ou inválido não consome crédito.
- Atualização: a fonte é a base pública do CNPJ da Receita Federal, atualizada todo mês. Uma alteração societária muito recente pode ainda não aparecer.
Para várias empresas de uma vez, o CNPJ em Lote aceita até 10.000 CNPJs por envio.
Como consultar o CPF de um sócio
A API da CPFHub.io permite verificar os dados cadastrais associados a um CPF com uma única requisição.
curl -X GET https://api.cpfhub.io/cpf/12345678900 \
-H "x-api-key: SUA_CHAVE_DE_API" \
-H "Accept: application/json"
Resposta
{
"success": true,
"data": {
"cpf": "12345678900",
"name": "Ricardo Alves Mendonça",
"nameUpper": "RICARDO ALVES MENDONÇA",
"gender": "M",
"birthDate": "03/11/1975",
"day": 3,
"month": 11,
"year": 1975
}
}
Com esses dados, é possível confirmar o nome completo, a data de nascimento e o gênero do sócio antes de elaborar o contrato social, e conferir se o nome bate com o que aparece no QSA do CNPJ.
Verificação prática dos dados
Comparação com os documentos apresentados
O exemplo a seguir compara os dados retornados pela API com os dados informados pelo sócio.
import requests
from difflib import SequenceMatcher
def verificar_socio(cpf: str, nome_informado: str, nascimento_informado: str) -> dict:
cpf_limpo = cpf.replace('.', '').replace('-', '')
url = f'https://api.cpfhub.io/cpf/{cpf_limpo}'
headers = {
'x-api-key': 'SUA_CHAVE_DE_API',
'Accept': 'application/json'
}
response = requests.get(url, headers=headers, timeout=10)
if response.status_code == 404:
# CPF não encontrado: não consome crédito
return {
'status': 'nao_encontrado',
'mensagem': 'CPF nao localizado na base. Verifique o numero.'
}
if response.status_code != 200:
# 403 (créditos), 422 (dígito inválido), 429 (limite por minuto) etc.
return {'status': 'erro', 'http': response.status_code}
dados = response.json()['data']
problemas = []
# Verificar nome
similaridade = SequenceMatcher(
None,
nome_informado.upper().strip(),
dados['nameUpper']
).ratio()
if similaridade < 0.9:
problemas.append({
'campo': 'nome',
'informado': nome_informado,
'oficial': dados['name'],
'similaridade': f'{similaridade:.0%}'
})
# Verificar data de nascimento
if nascimento_informado and nascimento_informado != dados['birthDate']:
problemas.append({
'campo': 'data_nascimento',
'informado': nascimento_informado,
'oficial': dados['birthDate']
})
if problemas:
return {
'status': 'divergencias',
'mensagem': 'Dados divergentes encontrados',
'problemas': problemas
}
return {
'status': 'ok',
'mensagem': 'Dados do socio conferem com os registros',
'dados_confirmados': {
'nome': dados['name'],
'nascimento': dados['birthDate'],
'genero': dados['gender']
}
}
# Verificar cada socio
socios = [
{'cpf': '12345678900', 'nome': 'Ricardo Alves Mendonça', 'nascimento': '03/11/1975'},
{'cpf': '98765432100', 'nome': 'Juliana Costa Lima', 'nascimento': '18/05/1983'},
]
for socio in socios:
resultado = verificar_socio(
cpf=socio['cpf'],
nome_informado=socio['nome'],
nascimento_informado=socio['nascimento']
)
print(f'Socio {socio["nome"]}: {resultado["status"]}')
if resultado.get('problemas'):
for p in resultado['problemas']:
print(f' - {p["campo"]}: informado "{p["informado"]}", oficial "{p["oficial"]}"')
Cenários de uso
Abertura de empresa
Antes de protocolar o contrato social na junta comercial, verifique o CPF de todos os sócios. Isso evita exigências e devoluções que atrasam o processo.
Alteração contratual
Quando um novo sócio entra na empresa ou há mudança na composição societária, os dados do novo sócio devem ser verificados antes da alteração.
Contratos de parceria
Em contratos entre pessoas físicas e jurídicas, a verificação do CPF do signatário garante que a pessoa que está assinando é quem diz ser.
Escritórios de contabilidade
Contadores que atendem múltiplas empresas podem usar a API para validar os dados dos sócios de cada empresa cliente, agilizando o trabalho de registro e manutenção societária.
async function verificarSociosEmpresa(listaSocios) {
const resultados = [];
for (const socio of listaSocios) {
const cpfLimpo = socio.cpf.replace(/\D/g, '');
const controller = new AbortController();
const timeoutId = setTimeout(() => controller.abort(), 10000);
try {
const response = await fetch(
`https://api.cpfhub.io/cpf/${cpfLimpo}`,
{
headers: {
'x-api-key': 'SUA_CHAVE_DE_API',
'Accept': 'application/json'
},
signal: controller.signal
}
);
clearTimeout(timeoutId);
const dados = await response.json();
resultados.push({
cpf: socio.cpf,
nomeInformado: socio.nome,
nomeOficial: dados.success ? dados.data.name : 'N/A',
confere: dados.success && dados.data.nameUpper.includes(
socio.nome.toUpperCase().split(' ')[0]
)
});
} catch (error) {
clearTimeout(timeoutId);
resultados.push({
cpf: socio.cpf,
nomeInformado: socio.nome,
erro: 'Falha na consulta'
});
}
// Respeitar rate limit
await new Promise(resolve => setTimeout(resolve, 2000));
}
return resultados;
}
Checklist para verificação de sócios
Antes de formalizar qualquer sociedade, confirme os seguintes itens:
-
CNPJ consultado: o QSA lista os mesmos sócios que vão assinar.
-
Nome completo confere: o nome no CPF é idêntico ao nome que será usado no contrato social.
-
Data de nascimento confere: a data no CPF corresponde ao documento de identidade.
-
CPF encontrado: a consulta retorna HTTP 200 com
success: true. -
Dados consistentes entre sócios: nenhum sócio apresenta dados divergentes.
-
Documentos conferidos: os dados da API foram comparados com os documentos originais (RG, CNH).
Boas práticas
-
Faça a verificação antes da assinatura: corrigir dados após o registro é muito mais custoso e demorado.
-
Registre a verificação: mantenha um registro de quando cada CPF foi verificado e qual foi o resultado, para fins de auditoria.
-
Respeite a privacidade: use os dados obtidos apenas para a finalidade declarada (verificação societária). A LGPD se aplica ao tratamento de dados pessoais de sócios.
-
Comunique aos sócios: informe que os CPFs serão verificados como parte do processo padrão de formalização.
Perguntas frequentes
O que é necessário para implementar validação de CPF neste contexto?
Uma chamada GET à API com o número do CPF e a chave no header x-api-key. A CPFHub.io retorna nome, gênero e data de nascimento do titular, em cerca de 150 ms no tempo típico. A situação cadastral na Receita não vem nessa consulta: para isso existe a Consulta em Tempo Real (POST /cpf/realtime), que exige também a data de nascimento.
A API CPFHub.io funciona para todos os volumes de consulta?
O plano Grátis oferece 50 créditos por mês sem cartão de crédito, bom para testes e projetos pequenos. Para volumes maiores, o plano Pro é escolhido pelo volume: R$ 19 (100 créditos), R$ 149 (1.000), R$ 599 (5.000) ou R$ 999 (10.000) por mês. No Grátis não há excedente: quando os 50 créditos acabam, a API responde HTTP 403 com "Limite de créditos excedido" e para. Nos planos pagos com excedente ativo, ele é cobrado na fatura seguinte conforme a página de preços. O limite por minuto responde HTTP 429 com Retry-After.
Os 50 créditos grátis valem para consulta de CNPJ?
Sim. O saldo é o mesmo para CPF e CNPJ: 1 crédito por CPF encontrado e 1 crédito por CNPJ encontrado. Dá para, por exemplo, consultar 10 CNPJs e validar 40 sócios no mesmo mês sem pagar nada.
A consulta de CNPJ mostra o CPF completo dos sócios?
Não. O quadro de sócios traz nome e qualificação, mas o CPF de sócio pessoa física vem sempre mascarado (***.456.789-**). O CPF completo precisa ser informado pelo próprio sócio.
Como garantir conformidade com a LGPD ao usar uma API de CPF?
Use o CPF apenas para a finalidade declarada ao titular, armazene apenas o necessário (não guarde o CPF cru se um token bastar), implemente controle de acesso aos logs de consulta e documente a base legal para o tratamento. A ANPD orienta que dados de identificação devem ser tratados com o princípio da necessidade.
Quanto tempo leva para integrar a API CPFHub.io?
A integração básica leva menos de 30 minutos: crie uma conta em cpfhub.io, gere a API key no painel e faça uma chamada GET para https://api.cpfhub.io/cpf/{CPF} com o header x-api-key. A documentação inclui exemplos em Python, Node.js, PHP, Java e outras linguagens.
Conclusão
Verificar os dados dos sócios antes de formalizar uma empresa, alterar um contrato social ou assinar uma parceria evita exigências na junta, atrasos e fraudes. Com os créditos grátis da CPFHub.io, você consulta o CNPJ para ver quem está no quadro societário e confirma nome, data de nascimento e gênero de cada sócio pelo CPF, antes de protocolar qualquer documento.
Conheça a Consulta de CNPJ da CPFHub.io e crie sua conta em cpfhub.io: 50 créditos mensais gratuitos, sem cartão de crédito, que valem para CPF e CNPJ.
CPFHub.io
Pronto para integrar a API?
50 créditos gratuitos para testar agora. Sem cartão de crédito. Acesso imediato à documentação.




