tripScoredNotification Webhook

The Trip Scored notification is sent by Zendrive when a trip uploaded by your application is completely uploaded and scored by the Zendrive backend. Your application can now query the Zendrive API for Trip Scores for this trip.

The tripScoredNotification webhook contains trip information including events recorded during the trip. Please ensure that you set the maximum payload size for the webhook at 256KB. If a lower payload size limit is set, the webhook is likely to fail.

The notification data block contains the following fields.

Request Parameter	Description
version	Currently, the value of this field is 3.
type	The type for this notification is trip_scored.
driver_id	The unique identification of the driver whose trip was just scored.
trip_id	The unique identification of the trip which was just scored.
data	A dictionary with the following details about the trip, available only to applications who are set up to receive trip details via webhook. Contact [email protected] to set this up for your application. Otherwise, this field will be an empty dictionary: info : Recorded information about the trip [ Total kilometers driven, drive time and so on]. simple_path: A coarse GPS trail of the trip. Useful for trip path visualization. score: Zendrive driver score. events: Events detected by Zendrive during the trip, such as hard braking, acceleration, speeding, phone use while driving and so on.

Sample Notification

The average_driver_speed_kmph, max_driver_speed_kmph, and posted_speed_limit_kmph fields are only generated in the case of an OVERSPEEDING event.

{
     "version": 3,
     "type": "TRIP_SCORED",
     "driver_id": "10101672903689391",
     "trip_id": "1416227804134",
     "data": {
        "info": {
            "start_time": "2020-03-10T19:32:29-05:00",
            "end_time": "2020-03-10T19:59:18-05:00",
            "trip_max_speed_kmph": 48.311961625088735,
            "duration_seconds": 1608.526,
            "distance_km": 3.812,
            "session_id": "NA",
            "tracking_id": "34451-b",
            "insurance_period": 2,
            "user_mode": "passenger",
            "drive_type": "driving",
            "vehicle_type": "Car"
            "extrapolated_distance_km": 0.195,
            "estimated_start_latitude": 12.964071937802245,
            "estimated_start_longitude": 77.75313923023563,
        },
        "driving_behavior": {
            "event_rating": {
                "hard_brake_rating": 5,
                "hard_turn_rating": 5,
                "rapid_acceleration_rating": 5,
                "phone_use_rating": 5,
                "overspeeding_rating": 5
            },
            "score": {
                "zendrive_score": 100
            }
        },     
    "simple_path": [
     {
         "latitude": 40.7048046,
         "timestamp": "2018-01-25T16:28:35.318000-05:00",
         "longitude": -73.7980828,
         "time_millis": 1516915715318
     },{
         "latitude": 40.7048046,
         "timestamp": "2018-01-25T16:29:10.805000-05:00",
         "longitude": -73.7980314,
         "time_millis": 1516915750805
     }],
    "trip_id": "1416227804134",
    "events": [{
     "event_type": 3,
     "event_type_name": "OVERSPEEDING",
     "latitude_end": 40.9145881796243,
     "longitude_end": -74.2668195549313,
     "longitude_start": -74.2656172626412,
     "latitude_start": 40.9139556857207,
     "average_driver_speed_kmph": 49.535568691545045,
     "max_driver_speed_kmph": 78.98654033076772,
     "end_time": "2017-09-07T15:16:45-04:00",
     "posted_speed_limit_kmph": 32.186854250516596,
     "start_time": "2017-09-07T15:15:56-04:00"
 }]
 }
 }