POST
/
v2.0
/
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"
    }   
2.0 is still the only supported version for sending remote commands. If you need to send commands, please continue using v2.0 until commands are supported in the latest version later this year.

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.