# Consulta de CPF na Receita Federal via API | CPFHub.io

> Consulta de CPF em tempo real na Receita Federal via API: situação cadastral, ano do óbito, código de controle e comprovante. 1,5 crédito por consulta.

**URL:** https://www.cpfhub.io/consulta-cpf-receita-federal

---

# 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. Cada consulta vem com comprovante para arquivar no contrato, no processo ou na auditoria.

[Começar grátis](https://app.cpfhub.io/auth/register) [Ver documentação](https://www.cpfhub.io/documentacao/referencia/cpf-tempo-real) 

50 créditos grátis por mês, sem cartão de crédito.

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

`situation` 

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

`deathYear` 

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

`validationHtmlUrl` `validationUrl` 

### Emissã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.

`emissionDate` `emissionTime` `controlCode` 

A 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 resposta](https://www.cpfhub.io/documentacao/referencia/cpf-tempo-real) 

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

## Dois dados entram. A prova sai.

Sem certificado digital, sem e‑CNPJ, sem procuração eletrônica e sem fila no site da Receita.

1.  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.
    
2.  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.
    
3.  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. Se o seu fluxo não pode esperar, use a [Consulta Simples](https://www.cpfhub.io/api-consulta-cpf)  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.

cURLPOST /cpf/realtime

```bash
# Situação cadastral na Receita, com comprovante

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"}'
```

Resposta

200 OK

```json
{
  "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/…"
  }
}
```

[Pegue sua chave grátis](https://app.cpfhub.io/auth/register) [Ver documentação](https://www.cpfhub.io/documentacao) 

50 créditos grátis por mês, sem cartão.

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

[RH e Admissão](https://www.cpfhub.io/solucoes/rh-admissao) 

### Locação

Locatário e fiador verificados antes da assinatura. Garantia com CPF irregular é garantia que não executa.

[Imobiliário](https://www.cpfhub.io/solucoes/imobiliario) 

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

[Seguros](https://www.cpfhub.io/solucoes/seguros) 

### Onboarding regulado

Quando o órgão regulador pede prova do que você verificou, o comprovante vale mais que um log de API.

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

[Ver planos](https://www.cpfhub.io/precos) 

## Perguntas frequentes

Atendimento automatizado 24 horas

Ainda tem dúvidas?

Fale com a gente pelo WhatsApp.

[Falar com o time](https://api.whatsapp.com/send/?phone=551132300861&text=Ol%C3%A1!%20Tenho%20interesse%20na%20Consulta%20em%20Tempo%20Real%2C%20com%20consulta%20em%20tempo%20real%20na%20Receita%20Federal%2C%20situa%C3%A7%C3%A3o%20cadastral%2C%20ano%20do%20%C3%B3bito%20e%20comprovante.&type=phone_number&app_absent=0) 

Qual a diferença entre a Consulta Simples e a Consulta em Tempo Real?

A Consulta Simples (GET /cpf/{cpf}) precisa só do CPF, responde 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. 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. 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\_realtime (Consulta em Tempo Real, com CPF e data de nascimento; devolve também deathYear, o ano do óbito, inteiro ou null), ao lado de lookup\_cpf, lookup\_cnpj, dos lotes bulk\_lookup\_cpf e bulk\_lookup\_cnpj, que usam a Consulta Simples, e de get\_quota\_info (saldo). Pelo MCP, a Consulta em Tempo Real também é feita CPF a CPF. 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.

[Começar grátis](https://app.cpfhub.io/auth/register) [Falar com o time](https://api.whatsapp.com/send/?phone=551132300861&text=Ol%C3%A1!%20Tenho%20interesse%20na%20Consulta%20em%20Tempo%20Real%2C%20com%20consulta%20em%20tempo%20real%20na%20Receita%20Federal%2C%20situa%C3%A7%C3%A3o%20cadastral%2C%20ano%20do%20%C3%B3bito%20e%20comprovante.&type=phone_number&app_absent=0) 

*   50 créditos grátis por mês
*   Sem cartão de crédito
*   Atendimento 24h no WhatsApp
