Simulate energy-based charging plan

GET

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

const url = 'https://demo.evcc.io/api/loadpoints/1/plan/static/preview/energy/25.5/2025-07-19T12%3A30%3A00.000Z';
const options = {method: 'GET'};

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

curl --request GET \
  --url https://demo.evcc.io/api/loadpoints/1/plan/static/preview/energy/25.5/2025-07-19T12%3A30%3A00.000Z

Simulate charging plan based on energy goal. Does not alter the actual charging plan.

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 - PlanRates result

application/json

object

result

object

duration

Duration in s

integer

plan

Array<object>

A charging interval

object

start

Start

string format: date-time

end

End

string format: date-time

value

Cost

number

planTime

Timestamp in RFC3339 format

string format: date-time

power

Power in W

number

Example

{
  "result": {
    "plan": [
      {
        "start": "2025-07-19T12:30:00.000Z",
        "end": "2025-07-19T12:30:00.000Z"
      }
    ],
    "planTime": "2025-07-19T12:30:00.000Z",
    "power": 2500
  }
}