Skip to main content
POST
/
api
/
LastTimeOnline
/
{vehicleId}
Get Vehicle Last Online
curl --request POST \
  --url https://api.telemax.com.au/api/LastTimeOnline/{vehicleId} \
  --header 'Authorization: Bearer <token>'
[
  {
    "LastTimeUTC": "2024-01-15T10:30:00Z",
    "secondsAgo": 861895.4007076
  }
]

Overview

Returns last heartbeat time and seconds since, for one vehicle.
A V2 version of this endpoint is available: Last online. New integrations should prefer V2.

Endpoint

POST /api/LastTimeOnline/{id}

Path parameters

id
integer
required
Legacy vehicle id.

Response

200 OKLastTimeOnlineDto
JSON fieldTypeDescription
LastTimeUTCstring (datetime) | nullLast heartbeat
secondsAgonumber | nullSeconds since heartbeat

Example response

{
  "LastTimeUTC": "2026-04-07T14:28:00",
  "secondsAgo": 42.7
}

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

Path Parameters

vehicleId
integer
required

Vehicle ID

Response

Successful response with timestamp data.

LastTimeUTC
string<date-time>

Time in UTC

Example:

"2024-01-15T10:30:00Z"

secondsAgo
number

Seconds elapsed since the vehicle was last seen online. Note: This field uses camelCase (intentional).

Example:

861895.4007076