Skip to main content
GET
Trip replay (V2)

Overview

Returns a paginated list of trips for the vehicle between from and to (both UTC), ordered oldest first. Each trip includes route points, addresses, and a Google Polyline encoded path.
This endpoint is equivalent to V1 Trip Replay (UTC) and Trip replay (user time). V2 is paginated.
Rate limit: 4 req/s · 20/min · 600/hr · 14,400/day

Endpoint

GET /v2/api/replay/{id}

Path parameters

integer
required
Vehicle ID.

Query parameters

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

Response

200 OKPagedListResult<TripDto>
distance is in km, not metres. It is calculated as lastPoint.odometer − startPoint.odometer where odometer is stored in km. A value of 11.34 means 11.34 km.duration is a .NET TimeSpan serialised without a custom converter — format is "03:05:50" (hh:mm:ss) or "2.04:04:21.0100000" (d.hh:mm:ss.fffffff) for multi-day trips. It is not ISO 8601.
PointDto fields (items in points). All field names are camelCase — no [JsonPropertyName] overrides.

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>
to
string<date-time>
page
integer
default:1
pageSize
integer
default:50
Required range: x <= 500

Response

Successful response