Vehicle

Read an electric vehicle’s battery level, range, and charging status.

What it reports

curl https://api.amps.ai/vehicle/device_abc123 \
  -H "x-api-key: $AMPS_API_KEY"

{
  "success": true,
  "data": {
    "id": "device_abc123",
    "state": {
      "batteryLevel": 64,
      "range": 182,
      "plugged": true,
      "charging": true,
      "fullyCharged": false,
      "batteryCapacity": 75,
      "chargeLimit": 80,
      "chargeRate": 7.2,
      "chargeTimeRemaining": 95,
      "maxCurrent": 32
    }
  }
}

Field
`batteryLevel`	State of charge, 0–100 percent.
`range`	Estimated driving range, in miles.
`plugged`	Plugged in to a charger.
`charging`	Drawing charge now.
`fullyCharged`	Reached `chargeLimit`.
`batteryCapacity`	Usable capacity, in kWh.
`chargeLimit`	Configured charge limit, in percent.
`chargeRate`	Charge rate, in kW. Negative when discharging.
`chargeTimeRemaining`	Minutes until `chargeLimit` is reached.
`maxCurrent`	Maximum current the vehicle accepts, in amps.

List a user’s vehicles with GET /vehicle?userId=user_abc123. See Pull for freshness and pagination. In sandbox, vehicles follow a daily pattern in UTC: charging overnight, unplugged and draining during the day.

What it accepts

Nothing yet. Vehicles are read-only: there is no command or settings endpoint for them. To control charging, use the EV charger the car is plugged in to. See Capabilities.

Coming soon. Vehicle control, such as starting and stopping charging.

Next steps

Pull

Read shape, freshness, and pagination.

EV charger cookbook

Control charging from the charger side.

Get started

API Reference

Guides

Cookbooks

What it reports

What it accepts

Next steps

Pull

EV charger cookbook

​What it reports

​What it accepts

​Next steps

Pull

EV charger cookbook

What it reports

What it accepts

Next steps