Debitado do seu saldo a cada chamada cobrada. Autenticação pelo header X-API-Key. Veja como obter a chave.
Permite consultar informações detalhadas sobre imóveis rurais registrados no cadastro nacional. O serviço retorna dados completos do imóvel, incluindo titulares, condôminos e possuidores, além de informações cadastrais estruturadas.
Ideal para:
Validação de dados: Conferir precisão de informações cadastrais de imóveis
Análise de risco/crédito: Fundamentar decisões operacionais com dados cadastrais confiáveis
Compliance: Atender requisitos de conformidade e ESG em operações que envolvam propriedades rurais
Redução de erros: Automatizar consultas e eliminar processamento manual de dados
Código de Identificação do Imóvel (CIB) no Cadastro de Imóveis Rurais. Aceita com ou sem formatação.
—
Resposta
A resposta inclui os seguintes campos sobre o imóvel consultado:
cib: Número de identificação do imóvel
nomeImovel: Denominação do imóvel
area: Dimensão total da propriedade
localizacao: Endereço e localização geográfica do imóvel
cep: Código postal do endereço
municipio: Município onde se localiza o imóvel
uf: Estado (Unidade Federativa)
dataEmissao: Data de emissão do registro
situacao: Status atual do imóvel no cadastro
cadeiaCIB: Histórico ou sequência de identificadores relacionados
codigoINCRA: Código de identificação perante o órgão regulador fundiário
dataConsulta: Timestamp da consulta realizada
A resposta também inclui metadados sobre a operação: identificador único da consulta, versão da API, tempo de execução e URL de acesso ao comprovante quando gerado.
Schema da resposta (JSON Schema)
JSON Schema
{
"type": "object",
"properties": {
"retorno": {
"type": [
"object",
"null"
],
"properties": {
"uf": {
"type": [
"string",
"null"
],
"description": "Unidade Federativa onde o imóvel está localizado."
},
"cep": {
"type": [
"string",
"null"
],
"description": "CEP do endereço do imóvel."
},
"cib": {
"type": [
"string",
"null"
],
"description": "Número CIB do imóvel."
},
"area": {
"type": [
"string",
"null"
],
"description": "Área do imóvel."
},
"situacao": {
"type": [
"string",
"null"
],
"description": "Situação atual do registro do imóvel."
},
"cadeiaCIB": {
"type": [
"string",
"null"
],
"description": "Cadeia de CIB do imóvel."
},
"municipio": {
"type": [
"string",
"null"
],
"description": "Município onde o imóvel está localizado."
},
"nomeImovel": {
"type": [
"string",
"null"
],
"description": "Nome do imóvel."
},
"codigoINCRA": {
"type": [
"string",
"null"
],
"description": "Código do imóvel perante o INCRA."
},
"dataEmissao": {
"type": [
"string",
"null"
],
"description": "Data de emissão do cadastro."
},
"localizacao": {
"type": [
"string",
"null"
],
"description": "Localização do imóvel."
},
"dataConsulta": {
"type": [
"string",
"null"
],
"description": "Data em que a consulta foi realizada."
}
},
"description": "Dados detalhados do imóvel rural."
},
"metaDados": {
"type": [
"object",
"null"
],
"properties": {
"ip": {
"type": [
"string",
"null"
],
"description": "Endereço IP da requisição."
},
"data": {
"type": [
"string",
"null"
],
"description": "Data e hora da consulta."
},
"chave": {
"type": [
"string",
"null"
],
"description": "Chave da consulta."
},
"usuario": {
"type": [
"string",
"null"
],
"description": "Usuário que realizou a consulta."
},
"mensagem": {
"type": [
"string",
"null"
],
"description": "Mensagem de resposta da consulta."
},
"apiVersao": {
"type": [
"string",
"null"
],
"description": "Versão da API utilizada."
},
"resultado": {
"type": [
"string",
"null"
],
"description": "Status ou resultado da consulta."
},
"assincrono": {
"type": [
"boolean",
"null"
],
"description": "Indica se a consulta foi realizada de forma assíncrona."
},
"consultaUid": {
"type": [
"string",
"null"
],
"description": "Identificador único da consulta."
},
"resultadoId": {
"type": [
"number",
"null"
],
"description": "Identificador numérico do resultado."
},
"consultaNome": {
"type": [
"string",
"null"
],
"description": "Nome da consulta realizada."
},
"enviarCallback": {
"type": [
"boolean",
"null"
],
"description": "Indica se será enviado callback após a consulta."
},
"urlComprovante": {
"type": [
"string",
"null"
],
"description": "URL do comprovante gerado."
},
"tempoExecucaoMs": {
"type": [
"number",
"null"
],
"description": "Tempo de execução da consulta em milissegundos."
},
"gerarComprovante": {
"type": [
"boolean",
"null"
],
"description": "Indica se foi gerado comprovante da consulta."
}
},
"description": "Metadados sobre a consulta realizada."
}
}
}
Códigos de erro
Código
Mensagem
Quando acontece
400
Requisição Inválida
a requisição está incorreta ou os parâmetros são inválidos.
401
Não Autenticado
o usuário não forneceu as credenciais corretas para acessar o recurso.
403
Não Autorizado
o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível.
404
Não Encontrado
o servidor não encontrou uma representação atual do recurso solicitado.
408
Tempo Esgotado
o servidor não conseguiu retornar a requisição no prazo estabelecido.
500
Falha ao Realizar Consulta
o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte.
503
Consulta em Manutenção
a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte.
Observações
Comprovante em PDF: A consulta pode gerar um comprovante em PDF que documenta os dados retornados e serve como prova da verificação realizada. Este recurso é útil para auditorias e registros regulatórios.
Integrabilidade: O serviço retorna dados estruturados prontos para integração com fluxos internos de decisão, sistemas de risco e plataformas de compliance.
Confiabilidade: Os dados refletem o cadastro oficial, oferecendo informações atualizadas e precisas para fundamentar análises e decisões operacionais.
Integrar
OpenAPI (JSON) ↗ — importe a URL
no Postman ou no Insomnia para gerar a coleção com todos os endpoints. Também dá para consultar
pelo chat: conecte via MCP. Esta página em Markdown.