Coach Job Webhook Payload Reference
Process the Coaches DLC Coach Job payload.
Coach Jobs use your existing TrackSim webhooks. You do not need to create a separate webhook URL for this job type. See the global Using Webhooks and Webhook Signing and Delivery guides for configuration and delivery behaviour.
The documentation and Portal call this a Coach Job. Payload identifiers use bus_job, and the vehicle is returned in the bus object.
#Payload structure
The payload uses the standard TrackSim event envelope.
| Property | Type | Description |
|---|---|---|
object | string | Always event, for example "event". |
type | string | bus_job.completed or bus_job.cancelled, for example "bus_job.completed". |
data.object | object | The Coach Job. |
{
"object": "event",
"type": "bus_job.completed",
"data": {
"object": {
"id": null,
"uuid": "6f0c1d2e-5b7a-4c3e-9a51-2d8e7b4f9c10",
"object": "job",
"driver": {
"id": null,
"steam_id": 76561198000000000,
"username": "Driver",
"profile_photo_url": null,
"client": {
"version": {
"name": "2.2.1",
"branch_name": null,
"platform": "windows"
}
},
"last_active": null
},
"start_time": 1794506819,
"stop_time": 1794508031,
"time_spent": 1212,
"driven_distance": 15.25,
"planned_distance": 166,
"is_late": true,
"market": "quick_job",
"game": {
"name": "Euro Truck Simulator 2",
"config": {
"police_enabled": true
},
"multiplayer": {
"mode": "single_player",
"meta": {}
},
"mods": []
},
"bus": {
"id": "vehicle.volvo.9700_23",
"name": "9700",
"brand": {
"id": "volvo",
"name": "Volvo"
},
"initial_odometer": 48210,
"odometer": 48225,
"average_speed": 12.78,
"top_speed": 27.22,
"wheel_count": 6,
"fuel_used": 4.88,
"license_plate": {
"country": {
"id": "germany",
"name": "Germany"
},
"text": "MA OM 930"
},
"current_damage": {
"cabin": 0.0,
"chassis": 0.0,
"engine": 0.0,
"transmission": 0.0,
"wheels": 0.0
},
"total_damage": {
"cabin": 0.0,
"chassis": 0.0,
"engine": 0.0,
"transmission": 0.0,
"wheels": 0.0
}
},
"source": {
"city": {
"id": "duisburg",
"name": "Duisburg"
}
},
"destination": {
"city": {
"id": "kassel",
"name": "Kassel"
}
},
"stops": {
"planned": 2,
"completed": 2,
"on_time": 1,
"late": 1,
"items": [
{
"index": 0,
"driven_distance": 5.125,
"source": {
"id": "duisburg",
"name": "Duisburg",
"type": "city"
},
"destination": {
"id": "dortmund",
"name": "Dortmund",
"type": "city"
},
"departure": {
"planned": 18253900,
"actual": 18253900,
"delay_minutes": 0
},
"arrival": {
"planned": 18253955,
"actual": 18253928,
"delay_minutes": -27,
"on_time": true
},
"passengers": {
"entering_planned": 45,
"leaving_planned": 30
}
},
{
"index": 1,
"driven_distance": 10.125,
"source": {
"id": "dortmund",
"name": "Dortmund",
"type": "city"
},
"destination": {
"id": "kassel",
"name": "Kassel",
"type": "city"
},
"departure": {
"planned": 18253970,
"actual": 18253970,
"delay_minutes": 0
},
"arrival": {
"planned": 18254150,
"actual": 18254170,
"delay_minutes": 20,
"on_time": false
},
"passengers": {
"entering_planned": 53,
"leaving_planned": 68
}
}
]
},
"passengers_planned": 98,
"satisfaction": {
"final": 0.383,
"rating_level": 4,
"start": 0.6363
},
"gforce": {
"max_lateral_g": 0.0,
"max_braking_g": 3.555,
"max_acceleration_g": 0.0,
"max_vertical_g": 0.0
},
"events": [
{
"type": "bus_job.started",
"real_time": "2026-11-12T18:06:59Z",
"time": 1794506819,
"location": {
"x": -13048.6,
"y": 40.0,
"z": -6169.01
},
"meta": {
"market": "quick_job",
"stages_count": 2
}
},
{
"type": "satisfaction_decrease",
"real_time": "2026-11-12T18:11:04Z",
"time": 1794507064,
"location": {
"x": -12899.01,
"y": 40.0,
"z": -6141.89
},
"meta": {
"reason": "severe_acceleration",
"change": -58.6,
"before": 0.6363,
"after": 0.0503,
"expected_min": -60.0,
"expected_max": -90.0,
"fit": "close",
"direction": "braking",
"peak_ms2": 13.32,
"at_stop": false,
"game_time": 18253901,
"speed_kmh": 1.2,
"other_reasons": "crash"
}
},
{
"type": "fine",
"real_time": "2026-11-12T18:20:49Z",
"time": 1794507649,
"location": {
"x": -11701.87,
"y": 40.0,
"z": -6831.99
},
"meta": {
"offence": "red_signal",
"amount": 360
}
},
{
"type": "satisfaction_decrease",
"real_time": "2026-11-12T18:20:50Z",
"time": 1794507650,
"location": {
"x": -11694.80,
"y": 40.0,
"z": -6828.67
},
"meta": {
"reason": "offence",
"change": -13.6,
"before": 0.6382,
"after": 0.5024,
"expected_min": -10.0,
"expected_max": -20.0,
"fit": "matches",
"fines": 1,
"at_stop": false,
"game_time": 18253972,
"speed_kmh": 32.1
}
},
{
"type": "satisfaction_increase",
"real_time": "2026-11-12T18:19:42Z",
"time": 1794507582,
"location": {
"x": -11836.93,
"y": 40.0,
"z": -6771.07
},
"meta": {
"reason": "passengers_changed",
"change": 63.8,
"before": 0.0,
"after": 0.6382,
"at_stop": true,
"game_time": 18253936,
"speed_kmh": 12.6,
"other_reasons": "on_time_arrival"
}
},
{
"type": "satisfaction_decrease",
"real_time": "2026-11-12T18:27:11Z",
"time": 1794508031,
"location": {
"x": -3202.13,
"y": 40.0,
"z": -3171.09
},
"meta": {
"reason": "late_arrival",
"change": -11.9,
"before": 0.5024,
"after": 0.383,
"expected_min": -5.0,
"expected_max": -13.0,
"fit": "matches",
"delay_minutes": 20,
"at_stop": true,
"source": "completed_event",
"game_time": 18254170
}
},
{
"type": "bus_job.completed",
"real_time": "2026-11-12T18:27:11Z",
"time": 1794508031,
"location": {
"x": -3202.13,
"y": 40.0,
"z": -3171.09
},
"meta": {
"revenue": 3090,
"earned.xp": 0,
"passenger.satisfaction": 0.383029,
"distance.km": 29.0,
"delivery.time": 270
}
}
]
}
}
}The real payload contains every event in time order; this example is shortened to one of each kind.
The id, driver profile fields (id, profile_photo_url, last_active) and client.version.branch_name are filled in by TrackSim when the webhook is sent, not by the tracker.
Cancelled jobs use the same payload shape. satisfaction.final and rating_level are null, is_late is false, stops.completed is lower than stops.planned, and unreached stages have arrival.actual, arrival.delay_minutes and arrival.on_time set to null. The last event is bus_job.cancelled with meta.penalty.
On bus_job.completed, these fields are never null: every stage has a departure and an arrival, and satisfaction.final and rating_level are set.
{
"object": "event",
"type": "bus_job.cancelled",
"data": {
"object": {
"satisfaction": {
"final": null,
"rating_level": null,
"start": 0.6363
},
"stops": {
"planned": 2,
"completed": 1,
"items": [
{
"arrival": {
"planned": 18254150,
"actual": null,
"delay_minutes": null,
"on_time": null
}
}
]
},
"events": [
{
"type": "bus_job.cancelled",
"meta": {
"penalty": 0
}
}
]
}
}
}#Coach Job fields
| Property | Type | Description |
|---|---|---|
id | int or null | TrackSim job ID, for example 48211. |
uuid | string | Job UUID generated by the tracker; unique per job, for example "6f0c1d2e-…". |
object | string | Always job. |
driver | object | Driver and client details, with the same object shape as Car Jobs. |
driver.id | int or null | TrackSim driver ID, filled in when the webhook is sent. |
driver.steam_id | int | Driver's Steam ID, for example 76561198000000000. |
driver.username | string | Steam name, for example "Driver". |
driver.profile_photo_url | string or null | Driver profile image URL, filled in when the webhook is sent. |
driver.client.version.name | string | Tracker version, for example "2.2.1". |
driver.client.version.branch_name | string or null | Tracker branch, filled in when the webhook is sent. |
driver.client.version.platform | string | Tracker platform, for example "windows". |
driver.last_active | string or null | Last-active time, filled in when the webhook is sent. |
start_time | int | When the job was accepted, Unix time in seconds (UTC), for example 1794506819. |
stop_time | int | When it was completed or cancelled, Unix time in seconds (UTC), for example 1794508031. |
time_spent | int | Real time on the job in seconds (stop_time - start_time), for example 1212. |
driven_distance | float | Distance driven during the job in km, two decimals, for example 15.25. |
planned_distance | int | Route length the game planned, in km, for example 166. |
is_late | boolean | true when the coach reached the final stop after its planned arrival time. false for cancelled jobs. |
market | string | Where the job came from: quick_job, company_job or tourist_job. |
game.name | string | Game name, for example "Euro Truck Simulator 2". |
game.config.police_enabled | boolean | Police enabled in the game settings, for example true. |
game.multiplayer | object | Multiplayer mode and metadata, with the same object shape as Car Jobs. |
game.multiplayer.mode | string | Multiplayer mode, for example "single_player". |
game.multiplayer.meta | object | Multiplayer metadata, for example {}. |
game.mods | array | Active mods, with the same shape as the Truck Job mods payload. |
bus | object | The coach driven. See Bus object. |
source.city.id / source.city.name | string | First stop, where passengers first board, for example "duisburg" / "Duisburg". On tourist jobs this can be a sight, not a city. |
destination.city.id / destination.city.name | string | Final stop, for example "kassel" / "Kassel". |
stops | object | Stages, punctuality and passengers. See Stops object. |
passengers_planned | int | Total passengers planned to board over the whole route, the sum of entering_planned, for example 98. |
satisfaction | object | Passenger satisfaction. See Satisfaction and g-force. |
gforce | object | Peak g-force during the job. See Satisfaction and g-force. |
events | array | In-game events in time order. See the Coach Job Event Reference. |
#Bus object
bus replaces truck (Truck Jobs) and car (Car Jobs).
| Property | Type | Description |
|---|---|---|
id | string | Coach unique ID, for example "vehicle.volvo.9700_23". |
name | string | Coach model name, for example "9700". |
brand.id | string or null | Brand ID, for example "volvo". |
brand.name | string or null | Brand name, for example "Volvo". |
initial_odometer | int | Odometer at job start, km, for example 48210. |
odometer | int | Odometer at job end, km, for example 48225. |
average_speed | float | Average speed while driving, m/s, two decimals, for example 12.78. |
top_speed | float | Top speed, m/s, two decimals, for example 27.22. |
wheel_count | int | Number of wheels, for example 6. |
fuel_used | float | Fuel used during the job, litres, two decimals, for example 4.88. |
license_plate.text | string | Plate text, for example "MA OM 930". |
license_plate.country.id | string | Plate country ID, for example "germany". |
license_plate.country.name | string | Plate country name, for example "Germany". |
current_damage | object | Wear at job end per part, 0–1: cabin, chassis, engine, transmission, wheels (float each). |
total_damage | object | Wear added during the job per part, 0–1, using the same keys. |
#Stops object
Use stops.items[].driven_distance to get the distance driven between stops. Each value covers one stage; it is not a cumulative distance for the route. Unlike the job-level driven_distance, stage distances are not rounded to two decimal places.
A coach route is a list of stages. Each stage is one leg from a stop to the next stop. Passengers board at a stage's source and leave at its destination. A route with 3 stops has 2 stages. All times in a stage are in-game time in minutes (the game clock), not real time.
| Property | Type | Description |
|---|---|---|
planned | int | Number of stages (legs) in the route, for example 2. |
completed | int | Stages whose destination was reached. Lower than planned on a cancelled job. |
on_time | int | Stages that arrived at or before their planned arrival time, for example 1. |
late | int | Stages that arrived after their planned arrival time, for example 1. |
items | array | One object per stage, in route order. |
items[].index | int | Stage number, starting at 0. |
items[].driven_distance | float or null | Distance driven from this stage's source stop to its destination stop in km, for example 5.125. Preserves the precision supplied by the tracker. null when the tracker did not report a distance for the stage. |
items[].source / items[].destination | object | Stop the stage leaves from or goes to: id (string), name (string), type (string). |
items[].source.type | string | city for a city bus stop; on tourist jobs the sight's photo-album category, for example viewpoints. |
items[].departure.planned | int | Planned departure, in-game minutes, for example 18253900. |
items[].departure.actual | int or null | Actual departure, in-game minutes; null if the coach never left this stop. |
items[].departure.delay_minutes | int or null | actual − planned in in-game minutes; negative means early. |
items[].arrival.planned | int | Planned arrival, in-game minutes, for example 18253955. |
items[].arrival.actual | int or null | Actual arrival; null if the stage was not reached. |
items[].arrival.delay_minutes | int or null | actual − planned in in-game minutes; negative means early. |
items[].arrival.on_time | boolean or null | true when delay_minutes ≤ 0; null if not reached. |
items[].passengers.entering_planned | int | Passengers planned to board at the source stop, for example 45. |
items[].passengers.leaving_planned | int | Passengers planned to leave at the destination stop, for example 30. |
The game only penalises passenger satisfaction for arrivals more than 15 in-game minutes late, but on_time and late use the planned time exactly.
#Satisfaction and g-force
| Property | Type | Description |
|---|---|---|
satisfaction.final | float or null | Final passenger satisfaction, 0–1, as reported by the game when the job completed (4 decimals). null for cancelled jobs. |
satisfaction.rating_level | int or null | Rating shown on the game's end screen, derived from final. null for cancelled jobs. |
satisfaction.start | float or null | Satisfaction when the job started, the first passengers' starting mood, 0–1. |
rating_level | final from | In-game rating |
|---|---|---|
0 | 0.86 | Flawless |
1 | 0.72 | Great |
2 | 0.58 | Reliable |
3 | 0.43 | Average |
4 | 0.29 | Subpar |
5 | 0.15 | Poor |
6 | 0.00 | Unprofessional |
The g-force values are peaks over the whole job, in g where 1 g = 9.80665 m/s², to 3 decimals. They are measured on the coach and smoothed over 0.1 s.
| Property | Type | Description |
|---|---|---|
gforce.max_lateral_g | float | Highest sideways (cornering) g, for example 0.0. |
gforce.max_braking_g | float | Highest braking g, for example 3.555. |
gforce.max_acceleration_g | float | Highest forward acceleration g, for example 0.0. |
gforce.max_vertical_g | float | Highest vertical g (bumps), excluding gravity, for example 0.0. |
Passengers get annoyed above 0.61 g (6 m/s²) on any axis, and lose a large share of satisfaction above 1.12 g (11 m/s²) braking or accelerating. The job fails above 2.24 g (22 m/s²). The in-game G-force meter turns orange at half the limit and red over it.
#Events and mods
events— see the Coach Job Event Reference.game.mods— same as the Truck Job Mods Payload.
Coach Job payloads have no cargo, trailers, company or customer_priorities fields.