Skip to main content
Uma Propriedade Urbana representa uma propriedade registrada em cadastro municipal de IPTU. O campo fonte indica a plataforma/origem do dado e o campo localizacao.uf o estado.

​
Tipagem

{
  "id": "a1b2c3d4e5f6",
  "fonte": "betha",
  "sql_iptu": "0123456789",
  "inscricao": "0123456789",
  "localizacao": {
    "logradouro": "R HENRIQUE PASSINI",
    "numero": "748",
    "complemento": "401",
    "bairro": "SERRA",
    "cidade": "BELO HORIZONTE",
    "uf": "MG",
    "cep": "30220-380"
  },
  "area_terreno": 360.00,
  "area_construida": 180.00,
  "ano_construcao": 1995,
  "tipo_uso": "RESIDENCIAL",
  "valor_venal": 450000.00,
  "valor_iptu": 2400.00,
  "proprietario": {
    "nome": "MARIA SILVA",
    "documento": "12345678901",
    "tipoDocumento": "CPF"
  }
}
CampoTipoDescrição
idstringIdentificador único interno
fontestringPlataforma/origem do dado IPTU municipal (ver abaixo)
sql_iptustringInscrição municipal / SQL IPTU
inscricaostringInscrição municipal
localizacaoobjectEndereço completo do imóvel (inclui complemento)
localizacao.ufstringEstado do imóvel
area_terrenonumberÁrea do terreno em m²
area_construidanumberÁrea construída em m²
ano_construcaonumberAno de construção
tipo_usostringRESIDENCIAL, COMERCIAL, INDUSTRIAL, TERRITORIAL
valor_venalnumberValor venal em R$ (base para cálculo do IPTU)
valor_iptunumberValor do IPTU anual em R$
proprietarioobjectProprietário: nome, documento (CPF/CNPJ formatado ou null), tipoDocumento

​
Fontes de dados

O campo fonte identifica a plataforma/sistema do portal de IPTU municipal de onde o registro foi extraído — por exemplo betha, elotech, sia. A estrutura do registro é idêntica independentemente da fonte.

​
Cobertura

Dados de 1.400+ municípios brasileiros via integração com portais municipais.

​
Conexões

  • Pessoa — como proprietário (CPF)
  • Empresa — como proprietário (CNPJ)
  • Endereço — localização do imóvel pode ser cruzada com endereços de moradia

​
Endpoints

RotaDescrição
GET /imoveis/cpf/{cpf}Imóveis por proprietário (CPF)
GET /imoveis/cnpj/{cnpj}Imóveis por proprietário (CNPJ)