Get Vehicle Operation Status

Description

Retrieve personal vehicle operation status, including engine start status, cumulative mileage, and parking status.

Endpoint

GET https://api.pleos.ai/v1/vehicles/{vin}/driving

Request

curl

curl -X GET "https://api.pleos.ai/v1/vehicles/{vin}/driving" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Brand: hyundai"

Header

Parameter	Type	Description	Required
Authorization	string	Access token	Required
Brand	string	Vehicle brand (hyundai/kia/genesis)	Required

Path Parameters

Parameter	Type	Description	Required
vin	string	VIN	Required

Response

Success

200

{
  "data": {
    "ignition": {
      "status": "on",
      "ignitionDetails": [
        {
          "type": "ign1",
          "status": "on"
        },
        {
          "type": "ign3",
          "status": "on"
        },
        {
          "type": "acc",
          "status": "on"
        }
      ]
    },
    "sleepMode": "off",
    "odometer": {
      "value": 6549.2,
      "unit": "km"
    },
    "transmission": {
      "parkingPosition": false
    },
    "timestamp": "2025-09-01T09:10:00Z"
  },
  "meta": {
    "code": 200,
    "message": "Success",
    "success": "true",
    "timestamp": "2025-09-01T11:00:00Z",
    "requestId": "835bdbd4-1105-4a8c-b438-a1b2c3d4f5g6"
  }
}

data field	Type	Description
ignition	object	Engine ignition status information
ignition.status	string	Engine ignition status (on, off, invalid)
ignition.ignitionDetails	array	Detailed engine ignition status information
ignition.ignitionDetails.type	string	Vehicle electric power type - ign1: ignition - ign3: ignition for high voltage system - acc: accessory mode
ignition.ignitionDetails.status	string	Vehicle electric power status (on, off, invalid)
sleepMode	string	Sleep mode status of the vehicle (on, off, invalid)
odometer	object	Mileage information of the vehicle
odometer.value	number	Mileage value of a vehicle (range: 0~16777214)
odometer.unit	string	Unit of mileage of a vehicle (km, mile, meter, feet, invalid)
transmission	object	Transmission information
transmission.parkingPosition	boolean	Whether transmission is in parking position
timestamp	string	Timestamp when data was transmitted from the vehicle (based on UTC+0) yyyy-MM-dd'T'HH:mm:ss'Z'

Failure

4002

{
  "error": {
    "code": "4002",
    "message": "Invalid request parameters",
    "details": [],
    "timestamp": "2025-09-01T12:00:00Z",
    "requestId": "835bdbd4-1105-4a8c-b438-a1b2c3d4f5g6"
  }
}

[Error Code]

For detailed explanation of error code on failure, refer to Error Code.