Get Telematics Device Status Info Data

Retrieve a list of all the device status info in an organization or subset of an organization

SecuritybearerAuth

Request

query Parameters

deviceId	string or null Can use either device serial number or device ID. Example: deviceId=5100FFFF-60B6-D7CD-3FA2-22CA712B0000
groupId	string or null Can use group ID or root group ID. Example: groupId=5100FFFF-60B6-D7CD-3FA2-22CA712B0000
isDriving	boolean If true, only devices that are currently driving are returned. Example: isDriving=false
isDeviceCommunicating	boolean If true, only devices that are currently communicating are returned. Example: isDeviceCommunicating=false
limit	integer or null Number of records to return. Example: limit=5000
offset	integer or null Record to start with. Example: offset=1500
startDate	string <date-time> The start date must be within the last 60 days. Example: startDate=2023-06-01
order	string or null Sort direction. Example: order=asc
sortProperty	string or null Name of property to sort on. Example: sortProperty=name
version required	string or null API version number. Example: version=1

Responses

200

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

get/plus/v1/devicestatusinfo

Request samples

curl
JavaScript
Node.js

Response samples

application/json

{"data": [{"deviceId": "dev-123",
"vehicleIdentificationNumber": "1HGCM82633A004352",
"serialNumber": "SN-987654",
"id": "status-001",
"latitude": 43.6532,
"longitude": -79.3832,
"bearing": 180,
"speed": 65.5,
"isDriving": true,
"isDeviceCommunicating": true,
"driverId": "driver-789",
"groups": [{"id": "grp-123",
"name": "Drivers Group",
"comment": "Main driver group",
"reference": "REF123",
"parent": { },
"children": [{ }
],
"color": { }
}
],
"dateTime": "2025-01-20T12:30:00.000Z",
"exceptionEvents": [{"id": "ex-123",
"activeFrom": "2025-01-20T08:00:00.000Z",
"activeTo": "2025-01-20T10:00:00.000Z",
"ruleId": "rule-456"
}
],
"lastTrip": {"id": "trip-999",
"start": "2025-01-20T06:30:00.000Z",
"stop": "2025-01-20T07:15:00.000Z"
}
}
]
}