Listar imóveis rurais de um cliente

GET

/v2/rural-production/{clientId}/rural-properties

Lista as áreas (imóveis rurais) do cliente, das mais recentes para as mais antigas, 60 por página. Antes de listar, os imóveis da consulta CAR mais recente do cliente que ainda não estão na lista são adicionados automaticamente, com o tipo de posse informado no CAR. Para imóveis vinculados a um CAR, carsRef traz o polígono de área do imóvel no CAR (AREA_IMOVEL) sem a geometria. As áreas total e própria vêm arredondadas para o hectare inteiro mais próximo. 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 de Consulta

Parâmetros Header

Respostas

🟢200

application/json

Harvested 200

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v2/rural-production//rural-properties?page=1' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Sucesso

[
    {
        "_id": "0b8f2c1e-5d4a-4e7b-9c3f-2a1d6e8b7c90",
        "type": "PRÓPRIA",
        "name": "Fazenda Boa Vista",
        "total_area": 1251,
        "owned_area": 1100,
        "state": "MT",
        "city": "SORRISO",
        "carsRef": {
            "_id": "6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c",
            "geo": [
                {
                    "area": 1250.5,
                    "tipo": "AREA_IMOVEL"
                }
            ]
        }
    }
]

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

Página anterior

Importar imóveis rurais de um cliente

Próxima página

Exportar produções de um cliente (Excel)