GuidesAPI ReferenceChangelogDiscussions
Log In
API Reference

Get the battery forecast for a time range

get
https://ampere.chargee.io/api/v2/addresses//batteries//forecast
  • Permission: READ_BATTERY_DATA
  • Roles: extended_user, flex_management

Computes on-demand battery charge/discharge forecasts for the given time range [fromDate, toDate) using all supported strategies and EPEX day-ahead prices. Query dates may include a timezone offset; timestamps in the response use UTC (+00:00). Use POST to supply custom prices and optionally filter strategies. Requires battery charge state updated within the last 60 minutes.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The uuid of the address

string
required

The uuid of the battery

Query Params
date-time
required

The start date (ISO 8601 with offset, e.g. 2026-01-01T00:00:00+01:00)

date-time
required

The end date (ISO 8601 with offset, e.g. 2026-01-01T00:00:00+01:00)

Responses

403

Forbidden — the caller's role lacks the required permission (READ_BATTERY_DATA).

Updated 27 days ago

Did this page help you?
Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 27 days ago

Did this page help you?