# 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](/docs/integrations/webhooks) and [Webhook Signing and Delivery](/docs/integrations/webhook-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. |

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

| 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](/docs/coach-jobs/integrations/webhook-events). |

## 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](/docs/coach-jobs/integrations/webhook-events).
- `game.mods` — same as the [Truck Job Mods Payload](/docs/truck-jobs/integrations/webhook-payloads#mods-payload).

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