Verificar dados complementares de imóvel rural por código INCRA

GET

/v2/rural-properties/incra/{incraNumber}

Verifica se há dados complementares (expansão) disponíveis para um imóvel rural a partir do código do imóvel no INCRA (SNCR/CCIR). São os dados que a plataforma usa para completar o cadastro de um imóvel rural: CAFIR, parcelas registradas no INCRA e no SNCI e CAR. O campo expansion vem true quando há dados para o código. A consulta é feita em tempo real no serviço de imóveis rurais da plataforma, a cada chamada; nada é gravado e a rota não depende de cliente. Quando o serviço de consulta recusa o código ou falha, a API devolve o mesmo status HTTP que ele devolveu e o corpo { "message": [...] } com a mensagem do serviço externo, sem o campo statusCode. Essa mensagem é definida pelo serviço externo e pode mudar. Requer autenticação via Bearer JWT ou header x-api-key.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros de Caminho

Parâmetros Header

Respostas

🟢200

application/json

Inferred 200 (from source code)

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠400Código recusado pelo serviço de consulta

🟠404Código não encontrado no serviço de consulta

🔴500Falha no serviço de consulta

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v2/rural-properties/incra/9500000000000' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Sucesso

{
    "expansion": true
}

Modificado em 2026-10-13 09:47:06

Página anterior

Verificar dados complementares de imóvel rural por NIRF

Próxima página

Verificar dados complementares de imóvel rural por CAR