Skip to main content
GET
Position history (V2)

Overview

Returns position records for a vehicle between from and to (both treated as UTC), ordered oldest first.
The V1 version of this endpoint is Position history. V2 is paginated.
Rate limit: 10 req/s · 60/min · 6,000/hr · 144,000/day

Endpoint

GET /v2/api/vehicles/{id}/positions

Path parameters

integer
required
Vehicle ID.

Query parameters

string (datetime)
required
Range start (UTC, ISO 8601).
string (datetime)
required
Range end (UTC, ISO 8601).
integer
default:"1"
Page number (1-based).
integer
default:"50"
Records per page.

Response

200 OKPagedListResult<MinPositionDto> MinPositionDto is a compact position record:

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.

Path Parameters

id
integer
required

Query Parameters

from
string<date-time>
required

Start of the date range (inclusive). Required — returns 422 if missing.

to
string<date-time>
required

End of the date range (inclusive). Required — returns 422 if missing.

page
integer
default:1
pageSize
integer
default:50

Response

Successful response