Skip to main content
GET
Position history (V2)

Overview

Returns position records for a vehicle from from (inclusive) up to to (exclusive), both treated as UTC, ordered oldest first.
The V1 version of this endpoint is Position history. V2 is paginated.
Rate limit: 144,000 req/s · 144,000/min · 60/hr · 144,000/day — in practice 60 requests per hour per API key

Endpoint

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

Path parameters

integer
required
Public vehicle ID (deviceId).

Query parameters

string (datetime)
required
Range start (UTC, ISO 8601), inclusive.
string (datetime)
required
Range end (UTC, ISO 8601), exclusive: a record at exactly to is not returned.
integer
default:"1"
Page number (1-based).
integer
default:"50"
Records per page.

Response

200 OK — PagedListResult<MinPositionDto> MinPositionDto is a compact position record:
A record sent without a GPS fix repeats the last fix’s lat, lng and speed. This endpoint has no satellite field to tell such records apart.

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.

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 (exclusive — a record at exactly to is not returned). Required — returns 422 if missing.

page
integer
default:1
pageSize
integer
default:50

Response

Successful response