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