Set energy-based charging plan

POST

/loadpoints/{id}/plan/energy/{energy}/{timestamp}

const url = 'https://demo.evcc.io/api/loadpoints/1/plan/energy/25.5/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/loadpoints/1/plan/energy/25.5/2025-07-19T12%3A30%3A00.000Z

Create charging plan with fixed time and energy target. Only available when a vehicle without SoC is connected.

More information

Parameters

Path Parameters

required

Loadpoint index starting at 1.

integer

>= 1

Example

Loadpoint index starting at 1

energy

required

Energy in kWh

number

Example

25.5

Energy in kWh

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

More information

object

energy

Energy in kWh

number

time

Timestamp in RFC3339 format

string format: date-time

Example

{
  "result": {
    "energy": 25.5,
    "time": "2025-07-19T12:30:00.000Z"
  }
}