Listar imóveis CAR de um cliente

GET

/v2/queries/clients/{clientId}/{queryId}/cars

Lista os imóveis CAR ativos do cliente numa consulta, em formato resumido: nome, município, estado, áreas, posse, quantidade de proprietários e o VTI médio de cada um. Traz também os totais do cliente — quantidade de imóveis, quantos são próprios, área total, área produtiva e VTI somado. Paginado por page. Para o detalhe completo de cada imóvel, com NDVI, tipologias e agcheck, use a versão detalhada. 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

Inferred 200 (from source code)

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠425ERRO - CONSULTA EM ANDAMENTO

🟠429TooManyRequests

🔴500InternalError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v2/queries/clients/CLIENT_ID/QUERY_ID/cars?page=1' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Sucesso

{
    "items": [
        {
            "_id": "string",
            "name": "string",
            "totalArea": 0,
            "state": "MT",
            "city": "string",
            "productiveArea": 0,
            "geo": [],
            "ownership": "propria",
            "ownersQuantity": 0,
            "vti": {
                "mean": 0,
                "status": "FINALIZADO"
            }
        }
    ],
    "properties": 0,
    "ownedProperties": 0,
    "totalArea": 0,
    "productiveArea": 0,
    "totalVti": 0
}

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

Página anterior

Obter URL assinada do recibo do CAR

Próxima página

Listar imóveis CAR de um cliente (detalhado)