Get Vehicle Operation Data

Description

Retrieve source data related to personal vehicle operation, including engine start status, cumulative mileage, and parking status.

Endpoint

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

Request

curl

curl -X GET "https://api.pleos.ai/v1/vehicles/{vin}/driving/data?startDate=20250825&endDate=20250901&zoneId=UTC" \
  -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

Query Parameters

Parameter	Type	Description	Required	Default Value
startDate	string	yyyyMMdd	Required	None
endDate	string	yyyyMMdd (Can only retrieve up to 7 days from the start date)	Required	None
zoneId	string	Timezone Id	Optional	UTC

Response

Success

200

{
  "data": {
    "trips": [
      {
        "triggerStartTime": "2025-09-01T10:00:00.000Z",
        "tripLength": 10000,
        "ignition": {
          "status": ["on", "on", "on", "on", "on", "on", "on", "on", "on", "on"]
        },
        "odometer": {
          "value": [50.2, 50.2, 50.2, 50.2, 50.2, 50.2, 50.2, 50.2, 50.2, 50.2]
        },
        "acceleration": {
          "longitudinal": [0, 0, 0, 0, 0, 0, 0, 0, 0, 0]
        },
        "angularVelocity": {
          "yaw": [0, 0, 0, 0, 0, 0, 0, 0, 0, 0]
        },
        "isla": {
          "optionUsm": [
            "off",
            "off",
            "off",
            "off",
            "off",
            "off",
            "off",
            "off",
            "off",
            "off"
          ],
          "optionUsm2": [
            "off",
            "off",
            "off",
            "off",
            "off",
            "off",
            "off",
            "off",
            "off",
            "off"
          ]
        },
        "seatbelt": {
          "assistance": [
            "unbelted",
            "unbelted",
            "unbelted",
            "unbelted",
            "unbelted",
            "unbelted",
            "unbelted",
            "unbelted",
            "unbelted",
            "unbelted"
          ],
          "driver": [
            "belted",
            "belted",
            "belted",
            "belted",
            "belted",
            "belted",
            "belted",
            "belted",
            "belted",
            "belted"
          ]
        },
        "steeringWheel": {
          "angle": [0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
          "rotationSpeed": [0, 0, 0, 0, 0, 0, 0, 0, 0, 0]
        },
        "transmission": {
          "gear": ["p", "p", "p", "p", "p", "p", "p", "p", "p", "p"]
        }
      }
    ]
  },
  "meta": {
    "code": 200,
    "message": "Success",
    "success": "true",
    "timestamp": "2025-09-01T11:00:00Z",
    "requestId": "835bdbd4-1105-4a8c-b438-a1b2c3d4f5g6"
  }
}

data field	Type	Description
trips	array of object	Trip data
trips.triggerStartTime	string	Engine start time yyyy-MM-dd'T'HH:mm:ss.SSS'Z'
trips..tripLength	long	Driving trip length (unit: ms)
trips..ignition	object	Engine Ignition status information
trips..status	array of string	Engine Ignition status (on, off)
trips..odometer	object	Vehicle mileage information
trips..value	array of number	Mileage of a vehicle (unit: km, range: 0~1677721.4)
trips..acceleration	object	Vehicle's longitudinal acceleration data
trips..longitudinal	array of number	Longitudinal acceleration of the vehicle(unit: g, range: -4.177~4.177)
trips..angularVelocity	object	Angular velocity data
trips..yaw	array of number	Speed at which the vehicle rotates about its vertical axis (unit: º/s, range: -40.95~40.95)
trips..isla	object	Driver-configured Intelligent Speed Limit Assist (ISLA) options
trips..optionUsm	array of string	ISLA option USM signal set by driver (none, off, warning, assist, invalid)
trips..optionUsm2	array of string	ISLA option USM 2 signal set by driver (none, off, information, warning, assist, invalid)
trips..seatbelt	object	Seatbelt information
trips..assistance	array of string	Status of seat belt for passenger seat (belted, unbelted)
trips..driver	array of string	Status of seat belt for driver seat (belted, unbelted)
trips..steeringWheel	object	Steering wheel information
trips..angle	array of number	Angle of steering wheel (unit: º, range: -3276.8~3276.7)
trips..rotationSpeed	array of number	Rotation speed of steering wheel(unit: º/s, range: 0~1016)
trips..transmission	object	Transmission information
trips..gear	array of string	Gear status of the vehicle by user - p: park - r: reverse - n: neutral - d: drive

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 descriptions of error code on failure, refer to Error Code.