Get a timeline of your crashes

The Crash Timeline Service delivers chronological reports of detected crashes involving drivers within your organization, with reports available on both a weekly and monthly basis.

Weekly and monthly timelines include the following indicators:

• Total crashes: the total number of crashes, including both confirmed and unconfirmed events.

• Confirmed crashes: the number of crashes validated by either the classifier or the supervisor.

• Users with detected crashes: the total number of users for whom at least one crash was detected.

• Users with confirmed crashes: the number of users with at least one crash confirmed by the classifier or a supervisor.

Unconfirmed crashes can be derived by subtracting the number of confirmed crashes from the total crashes.

If you have your admin API key, you can try the API via this link.

get

Header parameters

DriveKit-Admin-API-KeystringOptional

DriveKit admin API key

Responses

200

OK

application/json

401

Invalid API key

application/json

404

Timeline Not Found

application/json

get

HTTPcURLJavaScriptPython

GET /v3/drivekit/admin/crashes/timeline HTTP/1.1
Host: service.drivequant.com
Accept: */*

{
  "month": {
    "date": [
      "2025-08-01T12:00:00.000+00:00",
      "2025-09-01T12:00:00.000+00:00"
    ],
    "user": [
      {
        "total": [
          11,
          7
        ],
        "confirmed": [
          4,
          0
        ],
        "confirmedBySupervisor": [
          0,
          0
        ]
      }
    ],
    "crash": [
      {
        "total": [
          1100,
          174
        ],
        "confirmed": [
          7,
          0
        ],
        "confirmedBySupervisor": [
          0,
          0
        ]
      }
    ]
  },
  "week": {
    "date": [
      "2025-08-25T12:00:00.000+00:00",
      "2025-09-01T12:00:00.000+00:00",
      "2025-09-08T12:00:00.000+00:00"
    ],
    "user": [
      {
        "total": [
          9,
          7,
          4
        ],
        "confirmed": [
          0,
          0,
          0
        ],
        "confirmedBySupervisor": [
          0,
          0,
          0
        ]
      }
    ],
    "crash": [
      {
        "total": [
          249,
          95,
          71
        ],
        "confirmed": [
          0,
          0,
          0
        ],
        "confirmedBySupervisor": [
          0,
          0,
          0
        ]
      }
    ]
  }
}

Response

The table below summarizes the list of response data.

Field	Type	Description
month	Timeline	Monthly reports of the number of crashes in your organization
week	Timeline	Weekly reports of the number of crashes in your organization

Timeline

The table below summarizes the list of timeline data.

Field	Type	Description
date	array[date]	List of dates representing the first day of the timeline period (e.g., week or month) Date format: YYYY-MM-dd’T’HH:mm:ss.SSSZ
user	array[object]	Report of unique users for whom a crash event was detected during the period (see User)
crash	array[object]	Report of unique crashes detected during the period (see Crash)

User

The table below summarizes the list of user data.

Field	Type	Description
total	int	Total number of unique users for whom a crash event was detected during the period
confirmed	int	Number of unique users with a crash event confirmed by the classifier
confirmedBySupervisor	int	Number of unique users with a crash event confirmed by the classifier and the supervisor

Crash

The table below summarizes the list of crash data.

Field	Type	Description
total	int	Total number of crash events analyzed during the period
confirmed	int	Number of crash events confirmed by the classifier
confirmedBySupervisor	int	Number of crash events confirmed by the classifier and the supervisor