Listar veículos de uma consulta

GET

/v2/queries/vehicle-assets/{queryId}

Lista os veículos encontrados pela consulta de patrimônio veicular informada em queryId (o identificador da consulta, listado por serviço na rota de consultas do cliente), em ordem crescente do campo vehicle. Cada item traz os dados do veículo registrados na consulta, como plate, chassis, renavam, vehicle, color, fuel, situation e value. quantity é o número de veículos e totalValue, a soma de value (veículo sem valor conta 0). Consulta sem veículos, ou sem registro, devolve items vazio, quantity 0 e totalValue 0. Quando o resultado excede o previsto, a resposta é 200 com apenas message, informando que os veículos não puderam ser localizados. 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

Veículos da consulta

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v2/queries/vehicle-assets/3f6b1d2e-8c4a-4b7e-9d1a-5e2c7a9b0f13' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Sucesso

{
    "items": [
        {
            "_id": "25364758-6970-4cbc-8d8e-e5f6a7b8c901",
            "clientId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
            "taxId": "11144477735",
            "queryId": "3f6b1d2e-8c4a-4b7e-9d1a-5e2c7a9b0f13",
            "trashed": false,
            "source": "FONTE EXEMPLO",
            "plate": "EXE1A23",
            "chassis": "9BEXEMPLO00000001",
            "renavam": "00123456789",
            "uf": "MT",
            "city": "SORRISO",
            "modelYear": "2020",
            "manufacturingYear": "2019",
            "vehicle": "TRATOR EXEMPLO",
            "color": "VERDE",
            "fuel": "DIESEL",
            "situation": "CIRCULACAO",
            "value": 185000,
            "createdAt": "2026-09-18T14:03:00.000Z",
            "updatedAt": "2026-09-18T14:03:00.000Z"
        }
    ],
    "quantity": 1,
    "totalValue": 185000
}

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

Página anterior

Listar registros do Sintegra de um cliente

Próxima página

Visualizar Boa Vista de um cliente