API de consultaEm produção

CND federal: as que já foram emitidas

Envie o CNPJ e receba da Receita Federal o histórico de certidões de regularidade fiscal dos últimos 365 dias: cada certidão com situação, emissão, validade e o PDF, sem emitir uma nova.

Acesso no mesmo dia, com crédito para testar · atualizado em 28 de outubro de 2026

  1. 1

    Entrada

    cnpjcpfdata_nascimentocib
  2. 2
  3. 3

    Saída

    JSON + PDF

  4. CobrançaSó consulta concluída

Você envia, você recebe

Formato da resposta. Empresa fictícia.

Parâmetros

  • cnpjopcional

    A empresa.

  • cpfopcional

    Com a data de nascimento.

  • data_nascimentoopcional

    Só com CPF.

  • cibopcional

    Imóvel rural. Envie só uma das chaves.

Campos retornados

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[].situacao
Situação lida do título da certidão.
documentos[].status_certidao
Situação da certidão no portal (situacao do /consulta).
documentos[].emissao
Data de emissão (dataEmissao do portal).
documentos[].numero_controle
Código de controle da certidão.
documentos[].tipo_certidao
Tipo de certidão informado pelo portal.
Tela de Certidão de Pessoa Jurídica da Receita Federal, com o campo CNPJ e as opções Consultar Certidão e Emitir Certidão
RespostaJSON
{"com_apontamentos": false,"certidao_emitida": true,"mensagem_orgao": "3 certidão(ões) encontrada(s) no …","documentos": [{"com_apontamento": false,"dias_de_validade": 180,"valida_ate": "2026-12-01T00:00:00","pdf_url": "https://…/exemplo-01.pdf","texto_completo": "MINISTÉRIO DA FAZENDA Secretaria da …","situacao": "negativa","status_certidao": "Válida","emissao": "2026-06-04T10:20:30","numero_controle": "A1B2.C3D4.E5F6.0789","tipo_certidao": "Negativa"}]}

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

    verde

    Nada consta na fonte.

  • Atenção

    amarelo

    Há registro que não impede, como débito parcelado ou suspenso. Vale ler o documento.

  • Com apontamentos

    vermelho

    Consta débito, sanção ou processo. O documento vem junto.

  • Sem resposta

    cinza

    A 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

Quando a certidão federal já foi emitida, não é preciso pedir outra: a rota de histórico devolve todas as certidões dos últimos 365 dias, cada uma como um documento, com situação, status no portal, data de emissão, número de controle e validade, e o PDF de cada uma.

Serve para recuperar a certidão que alguém da equipe já tirou e para conferir o que está válido antes de uma licitação. Sem nenhuma certidão no período, volta sem documento. Para emitir uma nova, use a API da CND federal.

Perguntas frequentes

Emite certidão nova?

Não. Só traz as já emitidas no último ano.

Vem o PDF de cada uma?

Sim, um documento por certidão.

Serve para imóvel rural?

Sim, pelo CIB.

API Histórico de Certidões de Regularidade Fiscal Federal na sua integração

Em produção. Acesso no mesmo dia, com crédito para testar.

Recuperar CNDs federais em lote

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.