---
title: "List Vehicle Departure Times"
method: GET
path: "/v1/vehicles/{vehicle_id}/departure-times"
tags: ["Vehicle Charging Schedule"]
---

# List Vehicle Departure Times

`GET /v1/vehicles/{vehicle_id}/departure-times`

Retrieve a list of departure times for the provided vehicle.

Departure times determine when the vehicle needs to charge by, working with the target state of charge,
which determines the charging behavior. So for example, if the target state of charge is 80%,
the departure time is 10:00, the vehicle is at 70%, and the rate of charge is 10% per hour,
the vehicle might start charging at 9:00 to reach 80% by 10:00.


Possible Codes in Error Response (see [Errors](https://docs.volteras.com/api-reference/errors) for error response schema and meaning of codes):

- AUTHENTICATION_ERROR
- REQUEST_VALIDATION_ERROR
- SERVER_ERROR

## Path parameters

- `vehicle_id` string, required — Unique internal identifier for the vehicle.

## Response `200`

Successful Response

- VehicleDepartureTimes
  - `departureTimes` DepartureTime[], required
    - `hour` integer, required
    - `minute` integer, required
    - `daysOfWeek` Weekdays[], required — The days of the week that the departure time is valid for. If no values in the array, the departure time is valid for all days of the week.
    - `localTimeOffset` integer, required — The local time offset (vs. UTC) of the start and end times, in minutes. For example, if the vehicle was in UTC+1, this would be 60.

---

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