---
title: "Get a user's driving stats"
method: GET
path: "/users/{handleOrId}/game-stats"
tags: ["Users"]
---

# Get a user's driving stats

`GET /users/{handleOrId}/game-stats`

## Request

- Base URL: `https://api.trucklinemp.com`
- URL: `https://api.trucklinemp.com/users/{handleOrId}/game-stats`
- Auth: one of:
  - none
  - HTTP bearer

Time online and driving, distance driven, per-day activity and whether they are online now, as far as the user's own stats visibility allows. Otherwise `visible` is false.

## Path parameters

- `handleOrId` string, required: User id, webId, handle, or SteamID64.

## Response `200`

OK

- object
  - `visible` boolean, required
  - `isOwner` boolean, required
  - `visibility` 'public' | 'followers' | 'private', nullable, required
  - `showOnMap` boolean, nullable, required
  - `stats` object, nullable, required
    - `asOf` string, required
    - `totals` object, required
      - `secondsOnline` integer, required
      - `secondsDriving` integer, required
      - `distanceMeters` integer, required
      - `topSpeedKmh` number
      - `sessions` integer, required
      - `daysActive` integer, required
      - `longestSessionSeconds` integer, required
      - `jobsCompleted` integer, required
      - `jobDistanceKm` integer, required
      - `firstSeenAt` string, nullable, required
      - `lastSeenAt` string, nullable, required
    - `today` object, required
      - `secondsOnline` integer, required
      - `secondsDriving` integer, required
      - `distanceMeters` integer, required
      - `topSpeedKmh` number
    - `streak` object, required
      - `current` integer, required
      - `longest` integer, required
    - `days` object[], required
      - `day` string, required
      - `secondsOnline` integer, required
      - `secondsDriving` integer, required
      - `distanceMeters` integer, required
      - `sessions` integer, required
    - `online` object, nullable, required
      - `since` string, required

## Changes

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

[Operation history](https://skmtc.dev/trucklinemp/apis/trucklinemp-public-api/changes/users/:handleOrId/game-stats/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)
