Skip to main content
GET
/
api
/
partners
/
v2.0
/
org
/
{org_id}
/
users
/
{user_id}
/
electric-vehicles
/
{electric_vehicle_id}
/
sessions
/
current
Get the currently active charging session for an electric vehicle
curl --request GET \
  --url https://api.example.com/api/partners/v2.0/org/{org_id}/users/{user_id}/electric-vehicles/{electric_vehicle_id}/sessions/current \
  --header 'Authorization: Bearer <token>'
{
  "session": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "plug_in_time": "2023-11-07T05:31:56Z",
    "unplug_time": "2023-11-07T05:31:56Z",
    "inferred_session_end": "2023-11-07T05:31:56Z",
    "desired_charging_start_time": "2023-11-07T05:31:56Z",
    "desired_charging_end_time": "2023-11-07T05:31:56Z",
    "charge_deadline": "2023-11-07T05:31:56Z",
    "target_soc_pct": 123,
    "initial_soc_pct": 123,
    "final_soc_pct": 123,
    "energy_charged_kwh": 123,
    "avg_charge_power_kw": 123,
    "peak_charge_power_kw": 123,
    "actual_cost_eur": 123,
    "expected_savings_eur": 123,
    "actual_savings_eur": 123,
    "is_at_home": true,
    "is_hidden": false,
    "hidden_reason": "short_duration",
    "target_reachable": true,
    "reachable_soc_pct": 123
  }
}

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

org_id
string<uuid>
required

The organization ID

user_id
string<uuid>
required

The user ID

electric_vehicle_id
string<uuid>
required

The electric vehicle ID

Query Parameters

include_hidden
boolean
default:false

Include the active session even if flagged hidden. Back-office/debugging use.

Response

200 - application/json

OK

session
SessionItem · object
required