Get Exception Events Data

Admin

Devices

Drivers

Users

Groups

Vehicles

Safety

Safety Events (DriveCam)

Video (DriveCam)

Fleet Tracking

Distances (DriveCam)

DVIR (DriveCam)

ECM (DriveCam)

Geofences (DriveCam)

GPS (DriveCam)

HOS (DriveCam)

Trips (DriveCam)

Fleet Telematics

Data Connectors (GO9)

Diagnostics (GO9)

DVIR (GO9)

GPS (GO9)

HOS (GO9)

IFTAReport (GO9)

Trips (GO9)

Zones (GO9)

Legacy APIs

Beta APIs

DeviceStatusInfo (GO9)

ExceptionEvent

get

Get Exception Events Data

FaultData (GO9)

FleetUtilization (GO9)

MaintenanceRecords (GO9)

Rule

StatusData (GO9)

Zones (GO9)

Get Exception Events Data

Retrieve a list of all the exception events generated by Rule violation.

SecuritybearerAuth

Request

query Parameters

ruleId	string or null Can use either rule ID or rule name. Example: ruleId=5100FFFF-60B6-D7CD-3FA2-22CA712B0000
deviceId	string or null Can use either device serial number or device ID. Example: deviceId=5100FFFF-60B6-D7CD-3FA2-22CA712B0000
driverId	string or null Can use either driver ID or driver name. Example: driverId=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/exceptionEvent

Request samples

curl
JavaScript
Node.js

Response samples

application/json

{"data": [{"id": "1b33bcbe-15d3-445e-a06f-dda61208ad18",
"activeFrom": "2023-10-06T00:22:30.000Z",
"activeTo": "2025-10-06T00:22:30.000Z",
"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"
},
"distance": 12.5,
"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"
},
"duration": "PT5M30S",
"lastModifiedDate": "2023-10-07T08:00:00.000Z",
"rule": {"activeFrom": "2023-10-06T00:22:30.000Z",
"activeTo": "2025-10-06T00:22:30.000Z",
"baseType": "SpeedingRule",
"color": {"a": 255,
"r": 255,
"g": 0,
"b": 0
},
"comment": "Triggers when speed exceeds limit",
"condition": {"children": [{ }
],
"conditionType": "SpeedCondition",
"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"
},
"diagnostic": {"code": 101,
"controller": { },
"diagnosticType": "Engine",
"faultResetMode": "Automatic",
"id": "d1f6e56d-1234-4567-89ab-cdef12345678",
"isReadOnly": false,
"name": "Engine Overheat",
"source": { },
"tamperingDiagnostics": 0,
"unitOfMeasure": { },
"version": "v1.0"
},
"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": 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"
},
"group": {"id": "grp-123",
"name": "Drivers Group",
"comment": "Main driver group",
"reference": "REF123",
"parent": { },
"children": [{ }
],
"color": { }
},
"id": "cond-abc-123",
"value": 90.5,
"workTime": {"comment": "Standard working hours",
"details": [{"dayOfWeek": null,
"fromTime": null,
"id": null,
"toTime": null
}
],
"holidayGroup": {"groupId": "hg-001"
},
"id": "wt-001",
"name": "Weekday Schedule"
},
"zone": {"activeFrom": "2025-05-29T19:18:26.063Z",
"activeTo": "2025-06-29T19:18:26.063Z",
"comment": "Restricted area for heavy vehicles",
"displayed": true,
"externalReference": "zone-ext-12345",
"fillColor": {"a": 255,
"r": 255,
"g": 0,
"b": 0
},
"groups": ["group1",
"group2"
],
"id": "zone1f6e56d-1234-4567-89ab-cdef12345678",
"metadata": { },
"mustIdentifyStops": false,
"name": "No Parking Zone",
"points": [{"x": null,
"y": null
}
],
"version": "v1.0",
"zoneTypes": [{"id": null,
"name": null,
"comment": null
}
]
}
},
"groups": [{"id": "grp-123",
"name": "Drivers Group",
"comment": "Main driver group",
"reference": "REF123",
"parent": { },
"children": [{ }
],
"color": { }
}
],
"id": "1b33bcbe-15d3-445e-a06f-dda61208ad18",
"name": "Speeding Rule",
"version": "v1.0.0"
},
"version": "v1.0.0"
}
]
}