GET
/
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.

date
number

The date of the charging record, in UNIX timestamp.

home
number
default: "kWh"

The amount of energy consumed at home as defined by the vehicle owner. home is the Home Address as set on the vehicle.

other
number
default: "kWh"

The amount of energy consumed at locations other than home or Superchargers

superCharger
number
default: "kWh"

The amount of energy consumed at Superchargers.

total
number
default: "kWh"

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?