Belo Horizonte: o IPTU do imóvel quitado
Envie o índice cadastral do imóvel e receba da Prefeitura de Belo Horizonte a certidão de quitação de IPTU e taxas, do período que você escolher, com número e código de verificação.
Acesso no mesmo dia, com crédito para testar · atualizado em 28 de outubro de 2026
- 1
Entrada
indice_cadastralmes_inicialmes_final - 2
Fonte oficial
Prefeitura de Belo HorizonteCND Online, IPTU e Taxas
- 3
Saída
JSON + PDF
- CobrançaSó consulta concluída
Você envia, você recebe
Formato da resposta. Imóvel fictício.
Parâmetros
indice_cadastralobrigatórioO código do imóvel no cadastro da prefeitura.
mes_inicialopcionalPadrão: janeiro do ano atual.
mes_finalopcionalPadrão: o mês atual.
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[].pdf_url- O documento emitido pelo órgão, guardado pela Hath.
documentos[].texto_completo- O texto integral do documento, extraído do PDF.
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[].numero_documento- CPF/CNPJ consultado, só dígitos.
documentos[].tipo_certidao- Título da certidão.
documentos[].situacao- Situação da certidão (vocabulário do projeto).
documentos[].numero_certidao- Número da certidão.
documentos[].codigo_verificacao- Código de controle da certidão.
documentos[].exercicio- Exercício impresso.
documentos[].autenticada- Verdadeiro quando pdf_url é a confirmação de autenticidade; falso quando a autenticação falhou e vai o documento auxiliar.
documentos[].url_documento_auxiliar- Link (S3) do documento auxiliar em HTML.
documentos[].nome- Nome/razão social impresso.
documentos[].emissao_portal- Data de emissão (dd/mm/aaaa).
documentos[].valida_ate_portal- Validade impressa (dd/mm/aaaa).
documentos[].mensagem- Bloco OBSERVAÇÕES da certidão.
documentos[].suspensoes- Avisos de lançamentos com suspensão administrativa/judicial.
documentos[].debitos- Lançamentos em aberto da positiva (tabela PENDENCIAS); coluna nova vira snake_case do nome.
debitos[].tipo- Tipo do débito.
debitos[].tributo- Tributo.
debitos[].exercicio- Exercício do lançamento.
debitos[].lancamento- Número do lançamento (pode ter letras).
debitos[].identificador- Identificador (índice ou inscrição).
documentos[].indice_cadastral- Índice cadastral do IPTU (só letras e dígitos).
documentos[].periodo- Período pesquisado (MM/AAAA A MM/AAAA).
documentos[].endereco- Endereço do imóvel impresso.
Campos retornados
Fontes oficiais
RespostaJSON{"com_apontamentos": false,"certidao_emitida": true,"mensagem_orgao": "Índice cadastral não encontrado.","documentos": [{"pdf_url": "https://…/documento.pdf","texto_completo": "CERTIDÃO NEGATIVA DE DÉBITOS ...","com_apontamento": false,"dias_de_validade": 30,"valida_ate": "2026-11-26T00:00:00","numero_documento": "12345678000190","tipo_certidao": "Certidão de Quitação de IPTU/Taxas …","situacao": "negativa","numero_certidao": "1.234.567","codigo_verificacao": "AB12CD34EF56","exercicio": "2026","autenticada": true,"url_documento_auxiliar": "https://…/pbh_auxiliar.html","nome": "EMPRESA EXEMPLO LTDA","emissao_portal": "27/10/2026","valida_ate_portal": "26/12/2026","mensagem": "EMPRESA NÃO INSCRITA NO MUNICÍPIO DE …","suspensoes": ["Existe(m) lancamento(s) com suspensao …"],"debitos": [],"indice_cadastral": "1501230330083","periodo": "01/2026 A 10/2026","endereco": "RUA EXEMPLO, 100"}],"debitos": [{"tipo": "IPTU","tributo": "TAXA DE COLETA DE RESIDUOS","exercicio": "2025","lancamento": "0957810BIA0005","identificador": "1501230330083"}]}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
É uma certidão do imóvel: pede o índice cadastral, não o CNPJ, e o documento informado na resposta é o do proprietário impresso na certidão. Com débito no período, a resposta traz cada um com tributo e tipo; suspensões de cobrança vêm separadas.
Serve para compra e venda, locação e garantia, quando o imóvel da empresa entra no negócio. A quitação plena da empresa, o ISS e o ITBI saem pelo mesmo CND Online. O passo a passo manual está no guia da certidão municipal de BH.
Perguntas frequentes
Precisa do CNPJ?
Não. A chave é o índice cadastral do imóvel.
Qual período a certidão cobre?
O que você enviar; sem período, de janeiro ao mês atual.
Traz dado do proprietário?
O nome e o endereço impressos na certidão.
API Certidão de Quitação de IPTU e Taxas de Belo Horizonte 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.