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, 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, 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. 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 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

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)

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

{
    "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

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 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.

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 — 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.