# Consulta de CPF gratuita pelo gov.br: passo a passo completo > Veja o passo a passo completo para consultar CPF pelo gov.br e conheça alternativas automatizadas via API para validação em escala. **Publicado:** 20/12/2024 **Autor:** Redação CPFHub.io **URL:** https://cpfhub.io/blog/consulta-de-cpf-gratuita-pelo-gov-br-passo-a-passo-completo --- A consulta de CPF pelo gov.br é gratuita e oficial, mas funciona apenas para quem quer verificar a situação do próprio documento — o portal não permite consultar CPFs de terceiros nem oferece API pública. Para empresas e desenvolvedores que precisam validar CPFs de clientes de forma automatizada, a alternativa é usar uma API especializada como a [**CPFHub.io**](https://www.cpfhub.io/), que retorna nome, gênero e data de nascimento em cerca de 900ms. ## Introdução O portal gov.br, plataforma unificada do governo federal, oferece diversos serviços digitais ao cidadão brasileiro, incluindo a possibilidade de consultar informações relacionadas ao CPF. Esse tipo de consulta é frequentemente procurado por pessoas físicas que desejam verificar a situação do próprio documento. No entanto, quando o objetivo é validar CPFs de terceiros de forma automatizada — como em sistemas de cadastro, checkout ou onboarding — o gov.br apresenta limitações significativas. Este guia descreve o passo a passo para uso do gov.br e apresenta alternativas para quem precisa de automação, como a API da [**CPFHub.io**](https://www.cpfhub.io/), que integra em menos de 30 minutos e oferece 50 consultas gratuitas por mês sem cartão de crédito. --- ## Passo a passo para consultar CPF pelo gov.br ### Passo 1: acesse o portal gov.br Abra o navegador e acesse [gov.br](https://www.gov.br). Na página inicial, utilize a barra de busca para procurar por "Consultar CPF" ou "Situação cadastral CPF". ### Passo 2: faça login com sua conta gov.br Para acessar serviços relacionados ao CPF, é necessário ter uma conta gov.br. Se você ainda não tem, o cadastro pode ser feito com CPF, e-mail e celular. Existem diferentes níveis de conta (bronze, prata, ouro), que determinam quais serviços estão disponíveis. ### Passo 3: acesse o serviço de consulta Após o login, navegue até o serviço de consulta de situação cadastral do CPF. O sistema exibirá informações básicas sobre o CPF vinculado à sua conta. ### Passo 4: verifique as informações As informações exibidas geralmente incluem nome completo, data de nascimento e situação cadastral do CPF (regular, suspenso, cancelado, etc.). ### Passo 5: imprima ou salve o comprovante Se necessário, é possível gerar um comprovante de situação cadastral para apresentar a terceiros. --- ## Limitações da consulta pelo gov.br Embora o gov.br seja uma fonte oficial e confiável, ele apresenta limitações importantes: * **Consulta apenas do próprio CPF** -- o portal foi projetado para que o cidadão consulte seus próprios dados, não o CPF de terceiros. * **Processo manual** -- é necessário acessar o site, fazer login e navegar até o serviço. Não há possibilidade de automação. * **Sem API pública** -- o gov.br não oferece uma API aberta para consulta programática de CPF por terceiros. * **Depende de autenticação individual** -- cada consulta exige login com credenciais pessoais. * **Não é escalável** -- para empresas que precisam validar dezenas ou centenas de CPFs por mês, o processo manual é inviável. --- ## Quando o gov.br é suficiente A consulta pelo gov.br é adequada para: * Pessoas físicas que querem verificar a situação do próprio CPF. * Conferência pontual antes de uma operação financeira pessoal. * Geração de comprovante de situação cadastral para apresentar a bancos ou órgãos públicos. --- ## Quando você precisa de uma alternativa automatizada Para os cenários abaixo, o gov.br não atende e uma API especializada é necessária: * **Sistemas de cadastro** -- validar o CPF de novos clientes automaticamente durante o onboarding. * **E-commerce** -- verificar dados do comprador no checkout antes de aprovar a compra. * **Fintechs** -- processos de KYC que exigem validação em tempo real. * **ERPs e sistemas de gestão** -- validação de CPF de fornecedores e colaboradores. * **Plataformas de marketplace** -- verificar identidade de vendedores e compradores. --- ## A alternativa: consulta via API da CPFHub.io A [**CPFHub.io**](https://www.cpfhub.io/) oferece uma API REST que retorna dados cadastrais de CPF — nome, gênero e data de nascimento — com latência de aproximadamente 900ms, autenticação por `x-api-key` e suporte a mais de 13 linguagens de programação. ### Exemplo de consulta com cURL ```bash curl -X GET https://api.cpfhub.io/cpf/12345678900 \ -H "x-api-key: SUA_CHAVE_DE_API" \ -H "Accept: application/json" \ --max-time 10 ``` ### Exemplo de consulta com JavaScript (Node.js) ```javascript const consultarCPF = async (cpf) => { const controller = new AbortController(); const timeoutId = setTimeout(() => controller.abort(), 10000); try { const response = await fetch( `https://api.cpfhub.io/cpf/${cpf}`, { 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) { console.log(`Nome: ${data.data.name}`); console.log(`Nascimento: ${data.data.birthDate}`); console.log(`Gênero: ${data.data.gender}`); } return data; } catch (error) { clearTimeout(timeoutId); console.error('Erro na consulta:', error.message); return null; } }; ``` ### Resposta da API ```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 } } ``` --- ## Comparativo: gov.br vs. API da CPFHub.io | Aspecto | gov.br | CPFHub.io API | | --- | --- | --- | | Tipo de consulta | Manual (navegador) | Automatizada (API REST) | | CPF de terceiros | Não | Sim | | Integração com sistemas | Não | Sim (13+ linguagens) | | Tempo de resposta | Variável (depende do site) | ~900ms | | Volume mensal | Ilimitado (próprio CPF) | 50 grátis, até milhares (pagos) | | Custo | Gratuito | Gratuito (50/mês) ou pago | | Conformidade LGPD | Sim | Sim | | Dados retornados | Situação cadastral | Nome, gênero, nascimento | --- ## Como combinar as duas abordagens Em alguns cenários, pode fazer sentido usar ambas as ferramentas: * **gov.br para o próprio CPF** -- o titular pode gerar comprovantes e verificar a situação do seu documento. * **API da CPFHub.io para CPFs de terceiros** -- a empresa valida automaticamente os dados de clientes, fornecedores e parceiros. Essa combinação garante cobertura completa: o cidadão verifica seu próprio documento pelo canal oficial, e a empresa valida CPFs de terceiros por meio de uma API confiável. --- ## Boas práticas ao validar CPFs via API * **Valide o formato localmente antes de consultar a API** -- economize consultas rejeitando CPFs com formato inválido. * **Implemente tratamento de erros** -- trate códigos HTTP 400, 401, 404 e 500 de forma adequada. * **Registre logs de auditoria** -- mantenha registro de todas as consultas realizadas para fins de compliance. A [ANPD](https://www.gov.br/anpd) orienta que o tratamento de dados pessoais deve ser documentado e rastreável. * **Proteja a chave de API** -- nunca exponha a `x-api-key` em código front-end ou repositórios públicos. --- ## Perguntas frequentes ### O gov.br permite consultar o CPF de outra pessoa? Não. O portal gov.br foi projetado para que cada cidadão consulte a situação do seu próprio CPF usando suas credenciais pessoais. Para validar CPFs de terceiros — como clientes, fornecedores ou parceiros — é necessário usar uma API especializada como a CPFHub.io, que retorna nome, gênero e data de nascimento de forma programática. ### Qual é a diferença entre situação cadastral e consulta de dados de CPF? A situação cadastral (disponível no gov.br) informa se o CPF está regular, suspenso ou cancelado perante a Receita Federal. A consulta de dados via API, como a da CPFHub.io, retorna informações cadastrais como nome completo, gênero e data de nascimento — úteis para validação de identidade em onboarding, checkout e processos de KYC. ### A API CPFHub.io é gratuita? Sim, o plano gratuito oferece 50 consultas por mês sem necessidade de cartão de crédito. Quando o limite é ultrapassado, a API não bloqueia — cobra R$0,15 por consulta adicional. Para volumes maiores, o plano Pro inclui 1.000 consultas mensais por R$149/mês, também com R$0,15 por consulta extra. ### Quanto tempo leva para integrar a API da 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, Kotlin e outras linguagens. ### 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) - [API de consulta de CPF: diferenças entre planos gratuito, Pro e Corporate](https://cpfhub.io/blog/api-de-consulta-de-cpf-diferencas-entre-planos-gratuito-pro-e-corporate) - [APIs de CPF: como avaliar o custo-benefício antes de contratar?](https://cpfhub.io/blog/apis-de-cpf-como-avaliar-o-custo-beneficio-antes-de-contratar) --- ## Conclusão A consulta de CPF pelo gov.br é uma opção gratuita e oficial para verificar a situação do próprio documento. Porém, para empresas e desenvolvedores que precisam validar CPFs de terceiros de forma automatizada, uma API especializada é indispensável. Cadastre-se em [cpfhub.io](https://www.cpfhub.io/) — 50 consultas mensais gratuitas, sem cartão de crédito — e comece a validar CPFs de clientes de forma automática já nos primeiros minutos após o cadastro.