Skip to main content
GET
/
api
/
v2
/
replay
/
{id}
Trip replay (V2)
curl --request GET \
  --url https://api.telemax.com.au/api/v2/replay/{id} \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "id": 971757470,
      "distance": 0,
      "duration": "00:00:59",
      "startAddress": "11, Gould Rd, Herston, Brisbane, Qld, AUS",
      "endAddress": "11, Gould Rd, Herston, Brisbane, Qld, AUS",
      "startTimeUser": "05/20/2026 10:47:57",
      "endTimeUser": "05/20/2026 10:48:56",
      "encoded": "_p~iF~ps|U_ulLnnqC_mqNvxq`@",
      "url": "https://maps.googleapis.com/maps/api/staticmap?...",
      "points": [
        {
          "id": 716838935,
          "lat": -27.443087,
          "lng": 153.019897,
          "timeUtc": "2026-05-20T00:47:57",
          "speed": 0,
          "direction": 0,
          "ignition": true,
          "timeUser": "2026-05-20T10:47:57",
          "odo": 60021,
          "fuelLevel": null,
          "fuelVolume": null
        }
      ]
    }
  ],
  "totalResults": 9,
  "lastResultIndex": 1,
  "currentPage": 1,
  "numberOfPages": 9
}

​
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: 20 requests per 60 seconds per token.

​
Endpoint

GET /api/v2/replay/{id}

​
Path parameters

​
id
integer
required
Legacy vehicle ID.

​
Query parameters

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

​
Response

200 OK — PagedListResult<TripDto>
FieldTypeDescription
idintegerSynthetic trip ID
distancenumber | nullTrip distance in km (odometer delta — see note below)
durationstringTrip duration as .NET TimeSpan string: "hh:mm:ss" for < 1 day, "d.hh:mm:ss.fffffff" for ≥ 1 day
startAddressstringReverse-geocoded start address
endAddressstringReverse-geocoded end address
startTimeUserstringTrip start in user’s timezone (formatted string)
endTimeUserstringTrip end in user’s timezone (formatted string)
encodedstringGoogle Polyline Algorithm encoded path — decode with any standard polyline library
urlstringGoogle Static Maps thumbnail URL (⚠ requires valid API key configured server-side)
pointsarrayArray of PointDto — see below
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.
FieldTypeDescription
idintegerSynthetic point ID
latnumberLatitude
lngnumberLongitude
timeUtcdatetimePoint timestamp (UTC, no fractional seconds)
speednumberSpeed at this point (km/h)
directionnumberCompass heading in degrees (N=0, E=90, S=180, W=270)
ignitionbooleanIgnition state at this point
timeUserdatetimePoint timestamp in the user’s timezone
odonumber | nullOdometer reading at this point (km)
fuelLevelinteger | nullFuel level at this point (%)
fuelVolumenumber | nullFuel volume at this point (litres)

​
Error responses

StatusMeaning
401Token does not have access to this vehicle
403Token scope does not include replay access
404Vehicle not found
422Invalid date range
curl "https://api.telemax.com.au/api/v2/replay/88421?from=2026-04-01T00:00:00Z&to=2026-04-02T00:00:00Z&page=1&pageSize=20" \
  -H "Authorization: Bearer <token>"

Authorizations

​
Authorization
string
header
required

JWT Bearer token obtained from POST /api/v2/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

Response

Successful response