Fetch the driver's performance events (v2)

Purpose: Use this API to fetch a list of all the driver's performance events. Tracking performance events such as hard braking, rapid acceleration, and speeding helps identity risky driving behaviours that may lead to accidents. Monitoring such events allows you to be compliant with regulatory requirements, as well as maintain healthy Hours of Service (HOS). Continuous monitoring also provides data that can be used for constructive feedback and coaching.

📘

NOTE

The following event_types are supported in this endpoint version (v2):

• hard_accel, hard_brake, hard_corner, crash
• seat_belt_violation, tailgating, cell_phone, stop_sign_violation, distraction, unsafe_lane_change, drowsiness, road_facing_cam_obstruction, driver_facing_cam_obstruction, forward_collision_warning
• manual_event

Response Parameters

driver_performance_event

• Type: Object
• Description: Details of a driver's performance event.

---

id:

• Type: Integer
• Description: Unique identifier of the driver performance event.

acceleration:

• Type: String
• Description: Acceleration during the event in g-force.

duration:

• Type: Integer
• Description: Duration of the event in seconds.

end_bearing:

• Type: String
• Description: Bearing at the end of the event in degrees.

end_speed:

• Type: String
• Description: Speed at the end of the event in km/h.

end_time:

• Type: String
• Description: Timestamp when the event ended.

lat:

• Type: String
• Description: Latitude of the event location.

lon:

• Type: String
• Description: Longitude of the event location.

m_gps_heading:

• Type: Array of Floats
• Description: Array of GPS headings during the event.

m_gps_lat:

• Type: Array of Floats
• Description: Array of GPS latitudes during the event.

m_gps_lon:

• Type: Array of Floats
• Description: Array of GPS longitudes during the event.

m_veh_odo:

• Type: String
• Description: Odometer reading during the event.

m_veh_spd:

• Type: Array of Floats
• Description: Array of vehicle speeds during the event in km/h.

start_bearing:

• Type: String
• Description: Bearing at the start of the event in degrees.

start_speed:

• Type: String
• Description: Speed at the start of the event in km/h.

start_time:

• Type: String
• Description: Timestamp when the event started.

type:

• Type: String
• Description: Type of performance event (e.g., "cell_phone").

driver:

• Type: Object
• Description: Details of the driver involved in the event.

id:

• Type: Integer
• Description: Unique identifier of the driver.

first_name:

• Type: String
• Description: Driver's first name.

last_name:

• Type: String
• Description: Driver's last name.

username:

• Type: String
• Description: Username of the driver.

email:

• Type: String
• Description: Email of the driver.

driver_company_id:

• Type: String
• Description: Company ID of the driver.

mcleod_id:

• Type: String
• Description: McLeod ID of the driver.

status:

• Type: String
• Description: Status of the driver (e.g., "deactivated").

role:

• Type: String
• Description: Role of the driver (e.g., "driver").

vehicle:

• Type: Object
• Description: Details of the vehicle involved in the event.

id:

• Type: Integer
• Description: Unique identifier of the vehicle.

number:

• Type: String
• Description: Vehicle number.

year:

• Type: String
• Description: Year of the vehicle.

make:

• Type: String
• Description: Make of the vehicle.

model:

• Type: String
• Description: Model of the vehicle.

vin:

• Type: String
• Description: VIN of the vehicle.

metric_units:

• Type: Boolean
• Description: Indicates whether the vehicle uses metric units.

mcleod_id:

• Type: String
• Description: McLeod ID of the vehicle.

eld_device:

• Type: Object
• Description: Details of the ELD device used during the event.

id:

• Type: Integer
• Description: Unique identifier of the ELD device.

identifier:

• Type: String
• Description: ELD device identifier.

model:

• Type: String
• Description: Model of the ELD device.

camera_media:

• Type: Object
• Description: Details of the camera media associated with the event.

id:

• Type: Integer
• Description: Unique identifier of the camera media.

available:

• Type: Boolean
• Description: Indicates whether the camera media is available.

cam_positions:

• Type: Array of Strings
• Description: Array of camera positions (e.g., "front_facing", "driver_facing").

cam_type:

• Type: String
• Description: Type of camera (e.g., "dc54").

uploaded_at:

• Type: String
• Description: Timestamp when the media was uploaded.

start_time:

• Type: String
• Description: Timestamp when the media recording started.

duration:

• Type: Integer
• Description: Duration of the media in seconds.

downloadable_videos:

• Type: Object
• Description: URLs for downloadable videos.

front_facing_enhanced_url:

• Type: String
• Description: URL for the front-facing enhanced video.

front_facing_enhanced_ai_viz_url:

• Type: String
• Description: URL for the front-facing enhanced AI visualization video (currently not provided).

dual_facing_enhanced_url:

• Type: String
• Description: URL for the dual-facing enhanced video.

dual_facing_enhanced_ai_viz_url:

• Type: String
• Description: URL for the dual-facing enhanced AI visualization video.

front_facing_plain_url:

• Type: String
• Description: URL for the front-facing plain video.

driver_facing_plain_url:

• Type: String
• Description: URL for the driver-facing plain video.

auto_transcode_status:

• Type: String
• Description: Status of the auto-transcoding process (e.g., "success").

downloadable_images:

• Type: Object
• Description: URLs for downloadable images.

front_facing_jpg_url:

• Type: String
• Description: URL for the front-facing image.

driver_facing_jpg_url:

• Type: String
• Description: URL for the driver-facing image.

edited_by_fm:

• Type: Boolean
• Description: Indicates whether the event was edited by a fleet manager.

m_gps_spd:

• Type: Array of Floats
• Description: Array of GPS speeds during the event.

location:

• Type: String
• Description: Location of the event.

intensity:

• Type: String
• Description: Intensity of the event.

coaching_status:

• Type: String
• Description: Coaching status of the event (e.g., "pending_review").

coached_at:

• Type: String
• Description: Timestamp when the event was coached.

coachable_behaviors:

• Type: Array of Strings
• Description: Array of coachable behaviors during the event (e.g., "hard_brake").

coached_behaviors:

• Type: String
• Description: Coached behaviors for the event.

primary_behavior:

• Type: Array of Strings
• Description: Array of primary behaviors during the event (e.g., "cell_phone").

secondary_behaviors:

• Type: Array of Strings
• Description: Array of secondary behaviors during the event (e.g., "in_progress").

max_speed:

• Type: String
• Description: Maximum speed during the event in km/h.

min_speed:

• Type: String
• Description: Minimum speed during the event in km/h.

event_intensity:

• Type: Object
• Description: Intensity details of the event.

name:

• Type: String
• Description: Name of the intensity metric (e.g., "Distracted time").

value:

• Type: String
• Description: Value of the intensity metric.

unit_type:

• Type: String
• Description: Unit type of the intensity metric (e.g., "s").

metadata:

• Type: Object
• Description: Additional metadata for the event.

additional_context:

• Type: Object
• Description: Contextual details for the event.

slope:

• Type: Array of Strings
• Description: Slope details

Lighting:

• Type: Array of Strings
• Description: Lighting details

Road_type:

• Type: Array of Strings
• Description: Road type details

Lane_spacing:

• Type: Array of Strings
• Description: Lane spacing details

Tpv_behavior:

• Type: Array of Strings
• Description: TPV behavior details .

Road_geometry:

• Type: Array of Strings
• Description: Road geometry details .

Vehicle_speed:

• Type: Array of Strings
• Description: Vehicle speed details

Sensitive_zone:

• Type: Array of Strings
• Description: Sensitive zone details

Road_conditions:

• Type: Array of Strings
• Description: Road conditions details

road_visibility:

• Type: Array of Strings
• Description: Road visibility details

Traffic_density:

• Type: Array of Strings
• Description: Traffic density details

Driving_visibility:

• Type: Array of Strings
• Description: Driving visibility details

Traffic_conditions:

• Type: Array of Strings
• Description: Traffic conditions details

Traffic_violations:

• Type: Array of Strings
• Description: Traffic violations details

annotation_tags:

• Type: Array of Strings
• Description: Annotation tags for the event (e.g., "delayed_response", "seat_belt_violation").

severity:

• Type: String
• Description: Severity of the event

trigger:

• Type: String
• Description: Trigger for the event.

---