É possível verificar se um CPF está regular na Receita Federal sem pagar nada: o portal oficial da Receita Federal oferece consulta manual gratuita com CPF e data de nascimento, e a CPFHub.io disponibiliza uma API com 50 consultas mensais gratuitas para quem precisa automatizar a verificação em sistemas e aplicações.
Introdução
A regularidade do CPF é um requisito para diversas operações do dia a dia: abrir conta em banco, realizar compras no crédito, participar de concursos públicos, firmar contratos e até receber benefícios governamentais. Para empresas, validar os dados cadastrais de clientes e parceiros é parte fundamental de processos de compliance e prevenção de fraudes.
A boa notícia é que existem formas gratuitas de verificar dados cadastrais vinculados a um CPF.
O que significa CPF regular?
O CPF pode apresentar diferentes situações cadastrais: regular, pendente de regularização, suspenso, cancelado ou nulo. Cada situação tem implicações distintas para o titular e para quem precisa validar os dados.
Para fins de validação de identidade em sistemas, o mais importante é confirmar que o CPF existe, está associado a uma pessoa real e que os dados cadastrais (nome, data de nascimento) são consistentes com as informações fornecidas.
Canais gratuitos para verificar a situação do CPF
Portal da Receita Federal
O site da Receita Federal oferece um serviço de consulta de situação cadastral do CPF. O processo é simples:
- Acesse o portal da Receita Federal.
- Procure pelo serviço "Consultar CPF" ou "Comprovante de Situação Cadastral".
- Informe o CPF e a data de nascimento do titular.
- O sistema exibirá o nome, a situação cadastral e a data de nascimento vinculados ao CPF.
Limitações: o processo é manual, exige a data de nascimento do titular e não pode ser automatizado via API.
Portal gov.br
O gov.br centraliza diversos serviços digitais, incluindo informações sobre o CPF. Porém, como vimos, é voltado para consulta do próprio documento e exige autenticação individual.
Aplicativos de birôs de crédito
Aplicativos como os de Serasa e SPC permitem que o próprio titular consulte a situação do seu CPF gratuitamente. Não servem para consultar CPFs de terceiros.
Limitações das consultas manuais gratuitas
Para empresas e desenvolvedores, as consultas manuais apresentam problemas claros:
-
Não são automatizáveis -- cada consulta exige interação humana.
-
Não escalam -- validar centenas de CPFs manualmente é inviável.
-
Exigem dados adicionais -- alguns portais exigem a data de nascimento, que nem sempre está disponível.
-
Sem integração com sistemas -- os resultados precisam ser transcritos manualmente.
A alternativa automatizada: API da CPFHub.io
Para quem precisa de automação, a CPFHub.io oferece uma API REST que retorna nome, data de nascimento e gênero vinculados ao CPF consultado, com latência de ~150 ms e plano gratuito de 50 consultas mensais sem necessidade de cartão de crédito.
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 Python
import requests
def verificar_cpf(cpf):
url = f"https://api.cpfhub.io/cpf/{cpf}"
headers = {
"x-api-key": "SUA_CHAVE_DE_API",
"Accept": "application/json"
}
try:
response = requests.get(url, headers=headers, timeout=10)
data = response.json()
if data.get("success"):
info = data["data"]
print(f"CPF encontrado: {info['cpf']}")
print(f"Nome: {info['name']}")
print(f"Data de nascimento: {info['birthDate']}")
print(f"Gênero: {info['gender']}")
return True
else:
print("CPF não encontrado na base de dados.")
return False
except requests.exceptions.Timeout:
print("Timeout na consulta. Tente novamente.")
return None
except requests.exceptions.RequestException as e:
print(f"Erro na requisição: {e}")
return None
# Uso
verificar_cpf("12345678900")
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
}
}
Vantagens da consulta via API sobre métodos manuais
| Aspecto | Consulta manual | API CPFHub.io |
|---|---|---|
| Automatização | Não | Sim |
| Integração com sistemas | Não | Sim (13+ linguagens) |
| Tempo por consulta | 2-5 minutos | ~150 ms |
| Escalabilidade | Baixa | Alta |
| Exige dados adicionais | Sim (data de nascimento) | Não |
| Formato da resposta | Texto/HTML | JSON padronizado |
| Custo | Gratuito | Gratuito (50/mês) |
Cenários práticos de verificação
Abertura de conta
Bancos e fintechs verificam os dados do CPF no momento da abertura de conta digital. Com a API, essa verificação acontece em ~150 ms, sem que o usuário precise sair do fluxo de cadastro.
Contratação de funcionários
O departamento de RH pode validar o CPF de novos colaboradores durante o processo de admissão, garantindo que os dados estão corretos antes de registrar na folha de pagamento.
Fechamento de contratos
Empresas que fecham contratos com pessoas físicas podem verificar rapidamente se o CPF do contratante é válido e se os dados conferem.
Emissão de notas fiscais
Antes de emitir uma NF-e ou NFS-e, validar o CPF do destinatário evita rejeições e retrabalho.
Como maximizar o uso das consultas gratuitas
O plano gratuito da CPFHub.io oferece 50 consultas por mês. Para aproveitar ao máximo:
-
Valide o formato localmente -- rejeite CPFs com formato inválido antes de consumir a API.
-
Implemente cache -- armazene resultados por um período razoável para evitar consultas duplicadas.
-
Consulte apenas quando necessário -- defina regras de negócio para determinar quais cadastros exigem validação via API.
-
Monitore o consumo -- acompanhe o uso no dashboard para planejar a migração para o plano Pro quando necessário.
Quando o plano gratuito não é suficiente
Se sua operação precisa de mais de 50 consultas por mês, o plano Pro (R$ 149/mês) oferece:
- 1.000 consultas mensais.
- A franquia grátis não segue depois dos 50 créditos: a API responde HTTP 403 com "Limite de créditos excedido". O excedente dos planos pagos depende da faixa e está na página de preços. O limite por minuto continua à parte, com HTTP 429 e o header Retry-After.
- Rate limit de 30 requisições por minuto.
- SLA de 99%.
- Suporte via WhatsApp e e-mail.
Para grandes operações, o plano Corporativo oferece volume personalizado, infraestrutura exclusiva e SLA de 99,9%.
Perguntas frequentes
A API CPFHub.io confirma se o CPF está "regular" ou apenas retorna os dados cadastrais?
A API retorna os dados cadastrais vinculados ao CPF (nome, data de nascimento, gênero). A confirmação de "regularidade" no sentido estrito da Receita Federal — que inclui situações como suspenso, cancelado ou pendente — é feita pelo portal oficial. A CPFHub.io permite confirmar que o CPF existe e que os dados fornecidos pelo usuário coincidem com o cadastro federal.
É necessário informar a data de nascimento para consultar via API?
Não. Ao contrário do portal da Receita Federal, a API da CPFHub.io exige apenas o número do CPF e a chave de autenticação (x-api-key). A data de nascimento é retornada como parte da resposta — o que permite que sua aplicação a use para validação cruzada com os dados fornecidos pelo usuário.
O que acontece se eu ultrapassar 50 consultas no plano gratuito?
No gratuito, zerar os 50 créditos do mês interrompe as consultas com HTTP 403 ("Limite de créditos excedido"). Nos planos pagos o excedente não é um valor único: ele varia e está publicado na página de preços. O limite por minuto responde HTTP 429 com Retry-After. O controle de consumo pode ser acompanhado em app.cpfhub.io/settings/billing, permitindo planejar a migração para o plano Pro quando o volume crescer.
Quanto tempo leva a integração da API em um sistema existente?
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 se um CPF apresenta dados cadastrais consistentes é possível sem custo, tanto por canais oficiais (para consultas manuais do próprio CPF) quanto por APIs com plano gratuito (para validações automatizadas de CPFs de terceiros).
Cadastre-se em cpfhub.io — 50 consultas mensais gratuitas, sem cartão de crédito — e integre a verificação de CPF diretamente nos seus fluxos de cadastro, onboarding e emissão de documentos.
CPFHub.io
Pronto para integrar a API?
50 créditos gratuitos para testar agora. Sem cartão de crédito. Acesso imediato à documentação.




