Skip to main content
GET
/
api
/
v2
/
companies
/
{id}
/
vehicles
/
last-position
Fleet last positions (V2)
curl --request GET \
  --url https://api.telemax.com.au/api/v2/companies/{id}/vehicles/last-position \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "id": 1284686417,
      "utcTime": "2026-04-28T06:14:22",
      "userTime": "2026-04-28T16:14:22",
      "userTimeFormatted": "28/04/2026 04:14 PM",
      "lat": -33.8688,
      "lng": 151.2093,
      "speed": 0,
      "course": 142,
      "ignition": false,
      "odometer": 45321.2,
      "voltage": 12.8,
      "fatigue": "00:00:00",
      "engineHours": 1842.5,
      "satelliteCoverage": "Excellent",
      "satelliteCoverageRawValue": 12,
      "networkCoverage": "Excellent",
      "networkCoverageRawValue": 18,
      "deviceId": 88421,
      "ignitionTime": null,
      "deviceName": "Delivery Van 07",
      "imei": "353148090123456",
      "vin": "1HGBH41JXMN109186",
      "startMovingTime": null,
      "startMovingTimeUser": null,
      "lastMovementTime": "2026-04-28T05:50:00",
      "lastMovementTimeUser": "2026-04-28T15:50:00",
      "lastMovementTimeUserFormatted": "28/04/2026 03:50 PM",
      "drivingTime": null,
      "fuelLevel": null,
      "fuelVolume": null,
      "address": "42 George St, Sydney NSW 2000",
      "engineEnabled": true,
      "timeElapsed": 0.245,
      "startedTime": "2026-04-28T06:14:22",
      "endTime": "2026-04-28T06:14:22",
      "isOnline": false
    }
  ],
  "totalResults": 7,
  "lastResultIndex": 1,
  "currentPage": 1,
  "numberOfPages": 7
}

​
Overview

Returns the most recent position record for each vehicle in the specified company (and its sub-companies where allowed).
The V1 version of this endpoint is Fleet last positions. V2 is paginated.
Rate limit: 20 requests per 60 seconds per token.

​
Endpoint

GET /api/v2/companies/{id}/vehicles/last-position

​
Path parameters

​
id
integer
required
Company ID.

​
Query parameters

​
checkVehicleHandlerState
boolean
required
When true, cross-checks against live handler state; when false, returns the last stored record only.
​
page
integer
default:"1"
Page number (1-based).
​
pageSize
integer
default:"50"
Records per page.

​
Response

200 OK — PagedListResult<PositionDto> See V2 PositionDto fields for the full field list.

​
Error responses

StatusMeaning
401Token not scoped to this company
403Token does not have permission to access this company
404Company not found
curl "https://api.telemax.com.au/api/v2/companies/12/vehicles/last-position?checkVehicleHandlerState=false&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

​
checkVehicleHandlerState
boolean
​
page
integer
default:1
​
pageSize
integer
default:50

Response

Successful response