---
title: "List Charging Windows"
method: GET
path: "/v1/vehicles/{vehicle_id}/charging-windows"
tags: ["Vehicle Charging Schedule"]
---

# List Charging Windows

`GET /v1/vehicles/{vehicle_id}/charging-windows`

Retrieve a list of charging windows for the provided vehicle.

Charging windows determine the start and stop times for the vehicle to charge, for example so that
the vehicle can be set to charge during electricity off-peak times.


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

- VehicleChargingWindows
  - `chargingWindows` ChargingWindow[], required
    - `startHour` integer, required
    - `startMinute` integer, required
    - `endHour` integer, required
    - `endMinute` integer, required
    - `daysOfWeek` Weekdays[], required — The days of the week that the charging window is valid for. If no values in the array, the charging window 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.
    - `windowLocation` LatLngValue
      - `longitude` number, required
      - `latitude` number, required

---

[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)