User Electric Vehicles
Get savings data for a specified electric vehicle
Retrieve time-bucketed savings data for a specified electric vehicle within a given date range.
GET
Get savings data for a specified electric vehicle
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Path Parameters
The organization ID
The user ID
The electric vehicle ID
Query Parameters
Start of the date range
End of the date range
Time interval for aggregating data. Supported: 1DAY, 1WEEK, 1MONTH, 1QUARTER, 1YEAR
Previous
Trigger a boost charge or arm boost for the next sessionTrigger boost on the EV.
Behaviour depends on the EV's current state:
- **Plugged in + idle** (`boost_state=available`): immediately signals the
running schedule workflow to start charging now, bypassing optimization.
- **Unplugged** (`boost_state=unavailable` due to not plugged in): arms
`boost_for_next_session=True`. The next plug-in's session workflow will
automatically fire boost on its schedule child, then auto-reset the flag.
- **Already charging or in flight** (`boost_state` is `ongoing` or `requested`):
409 with `reason=already_charging`.
- **Fully charged**: 409 with `reason=fully_charged`.
Returns 204 on success (boost triggered or armed). Returns 409 when the
request can't be honoured, with fields:
- `state`: the EV's current `boost_state`.
- `reason`: `already_charging`, `fully_charged`, `no_active_session`, or
`internal_error`.
The arm path is idempotent: re-tapping while already armed returns 204 with
no change. To clear an armed flag, use ``DELETE /boost``.
Next
Get savings data for a specified electric vehicle
