Set a SoC-based charging plan

POST

/vehicles/{name}/plan/soc/{soc}/{timestamp}

const url = 'https://demo.evcc.io/api/vehicles/vehicle_1/plan/soc/60/2025-07-19T12%3A30%3A00.000Z';
const options = {method: 'POST'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://demo.evcc.io/api/vehicles/vehicle_1/plan/soc/60/2025-07-19T12%3A30%3A00.000Z

Create charging plan with fixed time and SoC target.

More information

Parameters

Path Parameters

name

required

More information

string

>= 1 characters /[a-zA-Z0-9_.:-]+/

Example

vehicle_1

Vehicle name

soc

required

SOC in %

number

<= 100

Example

SOC in %

timestamp

required

Timestamp in RFC3339 format

string format: date-time

Example

2025-07-19T12:30:00.000Z

Timestamp in RFC3339 format

Responses

200

Success

application/json

object

result

object

soc

SOC in %

number

<= 100

time

Timestamp in RFC3339 format

string format: date-time

Example

{
  "result": {
    "soc": 60,
    "time": "2025-07-19T12:30:00.000Z"
  }
}