> For the complete documentation index, see [llms.txt](https://docs.drivequant.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.drivequant.com/backend/crashes/get-a-timeline-of-your-crashes.md).

# 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.

{% hint style="info" %}
If you have your **admin API key**, you can try the API via this [**link**](https://drivequant.stoplight.io/docs/drivequant-public/7d7edc89bce63-get-a-timeline-of-your-crashes).
{% endhint %}

## GET /drivekit/admin/crashes/timeline

>

```json
{"openapi":"3.0.3","info":{"title":"DKAdminCrashesV3","version":"1.0"},"servers":[{"url":"https://service.drivequant.com/v3","description":"Prod"}],"paths":{"/drivekit/admin/crashes/timeline":{"get":{"summary":"","description":"","operationId":"get-drivekit-admin-crashes-timeline","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerCrashTimelineResponse"}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Timeline Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"schema":{"type":"string"},"in":"header","name":"DriveKit-Admin-API-Key","description":"DriveKit admin API key"}]}}},"components":{"schemas":{"CustomerCrashTimelineResponse":{"title":"CustomerCrashTimelineResponse","type":"object","properties":{"week":{"type":"object","properties":{"items":{"$ref":"#/components/schemas/CustomerCrashTimelineItemResponse"}}},"month":{"type":"object","properties":{"items":{"$ref":"#/components/schemas/CustomerCrashTimelineItemResponse"}}}}},"CustomerCrashTimelineItemResponse":{"title":"CustomerTimelineItemResponse","type":"object","properties":{"date":{"type":"array","description":"List of dates representing the first day of the timeline period (e.g., week or month)","items":{"type":"string","format":"date-time"}},"user":{"type":"array","description":"Report of unique users for whom a crash event was detected during the period","items":{"type":"object","properties":{"total":{"type":"integer","description":"Total number of unique users for whom a crash event was detected during the period"},"confirmed":{"type":"integer","description":"Number of unique users with a crash event confirmed by the classifier"},"confirmedBySupervisor":{"type":"integer","description":"Number of unique users with a crash event confirmed by the classifier and the supervisor"}}}},"crash":{"type":"array","description":"Report of unique crashes detected during the period","items":{"type":"object","properties":{"total":{"type":"integer","description":"Total number of crash events analyzed during the period"},"confirmed":{"type":"integer","description":"Number of crash events confirmed by the classifier"},"confirmedBySupervisor":{"type":"integer","description":"Number of crash events confirmed by the classifier and the supervisor"}}}}}},"ErrorResponse":{"title":"ErrorResponse","type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"},"messageKey":{"type":"string"}}}}}}
```

## Response

The table below summarizes the list of response data.

<table><thead><tr><th width="137.66666666666666">Field</th><th width="209">Type</th><th>Description</th></tr></thead><tbody><tr><td>month</td><td><a href="#timeline">Timeline</a></td><td>Monthly reports of the number of crashes in your organization</td></tr><tr><td>week</td><td><a href="#timeline">Timeline</a></td><td>Weekly reports of the number of crashes in your organization</td></tr></tbody></table>

### Timeline

The table below summarizes the list of timeline data.

<table><thead><tr><th width="137.66666666666666">Field</th><th width="209">Type</th><th>Description</th></tr></thead><tbody><tr><td>date</td><td><code>array[date]</code></td><td>List of dates representing the first day of the timeline period (e.g., week or month)<br><em>Date format: <code>YYYY-MM-dd’T’HH:mm:ss.SSSZ</code></em></td></tr><tr><td>user</td><td><code>array[object]</code></td><td>Report of unique users for whom a crash event was detected during the period (see <a href="#user">User</a>)</td></tr><tr><td>crash</td><td><code>array[object]</code></td><td>Report of unique crashes detected during the period (see <a href="#crash">Crash</a>)</td></tr></tbody></table>

### User

The table below summarizes the list of user data.

<table><thead><tr><th width="204.51041666666666">Field</th><th width="103.81640625">Type</th><th>Description</th></tr></thead><tbody><tr><td>total</td><td><code>int</code></td><td>Total number of unique users for whom a crash event was detected during the period</td></tr><tr><td>confirmed</td><td><code>int</code></td><td>Number of unique users with a crash event confirmed by the classifier</td></tr><tr><td>confirmedBySupervisor</td><td><code>int</code></td><td>Number of unique users with a crash event confirmed by the classifier and the supervisor</td></tr></tbody></table>

### Crash

The table below summarizes the list of crash data.

<table><thead><tr><th width="204.51041666666666">Field</th><th width="105.375">Type</th><th>Description</th></tr></thead><tbody><tr><td>total</td><td><code>int</code></td><td>Total number of crash events analyzed during the period</td></tr><tr><td>confirmed</td><td><code>int</code></td><td>Number of crash events confirmed by the classifier</td></tr><tr><td>confirmedBySupervisor</td><td><code>int</code></td><td>Number of crash events confirmed by the classifier and the supervisor</td></tr></tbody></table>