Skip to main content
POST
List vehicles (V2)

Overview

Returns last-known positions for a specific set of vehicles. The request body is required and must contain between 1 and 50 deviceId values — this limit prevents the endpoint from being used to scrape the entire fleet.
The V1 version of this endpoint is Device positions. V2 is paginated.
Rate limit: 10 req/s · 30/min · 6,000/hr · 144,000/day

Endpoint

POST /v2/api/vehicles/list

Query parameters

integer
default:"1"
Page number (1-based).
integer
default:"50"
Records per page.

Request body

Response

200 OKPagedListResult<PositionDto> Each item in items is a full PositionDto. All fields below are present on every item. Record & timestamps Location Engine & power Signal Device & identity Movement history Trip & driver Fuel Vehicle state Connectivity Request metadata

Error responses

Authorizations

Authorization
string
header
required

JWT Bearer token obtained from POST /v2/api/authentication/token/api-key.

Lifetime: ~24 hours (86,399 seconds). Cache the token and reuse it. Re-authenticate 5 minutes before expiry.

Scoping: API key tokens are scoped to the company the key belongs to and may restrict access to a vehicle allowlist and/or action set (see token claims).

No refresh endpoint — re-authenticate with your API key when the token expires.

Query Parameters

page
integer
default:1
pageSize
integer
default:50

Body

application/json
vehicleIds
integer[]
required

List of deviceId values to query. Must contain between 1 and 50 entries. Returns 422 if empty or omitted.

Required array length: 1 - 50 elements

Response

Successful response