Restituição do IR: a situação pelo CPF
Envie CPF, data de nascimento e exercício e receba da Receita Federal a situação da restituição do imposto de renda daquela declaração: se está em lote, em processamento ou com pendência.
Acesso no mesmo dia, com crédito para testar · atualizado em 27 de outubro de 2026
- 1
Entrada
cpfdata_nascimentoexercicio - 2
Fonte oficial
Receita FederalConsultar restituição
- 3
Saída
JSON
- CobrançaSó consulta concluída
Você envia, você recebe
Formato da resposta. Contribuinte fictício.
Parâmetros
cpfobrigatórioO declarante.
data_nascimentoobrigatórioPrecisa bater com o cadastro.
exercicioobrigatórioO ano da declaração; a tela abre em 2026.
com_apontamentos- true quando a consulta encontrou algo que pede atenção (débito, processo, sanção).
certidao_emitida- Se o órgão emitiu o documento nesta consulta.
mensagem_orgao- A mensagem que o próprio portal devolveu, quando há.
documentos- Os documentos emitidos, um por item.
documentos[].com_apontamento- true quando este documento tem apontamento.
documentos[].dias_de_validade- Prazo de validade do documento, em dias.
documentos[].valida_ate- Data de validade, pronta para agendar a renovação.
documentos[].pdf_url- O documento emitido pelo órgão, guardado pela Hath.
documentos[].texto_completo- O texto integral do documento, extraído do PDF.
documentos[].exercicio- Ano da declaração consultada.
documentos[].situacao- A situação que a Receita mostra para a declaração.
documentos[].lote- O lote, quando a restituição já foi liberada.
documentos[].consultado_em- Data e hora da consulta.
Campos retornados
RespostaJSON{"com_apontamentos": false,"certidao_emitida": false,"mensagem_orgao": "Declaração do exercício 2026 em …","documentos": [{"com_apontamento": false,"dias_de_validade": null,"valida_ate": null,"pdf_url": null,"texto_completo": "Sua declaração está em processamento.","exercicio": 2026,"situacao": "Em processamento","lote": null,"consultado_em": "2026-10-28T10:15:00"}]}Como o resultado chega
A mesma estrutura em qualquer órgão: um status classificado e, quando a fonte emite, o PDF oficial. Só a consulta concluída é cobrada; tentativa sem resultado não entra na conta.
Regular
verdeNada consta na fonte.
Atenção
amareloHá registro que não impede, como débito parcelado ou suspenso. Vale ler o documento.
Com apontamentos
vermelhoConsta débito, sanção ou processo. O documento vem junto.
Sem resposta
cinzaA fonte não respondeu, o captcha falhou ou ficou fora deste ciclo. Vira reprocessamento, nunca um "nada consta" falso.
A entrega sai em JSON, CSV, XLSX ou XML, por API REST, webhook ou direto no seu ERP. Portal que muda de layout, adiciona captcha ou troca de sistema é conta nossa: você paga pela entrega, não pelo conserto.
Como ler o resultado
A restituição sai em lotes com cronograma publicado pela Receita. O valor é corrigido pela Selic a partir do mês seguinte ao prazo de entrega, mais 1% no mês do depósito; depois de enviado ao banco, não muda mais.
Restituição que voltou do banco sem saque tem serviço próprio de resgate, e o pedido feito por PER/DCOMP tem outra consulta. Esta API cobre a restituição apurada na declaração (DIRPF).
Perguntas frequentes
Precisa de login gov.br?
Não; a consulta usa CPF, nascimento e exercício.
Cobre PER/DCOMP?
Não; esse pedido tem consulta separada na Receita.
Dá para consultar anos anteriores?
Sim, escolhendo o exercício.
API Consulta de Restituição do IRPF (Receita Federal) na sua integração
Em produção. Acesso no mesmo dia, com crédito para testar.
A coleta é feita em fonte pública oficial: a Hath Data não é a fonte e não certifica o conteúdo publicado pelo órgão. O serviço é prestado sob contrato, o cliente é o controlador dos dados e declara a finalidade; a Hath atua como operadora. Nomes de órgãos são citados apenas para identificar a fonte, sem vínculo ou endosso. Veja os termos de uso e a política de privacidade.