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 <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

Query Params

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