Consultar imóvel rural

GET

/assets/properties/rural/{propertyId}

Devolve o imóvel rural informado em propertyId, como está cadastrado: dados cadastrados, dados do CAFIR com os proprietários, parcelas georreferenciadas e CARs vinculados. Não traz os campos calculados da listagem detalhada (percentual e área do cliente, classificação do imóvel). Imóvel inexistente ou removido devolve 404. O imóvel precisa ser de um cliente da empresa do usuário: cliente de outra empresa devolve 401 (Acesso negado). 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

Imóvel rural

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠404Imóvel rural não encontrado

Request Example

Shell

JavaScript

Java

Swift

curl --location '/assets/properties/rural/f1a2b3c4-0000-4000-8000-000000000101' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Sucesso

{
    "_id": "f1a2b3c4-0000-4000-8000-000000000101",
    "clientId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "owned": true,
    "partnership": false,
    "insertInfo": {
        "name": "FAZENDA EXEMPLO",
        "totalArea": 480.5,
        "nirf": "12345678",
        "numIncra": "9500000000001",
        "car": [
            "MT-5107925-0000000000000000000000000000000A"
        ],
        "state": "MT",
        "city": "SORRISO",
        "value": 12500000
    },
    "estimatedValue": 0,
    "fiscalModule": 0,
    "productiveArea": 0,
    "cafir": {
        "nirf": "12345678",
        "numIncra": "9500000000001",
        "totalArea": 480.5,
        "farmName": "FAZENDA EXEMPLO",
        "state": "MT",
        "city": "SORRISO",
        "registrationDate": "2015-03-10",
        "owners": [
            {
                "taxId": "11222333000181",
                "name": "AGRO EXEMPLO S.A.",
                "birthDate": "",
                "situation": "ATIVO",
                "type": "PROPRIETARIO",
                "share": 50,
                "legalNature": "JURIDICA"
            }
        ]
    },
    "parcels": [
        {
            "numIncra": "9500000000001",
            "farmName": "FAZENDA EXEMPLO",
            "area": 480.5,
            "geometry": {
                "type": "Polygon",
                "coordinates": [
                    [
                        [
                            -55.71,
                            -12.54
                        ],
                        [
                            -55.7,
                            -12.54
                        ],
                        [
                            -55.7,
                            -12.55
                        ],
                        [
                            -55.71,
                            -12.54
                        ]
                    ]
                ]
            }
        }
    ],
    "car": [
        {
            "carCode": "MT-5107925-0000000000000000000000000000000A",
            "area": 480.5,
            "fiscalModule": 5.2,
            "geometry": {
                "type": "Polygon",
                "coordinates": []
            }
        }
    ],
    "createdAt": "2026-09-01T12:00:00.000Z",
    "updatedAt": "2026-09-01T12:00:00.000Z"
}

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

Página anterior

Cadastrar imóvel rural no patrimônio de um cliente

Próxima página

Remover imóvel rural de um cliente