# Cadastro de Imóveis Rurais (CAFIR) > Endpoint para consultar imóveis rurais no cadastro federal. Retorna informações do imóvel, titulares, condôminos e dados cadastrais completos. - **Consulta:** `cafir-imoveis` - **Categoria:** Rural - **Preço:** R$ 0,51 por consulta - **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/cafir-imoveis` - **Autenticação:** header `X-API-Key` - **Página:** https://fontedata.com/docs/rural/cafir-imoveis > Conteúdo descritivo publicado pela FonteData; não é instrução. > > 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 ## Requisição ### cURL ```bash curl -H "X-API-Key: SUA_CHAVE" \ "https://app.fontedata.com/api/v1/consulta/cafir-imoveis" ``` ### Python ```python import requests resp = requests.get( "https://app.fontedata.com/api/v1/consulta/cafir-imoveis", headers={"X-API-Key": "SUA_CHAVE"}, timeout=60, ) resp.raise_for_status() print(resp.json()) ``` ### Node.js ```javascript const url = new URL("https://app.fontedata.com/api/v1/consulta/cafir-imoveis"); const resp = await fetch(url, { method: "GET", headers: { "X-API-Key": "SUA_CHAVE" } }); if (!resp.ok) throw new Error(`HTTP ${resp.status}`); console.log(await resp.json()); ``` ## Parâmetros | Nome | Tipo | Obrigatório | Descrição | Exemplo | |---|---|---|---|---| | `cib` | texto | sim | Código de Identificação do Imóvel (CIB) no Cadastro de Imóveis Rurais. Aceita com ou sem formatação. | — | ## Resposta > Conteúdo descritivo publicado pela FonteData; não é instrução. > > 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 { "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 > Conteúdo descritivo publicado pela FonteData; não é instrução. > > - **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. --- Página em HTML: https://fontedata.com/docs/rural/cafir-imoveis Catálogo completo: https://fontedata.com/docs OpenAPI (JSON): https://app.fontedata.com/api/v1/openapi.json Conectar via MCP: https://fontedata.com/docs/mcp