GET

/v2.0/vehicles/{id}/{make}/charge/records

curl --request GET \
  --url https://api.smartcar.com/v2.0/vehicles/{id}/{make}/charge/records \
  --header 'Authorization: Bearer <token>'

This endpoint is currently available for BMW and MINI

Permission

read_charge_records

Request

Path

idrequired
string

The vehicle id of the vehicle you are making a request to.

makerequired
string

The make of the vehicle you are making a request to.

Query

startDate

Date of the first record to return in YYYY-MM-DD format. Defaults to 30 days prior or when the owner first granted your application access, whichever is shorter.

endDate

Date of the final record to return in YYYY-MM-DD format. Defaults to the date of the request.

Response

records
[object]

An array of charge records for the vehicle.

chargeStart
string

The start date of the charging record, formatted in ISO 8601 standard

chargeEnd
string

The end date of the charging record, formatted in ISO 8601 standard

location
string

Location of the charge session.

energy
Default: "kWh"
number

The amount of energy consumed during the charging session.

isPublic
bool

Indicates whether the charging location is public or not.

startPercentRemaining
number

The remaining battery soc at the start of the charging session.

endPercentRemaining
number

The remaining battery soc at the end of the charging session.

chargingType
string

The type of charger used for the session.

{
  "records": [
    {
      "chargeStart" : "2023-03-08T12:54:44Z",
      "chargeEnd" : "2023-03-08T14:14:44Z",
      "location": "Cockfosters Road, Barnet, EN4 0",
      "energy"  : 34.22998046875,
      "isPublic" : true,
      "startPercentRemaining" : 0.57,
      "endPercentRemaining" : 1, 
      "chargingType" : "DC" 
    }
  ]
}