Skip to main content
GET
/
api
/
v2
/
vehicles
/
{id}
/
positions
Position history (V2)
curl --request GET \
  --url https://api.telemax.com.au/api/v2/vehicles/{id}/positions \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "utcTime": "2026-05-28T00:14:15",
      "userTime": "2026-05-28T10:14:15",
      "lat": -27.443087,
      "lng": 153.019897,
      "speed": 0,
      "ignition": false,
      "odometer": 125003,
      "internalBatteryVoltage": 12.07,
      "deviceId": 22259,
      "deviceName": "Delivery Van 07",
      "fuelLevel": null,
      "fuelVolume": null
    }
  ],
  "totalResults": 35,
  "lastResultIndex": 2,
  "currentPage": 1,
  "numberOfPages": 18
}

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

​
Endpoint

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

​
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<MinPositionDto> MinPositionDto is a compact position record:
FieldTypeDescription
utcTimedatetimeRecord timestamp (UTC)
userTimedatetimeRecord timestamp in user’s timezone
lat / lngnumberGPS coordinates
speednumberSpeed (km/h)
ignitionbooleanIgnition state
odometernumber | nullGPS odometer (km)
voltagenumber | nullBattery voltage (V)
deviceIdintegerLegacy vehicle ID
deviceNamestringVehicle display name
fuelLevelintegerFuel level (%)
fuelVolumenumber | nullFuel volume (litres)

​
Error responses

StatusMeaning
401Token does not have access to this vehicle
404Vehicle not found
422Invalid date range (e.g. from after to)
curl "https://api.telemax.com.au/api/v2/vehicles/88421/positions?from=2026-04-01T00:00:00Z&to=2026-04-02T00:00:00Z&page=1&pageSize=50" \
  -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>
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