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. Items come back in the vehicles’ internal order, not in the order of vehicleIds.
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 OK — PagedListResult<PositionDto> Each item in items is a full PositionDto. See PositionDto fields for the field list; on this endpoint the rows marked “list, fleet, nearest” apply.

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 by the key's company and its action set; see Token scoping.

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 public vehicle IDs (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