Coach Jobs — Integrations

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.

PropertyTypeDescription
objectstringAlways event, for example "event".
typestringbus_job.completed or bus_job.cancelled, for example "bus_job.completed".
data.objectobjectThe Coach Job.
json
{
  "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.

json
{
  "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

PropertyTypeDescription
idint or nullTrackSim job ID, for example 48211.
uuidstringJob UUID generated by the tracker; unique per job, for example "6f0c1d2e-…".
objectstringAlways job.
driverobjectDriver and client details, with the same object shape as Car Jobs.
driver.idint or nullTrackSim driver ID, filled in when the webhook is sent.
driver.steam_idintDriver's Steam ID, for example 76561198000000000.
driver.usernamestringSteam name, for example "Driver".
driver.profile_photo_urlstring or nullDriver profile image URL, filled in when the webhook is sent.
driver.client.version.namestringTracker version, for example "2.2.1".
driver.client.version.branch_namestring or nullTracker branch, filled in when the webhook is sent.
driver.client.version.platformstringTracker platform, for example "windows".
driver.last_activestring or nullLast-active time, filled in when the webhook is sent.
start_timeintWhen the job was accepted, Unix time in seconds (UTC), for example 1794506819.
stop_timeintWhen it was completed or cancelled, Unix time in seconds (UTC), for example 1794508031.
time_spentintReal time on the job in seconds (stop_time - start_time), for example 1212.
driven_distancefloatDistance driven during the job in km, two decimals, for example 15.25.
planned_distanceintRoute length the game planned, in km, for example 166.
is_latebooleantrue when the coach reached the final stop after its planned arrival time. false for cancelled jobs.
marketstringWhere the job came from: quick_job, company_job or tourist_job.
game.namestringGame name, for example "Euro Truck Simulator 2".
game.config.police_enabledbooleanPolice enabled in the game settings, for example true.
game.multiplayerobjectMultiplayer mode and metadata, with the same object shape as Car Jobs.
game.multiplayer.modestringMultiplayer mode, for example "single_player".
game.multiplayer.metaobjectMultiplayer metadata, for example {}.
game.modsarrayActive mods, with the same shape as the Truck Job mods payload.
busobjectThe coach driven. See Bus object.
source.city.id / source.city.namestringFirst 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.namestringFinal stop, for example "kassel" / "Kassel".
stopsobjectStages, punctuality and passengers. See Stops object.
passengers_plannedintTotal passengers planned to board over the whole route, the sum of entering_planned, for example 98.
satisfactionobjectPassenger satisfaction. See Satisfaction and g-force.
gforceobjectPeak g-force during the job. See Satisfaction and g-force.
eventsarrayIn-game events in time order. See the Coach Job Event Reference.

#Bus object

bus replaces truck (Truck Jobs) and car (Car Jobs).

PropertyTypeDescription
idstringCoach unique ID, for example "vehicle.volvo.9700_23".
namestringCoach model name, for example "9700".
brand.idstring or nullBrand ID, for example "volvo".
brand.namestring or nullBrand name, for example "Volvo".
initial_odometerintOdometer at job start, km, for example 48210.
odometerintOdometer at job end, km, for example 48225.
average_speedfloatAverage speed while driving, m/s, two decimals, for example 12.78.
top_speedfloatTop speed, m/s, two decimals, for example 27.22.
wheel_countintNumber of wheels, for example 6.
fuel_usedfloatFuel used during the job, litres, two decimals, for example 4.88.
license_plate.textstringPlate text, for example "MA OM 930".
license_plate.country.idstringPlate country ID, for example "germany".
license_plate.country.namestringPlate country name, for example "Germany".
current_damageobjectWear at job end per part, 0–1: cabin, chassis, engine, transmission, wheels (float each).
total_damageobjectWear 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.

PropertyTypeDescription
plannedintNumber of stages (legs) in the route, for example 2.
completedintStages whose destination was reached. Lower than planned on a cancelled job.
on_timeintStages that arrived at or before their planned arrival time, for example 1.
lateintStages that arrived after their planned arrival time, for example 1.
itemsarrayOne object per stage, in route order.
items[].indexintStage number, starting at 0.
items[].driven_distancefloat or nullDistance 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[].destinationobjectStop the stage leaves from or goes to: id (string), name (string), type (string).
items[].source.typestringcity for a city bus stop; on tourist jobs the sight's photo-album category, for example viewpoints.
items[].departure.plannedintPlanned departure, in-game minutes, for example 18253900.
items[].departure.actualint or nullActual departure, in-game minutes; null if the coach never left this stop.
items[].departure.delay_minutesint or nullactual − planned in in-game minutes; negative means early.
items[].arrival.plannedintPlanned arrival, in-game minutes, for example 18253955.
items[].arrival.actualint or nullActual arrival; null if the stage was not reached.
items[].arrival.delay_minutesint or nullactual − planned in in-game minutes; negative means early.
items[].arrival.on_timeboolean or nulltrue when delay_minutes ≤ 0; null if not reached.
items[].passengers.entering_plannedintPassengers planned to board at the source stop, for example 45.
items[].passengers.leaving_plannedintPassengers 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

PropertyTypeDescription
satisfaction.finalfloat or nullFinal passenger satisfaction, 0–1, as reported by the game when the job completed (4 decimals). null for cancelled jobs.
satisfaction.rating_levelint or nullRating shown on the game's end screen, derived from final. null for cancelled jobs.
satisfaction.startfloat or nullSatisfaction when the job started, the first passengers' starting mood, 0–1.
rating_levelfinal fromIn-game rating
00.86Flawless
10.72Great
20.58Reliable
30.43Average
40.29Subpar
50.15Poor
60.00Unprofessional

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.

PropertyTypeDescription
gforce.max_lateral_gfloatHighest sideways (cornering) g, for example 0.0.
gforce.max_braking_gfloatHighest braking g, for example 3.555.
gforce.max_acceleration_gfloatHighest forward acceleration g, for example 0.0.
gforce.max_vertical_gfloatHighest 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

Coach Job payloads have no cargo, trailers, company or customer_priorities fields.