---
title: "Search users"
method: GET
path: "/users/search"
tags: ["Users"]
---

# Search users

`GET /users/search`

Search by name or handle (minimum 2 characters). Exact SteamID64 queries are supported. Results include public steamId when linked.

## Query parameters

- `limit` integer — Maximum number of users to return (1-50).
- `cursor` integer — Offset-based cursor from a previous response's nextCursor, or 0 to start.
- `offset` integer — Number of items to skip. Alias of cursor.
- `page` integer — 1-indexed page number. Alternative to cursor/offset.
- `pageSize` integer — Alias of limit, used with page.
- `q` string — Search by name or handle (minimum 2 characters). Exact SteamID64 also supported.

## Response `200`

OK

- object
  - `items` object[], required
    - `id` string, required
    - `webId` integer, required
    - `handle` string, nullable, required
    - `name` string, required
    - `image` string, nullable, required
    - `steamId` string, nullable, required
    - `vtcName` string, nullable, required
    - `vtcId` integer, nullable, required
    - `role` string, nullable, required
    - `staffRole` object, nullable, required
      - `name` string, required
      - `color` string, nullable, required
  - `users` object[], required
    - `id` string, required
    - `webId` integer, required
    - `handle` string, nullable, required
    - `name` string, required
    - `image` string, nullable, required
    - `steamId` string, nullable, required
    - `vtcName` string, nullable, required
    - `vtcId` integer, nullable, required
    - `role` string, nullable, required
    - `staffRole` object, nullable, required
      - `name` string, required
      - `color` string, nullable, required
  - `nextCursor` number, nullable, required
  - `total` integer, required
  - `pagination` object, required
    - `totalPages` integer, required
    - `total` integer, 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/880b1f4d531c?raw)