---
title: "List public bans"
method: GET
path: "/bans"
tags: ["Bans"]
---

# List public bans

`GET /bans`

## Query parameters

- `limit` integer
- `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 bans by reason or banned user's name/handle.
- `scope` 'website' | 'game' | 'event' | 'vtc' — Filter bans by the scope they were issued under.

## Response `200`

OK

- object
  - `items` object[], required
    - `id` integer, required
    - `userHandle` string, nullable, required
    - `userName` string, nullable, required
    - `userImage` string, nullable, required
    - `scope` string, required
    - `severity` string, required
    - `reasonShort` string, required
    - `issuedAt` string, date-time, required
    - `expiresAt` string, date-time, nullable, required
  - `data` object[], required
    - `id` integer, required
    - `userHandle` string, nullable, required
    - `userName` string, nullable, required
    - `userImage` string, nullable, required
    - `scope` string, required
    - `severity` string, required
    - `reasonShort` string, required
    - `issuedAt` string, date-time, required
    - `expiresAt` string, date-time, nullable, required
  - `nextCursor` number, nullable, required
  - `total` integer, required
  - `page` integer, required
  - `pageSize` 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/5212ba63601d?raw)