---
title: "List convoys for the live map"
method: GET
path: "/live-map/convoys"
tags: ["Events"]
---

# List convoys for the live map

`GET /live-map/convoys`

## Request

- Base URL: `https://api.trucklinemp.com`
- URL: `https://api.trucklinemp.com/live-map/convoys`
- Auth: one of:
  - none
  - HTTP bearer

Public ETS2 convoys running now or starting within 24 hours, with departure and arrival. While a convoy runs, `drivers` lists the attendees who show on its public roster. `routeUpdatedAt` is set when the convoy has a public planned route (`GET /events/{eventId}/route`) and changes whenever the organizer saves a new one.

## Response `200`

OK

- object
  - `convoys` object[], required
    - `id` integer, required
    - `name` string, required
    - `organizer` object, nullable, required
      - `name` string, required
      - `handle` string, nullable, required
    - `startAt` string, date-time, required
    - `endAt` string, date-time, required
    - `meetupAt` string, date-time, nullable, required
    - `server` string, nullable, required
    - `departure` object, required
      - `city` string, nullable, required
      - `location` string, nullable, required
    - `arrival` object, required
      - `city` string, nullable, required
      - `location` string, nullable, required
    - `attendeeCount` integer, required
    - `maxAttendees` integer, nullable, required
    - `live` boolean, required
    - `drivers` string[], required: Account ids of attendees who show on the event's public roster, while the convoy is live.
    - `routeUpdatedAt` string, date-time, nullable, required: When the organizer last saved the convoy's public planned route; null when it has none.

## Changes

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

[Operation history](https://skmtc.dev/trucklinemp/apis/trucklinemp-public-api/changes/live-map/convoys/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)
