Daily Driver Aggregate Summary

Get Daily Driver Summary

GET
https://api.fairmatic.com/api/v1/driver-aggregate/daily?start_date=2024-05-20&driver_id=xyz&driver_id=abc&driver_id=123

The Daily Driver Summary API provides aggregated daily information for specified drivers based on their driver_id(s). The data returned includes various metrics and statistics that offer insights into the daily performance and activities of the drivers. This endpoint is useful for tracking and analyzing driver behavior on a day-to-day basis.

info

All dates and epoch time is provided here are as per UTC timezone and aggregates done as per UTC dates.

Headers

Name	Value
Content-Type	application/json
Authorization	APIKEY <token>

Parameters

Name	Type	Description
start_date	string	Summary Date
driver_id	string	driver_id to fetch summary. Accepts multiple driver_ids.

info

• start_date:
  • The start date needs to be within last 6 months range.
  • The start date cant be today's date(current day).
• driver_id:
  • Min 1 driver_id should be there, max 20 driver_id can be sent.
  • Driver id can be fetched from drivers list api for App integration, for SDK integration driver_id is same as the one provided during SDK initiation.

Response

200

{
"data": [
     {
       "driver_info": {
           // All fields except driver_id can contain null
           "driver_id": "548eddcdb576436f96ad7870efcced01",
           "first_name": "John",            
           "last_name": "Doe",              
           "email": None,                    
           "alias": "John Doe",
           "first_travel_date": "2024-05-23",
           "last_travel_date": "2024-05-23"  
       },
       "driving_summary": {
           "fm_score": 88.0,
           "fm_grade": "excellent",
           "trip_count": 1,
           "distance_miles": 10.0,
           "duration_seconds": 1800.0,
           "night_driving_seconds": 1800.0,
           "highway_miles": 3.0,
           "events_summary": {
               "phone_use_count": 1,
               "rapid_acceleration_count": 1,
               "hard_brake_count": 1,
               "overspeeding_count": 1,
               "phone_use_time_seconds": 0,
               "overspeeding_time_seconds": 0
           },
           "focus_area": {
               "is_phone_use": true,
               "is_overspeeding": false,
               "is_hard_brake": false,
               "is_acceleration": false
           },
           "date": "2024-05-20",
        }
    },
    driver_2 data ...
    driver_3 data ...
    ...
    driver_20 data ...
  ]
}