Get telematics Drivers data

Retrieve a list of the drivers in an organization or subset of an organization

SecuritybearerAuth

Request

query Parameters

groupId	string or null Can use group ID or root group ID. Example: groupId=5100FFFF-60B6-D7CD-3FA2-22CA712B0000
includeSubGroups	boolean If true, all descendant groups under the specified group are included. Example: includeSubGroups=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
endDate	string <date-time> End date to filter by. Example: endDate=2023-06-02
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/drivers

Request samples

curl
JavaScript
Node.js

Response samples

application/json

{"data": [{"id": "1b33bcbe-15d3-445e-a06f-dda61208ad18",
"firstName": "John",
"lastName": "Doe",
"name": "John Doe",
"licenseNumber": "DL-123456",
"licenseProvince": "CA",
"acceptedEULA": 1,
"driveGuideVersion": 2,
"wifiEULA": 1,
"activeFrom": "2023-10-06T00:22:30.000Z",
"activeTo": "2025-10-06T00:22:30.000Z",
"lastAccessDate": "2025-09-15T12:22:30.000Z",
"companyName": "Acme Corp",
"companyAddress": "123 Main Street, Toronto, ON",
"carrierNumber": "CARR123",
"isDriver": true,
"isEmailReportEnabled": false,
"language": "en-US",
"timeZoneId": "America/Toronto",
"userAuthenticationType": 1,
"zoneDisplayMode": 2,
"driverGroups": [{"id": "grp-123",
"name": "Drivers Group",
"comment": "Main driver group",
"reference": "REF123",
"parent": { },
"children": [{ }
],
"color": { }
}
],
"companyGroups": [{"id": "grp-123",
"name": "Drivers Group",
"comment": "Main driver group",
"reference": "REF123",
"parent": { },
"children": [{ }
],
"color": { }
}
],
"keys": [{ }
],
"bookmarks": [{ }
],
"viewDriversOwnDataOnly": false,
"designation": "Manager",
"employeeNo": "EMP12345",
"phoneNumber": "+1-123-456-7890",
"phoneNumberExtension": "101"
}
]
}