newFleetVehiclePerformance API Endpoint

As of January 2024, the newFleetVehiclePerformance API endpoint is slated for deprecation.

The newFleetVehiclePerformance API endpoint enables the Commercial Lines Fleet Manager to obtain and view fleet vehicle performance.

API Details

GET https://api.zendrive.com/insurance/v2/vehicle/<vehicle_id>/score?start_date=2022-01-01&end_date=2022-01-20

To get and view fleet vehicle performance.

Headers

Name	Type	Description
Authorization*	String	API KEY <APIKEY>

200: OK

{
	"driving_behavior": {
		"event_rating": {
			"hard_brake_rating": 4,
			"hard_turn_rating": 4,
			"rapid_acceleration_rating": 5,
			"phone_use_rating": 3,
			"overspeeding_rating": 2
		},
		"score": {
			"vehicle": {
				"zendrive_score": 84
			},
			"drivers": {
				"D1": {
					"zendrive_score": 82,
                              "full_name": D1 name
				},
				"D2": {
					"zendrive_score": 86,
                              "full_name": D2 name
				}
			}
		},
		"event_count": {
			"pu": 14,
			"ra": 1,
			"hb": 6,
			"ht": 2,
			"os": 13
		},
		"event_duration_seconds": {
			"pu": 158.259,
                  "ra": 0.0,
                  "hb": 158.259,
                  "ht": 0.0,
			"overspeeding": 745.147
		}
	},
	"daily_driving_behavior": [{
            "date": "2022-02-19",
		"event_rating": {
			"hard_brake_rating": 4,
			"hard_turn_rating": 2,
			"rapid_acceleration_rating": 4,
			"phone_use_rating": 2,
			"overspeeding_rating": 3
		},
		"score": {
			"vehicle_score": {
				"Zendrive_score": 84
               }
		}
	},
      {
          "date": "2022-02-19",
	    "event_rating": {
			"hard_brake_rating": 4,
			"hard_turn_rating": 2,
			"rapid_acceleration_rating": 4,
			"phone_use_rating": 2,
			"overspeeding_rating": 3
		},
		"score": {
			"vehicle_score": {
				"Zendrive_score": 84
               }
		}
	}
],
	"info": {
		"trip_count": 12,
		"duration_seconds": 10087.250999999998,
		"distance_km": 93.903,
            "night_driving_distance":35.2,
            "highway_distance": 12.0,
		"night_driving_fraction": 0.05360563553232597,
		"highway_ratio": 0.38080524225508516,
		"first_trip_date": "2021-08-28",
		"last_trip_date": "2022-02-20",
            "attributes": {
			"model": "A4",
			"make": "Audi",
			"model_year": 2022,
			"color": "white",
			"vin": "vin_string",
			"nickname": "nickname_string",
                  "pairing": "bluetooth"
		}
	},
	"start_date": "2022-02-01",
	"end_date": "2022-03-01"
}

Sample URL

URL: https://api.zendrive.com/insurance/v2/vehicle/<vehicle_id>/score?start_date=2022-01-01&end_date=2022-01-20" -H 'Authorization: APIKEY <api_key>'

This API uses the following Date Range, Pagination, and Sorting parameters:

• To specify date range:start_date, end_date

• To search for specific vehicle_ids:vehicle_ids

• For sorting, based on the following order_by, order_type:

  • trip_count, duration_seconds, distance_km, zendrive_score, and one of asc, desc

• For pagination: limit, offset

• info, driving_behavior:

Sample Response

{
	"driving_behavior": {
		"event_rating": {
			"hard_brake_rating": 4,
			"hard_turn_rating": 4,
			"rapid_acceleration_rating": 5,
			"phone_use_rating": 3,
			"overspeeding_rating": 2
		},
		"score": {
			"vehicle": {
				"zendrive_score": 84
			},
			"drivers": {
				"D1": {
					"zendrive_score": 82,
                              "full_name": D1 name
				},
				"D2": {
					"zendrive_score": 86,
                              "full_name": D2 name
				}
			}
		},
		"event_count": {
			"pu": 14,
			"ra": 1,
			"hb": 6,
			"ht": 2,
			"os": 13
		},
		"event_duration_seconds": {
			"pu": 158.259,
                  "ra": 0.0,
                  "hb": 158.259,
                  "ht": 0.0,
			"overspeeding": 745.147
		}
	},
	"daily_driving_behavior": [{
            "date": "2022-02-19",
		"event_rating": {
			"hard_brake_rating": 4,
			"hard_turn_rating": 2,
			"rapid_acceleration_rating": 4,
			"phone_use_rating": 2,
			"overspeeding_rating": 3
		},
		"score": {
			"vehicle_score": {
				"Zendrive_score": 84
               }
		}
	},
      {
          "date": "2022-02-19",
	    "event_rating": {
			"hard_brake_rating": 4,
			"hard_turn_rating": 2,
			"rapid_acceleration_rating": 4,
			"phone_use_rating": 2,
			"overspeeding_rating": 3
		},
		"score": {
			"vehicle_score": {
				"Zendrive_score": 84
               }
		}
	}
],
	"info": {
		"trip_count": 12,
		"duration_seconds": 10087.250999999998,
		"distance_km": 93.903,
            "night_driving_distance":35.2,
            "highway_distance": 12.0,
		"night_driving_fraction": 0.05360563553232597,
		"highway_ratio": 0.38080524225508516,
		"first_trip_date": "2021-08-28",
		"last_trip_date": "2022-02-20",
            "attributes": {
			"model": "A4",
			"make": "Audi",
			"model_year": 2022,
			"color": "white",
			"vin": "vin_string",
			"nickname": "nickname_string",
                  "pairing": "bluetooth"
		}
	},
	"start_date": "2022-02-01",
	"end_date": "2022-03-01"
}