Coach Jobs — Integrations

Coach Job Webhook Event Reference

Enable Coach Job webhook events and reference the in-game events included in their payloads.

Coach Jobs use your existing TrackSim webhook configuration. The documentation and Portal call this a Coach Job; event identifiers use bus_job.

#Enable Coach Job webhook events

Edit an existing webhook in the TrackSim Portal and enable the events you want to receive:

  • Coach Job Completed
  • Coach Job Cancelled

The top-level type can only be bus_job.completed or bus_job.cancelled. The nested events array is separate and records everything that happened during the job.

For bus_job.cancelled, 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.

#Event Payload

json
{
  "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 }
}
PropertyTypeDescription
typestringEvent type documented below.
real_timestringWhen it happened, ISO 8601 UTC.
timeintThe same moment, Unix seconds.
locationobjectWorld position x, y, z (float), in game units.
metaobjectEvent-specific values; numbers and booleans keep their JSON type.

#Event types

#Coach Job Started

Type: bus_job.started

This event is recorded when the Coach Job is accepted. Its location is the coach's position at the first stop; for quick jobs, this is where the coach first moves.

Meta example

json
{ "market": "quick_job", "stages_count": 2 }

Meta Properties

PropertyTypeDescription
marketstringquick_job, company_job or tourist_job.
stages_countintNumber of stages (legs) in the route.

#Coach Job Completed

Type: bus_job.completed

This event is recorded when the coach reaches the final stop and the game completes the job. It is the last event of a completed job, after the final satisfaction_decrease or satisfaction_increase. The keys are the game's own names and contain dots.

Meta example

json
{ "revenue": 3090, "earned.xp": 0, "passenger.satisfaction": 0.383029, "distance.km": 29.0, "delivery.time": 270 }

Meta Properties

PropertyTypeDescription
revenueintMoney earned, in Euros in ETS2.
earned.xpintXP earned.
passenger.satisfactionfloatFinal satisfaction 0–1, unrounded; satisfaction.final is the rounded copy.
distance.kmfloatDistance the game counted for the job, km.
delivery.timeintIn-game minutes the job took.

#Coach Job Cancelled

Type: bus_job.cancelled

This event is recorded when the player cancels the job. It is the last event of a cancelled job.

Meta example

json
{ "penalty": 0 }

Meta Properties

PropertyTypeDescription
penaltyintCancellation penalty in Euros. A default value of 0 is used when there is no penalty or the game does not provide one.

#Satisfaction Decrease

Type: satisfaction_decrease

This event is recorded when the passengers' average satisfaction drops. The game does not state why; TrackSim determines the most likely reason from what happened just before and checks it against the game's satisfaction rules.

#Satisfaction Increase

Type: satisfaction_increase

This event is recorded when passenger satisfaction rises because of a reward or new passengers boarding at a stop.

Both satisfaction event types use the following metadata. Conditional keys only appear in the circumstances shown.

Meta Properties

PropertyTypeWhenDescriptionExample
reasonstringalwaysMost likely reason, from the lists below."offence"
changefloatalwaysChange in percentage points, 1 decimal; negative for decreases.-13.6
beforefloatalwaysSatisfaction before, 0–1.0.6382
afterfloatalwaysSatisfaction after, 0–1.0.5024
at_stopbooleanalwaystrue when it happened at a bus stop.false
expected_min / expected_maxfloatgame-rule reasonsThe game's range for that reason, percentage points, negative for decreases.-10.0 / -20.0
fitstringgame-rule reasonsHow well change fits that range: matches, close (within 5 points) or outside. Near 0% or 100%, the change is capped and can be smaller than the range."matches"
other_reasonsstringwhen more than one fittedOther possible reasons, comma separated."crash"
game_timeintwhen knownIn-game minutes.18253972
speed_kmhfloatwhen knownCoach speed, km/h.32.1
speed_limit_kmhfloatwhen knownPosted speed limit, km/h.50
sourcestringfinal stop onlycompleted_event means the change comes from the game's final score at the last stop, where the in-game display resets to 100%."completed_event"
directionstringsevere_accelerationbraking or accelerating."braking"
peak_ms2floatsevere_acceleration, harsh_*Peak acceleration, m/s².13.32
wear_increasefloatcrashWear added, 0–1.0.04644
damage_tierintcrash1 (≥ 0.01 wear) or 2 (≥ 0.05).1
finesintoffenceFines in the window.1
seconds_at_or_above_kmhfloatspeedingSeconds at or above trigger_kmh.6.2
trigger_kmhfloatspeedingSpeed the game penalises, 130 km/h.130
max_speed_kmhfloatspeedingHighest speed in the window.134.0
max_over_limit_kmhfloatover_speed_limitMost km/h over the posted limit.22.5
delay_minutesintlate_arrival, on_time_arrivalArrival delay in in-game minutes; negative means early.20
km_without_penaltyfloatno_penalty_distanceKm driven since the last penalty or reward.30.4

Decrease reasons

ReasonMeaningGame range
severe_accelerationBraking or accelerating over 11 m/s² (1.12 g).−60 to −90%
crashDamage to the coach (wear ≥ 0.01 / ≥ 0.05) or a crash above 6 km/h.−5 to −46%
offencePolice fine.−10 to −20%
speeding130 km/h or more for 5 seconds, not the posted limit.−9 to −18%
harsh_braking / harsh_acceleration / harsh_cornering / harsh_verticalOver 6 m/s² (0.61 g) on that axis.−9 to −18%
late_arrivalArrived more than 15 in-game minutes late.−5 to −13%
over_speed_limitOver the posted limit; informational, not a game rule.—
unknownNothing recorded explains it.—

Increase reasons

ReasonMeaningGame range
no_penalty_distance30 km without a penalty.+6 to +12%
on_time_arrivalArrived on time at a stop.+6 to +18%
no_penalty_stageA whole stage without a penalty.+6 to +12%
passengers_changedPassengers left and boarded at a stop, so the average changed.—
unknownNothing recorded explains it.—

#Fine

Type: fine

This event is recorded when a fine is issued.

Meta Properties

PropertyTypeDescription
offencestringThe offence committed.
amountintFine amount in Euros.

When offence is speeding_camera, the metadata also includes:

PropertyTypeDescription
speed_limitintSpeed limit in km/h.
speedintCoach speed in km/h.

#Tollgate

Type: tollgate

This event is recorded when a tollgate is used.

Meta Properties

PropertyTypeDescription
costintToll cost in Euros.

#Ferry

Type: ferry

This event is recorded when a ferry is used.

Meta Properties

PropertyTypeDescription
costintFerry cost in Euros.
source_idstringStarting location ID.
source_namestringStarting location name in its native language.
target_idstringEnding location ID.
target_namestringEnding location name in its native language.

#Train

Type: train

This event is recorded when a train is used.

Meta Properties

PropertyTypeDescription
costintTrain cost in Euros.
source_idstringStarting location ID.
source_namestringStarting location name in its native language.
target_idstringEnding location ID.
target_namestringEnding location name in its native language.

#Collision

Type: collision

This event is recorded when the driver causes a collision.

Meta Properties

PropertyTypeDescription
wear_enginefloatCoach engine wear.
wear_chassisfloatCoach chassis wear.
wear_transmissionfloatCoach transmission wear.
wear_cabinfloatCoach cabin wear.
wear_wheelsfloatCoach wheel wear.

#Repair

Type: repair

This event is recorded when the coach is repaired. No metadata is available.

#Refuel

Type: refuel

This event is recorded when the coach is refuelled.

Meta Properties

PropertyTypeDescription
amountintRefuelling cost in Euros.

#Teleport

Type: teleport

This event is recorded when a teleport is detected.

Meta Properties

PropertyTypeDescription
from_xfloatOriginal in-game X position.
from_yfloatOriginal in-game Y position.
from_zfloatOriginal in-game Z position.
to_xfloatNew in-game X position.
to_yfloatNew in-game Y position.
to_zfloatNew in-game Z position.

#Speeding

Type: speeding

This event is recorded when the driver is detected speeding.

Meta Properties

PropertyTypeDescription
speed_limitintIn-game speed limit in km/h.
speedfloatCoach speed in km/h.
from_xfloatOriginal in-game X position.
from_yfloatOriginal in-game Y position.
from_zfloatOriginal in-game Z position.
to_xfloatNew in-game X position.
to_yfloatNew in-game Y position.
to_zfloatNew in-game Z position.