Imóveis Rurais por CPF

Parâmetros

O que você recebe

33 campos no retorno, como o seu sistema recebe.

• pessoaDado pessoal

  Pessoa consultada

  Bloco com o CPF consultado, formatado, e o nome da pessoa.

• pessoa.cpfDado pessoal

  CPF

  Número do CPF da pessoa física. O CPF consultado, formatado.

• pessoa.nomeDado pessoal

  Nome

  Nome completo da pessoa física. Não aparece quando a base só tem o nome com asteriscos; aí vem nomeParcial.

• pessoa.nomeParcialDado pessoal

  Nome parcial

  Nome publicado com asteriscos pela origem, quando não há o nome completo. Vem no lugar do nome.

• resumo

  Resumo dos vínculos

  Totais da consulta: quantos itens existem na base, quantos vieram, quantos são propriedade atual e quantos há em cada papel.

• resumo.totalImoveis

  Total de imóveis

  Quantidade de imóveis ligados ao CPF, inclusive os que passaram do limite da resposta.

• resumo.imoveisRetornados

  Imóveis retornados

  Quantidade de imóveis que vieram na resposta (até 500, dos mais relevantes para os menos). Menor que totalImoveis só quando a lista passa de 500 imóveis.

• resumo.imoveisAtuais

  Imóveis em propriedade atual

  Quantos dos imóveis retornados são propriedade atual da pessoa.

• resumo.porPapel

  Quantidade por papel

  Quantos itens há em cada papel de vínculo (titular, condomino, tomadorCredito, operadorLavoura, detentor, usoSigef, declaranteArea). Um item com dois papéis conta nos dois. Conta imóveis: um imóvel em que a pessoa tem dois papéis conta nos dois.

• imoveisDado pessoal

  Imóveis vinculados

  Lista dos imóveis ligados à pessoa, dos mais relevantes para os menos: primeiro os de propriedade atual.

• imoveis[].numeroCar

  Código CAR

  Número de inscrição do imóvel no Cadastro Ambiental Rural.

• imoveis[].nomeImovel

  Nome do imóvel

  Denominação do imóvel rural. Só aparece quando a base tem um nome confiável para o imóvel.

• imoveis[].uf

  UF

  Sigla do estado.

• imoveis[].municipio

  Município

  Nome do município.

• imoveis[].codigoMunicipioIbge

  Código IBGE do município

  Código do município na tabela do IBGE.

• imoveis[].centroide

  Centro do imóvel

  Ponto central do perímetro, como [longitude, latitude].

• imoveis[].areaHa

  Área do imóvel

  Área total do imóvel, em hectares.

• imoveis[].areaSuspeita

  Área suspeita

  Verdadeiro quando a área declarada no CAR passa de 200 mil hectares ou quando o polígono do próprio CAR desmente a área declarada. A área continua vindo como declarada: confira o imóvel antes de somá-la ao patrimônio. Não aparece quando o imóvel só é conhecido pelos vínculos (cadastradoNaBase falso).

• imoveis[].situacaoCar

  Situação do CAR

  Situação do cadastro no SICAR (ex.: Ativo, Pendente, Suspenso, Cancelado).

• imoveis[].condicao

  Condição da análise

  Etapa da análise do cadastro pelo órgão ambiental estadual.

• imoveis[].tipo

  Tipo do imóvel

  Tipo do cadastro no SICAR (imóvel rural, assentamento, território tradicional).

• imoveis[].modulosFiscais

  Módulos fiscais

  Tamanho do imóvel em módulos fiscais do município.

• imoveis[].cadastradoNaBase

  Cadastrado na base

  Verdadeiro quando o CAR consta na base cadastral; falso quando só a consulta pública o conhece. Falso quando o imóvel só é conhecido pelos vínculos: vêm apenas o número do CAR, a UF e o código do município.

• imoveis[].propriedadeAtual

  Proprietário atual

  Verdadeiro quando a pessoa consta como titular do imóvel em registro ou cadastro oficial (SIGEF, SINTER, CCIR, SNCR ou CAFIR), inclusive como condômino com CPF confirmado. Órgão público titular não conta. Não é uma data de vínculo, e um imóvel pode ter mais de um. Verdadeiro quando o imóvel é propriedade atual da pessoa consultada.

• imoveis[].vinculos

  Vínculos

  Formas pelas quais a pessoa se liga ao imóvel, cada uma com papel, prova, força, fonte e score.

• imoveis[].vinculos[].papel

  Papel do vínculo

  Como a pessoa se liga ao imóvel: titular, condomino (condômino no SNCR, com a fração), tomadorCredito (crédito rural), operadorLavoura (seguro de lavoura), detentor, usoSigef (usufruto ou concessão) ou declaranteArea (declarou sobre a área sem ser o titular).

• imoveis[].vinculos[].prova

  Prova do vínculo

  Tipo de registro que sustenta o vínculo: registral, cadastral, publico (o titular é órgão público), declarado ou inferido; nos papéis que não são de propriedade, tomador, operador, detencao ou uso.

• imoveis[].vinculos[].forca

  Força do vínculo

  Solidez da ligação: forte, medio ou fraco; na quando não se aplica.

• imoveis[].vinculos[].fonte

  Fonte do vínculo

  Órgão ou sistema de origem da informação (ex.: CAFIR/RFB, SNCR/INCRA, SIGEF/INCRA, SICOR/BACEN).

• imoveis[].vinculos[].score

  Score do vínculo

  Nota de 0 a 1 da confiança na titularidade, quando a origem oferece; ausente nos demais papéis.

• imoveis[].vinculos[].percentual

  Fração do condômino

  Parte do imóvel que o condômino detém no quadro de titulares do SNCR/INCRA, em %. Só aparece no papel condomino.

• observacoes

  Avisos de leitura

  Textos fixos que explicam como ler o resultado, como o significado de propriedade atual. Não indicam erro.

• ressalvas

  Ressalvas

  Avisos sobre limites do resultado (ex.: camada indisponível nesta execução). Só aparece quando a lista é limitada a 500 imóveis.

Opções da chamada

• assincrono=trueProcessa em segundo plano e devolve 202 com o consultaId.
• comprovante=trueEsta API não emite comprovante em PDF.

Códigos de resposta

• 200Sucesso — Consulta concluída; o retorno traz os dados da fonte.
• 202Em processamento — Recupere em GET /api/Marketplace/Consulta/Resultado/{consultaId}. Recuperar não é cobrado.
• 422Requisição inválida — Parâmetros validados antes de qualquer cobrança.
• 429Limite simultâneo — Até 5 consultas simultâneas por cliente.
• 503Em manutenção — A consulta está temporariamente indisponível; nada é cobrado.