# Consulta de CPF grátis: diferença entre verificar e consultar dados completos > Entenda a diferença entre verificar a validade de um CPF e consultar dados cadastrais completos via API. Saiba qual abordagem usar em cada cenário. **Publicado:** 20/03/2025 **Autor:** Redação CPFHub.io **URL:** https://cpfhub.io/blog/consulta-de-cpf-gratis-diferenca-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 ```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**](https://www.cpfhub.io/), a resposta JSON inclui: ```json { "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 | Aspecto | Verificação (local) | Consulta completa (API) | | --- | --- | --- | | Onde executa | Localmente (client/server) | API externa (CPFHub.io) | | Custo | Zero | Gratuito (50/mês) ou pago | | Velocidade | Instantânea (<1ms) | ~900ms | | Precisa de internet | Não | Sim | | Confirma existência real | Não | Sim | | Retorna nome do titular | Não | Sim | | Retorna data de nascimento | Não | Sim | | Retorna gênero | Não | Sim | | Previne fraude com CPF inventado | Não | Sim | | Ideal para | Filtro em formulários | KYC, onboarding, antifraude | --- ## 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](https://www.gov.br/anpd/pt-br) 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: ```javascript 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 | Etapa | Custo | Consumo de API | | --- | --- | --- | | Verificação local | R$ 0 | 0 consultas | | Consulta completa (CPFHub.io) | R$ 0 (até 50/mês) | 1 consulta por CPF | 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. ### Leia também - [API de CPF grátis para desenvolvedores: como começar em 5 minutos](https://cpfhub.io/blog/api-cpf-gratis-desenvolvedores-comecar-5-minutos) - [Diferença entre validação de CPF e consulta de CPF: quando usar cada uma](https://cpfhub.io/blog/diferenca-entre-validacao-de-cpf-e-consulta-de-cpf-quando-usar-cada-uma) - [KYC no Brasil: quais setores são obrigados a validar CPF por lei](https://cpfhub.io/blog/kyc-no-brasil-quais-setores-sao-obrigados-a-validar-cpf-por-lei) - [Onboarding digital em fintechs: como validar CPF em menos de 30 segundos](https://cpfhub.io/blog/onboarding-digital-em-fintechs-como-validar-cpf-em-menos-de-30-segundos) --- ## 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](https://www.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.