Skip to main content
POST
/
v2.0
/
vehicles
/
{id}
/
charge
/
limit
curl "https://api.smartcar.com/v2.0/vehicles/{id}/charge/limit" \
    -H "Authorization: Bearer {token}" \
    -X "POST" \
    -H "Content-Type: application/json" \
    -d '{"limit": 0.8}'

{
    "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
​
limit
number
required
The level at which the vehicle should stop charging and be considered fully charged. Cannot be less than 0.5, or greater than 1.
curl "https://api.smartcar.com/v2.0/vehicles/{id}/charge/limit" \
    -H "Authorization: Bearer {token}" \
    -X "POST" \
    -H "Content-Type: application/json" \
    -d '{"limit": 0.8}'

​
Response

​
status
string
If the request is successful, Smartcar will return “success” (HTTP 200 status).
​
message
string
If the request is successful, Smartcar will return a message (HTTP 200 status).

​
Notes

This endpoint will return a CHARGING_PLUG_NOT_CONNECTED error if the OEM is unable to set a charge limit while the vehicle is unpluged. Ford and Lincoln
If a vehicle starts charging as a result of a start charge request it will always charge to 100% if the charging location has a schedule in place. Charging schedules on the vehicle can be read through the Charge.ChargeTimers signal. BMW and MINI
Vehicle needs to be on OS Version 8+ 
{
    "message": "Successfully sent request to vehicle",
    "status": "success"
}