Charge Records
Returns the daily kWh consumption used to charge a vehicle at home, Superchargers and other locations. Limited to the last 30 days or when the owner first granted your application access, which ever is shorter.
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
The vehicle ID of the vehicle you are making a request to.
The make of the vehicle you are making a request to.
Query
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.
Date of the final record to return in YYYY-MM-DD format. Defaults to the date of the request.
Response
An array of charge records for the vehicle.
The date of the charging record, in UNIX timestamp.
The amount of energy consumed at home as defined by the vehicle owner. home is the Home Address as set on the vehicle.
The amount of energy consumed at locations other than home or Superchargers
The amount of energy consumed at Superchargers.
The total amount of energy consumed to charge the vehicle for a given date.
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.
Was this page helpful?