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 <your_access_token>" \
  -H "Brand: hyundai"

Header Params

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

Path Params

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
└─ status	string	Engine ignition status (on, off, invalid)
└─ ignitionDetails	array	Detailed engine ignition status information
└────── type	string	Vehicle electric power type - ign1: ignition - ign3: ignition for high voltage system - acc: accessory mode
└────── 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
└─ value	number	Mileage value of a vehicle (range: 0~16777214)
└─ unit	string	Unit of mileage of a vehicle (km, mile, meter, feet, invalid)
transmission	object	Transmission information
└─ 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.