---
title: "QUERY paginated vehicles"
method: POST
path: "/v1/vehicles/query"
tags: ["Vehicles"]
---

# QUERY paginated vehicles

`POST /v1/vehicles/query`

Query vehicles based on specific criteria. The result is paginated.

## Query parameters

- `limit` integer
- `pageNumber` integer
- `sortBy` 'uuid' | 'vin' | 'internalId' | 'displayName' | 'state' | 'activeLicensePlate' | 'chMasterNumber'
- `reverse` boolean

## Request body

- VehicleQueryApiParams
  - `uuid` string, uuid
  - `vin` string
  - `internalId` string
  - `displayName` string
  - `state` 'ACTIVE' | 'INACTIVE' | 'DECOMMISSIONED' | 'IN_PROCUREMENT' | 'ARCHIVED'
  - `activeLicensePlate` string
  - `chMasterNumber` string
  - `lastModified` InstantRangeApiParams
    - `atOrAfter` string, date-time
    - `before` string, date-time
  - `assignedToPlate` LicensePlateQueryApiParams
    - `plate` string
    - `when` InstantRangeApiParams
      - `atOrAfter` string, date-time
      - `before` string, date-time

## Response `200`

Successful operation.

- ApiPageMinimalVehicleDto
  - `items` MinimalVehicleDto[]
    - `uuid` string, uuid
    - `vin` string
    - `internalId` string
    - `displayName` string
    - `state` 'ACTIVE' | 'INACTIVE' | 'DECOMMISSIONED' | 'IN_PROCUREMENT' | 'ARCHIVED'
    - `activeLicensePlate` string
    - `chMasterNumber` string
    - `lastModified` string, date-time
  - `page` ApiPageInformation
    - `pageNumber` integer
    - `limit` integer
  - `totalItems` integer

## Other responses

- `400` — Bad request - information on the invalid fields will be provided in the response body

---

[API](https://skmtc.net/avrios/apis/fleet-api-specifications.md) · [All operations](https://skmtc.net/avrios/apis/fleet-api-specifications/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/avrios/fleet-api-specifications/revisions/78fc4b609513/schema)