Skip to main content
POST
/
api
/
GetReplay
Get Trip Replay (UTC)
curl --request POST \
  --url https://api.telemax.com.au/api/GetReplay \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": 103925,
    "distance": 15640.75,
    "duration": "PT1H25M",
    "startAddress": "123 Main St, New York, NY 10001",
    "endAddress": "789 Park Ave, New York, NY 10021",
    "startTimeUser": "2024-01-15T08:00:00+02:00",
    "endTimeUser": "2024-01-15T09:25:00+02:00",
    "encoded": "mfp_IvhkeLh@d@pFzBrA`@v@eBhA",
    "url": "https://maps.googleapis.com/maps/api/staticmap?path=enc:mfp_IvhkeLh@d@pFzBrA`@v@eBhA",
    "points": [
      {
        "id": 13029,
        "lat": 40.7128,
        "lng": -74.006,
        "utcTime": "2024-01-15T08:15:00Z"
      },
      {
        "id": 13030,
        "lat": 40.7135,
        "lng": -74.0055,
        "utcTime": "2024-01-15T08:30:00Z"
      }
    ]
  }
]
Vehicle id parameters refer to the legacy vehicle id unless stated otherwise.

​
Overview

Same as GetReplayUserTime—trip replay for the vehicle between from and to (UTC in service).
A V2 version of this endpoint is available: Trip replay. New integrations should prefer V2.

​
Endpoint

POST /api/GetReplay

​
Query parameters

Same as GetReplayUserTime (id, from, to).

​
Response

200 OK — TripDto[]. See Trip replay (user time) for the full field list and known issues (Distance in km, Duration as .NET TimeSpan, Points using camelCase field names).

Authorizations

​
Authorization
string
header
required

JWT Bearer token obtained from POST /api/authentication/token/user or POST /api/authentication/token/api-key.

Lifetime: ~24 hours (86,399 seconds). Cache the token and reuse it. Re-authenticate 5 minutes before expiry.

Scoping:

  • User tokens are scoped to a single company.
  • API key tokens may restrict access to a vehicle allowlist and/or action set (see token claims).

No refresh endpoint — re-authenticate with your credentials when the token expires.

Headers

​
Content-Type
string

Standard and must keep as it is.

​
Authorization
string
required

Bearer your_token

Query Parameters

​
id
integer
required

Vehicle ID

​
from
string
required

From Date and Time

​
to
string
required

To Date and Time

Response

Successful response with array of vehicle trip data

​
id
number<integer>
Example:

1305020

​
distance
number<double> | null

Unit: metres (not kilometres). Total distance of the trip.

Example:

15640.75

​
duration
string<duration>

Duration of the trip

Example:

"PT1H25M"

​
startAddress
string

Start address of the trip

Example:

"123 Main St, New York, NY 10001"

​
endAddress
string

End address of the trip

Example:

"789 Park Ave, New York, NY 10021"

​
startTimeUser
string<date-time>

Start time of the trip (user timezone)

Example:

"2024-01-15T08:00:00+02:00"

​
endTimeUser
string<date-time>

End time of the trip (user timezone)

Example:

"2024-01-15T09:25:00+02:00"

​
encoded
string

Encoded string of the trip path for Google Static Maps

Example:

"mfp_IvhkeLh@d@pFzBrA@v@eBhA"`

​
url
string<uri>

Google Static Maps URL

Example:

"https://maps.googleapis.com/maps/api/staticmap?path=enc:mfp_IvhkeLh@d@pFzBrA@v@eBhA"`

​
points
object[]

List of vehicle positions within the trip