Skip to main content
POST
/
api
/
Devices
List Vehicles
curl --request POST \
  --url https://api.telemax.com.au/api/Devices \
  --header 'Authorization: Bearer <token>'
[
  {
    "utcTime": "2024-01-15T10:30:00Z",
    "userTime": "2024-01-15T12:30:00+02:00",
    "userTimeFormatted": "15/01/2024 12:30:00",
    "lat": 40.7128,
    "lng": -74.006,
    "speed": 65.5,
    "course": 90,
    "ignition": true,
    "odometer": 125000.5,
    "internalBatteryVoltage": 12.6,
    "fatigue": "PT2H30M",
    "engineHours": "PT150H45M",
    "satSignal": "Good",
    "satellites": 8,
    "connectionStrength": 85,
    "deviceId": 12345,
    "ignitionTime": 3600.5,
    "deviceName": "Fleet Vehicle 001",
    "imei": "123456789012345",
    "vin": "1HGBH41JXMN109186",
    "startMovingTime": "2024-01-15T08:00:00Z",
    "startMovingTimeUser": "2024-01-15T10:00:00+02:00",
    "lastMovementTime": "2024-01-15T16:00:00Z",
    "lastMovementTimeUser": "2024-01-15T18:00:00+02:00",
    "lastMovementTimeUserFormatted": "15/01/2024 18:00:00",
    "drivingTime": "2024-01-15T14:30:00Z",
    "driver": "John Smith",
    "fuelLevel": 75,
    "dtc": "P0301",
    "isDoorLocked": true,
    "address": "123 Main St, New York, NY 10001",
    "engineEnabled": true,
    "timeElapsed": 0.125,
    "startedTime": "2024-01-15T10:30:00Z",
    "endTime": "2024-01-15T10:30:01Z"
  }
]

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

Response

Successful response with list of vehicles and their last known positions.

​
utcTime
string<date-time>

Time in UTC

Example:

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

​
userTime
string<date-time>

Time in user timezone

Example:

"2024-01-15T12:30:00+02:00"

​
userTimeFormatted
string

Time in user time format

Example:

"15/01/2024 12:30:00"

​
lat
number<double>

Latitude

Example:

40.7128

​
lng
number<double>

Longitude

Example:

-74.006

​
speed
number<double>

Unit: km/h. Current vehicle speed.

Example:

65.5

​
course
integer

Direction, degrees (N - 0, E - 90, S - 180, W - 270)

Example:

90

​
ignition
boolean

Ignition status

Example:

true

​
odometer
number<float> | null

Unit: km. Total distance travelled (odometer reading).

Example:

125000.5

​
internalBatteryVoltage
number<float> | null

Unit: V (volts). Vehicle battery voltage.

Example:

12.6

​
fatigue
string<duration>

Fatigue time

Example:

"PT2H30M"

​
engineHours
string<duration>

Unit: hours (decimal). Cumulative engine-on time. This is a plain number, not an ISO 8601 duration.

Example:

"PT150H45M"

​
satSignal
string

Satellite signal status

Example:

"Good"

​
satellites
integer

Number of satellites

Example:

8

​
connectionStrength
integer

Connection strength status

Required range: 0 <= x <= 255
Example:

85

​
deviceId
integer

Vehicle ID

Example:

12345

​
ignitionTime
number<double> | null

Unit: seconds. Elapsed time since ignition turned on (trip duration).

Example:

3600.5

​
deviceName
string

Name of the vehicle

Example:

"Fleet Vehicle 001"

​
imei
string

IMEI of the tracker

Example:

"123456789012345"

​
vin
string | null

VIN of the vehicle

Example:

"1HGBH41JXMN109186"

​
startMovingTime
string<date-time> | null

Time when vehicle started to move, UTC

Example:

"2024-01-15T08:00:00Z"

​
startMovingTimeUser
string<date-time> | null

Time when vehicle started to move, user timezone

Example:

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

​
lastMovementTime
string<date-time> | null

Time when vehicle stopped, UTC

Example:

"2024-01-15T16:00:00Z"

​
lastMovementTimeUser
string<date-time> | null

Time when vehicle stopped, user timezone

Example:

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

​
lastMovementTimeUserFormatted
string | null

Time when vehicle stopped, user timezone and formatted

Example:

"15/01/2024 18:00:00"

​
drivingTime
string<date-time> | null

Driving time within the trip

Example:

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

​
driver
string | null

Driver name if any

Example:

"John Smith"

​
fuelLevel
integer

Fuel level, %

Required range: 0 <= x <= 100
Example:

75

​
dtc
string | null

DTC code

Example:

"P0301"

​
isDoorLocked
boolean
deprecated

Is the door locked (Deprecated)

Example:

true

​
address
string

Address of the vehicle

Example:

"123 Main St, New York, NY 10001"

​
engineEnabled
boolean

Whether the engine is enabled

Example:

true

​
timeElapsed
number<double>

Unit: seconds. Server-side time taken to process this request. Note: This field uses camelCase (intentional) while most other fields use PascalCase.

Example:

0.125

​
startedTime
string<date-time>

UTC timestamp when this request was received by the server. Note: This field uses camelCase (intentional) while most other fields use PascalCase.

Example:

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

​
endTime
string<date-time>

UTC timestamp when this request completed. Note: This field uses camelCase (intentional) while most other fields use PascalCase.

Example:

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