Charge Schedule

Returns the charging schedule of a vehicle. The response contains the start time and departure time of the vehicle’s charging schedule.

GET /v2.0/vehicles/{id}/{make}/charge/schedule

cURL

curl "https://api.smartcar.com/v2.0/vehicles/{id}/{make}/charge/schedule" \
-H "Authorization: Bearer {token}" \
-X "GET"

Example Response

{
  "departureTime": {
    "enabled": false,
    "time": null
  },
  "startTime": {
    "enabled": true,
    "time": "18:30"
  }
}

This endpoint is currently available for tesla

Permission

read_charge

Request

Path

id · string · required

The vehicle ID of the vehicle you are making a request to.

make · string · required

The make of the vehicle you are making a request to.

cURL

curl "https://api.smartcar.com/v2.0/vehicles/{id}/{make}/charge/schedule" \
-H "Authorization: Bearer {token}" \
-X "GET"

Response

departureTime · object

The departure time configuration for the charging schedule.

Show departureTime

enabled · boolean

Indicates whether this schedule type is enabled or disabled. Only one of departureTime or departureTime can be enabled at a time.

time · string | null

When plugged in, the vehicle may delay starting a charging session as long as it can reach its charge limit by this time in HH:mm.

startTime · object

The start time configuration for the charging schedule.

Show startTime

enabled · boolean

Indicates whether this schedule type is enabled or disabled. Only one of departureTime or departureTime can be enabled at a time.

time · string | null

When plugged in, the vehicle will delay starting a charging session until this time in HH:mm.

Example Response

{
  "departureTime": {
    "enabled": false,
    "time": null
  },
  "startTime": {
    "enabled": true,
    "time": "18:30"
  }
}