Consulta em Tempo Real
A situação do CPF,
direto da Receita Federal.
Envie o CPF e a data de nascimento e receba a situação cadastral direto da Receita Federal, em cerca de 1 segundo. Cada consulta vem com comprovante para arquivar no contrato, no processo ou na auditoria.
50 créditos grátis por mês, sem cartão de crédito.
O que você recebe
Não é um dado. É uma prova.
A diferença entre saber e conseguir demonstrar depois.
A situação cadastral
Regular, pendente de regularização, suspensa, cancelada, nula ou titular falecido, conforme o cadastro da Receita Federal no momento da consulta.
situationO ano do óbito
Sempre presente, como número inteiro ou null. Traz só o ano, sem dia nem mês. É null quando não há óbito registrado ou quando o valor recebido da Receita é inválido.
deathYearO comprovante
Uma página em HTML com o resultado da consulta, pronta para arquivar, e o link para conferir a consulta no site da Receita Federal.
validationHtmlUrlvalidationUrlEmissão e código de controle
A data e a hora exatas da resposta da Receita e o código que identifica a consulta. É o que mostra que a verificação aconteceu antes da decisão.
emissionDateemissionTimecontrolCodeA resposta também traz o nome do titular, em caixa alta, e a data de nascimento (name e birthDate).
Ver a referência completa da respostaSituação cadastral
Seis respostas possíveis.
Uma delas libera. As outras cinco são o motivo de você estar consultando.
Regular
CPF em ordem, sem pendências.
Pendente de regularização
Falta entregar declaração ou atualizar o cadastro.
Suspensa
Cadastro incorreto ou incompleto.
Cancelada
Encerrado por decisão administrativa, judicial ou duplicidade.
Nula
Inscrição obtida com fraude.
Titular falecido
Óbito registrado no cadastro da Receita.
Como funciona
Dois dados entram. A prova sai.
Sem certificado digital, sem e‑CNPJ, sem procuração eletrônica e sem fila no site da Receita.
- 01
Você envia dois dados
O CPF e a data de nascimento do titular. É o que a Receita Federal exige para responder, e é tudo o que pedimos.
- 02
Consultamos a Receita na hora
Sem base intermediária e sem cópia de ontem. A consulta acontece na Receita Federal no momento da sua chamada.
- 03
Você recebe o JSON e o comprovante
Situação cadastral, ano do óbito, data e hora de emissão, código de controle e o link do comprovante. Seu sistema decide e arquiva a prova.
O tempo depende da Receita Federal. O típico é cerca de 1 segundo, não é um SLA. Se o seu fluxo não pode esperar, use a Consulta Simples no caminho crítico e esta consulta onde for preciso comprovar.
Integre em qualquer linguagem
A mesma chave que você já usa, uma rota diferente. Exemplos prontos em dez linguagens.
curl -X POST \
'https://api.cpfhub.io/cpf/realtime' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'content-type: application/json' \
-d '{"cpf":"12345678909","birthDate":"15/06/1990"}'{
"success": true,
"data": {
"cpf": "12345678909",
"name": "FULANO DE TAL",
"birthDate": "15/06/1990",
"deathYear": null,
"situation": "REGULAR",
"emissionDate": "02/10/2026",
"emissionTime": "14:15:16",
"controlCode": "ABCD.1234.EFGH.5678",
"validationUrl": "https://servicos.receita…",
"validationHtmlUrl": "https://api.cpfhub.io/…"
}
}50 créditos grátis por mês, sem cartão.
Onde usar
Quando alguém vai cobrar a prova.
Todo fluxo em que a decisão vira contrato, pagamento ou registro, e precisa se sustentar depois.
Admissão
Confirme o CPF do candidato antes de assinar a carteira. CPF irregular trava eSocial e vira retrabalho no RH.
Locação
Locatário e fiador verificados antes da assinatura. Garantia com CPF irregular é garantia que não executa.
Contratos e jurídico
O comprovante em HTML documenta a diligência na identificação das partes, com data, hora e código de controle.
Folha e benefícios
A resposta traz o ano do óbito em deathYear e a situação TITULAR FALECIDO quando o cadastro registra óbito. Pagamento indevido é barrado antes de sair.
Sinistro e seguros
Confirme o segurado na Receita Federal antes de liberar o pagamento, com registro arquivável do que foi consultado.
Onboarding regulado
Quando o órgão regulador pede prova do que você verificou, o comprovante vale mais que um log de API.
Preço
Mesmo plano, mesmo saldo de créditos.
A Consulta em Tempo Real usa a mesma chave, o mesmo plano e o mesmo saldo da Consulta Simples. Cada consulta concluída consome 1,5 crédito por padrão, e alguns planos têm valores diferentes.
1,5 crédito
por consulta concluída, contra 1 crédito da Consulta Simples
0 crédito
quando o CPF tem formato incorreto ou a Receita Federal não responde
50
créditos grátis por mês para testar, sem cartão
Perguntas frequentes
Qual a diferença entre a Consulta Simples e a Consulta em Tempo Real?
A Consulta Simples (GET /cpf/{cpf}) precisa só do CPF, tem tempo típico de ~150 ms (não é um SLA) a partir da nossa base e devolve nome, gênero e data de nascimento. A Consulta em Tempo Real (POST /cpf/realtime) recebe o CPF e a data de nascimento no corpo JSON, consulta a Receita Federal no momento da chamada e devolve situação cadastral, ano do óbito (deathYear, inteiro ou null), código de controle e comprovante em HTML, em cerca de 1 segundo (tempo típico, não um SLA). São rotas independentes: uma nunca cai para a outra.
Por que a Consulta em Tempo Real exige a data de nascimento?
É exigência da própria Receita Federal. O serviço público de consulta só responde quando recebe o CPF e a data de nascimento do titular juntos. Se você não tem a data no seu fluxo, a rota indicada é a Consulta Simples.
A consulta devolve o ano de falecimento?
Devolve o ano do óbito no campo deathYear, sempre presente, como inteiro ou null. Não devolve dia nem mês. null aparece quando não há óbito registrado ou quando o valor recebido é inválido: precisa ter 4 dígitos, ficar entre 1900 e o ano atual e não ser anterior ao ano de nascimento.
O que significa cada situação cadastral?
Regular: CPF em ordem. Pendente de regularização: falta entregar declaração ou atualizar cadastro. Suspensa: cadastro incorreto ou incompleto. Cancelada: encerrado por decisão administrativa ou judicial, ou por duplicidade. Nula: inscrição obtida com fraude. Titular falecido: óbito registrado no cadastro.
Como funciona o comprovante?
A resposta traz validationHtmlUrl, um comprovante em HTML com os dados da consulta, data e hora de emissão e código de controle, e validationUrl, o link para conferir a consulta no site da Receita Federal. É o registro que sustenta uma admissão, uma locação ou um contrato em auditoria.
Quanto custa a Consulta em Tempo Real?
Por padrão, 1,5 crédito por consulta concluída, contra 1 crédito da Consulta Simples (alguns planos têm valores diferentes). A cobrança usa o mesmo saldo do seu plano, sem pacote separado. CPF com formato ou dígito verificador incorreto e falhas de comunicação com a Receita Federal (502 e 503) não consomem crédito.
Quanto tempo demora?
A Consulta em Tempo Real depende do tempo de resposta da Receita Federal. O tempo típico é cerca de 1 segundo, não é um SLA. Se o seu fluxo não pode esperar, faça a chamada de forma assíncrona ou use a Consulta Simples no caminho crítico.
Posso usar a Consulta em Tempo Real em lote ou pelo MCP?
Em lote, não. POST /cpf/bulk atende só a Consulta Simples. Pelo servidor MCP remoto (https://api.cpfhub.io/mcp), sim: ele expõe lookup_cpf (Consulta Simples), lookup_cpf_realtime (Consulta em Tempo Real, com CPF e data de nascimento; devolve também deathYear, o ano do óbito, inteiro ou null) e get_quota_info (saldo). Não há tool de lote no MCP. Para volume na Consulta em Tempo Real, fale com o nosso time pelo WhatsApp ou em contato@cpfhub.io.
Preciso de outra conta ou outra chave?
Não. É a mesma conta, a mesma x-api-key, o mesmo plano e o mesmo saldo de créditos que você já usa em GET /cpf/{cpf}.
Situação cadastral
em tempo real.
- 50 créditos grátis por mês
- Sem cartão de crédito
- Atendimento 24h no WhatsApp