Consulta de CPF grátis: diferença entre verificar e consultar dados completos

Verificar um CPF confirma apenas que o número tem formato matemático válido — operação gratuita e local. Consultar dados completos via API retorna nome, data de nascimento e gênero do titular, confirmando que o CPF pertence a uma pessoa real. A escolha certa depende do risco da operação: filtros de formulário pedem verificação; KYC, antifraude e emissão de notas fiscais exigem consulta completa.

Introdução

Quando se fala em "consultar CPF", diferentes pessoas podem estar se referindo a operações bastante distintas. Para um desenvolvedor, pode significar validar o formato do número. Para um analista de fraudes, pode significar obter nome e data de nascimento do titular. Para um gestor de compliance, pode significar confirmar se os dados informados pelo cliente são reais.

Entender a diferença entre verificar um CPF e consultar dados completos é essencial para escolher a abordagem certa — e para decidir quando usar uma solução gratuita e quando investir em uma API mais completa.

O que significa "verificar" um CPF?

A verificação de CPF se refere a confirmar se um número de CPF tem formato válido. Essa operação pode ser realizada localmente, sem consulta a nenhuma base de dados externa.

O que a verificação checa

• Quantidade de dígitos — o CPF deve ter exatamente 11 dígitos numéricos.

• Sequências repetidas — números como 111.111.111-11 são rejeitados.

• Dígitos verificadores — os dois últimos dígitos seguem um algoritmo matemático que pode ser validado localmente.

Exemplo de verificação em JavaScript

function verificarCPF(cpf) {
    cpf = cpf.replace(/\D/g, '');
    if (cpf.length !== 11) return false;
    if (/^(\d)\1{10}$/.test(cpf)) return false;

    let soma = 0;
    for (let i = 0; i < 9; i++) soma += parseInt(cpf[i]) * (10 - i);
    let resto = (soma * 10) % 11;
    if (resto === 10) resto = 0;
    if (resto !== parseInt(cpf[9])) return false;

    soma = 0;
    for (let i = 0; i < 10; i++) soma += parseInt(cpf[i]) * (11 - i);
    resto = (soma * 10) % 11;
    if (resto === 10) resto = 0;
    return resto === parseInt(cpf[10]);
}

// Resultado: true ou false (formato válido ou não)
console.log(verificarCPF('123.456.789-09'));

Limitações da verificação

A verificação confirma apenas que o formato é matematicamente válido. Ela não garante que:

• O CPF pertence a uma pessoa real.
• O CPF está ativo.
• O nome informado corresponde ao titular.

O que significa "consultar dados completos" de um CPF?

A consulta de dados completos vai além da verificação de formato. Ela acessa uma base de dados atualizada e retorna informações cadastrais reais associadas ao número do CPF.

O que a consulta retorna

Na API da CPFHub.io, a resposta JSON inclui:

{
    "success": true,
    "data": {
    "cpf": "12345678900",
    "name": "João da Silva",
    "nameUpper": "JOÃO DA SILVA",
    "gender": "M",
    "birthDate": "15/06/1990",
    "day": 15,
    "month": 6,
    "year": 1990
    }
}

O que é possível com os dados completos

• Confirmar identidade — cruzar o nome retornado com o nome informado pelo usuário.

• Verificar data de nascimento — confirmar se a idade declarada é compatível.

• Validar gênero — quando relevante para o contexto da operação.

• Prevenir fraudes — identificar divergências que indicam uso indevido de dados.

Comparativo: verificação vs. consulta completa

Quando usar apenas a verificação?

A verificação local é suficiente quando:

• O objetivo é filtrar erros de digitação — por exemplo, em formulários web onde o usuário pode ter errado um dígito.

• Não há necessidade de confirmar identidade — como em cadastros informativos que não envolvem risco financeiro.

• O volume é muito alto e o custo precisa ser zero — milhares de validações por dia onde o custo de uma API seria proibitivo.

• Como primeiro filtro antes da consulta via API — para evitar gastar consultas com CPFs sintaticamente inválidos.

Quando é necessária a consulta completa?

A consulta via API é necessária quando:

• Há risco financeiro — checkout de e-commerce, concessão de crédito, crediário.

• Conformidade regulatória exige identificação — processos de KYC, AML, legislação eleitoral. A ANPD orienta que dados de identificação devem ser tratados com base legal adequada e com o princípio da necessidade.

• A identidade do titular precisa ser confirmada — cadastro de funcionários, fornecedores, doadores.

• Documentos fiscais serão emitidos — notas fiscais que exigem CPF válido e correspondente ao destinatário.

A melhor prática: usar as duas em sequência

A abordagem mais eficiente é combinar verificação local e consulta via API:

const validarCompletoComAPI = async (cpf, nomeInformado) => {
    // Passo 1: verificação local
    if (!verificarCPF(cpf)) {
    return { valido: false, motivo: 'CPF com formato inválido' };
    }

    // Passo 2: consulta de dados completos via API
    const controller = new AbortController();
    const timeoutId = setTimeout(() => controller.abort(), 10000);

    try {
    const response = await fetch(
    `https://api.cpfhub.io/cpf/${cpf.replace(/\D/g, '')}`,
    {
    method: 'GET',
    headers: {
    'x-api-key': process.env.CPFHUB_API_KEY,
    'Accept': 'application/json'
    },
    signal: controller.signal
    }
    );

    clearTimeout(timeoutId);
    const data = await response.json();

    if (!data.success) {
    return { valido: false, motivo: 'CPF não encontrado na base' };
    }

    // Passo 3: cruzamento de dados
    const nomeReal = data.data.name.toLowerCase();
    const nomeInput = nomeInformado.toLowerCase();
    const nomeConfere = nomeReal.includes(nomeInput.split(' ')[0]);

    return {
    valido: true,
    nomeConfere: nomeConfere,
    dadosReais: {
    nome: data.data.name,
    nascimento: data.data.birthDate,
    genero: data.data.gender
    }
    };
    } catch (error) {
    clearTimeout(timeoutId);
    return { valido: false, motivo: 'Erro na consulta da API' };
    }
};

Essa abordagem:

1. Elimina CPFs com formato inválido sem consumir consultas da API.
2. Consulta os dados reais para CPFs sintaticamente válidos.
3. Cruza o nome informado com o nome real para detectar inconsistências.

Custo da combinação

Com o plano gratuito da CPFHub.io, é possível verificar o formato de CPFs ilimitadamente (localmente) e consultar dados completos de até 50 CPFs por mês (via API). Para volumes maiores, o plano Pro oferece 1.000 consultas por R$ 149/mês — e, ao ultrapassar o limite, cada consulta adicional custa R$ 0,15 sem interrupção do serviço.

Perguntas frequentes

Qual é a diferença prática entre verificar e consultar um CPF?

A verificação checa apenas se o número tem formato matemático válido — é feita localmente, sem internet e sem custo. A consulta completa aciona uma API e retorna dados cadastrais reais: nome do titular, data de nascimento e gênero. Use verificação para filtrar erros de digitação em formulários; use a consulta completa quando precisar confirmar que o CPF pertence a uma pessoa real.

A consulta via API da CPFHub.io é realmente gratuita?

Sim. O plano gratuito oferece 50 consultas por mês sem exigir cartão de crédito. Para projetos maiores, o plano Pro inclui 1.000 consultas por R$ 149/mês. Se o volume exceder o limite contratado, a API não bloqueia as requisições — cada consulta adicional é cobrada a R$ 0,15.

É possível usar apenas a verificação local em processos de KYC?

Não. Processos de KYC (Know Your Customer) exigem confirmar a identidade real do titular, o que a verificação local não faz. A verificação local só confirma que o formato do número é matematicamente correto — um CPF fabricado com dígitos válidos passa nesse teste. Para KYC, onboarding em fintechs e operações com risco financeiro, a consulta completa via API é obrigatória.

Como combinar as duas abordagens sem desperdício de consultas?

Execute sempre a verificação local primeiro. Se o CPF for matematicamente inválido, rejeite na hora sem consumir nenhuma consulta da API. Só acione a API para CPFs que passaram na verificação local. Essa sequência elimina gastos com números digitados incorretamente e concentra as consultas nos casos que realmente precisam de confirmação de identidade.

Conclusão

Verificar o formato de um CPF e consultar dados cadastrais completos são operações distintas que se complementam. A verificação local é gratuita e instantânea, mas não confirma a existência real do CPF. A consulta via API retorna dados cadastrais reais, permitindo confirmar a identidade do titular e prevenir fraudes.

Cadastre-se em cpfhub.io — 50 consultas mensais gratuitas, sem cartão de crédito — e valide CPFs em tempo real com retorno de nome, data de nascimento e gênero do titular.