Distrito Federal: débitos, dívida ativa, imóvel e veículo
Envie o CNPJ ou o CPF e receba da Receita do Distrito Federal a certidão de débitos ou a de dívida ativa. O mesmo portal emite por inscrição do imóvel e por Renavam.
Acesso no mesmo dia, com crédito para testar · atualizado em 28 de outubro de 2026
- 1
Entrada
cnpjcpfinscricao_imovelrenavam - 2
Fonte oficial
Receita do DFPortal de Serviços da Receita, Emissão de Certidão
- 3
Saída
JSON + PDF
- CobrançaSó consulta concluída
Você envia, você recebe
Formato da resposta. Empresa fictícia.
Parâmetros
cnpjopcionalPessoa jurídica.
cpfopcionalPessoa física.
inscricao_imovelopcionalNa rota do imóvel.
renavamopcionalNa rota do veículo.
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.
acao_necessaria- Só com argumento vazio ou fora da faixa de dígitos (imóvel 1-14, Renavam 9-11): 500 sem cobrança.
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 pelo RetornoPesquisa do portal, conferida com o título do PDF.
documentos[].tipo_certidao- Título do PDF (ou nome padrão).
documentos[].numero_certidao- Número da certidão (só existe no PDF).
documentos[].codigo_retorno_portal- RetornoPesquisa da API do portal (01-06 emite; 11-14/29 há débitos).
documentos[].nome- Nome do contribuinte (null quando 'NAO CADASTRADO').
documentos[].endereco- Endereço devolvido pela API.
documentos[].bairro- Bairro.
documentos[].inscricao_estadual- CF/DF.
documentos[].sem_cadastro- CPF/CNPJ não cadastrado no DF (retornos 02/04).
documentos[].mensagens_debito- Mensagens da API sobre débitos (ex.: 'HA DEBITOS').
documentos[].finalidade- Finalidade da certidão.
documentos[].emissao- Data e hora da emissão (do PDF).
documentos[].emissao_portal- Data de emissão.
documentos[].valida_ate_portal- Validade (da API; 90 dias).
documentos[].avisos_extracao- Divergências (viram nao_identificada).
documentos[].numero_documento- Argumento consultado (só dígitos).
documentos[].mensagem- Só na positiva_restrita: mensagem de não emissão.
documentos[].mensagem_portal- Só na positiva_restrita: aviso literal do site.
documentos[].consultado_em- Só na positiva_restrita: data e hora da consulta.
Campos retornados
Fontes oficiais
RespostaJSON{"com_apontamentos": false,"certidao_emitida": true,"mensagem_orgao": null,"documentos": [{"com_apontamento": false,"dias_de_validade": 90,"valida_ate": "2027-01-25T00:00:00","pdf_url": "https://…/certidao-exemplo.pdf","texto_completo": "CERTIDÃO NEGATIVA DE DÉBITOS …","situacao": "negativa","tipo_certidao": "CERTIDÃO NEGATIVA DE DÉBITOS","numero_certidao": "123456789012026","codigo_retorno_portal": "01","nome": "EMPRESA EXEMPLO LTDA","endereco": "SQS 100 BLOCO A","bairro": "ASA SUL","inscricao_estadual": "0712345600123","sem_cadastro": false,"mensagens_debito": null,"finalidade": "DIVERSAS","emissao": "27/10/2026 10:15:42","emissao_portal": "27/10/2026","valida_ate_portal": "25/01/2027","avisos_extracao": null,"numero_documento": "12345678000195","mensagem": "NÃO FOI POSSÍVEL EMITIR SUA CERTIDÃO …","mensagem_portal": "Para emitir a certidão Clique Aqui","consultado_em": "27/10/2026 10:15:42"}],"acao_necessaria": {"codigo": "invalid_document","mensagem": "CPF/CNPJ inválido (dígito verificador)","campos": ["<campo da rota>"]}}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
Por CNPJ ou CPF, com débito, a área pública não emite: a resposta volta positiva_restrita, com as mensagens de débito do portal e a página guardada. Por imóvel ou veículo, o portal segue até o PDF mesmo com débito, e a situação sai do título da certidão.
A finalidade escolhida sai impressa no documento. Inscrição de imóvel ou placa não cadastrada voltam como recusa, sem documento. Uma certidão emitida se confere pelo número e pelo documento. Para as outras UFs, veja a API de CND estadual.
Perguntas frequentes
Débitos e dívida ativa são a mesma certidão?
Não. São dois tipos, cada um numa rota.
Emite certidão de veículo?
Sim, pelo Renavam.
Tem captcha?
Tem verificação anti-robô, resolvida do lado da Hath.
API Certidão de Débitos e de Dívida Ativa do Distrito 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.