Skip to main content
Charge a battery during an off-peak tariff window by sending charge with a start and an end. Amps runs the charge at start and takes it back at end, with no further calls from you.

1. Check the battery supports it

The battery must list windowed in commands.charge.execution.
If windowed is missing, the push returns 422 DEVICE_NOT_CAPABLE with the supported shapes in details.supportedExecution.

2. Send the command

Charge to 90% between 00:30 and 04:30, capped at 3 kW. Times are the battery’s local time, with no offset. See Scheduling.
The API returns 202 Accepted. The action stays scheduled until start. To open the window now, leave out start: the charge is sent straight away and the action comes back acknowledged with its end. If the battery already has a pending action, you get a 409; see Conflicts.

3. Confirm

Listen for push.completed or push.failed on your webhook, or read the action at links.self. See Push for the action lifecycle.

Next steps

Discharge during a peak

The same window shape, for discharging.

Cancel an action

Cancel the window before it starts.