---
title: "get simulated vehicle events"
method: GET
path: "/simulator/events"
tags: ["simulator"]
---

# get simulated vehicle events

`GET /simulator/events`

Obtain detailed events from the simulated vehicle in its running state.

## Response `200`

vehicle events

- ModelsVehicleEvent[]
  - `EventID` integer, required
  - `JourneyID` string
  - `AutoID` integer
  - `DriverID` integer
  - `EventCategoryID` integer
  - `automation_level` integer — SAE J3016 automation level.
  - `steering_wheel_angle` number, float
  - `torque_at_transmission` number, float
  - `engine_speed` number, float
  - `vehicle_speed` number, float
  - `accelerator_pedal_position` number, float
  - `parking_brake_status` 'true' | 'false'
  - `brake_pedal_status` 'true' | 'false'
  - `transmission_gear_position` 'first' | 'second' | 'third' | 'fourth' | 'fifth' | 'sixth' | 'seventh' | 'eighth' | 'ninth' | 'tenth' | 'reverse' | 'neutral'
  - `gear_lever_position` 'drive' | 'sport' | 'low' | 'first' | 'second' | 'third' | 'fourth' | 'fifth' | 'sixth' | 'seventh' | 'eighth' | 'ninth' | 'tenth' | 'reverse' | 'neutral'
  - `odometer` number, double
  - `ignition_status` 'off' | 'accessory' | 'run' | 'start'
  - `fuel_level` number, float — percentage fuel remaining level
  - `fuel_consumed_since_restart` number, double — fuel consumed in litres (this goes to 0 every time the vehicle restarts, like a trip meter)
  - `door_status` 'all_locked' | 'all_unlocked' | 'driver' | 'passenger' | 'rear_left' | 'rear_right'
  - `headlamp_status` 'true' | 'false'
  - `high_beam_status` 'true' | 'false'
  - `windshield_wiper_status` 'true' | 'false'
  - `latitude` number, float
  - `longitude` number, float
  - `bearing` number, float
  - `accuracy` number, float
  - `timestamp` string, date-time
  - `accel_x` number, float
  - `accel_y` number, float
  - `accel_z` number, float
  - `gyro_x` number, float
  - `gyro_y` number, float
  - `gyro_z` number, float

## Other responses

- `401` — Access token is missing or invalid

---

[API](https://skmtc.net/knowgoio/apis/knowgo-vehicle-simulator-api.md) · [All operations](https://skmtc.net/knowgoio/apis/knowgo-vehicle-simulator-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/knowgoio/knowgo-vehicle-simulator-api/revisions/c420a5f456ea/schema)