---
title: "Get an event's planned route"
method: GET
path: "/events/{eventId}/route"
tags: ["Events"]
---

# Get an event's planned route

`GET /events/{eventId}/route`

## Request

- Base URL: `https://api.trucklinemp.com`
- URL: `https://api.trucklinemp.com/events/{eventId}/route`
- Auth: one of:
  - none
  - HTTP bearer

The convoy route the organizer planned on the live map: its places in order, the line on the map in game metres (encoded polyline at 0.1 m), each leg's distance, and the whole route's distance as the game's route advisor counts it (`km`). 404 unless the event is public and the organizer shows the route to everyone.

## Path parameters

- `eventId` integer, required

## Response `200`

OK

- object
  - `event` object, required
    - `id` integer, required
    - `title` string, required
    - `startAt` string, date-time, required
    - `url` string, required
  - `route` object, required
    - `version` unknown, required
    - `waypoints` object[], required
      - `kind` 'start' | 'stop' | 'via' | 'shape' | 'end', required
      - `x` number, required
      - `z` number, required
      - `name` string, nullable
      - `city` string, nullable
    - `options` object, required
      - `profile` 'fast' | 'balanced' | 'local' | 'short', required
      - `avoidFerries` boolean, required
    - `path` string, required
    - `legs` object[], required
      - `distance` number, required
      - `km` number
      - `ferries` string[]
    - `distance` number, required
    - `km` number
    - `roads` string, required
    - `token` string
    - `crossings` object[]
      - `start` integer, required
      - `end` integer, required
  - `updatedAt` string, date-time, required

## Changes

- **2026-10-03** `99773b315203`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/trucklinemp/apis/trucklinemp-public-api/changes/events/:eventId/route/get.md)

---

[API](https://skmtc.dev/trucklinemp/apis/trucklinemp-public-api.md) - [All operations](https://skmtc.dev/trucklinemp/apis/trucklinemp-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trucklinemp/apis/trucklinemp-public-api/revisions/98fe7178ea0e?raw)
