Skip to main content
GET
https://api.smartcar.com
/
v2.0
/
vehicles
/
{id}
/
{make}
/
charge
/
records
curl "https://api.smartcar.com/v2.0/vehicles/{id}/{make}/charge/records" \
    -H "Authorization: Bearer {token}" \
    -X "GET" \
    -H "Content-Type: application/json" \

{
  "records": [
    {
      "date": 1692169200,
      "home": 10,
      "other": 15,
      "superCharger": 25,
      "total": 50
    }
  ]
}
As of Dec 6, 2023 this API is no longer supported if a vehicle was connected through our upgraded Tesla integration. Instead, we’ll return a VEHICLE_NOT_CAPABLE error.

Please reach out to support or your Account Manager for information on when this endpoint will be available again.

​
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.

​
Notes

  • If a vehicle owner has not set their Home address on the vehicle, sessions at their home will be rolled into other.
  • Records are only available for the primary vehicle owner i.e. you must connect to Smartcar with the primary Tesla account.
  • Road Segment sharing must be enabled under the Software tab of the vehicle’s touch screen.
curl "https://api.smartcar.com/v2.0/vehicles/{id}/{make}/charge/records" \
    -H "Authorization: Bearer {token}" \
    -X "GET" \
    -H "Content-Type: application/json" \

{
  "records": [
    {
      "date": 1692169200,
      "home": 10,
      "other": 15,
      "superCharger": 25,
      "total": 50
    }
  ]
}