v1

latestOpenAPI 3.1.02026-07-2617501.1 MB

Fetch the driver's performance events (v2)

get/v2/driver_performance_events

Query parameters

driver_ids[]integer[]

Specify the Driver IDs for whom you want check the performance events.

vehicle_ids[]integer[]

Specify the vehicle IDs to filter out the performance events.

event_typesstring[]

Specify event types if you want the response to fetch only those certain events.NOTE: The following event types are supported by this endpoint:<ul><li>hard_accel, hard_brake, hard_corner, crash</li><li>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</li><li>manual_event</li><li>unsafe_parking</li><li>yawning, driver_eating, driver_fatigue, driver_microsleep, driver_rubbing_eyes, stretching, individual_lane_swerving, aggregated_lane_swerving, near_miss, forward_parking, smoking</li></ul>

positive_behavior_tagsstring

Specify the name of the positive behavior tag that you want to include in the response. Allowed values are: <ul><li>alert_driving: This is an annotation tag that is added when a driver is observed to be mostly alert. </li><li>safe_distancing: This is a video tag that is added when it is observed that the driver has maintained a safe distance to other vehicles during a trip.</li></ul>

start_datestring date

Specify a start date from when you want the performance events to be fetched. FORMAT: YYYY-MM-DD. Default: TODAY() - 1 WEEK

end_datestring date

Specify an end date before which you want to fetch the driver's performance events. FORMAT: YYYY-MM-DD. Default: TODAY()

updated_afterstring date

Return all driver performance events updated after given time.

ignore_thresholdsboolean

Specify the vehicle threshold. TRUE: Will return all the corresponding events and will ignore all the thresholds. FALSE: Will only fetch those events that are below the threshold.

media_requiredboolean

Specify if the API response must include media or not. TRUE: Will fetch only those events that have a media attached to it. FALSE: Will fetch all the events irrespective of the media.

per_pagestring

Number of records per page.

page_nostring

Denotes the page number.

Response

200

per_pageinteger

page_nointeger

totalinteger

Example response

{
  "driver_performance_events": [
    {
      "driver_performance_event": {
        "id": 1399325092,
        "duration": 207,
        "end_bearing": 256.13577,
        "end_speed": 124,
        "end_time": "2025-10-09T02:27:23Z",
        "lat": 43.0852581,
        "lon": -76.4238473,
        "start_bearing": 259.3954,
        "start_speed": -99,
        "start_time": "2025-10-09T02:23:56Z",
        "type": "aggregated_lane_swerving",
        "company_id": 12345,
        "driver": {
          "id": 2717522,
          "first_name": "Jhon",
          "last_name": "Doe",
          "username": "jhondoe",
          "email": "abcd@keeptruckin.com",
          "status": "active",
          "role": "driver"
        },
        "vehicle": {
          "id": 2116922,
          "number": "celd_01134453",
          "year": "0"
        },
        "eld_device": {
          "id": 1648722,
          "identifier": "01134453",
          "model": "lbb-3.6ca"
        },
        "company_name": "Jhon Doe Company",
        "m_gps_spd": [
          122.97866
        ],
        "location": "6.8 mi SW of Baldwinsville, NY",
        "intensity": "0 ",
        "coaching_status": "coachable",
        "coachable_behaviors": [
          "aggregated_lane_swerving"
        ],
        "primary_behavior": [
          "aggregated_lane_swerving"
        ],
        "max_speed": 124,
        "min_speed": 122.97866,
        "event_intensity": {
          "name": "Max. Deviation",
          "value": -1.41,
          "unit_type": "m"
        },
        "sub_event_metadata": {
          "max_intensity_event": 3,
          "sub_event_count": 3
        },
        "sub_events": [
          {
            "duration": 12,
            "end_bearing": 259.24777,
            "end_speed": -99,
            "end_time": "2025-10-09T02:24:08Z",
            "lat": 43.0852581,
            "lon": -76.4238473,
            "m_gps_heading": [
              261.46463
            ],
            "m_gps_lat": [
              43.0855937
            ],
            "m_gps_lon": [
              -76.4213424
            ],
            "m_veh_spd": [
              123.09373
            ],
            "start_bearing": 259.3954,
            "start_speed": -99,
            "start_time": "2025-10-09T02:23:56Z",
            "type": "individual_lane_swerving",
            "m_gps_spd": [
              123.09373
            ],
            "max_speed": 125.301765,
            "min_speed": 123.804405,
            "camera_media": {
              "id": 3219121126,
              "available": true,
              "cam_positions": [
                "front_facing"
              ],
              "cam_type": "dc54",
              "uploaded_at": "2025-10-09T02:28:20Z",
              "start_time": "2025-10-09T02:23:57Z",
              "duration": 7,
              "downloadable_videos": {
                "front_facing_plain_url": "https://keep-truckin-preview.s3.amazonaws.com/uploads/camera_media/media/2436118/mp4-front_facing-7fa92a01-38c6-493b-ba3e27aa",
                "driver_facing_plain_url": "https://keep-truckin-preview.s3.amazonaws.com/uploads/camera_media/media/2436118/mp4-driver_facing-7fa92a01-38c6-493b-ba0b-5f3468c90c4a1de1f81e527bbaea69176acd25cce16c0968310"
              },
              "auto_transcode_status": "success"
            }
          }
        ],
        "metadata": {
          "annotation_tags": [
            "aggregated_lane_swerving"
          ],
          "severity": "high",
          "trigger": "aggregated_lane_swerving"
        }
      }
    }
  ],
  "per_page": 25,
  "page_no": 1,
  "total": 3
}