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

This endpoint is currently available for bmw and mini

Permission

read_charge_records

Request

Path

id
string
required

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

make
string
required

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
number
default: "kWh"

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" 
    }
  ]
}