POST
/
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"
}   

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 charing as a result of a start charge request it will always charge to 100% if the charging location has a schedule in place.

For the vehicle to respect it’s charge limit, please set one along with preferred charge times or clear the schedule through the charge schedule by location endpoint.

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

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