---
title: "Batch get users"
method: GET
path: "/users/batch"
tags: ["Users"]
---

# Batch get users

`GET /users/batch`

Fetch up to 50 public user profiles at once by id, handle, or SteamID64. Missing ids are silently omitted. Each profile includes steamId when linked.

## Query parameters

- `ids` string[], required — User ids, handles, or SteamID64s to fetch (max 50).

## Response `200`

OK

- object
  - `users` object[], required
    - `id` string, required
    - `webId` integer, required
    - `handle` string, nullable, required
    - `name` string, required
    - `image` string, nullable, required
    - `steamId` string, nullable, required
    - `createdAt` string, date-time, required
    - `vtc` object, nullable, required
      - `id` integer, required
      - `name` string, required
      - `handle` string, nullable, required
      - `role` string, required
      - `joinedAt` string, date-time, required
    - `staffRoles` object[], required
      - `name` string, required
      - `color` string, nullable, required
    - `social` object, nullable, required
      - `youtube` string, nullable, required
      - `youtubeChannelName` string, nullable, required
      - `twitch` string, nullable, required
      - `twitter` string, nullable, required
      - `worldOfTrucks` string, nullable, required
      - `medal` string, nullable, required
      - `tiktok` string, nullable, required
    - `gameStatus` object, nullable, required
      - `server` string, required
      - `gameId` integer, required
      - `near` string, required

---

[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/5212ba63601d?raw)
