---
title: "View the idle events of your drivers"
method: GET
path: "/v1/idle_events"
---

# View the idle events of your drivers

`GET /v1/idle_events`

## Request

- Base URL: `https://api.gomotive.com`
- URL: `https://api.gomotive.com/v1/idle_events`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/gomotive/apis/motive/docs/v1/idle_events/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `driver_ids[]` integer[], required
- `vehicle_ids[]` integer[], required
- `start_date` string, date, required
- `end_date` string, date, required
- `per_page` integer, required
- `page_no` integer, required

## Headers

- `X-Time-Zone` string
- `X-Metric-Units` boolean
- `X-User-Id` integer

## Response `200`

200

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/gomotive/apis/motive.md) - [All operations](https://skmtc.dev/gomotive/apis/motive/llms.txt) - [OpenAPI document](https://skmtc.dev/gomotive/apis/motive/revisions/c71780e497f5?raw)