POST
/
vehicles
/
{id}
/
charge
curl "https://api.smartcar.com/v2.0/vehicles/{id}/charge" \
    -H "Authorization: Bearer {token}" \
    -X "POST" \
    -H "Content-Type: application/json" \
    -d '{"action": "START"}'

    {
        "message": "Successfully sent request to vehicle",
        "status": "success"
    }

​
Permission

control_charge

​
Request

Path

​
id
string
required

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

Body

​
action
string
required

START or STOP the vehicle charging.

curl "https://api.smartcar.com/v2.0/vehicles/{id}/charge" \
    -H "Authorization: Bearer {token}" \
    -X "POST" \
    -H "Content-Type: application/json" \
    -d '{"action": "START"}'

​
Response

​
status
string

If the request is successful, Smartcar will return “success”.

​
message
string

If the request is successful, Smartcar will return a message.

    {
        "message": "Successfully sent request to vehicle",
        "status": "success"
    }

​
Notes

BMW and MINI
Vehicle needs to be on OS Version 8+

Ford and Lincoln
Issuing a start command while the vehicle has a schedule in place for its current charging location will result in the vehicle charging to 100%.

Please see charge schedule by location for details on setting a charge limit with preferred charging times or clearing schedules.

Nissan
Currently only START charge commands are supported in the US. See Set Charge Schedule for details on setting a charge schedule for Nissan vehicles.

Chevrolet, GMC, Buick and Cadillac
These vehicles require a minimum charge of 50% in order to be able to start or stop charging via the API.