Skip to main content
GET
/
vehicle
/
{deviceId}
curl
curl --request GET \
  --url 'https://api.amps.ai/vehicle/dev_abc123' \
  --header 'x-api-key: amps_sk_test_xxxxxxxxxxxxxxxxxxxxxxxx'
{
  "id": "device_vehicle_001",
  "vendor": "example_vendor_a",
  "sync": {
    "available": true,
    "lastPulledAt": "2026-05-07T09:23:45.000Z"
  },
  "metadata": {
    "model": "EV Sedan",
    "source": "live"
  },
  "state": {
    "batteryLevel": 64,
    "range": 184,
    "plugged": true,
    "charging": true,
    "fullyCharged": false,
    "batteryCapacity": 75,
    "chargeLimit": 80,
    "chargeRate": 7,
    "chargeTimeRemaining": 110,
    "maxCurrent": 32
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.amps.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
deviceId
string
required

The unique identifier for the vehicle device

Example:

"device_abc123"

Query Parameters

​
expedite
boolean

Use expedite cache with 1 minute TTL instead of normal 15 minute TTL

Example:

false

Response

Vehicle state retrieved successfully

​
id
string
required

Unique identifier for the vehicle device.

​
vendor
string
required

OEM display name (e.g. tesla, rivian).

​
sync
object
required
​
metadata
object
required
​
state
object
required