Skip to main content
Uma Propriedade Rural representa uma propriedade rural registrada nos cadastros federais. O perfil rural retorna os imóveis em dois arrays separados: propriedades_sncr (INCRA) e propriedades_cafir (Receita Federal). Cada fonte tem seu próprio conjunto de campos.

​
SNCR (INCRA) — propriedades_sncr[]

{
  "codigo_imovel": "9301234",
  "nome_imovel": "FAZENDA SAO JOSE",
  "municipio": "UBERABA",
  "uf": "MG",
  "area_total": 150.5,
  "modulos_fiscais": 4.2,
  "cod_ibge": "3170206",
  "nome_detentor": "JOAO DA SILVA",
  "cpf_cnpj_mask": "123.***.***-01",
  "documento": "12345678901",
  "tipo": "PF",
  "tipo_detentor": "PROPRIETARIO",
  "fracao": 100.0,
  "condicao_detentor": "PROPRIETARIO",
  "pais": "BRASIL"
}
CampoTipoDescrição
codigo_imovelstringCódigo no SNCR (INCRA)
nome_imovelstringNome da propriedade
municipio / ufstringLocalização
area_totalnumberÁrea em hectares
modulos_fiscaisnumberTamanho em módulos fiscais do município
cod_ibgestringCódigo IBGE do município
nome_detentorstringNome do proprietário/detentor
cpf_cnpj_maskstringDocumento mascarado do detentor
documentostringCPF/CNPJ do detentor (somente dígitos)
tipostringPF ou PJ
tipo_detentorstringTipo de detentor
fracaonumberPercentual de participação (%)
condicao_detentorstringPROPRIETARIO, ARRENDATARIO, POSSEIRO, etc.
paisstringPaís do detentor

​
CAFIR (Receita Federal) — propriedades_cafir[]

{
  "nirf": "1234567",
  "area_total": 150.5,
  "codigo_incra": "9301234",
  "nome_imovel": "FAZENDA SAO JOSE",
  "situacao": "ATIVO",
  "logradouro": "ESTRADA RURAL KM 5",
  "distrito": "DISTRITO RURAL",
  "uf": "MG",
  "municipio": "UBERABA",
  "cep": "38000000",
  "data_atualizacao": "2023-01-15",
  "imune_isento": "Não",
  "codigo_sncr": "9301234"
}
CampoTipoDescrição
nirfstringNúmero do Imóvel na Receita Federal
area_totalnumberÁrea em hectares
codigo_incrastringCódigo INCRA
nome_imovelstringNome da propriedade
situacaostringStatus (ATIVO, CANCELADO, etc.)
logradouro / distritostringEndereço
municipio / ufstringLocalização
cepstringCEP
data_atualizacaostringData da última atualização
imune_isentostringSe é imune ou isento de ITR
codigo_sncrstringVínculo com o SNCR

​
Dados ambientais vinculados

Imóveis rurais podem ter vinculados:
  • Infrações ambientais — multas, embargos e apreensões do IBAMA
  • Autorizações florestais — licenças de exploração (AUTEX)
  • Transportes florestais — guias de transporte de madeira/carvão (DOF)

​
Conexões

  • Pessoa — como detentor (CPF)
  • Empresa — como detentor (CNPJ)
  • Infrações — multas e embargos ambientais vinculados ao imóvel ou detentor
  • Transportes — operações de transporte florestal vinculadas ao detentor

​
Endpoints

RotaDescrição
GET /rural/cpf/{cpf}Perfil rural completo (imóveis SNCR + CAFIR, infrações, autorizações, transportes, produtor orgânico)
GET /rural/cnpj/{cnpj}Perfil rural da empresa (mesma estrutura)
GET /rural/jobs/{jobId}Status de um job assíncrono