Skip to main content
GET
/
api
/
partners
/
v2.0
/
org
/
{org_id}
/
users
/
{user_id}
/
electric-vehicles
/
{electric_vehicle_id}
/
data
Get EV data
curl --request GET \
  --url https://api.example.com/api/partners/v2.0/org/{org_id}/users/{user_id}/electric-vehicles/{electric_vehicle_id}/data \
  --header 'Authorization: Bearer <token>'
{
  "metadata": {},
  "data": [
    {
      "time": "<string>",
      "price": 123,
      "battery_level": 123,
      "is_charging": true,
      "is_plugged_in": true,
      "is_at_optimized_location": true,
      "estimated_consumption": 123,
      "unoptimized_consumption": 123
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

Headers

​
fill-missing
boolean
default:false

When set to true, the API will return the full requested time range, filling missing values with null. If no data is available at all, an empty dataset with null values at from_datetime will be returned instead no values at all

Path Parameters

​
org_id
string<uuid>
required

The organization ID of the user's organization

​
user_id
string<uuid>
required

The user ID of the user whom the EV belongs to

​
electric_vehicle_id
string<uuid>
required

The ID of the specified EV

Query Parameters

​
from_datetime
string<date-time>

The start of the time range for the data

​
to_datetime
string<date-time>

The end of the time range for the data

​
resolution
string
default:15MIN

The time interval for aggregating data. Supported values: 15MIN, 1HOUR, 1DAY, 1WEEK, 1MONTH

​
keywords
string

A comma-separated list of keywords. Supported values: price, battery_level, is_charging, is_plugged_in, is_at_optimized_location, estimated_consumption, unoptimized_consumption

Response

200 - application/json

OK

​
metadata
Metadata · object
required
​
data
ElectricVehicleDataPointOutput · object[]
required