GET /fleet/vehicles/{vehicleId}/status — Get Vehicle Status

Returns the real-time operational status of a single vehicle, including location, connectivity, engine state, fuel/battery level, and door lock state.

Endpoint { .section}

|

Method

||

GET

||

URI Path

||

https://api.connectedcar.io/v1/fleet/vehicles/{vehicleId}/status

||

Auth Scope

||

fleet:read

||

Rate Limit

||

300 requests / minute per tenant

|

Authentication { .section}

Authorization: Bearer {access_token}
X-Tenant-ID: {tenant_id}

Path Parameters { .section}

Parameter	Type	Required	Description
vehicleId	string	Yes	Unique platform vehicle identifier (e.g., veh_X7K2M9P1).

Sample Request { .section}

GET /v1/fleet/vehicles/veh_X7K2M9P1/status HTTP/1.1
Host: api.connectedcar.io
Authorization: Bearer eyJhbGciOiJSUzI1NiJ9...
X-Tenant-ID: tenant_abc123
X-Request-ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890
Accept: application/json

Sample Response — 200 OK { .section}

{
  "status": "success",
  "data": {
    "vehicle_id": "veh_X7K2M9P1",
    "vin": "1HGCM82633A004352",
    "timestamp": "2026-04-30T08:20:15Z",
    "operational_status": "active",
    "engine": {
      "state": "off",
      "runtime_hours": 1842.5,
      "coolant_temp_celsius": 22
    },
    "location": {
      "latitude": 37.7749,
      "longitude": -122.4194,
      "heading_degrees": 275,
      "speed_kmh": 0,
      "altitude_m": 16,
      "address": "Market St, San Francisco, CA, USA",
      "geofence_status": "inside"
    },
    "fuel": {
      "level_percent": 68,
      "range_km": 412,
      "type": "petrol"
    },
    "battery": {
      "voltage_v": 12.7,
      "health_percent": 92,
      "charging": false
    },
    "doors": {
      "locked": true,
      "front_left": "closed",
      "front_right": "closed",
      "rear_left": "closed",
      "rear_right": "closed",
      "trunk": "closed"
    },
    "connectivity": {
      "online": true,
      "signal_type": "5G",
      "signal_strength_dbm": -72,
      "last_heartbeat": "2026-04-30T08:20:10Z"
    },
    "odometer_km": 24315,
    "alerts_active": 0
  },
  "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "timestamp": "2026-04-30T08:20:15Z"
}

Error Codes { .section}

HTTP Status	Error Code	Description	Resolution
404	VEHICLE_NOT_FOUND	No vehicle with the given vehicleId exists in this tenant.	Verify the vehicle ID using the List Vehicles endpoint.
403	INSUFFICIENT_SCOPE	Token missing fleet:read scope.	Re-authorize with correct scope.
503	VEHICLE_OFFLINE	Vehicle TCU is not currently reachable; last known status returned.	Check connectivity.last_heartbeat for staleness context.

Related information

List All Fleet Vehicles

Fleet Group Management