Get Telematics DVIR Data

Retrieve a list of driver-vehicle inspection reports (DVIRs)

SecuritybearerAuth

Request

query Parameters

groupId	string or null Can use group ID or root group ID. All descendant groups under the specified group are included in the response. Example: groupId=5100FFFF-60B6-D7CD-3FA2-22CA712B0000
deviceId	string or null Example: deviceId=5100FFFF-60B6-D7CD-3FA2-22CA712B0000
userId	string or null Can use user ID. Example: userId=5100FFFF-60B6-D7CD-3FA2-22CA712B0000
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/dvir

Request samples

curl
JavaScript
Node.js

Response samples

application/json

{"data": [{"authorityAddress": "123 Main St, Springfield",
"authorityName": "Department of Transportation",
"certifiedBy": {"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"
},
"certifyDate": "2025-05-29T19:18:26.063Z",
"certifyRemark": "All systems OK",
"dateTime": "2025-05-29T19:18:26.063Z",
"defectList": {"id": "grp-123",
"name": "Drivers Group",
"comment": "Main driver group",
"reference": "REF123",
"parent": { },
"children": [{ }
],
"color": { }
},
"defects": [{"id": "grp-123",
"name": "Drivers Group",
"comment": "Main driver group",
"reference": "REF123",
"parent": { },
"children": [{ }
],
"color": { }
}
],
"device": {"id": "1b33bcbe-15d3-445e-a06f-dda61208ad18",
"activeFrom": "2023-10-06T00:22:30.000Z",
"activeTo": "2025-10-06T00:22:30.000Z",
"comment": "Installed in vehicle A123",
"groups": ["Group1",
"Group2"
],
"timeZoneId": "America/Toronto",
"deviceFlags": "FLAG_001",
"deviceType": "GO9",
"hardwareId": "HW-ABC-12345",
"ignoreDownloadsUntil": "2025-05-15T12:00:00.000Z",
"maxSecondsBetweenLogs": 300,
"name": "Device A123",
"productId": "PROD-456",
"serialNumber": "SN123456789",
"timeToDownload": "2025-09-20T10:00:00.000Z",
"workTime": "08:00-17:00",
"registerDeviceResultLite": { },
"devicePlanBillingInfo": { },
"deviceReplacementInfo": { },
"customProperties": { },
"mediaFiles": ["file1.jpg",
"file2.mp4"
],
"tmpTrailerId": "TRAILER-123",
"version": "v1.2.3"
},
"driver": {"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"
},
"driverRemark": "No issues observed",
"duration": "02:15:00",
"dvirDefects": [{"defect": {"children": [{"id": null,
"name": null,
"comment": null,
"reference": null,
"parent": null,
"children": [ ],
"color": null
}
],
"color": {"a": 255,
"r": 255,
"g": 0,
"b": 0
},
"comments": "Requires immediate attention",
"id": "def1f6e56d-1234-4567-89ab-cdef12345678",
"isHidden": false,
"isRequired": true,
"name": "Brake Pads",
"parent": {"id": "grp-123",
"name": "Drivers Group",
"comment": "Main driver group",
"reference": "REF123",
"parent": { },
"children": [null
],
"color": { }
},
"reference": "REF-001",
"severity": "High"
},
"defectRemarks": [{"dateTime": "2025-05-29T19:18:26.063Z",
"id": "r1f6e56d-1234-4567-89ab-cdef12345678",
"remark": "Checked brakes",
"user": {"id": null,
"firstName": null,
"lastName": null,
"name": null,
"licenseNumber": null,
"licenseProvince": null,
"acceptedEULA": null,
"driveGuideVersion": null,
"wifiEULA": null,
"activeFrom": null,
"activeTo": null,
"lastAccessDate": null,
"companyName": null,
"companyAddress": null,
"carrierNumber": null,
"isDriver": null,
"isEmailReportEnabled": null,
"language": null,
"timeZoneId": null,
"userAuthenticationType": null,
"zoneDisplayMode": null,
"driverGroups": [ ],
"companyGroups": [ ],
"keys": [ ],
"bookmarks": [ ],
"viewDriversOwnDataOnly": null,
"designation": null,
"employeeNo": null,
"phoneNumber": null,
"phoneNumberExtension": null
}
}
],
"id": "dd1f6e56d-1234-4567-89ab-cdef12345678",
"repairDateTime": "2025-05-30T10:00:00.000Z",
"repairStatus": "Repaired",
"repairUser": {"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": null,
"name": null,
"comment": null,
"reference": null,
"parent": null,
"children": [ ],
"color": null
}
],
"companyGroups": [{"id": null,
"name": null,
"comment": null,
"reference": null,
"parent": null,
"children": [ ],
"color": null
}
],
"keys": [{ }
],
"bookmarks": [{ }
],
"viewDriversOwnDataOnly": false,
"designation": "Manager",
"employeeNo": "EMP12345",
"phoneNumber": "+1-123-456-7890",
"phoneNumberExtension": "101"
}
}
],
"engineHours": 5.5,
"id": "d1f6e56d-1234-4567-89ab-cdef12345678",
"isSafeToOperate": true,
"loadHeight": 3.5,
"loadWidth": 2.5,
"location": { },
"logType": "Pre-Trip",
"odometer": 12550,
"repairDate": "2025-05-30T08:22:30.000Z",
"repairedBy": {"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"
},
"repairRemark": "Replaced brake pads",
"version": "v1.0"
}
]
}