---
title: "Fetch a list of the vehicle's driving periods"
method: GET
path: "/v1/driving_periods"
---

# Fetch a list of the vehicle's driving periods

`GET /v1/driving_periods`

## Query parameters

- `driver_ids[]` integer[]
- `vehicle_ids[]` integer[]
- `type` string
- `status` string
- `annotation_status` string
- `assigned_to_driver` boolean
- `start_date` string, date
- `end_date` string, date
- `updated_after` string, date
- `per_page` integer
- `page_no` integer

## Headers

- `X-Time-Zone` string

## Response `200`

200

- object
  - `driving_periods` object[]
    - `driving_period` object
      - `id` integer
      - `start_time` string
      - `end_time` string
      - `status` unknown
      - `type` string
      - `annotation_status` unknown
      - `notes` unknown
      - `duration` integer
      - `start_kilometers` integer
      - `end_kilometers` integer
      - `start_hvb_state_of_charge` number
      - `end_hvb_state_of_charge` number
      - `start_hvb_lifetime_energy_output` number
      - `end_hvb_lifetime_energy_output` number
      - `driver` object
        - `id` integer
        - `first_name` string
        - `last_name` string
        - `username` unknown
        - `email` string
        - `driver_company_id` unknown
        - `status` string
        - `role` string
      - `vehicle` object
        - `id` integer
        - `number` string
        - `year` unknown
        - `make` unknown
        - `model` unknown
        - `vin` unknown
        - `metric_units` boolean
      - `origin` string
      - `origin_lat` number
      - `origin_lon` number
      - `destination_lat` number
      - `destination_lon` number
      - `destination` string
      - `distance` string
      - `source` integer
  - `pagination` object
    - `per_page` integer
    - `page_no` integer
    - `total` integer

---

[API](https://skmtc.net/gomotive/apis/motive.md) · [All operations](https://skmtc.net/gomotive/apis/motive/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gomotive/motive/revisions/c71780e497f5/schema)