Uma Propriedade Urbana representa uma propriedade registrada em cadastro municipal. Os dados podem vir de diferentes fontes tributarias — o campo fonte indica a origem e o campo uf o estado.

​
Tipagem

{
  "id": "a1b2c3d4e5f6",
  "fonte": "iptu",
  "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"
  }
}
CampoTipoDescricao
idstringIdentificador unico interno
fontestringTipo de fonte tributaria (ver tabela abaixo)
sql_iptustringInscricao municipal / SQL IPTU
localizacaoobjectEndereco completo do imovel
localizacao.ufstringEstado — combinar com fonte para saber a origem (ex: fonte iptu + uf SP = IPTU de Sao Paulo)
area_terrenonumberArea do terreno em m²
area_construidanumberArea construida em m²
ano_construcaonumberAno de construcao
tipo_usostringRESIDENCIAL, COMERCIAL, INDUSTRIAL, TERRITORIAL
valor_venalnumberValor venal em R$ (base para calculo do IPTU)
valor_iptunumberValor do IPTU anual em R$
proprietarioobjectNome, documento (CPF/CNPJ) do proprietario

​
Fontes de dados

O campo fonte indica de qual tributo/cadastro os dados foram extraidos:
FonteDescricaoDados tipicos
iptuImposto Predial e Territorial UrbanoArea, valor venal, tipo de uso, proprietario
itbiImposto de Transmissao de Bens ImoveisValor de transacao, comprador, vendedor
Para saber a origem especifica, combine fonte + localizacao.uf:
ExemploSignifica
fonte: "iptu" + uf: "SP"IPTU de Sao Paulo
fonte: "iptu" + uf: "MG"IPTU de Minas Gerais
fonte: "itbi" + uf: "RJ"ITBI do Rio de Janeiro

​
Cobertura

Dados de 1.400+ municipios brasileiros via integracao com portais municipais.

​
Conexoes

  • Pessoa — como proprietario (CPF)
  • Empresa — como proprietario (CNPJ)
  • Endereco — localizacao do imovel pode ser cruzada com enderecos de moradia

​
Endpoints

RotaDescricao
GET /imoveis/cpf/{cpf}Imoveis por proprietario (CPF)
GET /imoveis/cnpj/{cnpj}Imoveis por proprietario (CNPJ)
GET /imoveis/cpf/{cpf}?uf=SPFiltrado por estado