---
title: "List public bans for a user"
method: GET
path: "/users/{userId}/bans"
tags: ["Users"]
---

# List public bans for a user

`GET /users/{userId}/bans`

Returns the user's active ban, total past ban count, and a paginated history of public bans. Use cursor + limit for paging.

## Path parameters

- `userId` string, required — User id or handle.

## Query parameters

- `limit` integer — Number of history entries to return (1-50).
- `cursor` integer — Offset from a previous nextCursor, or 0 for the first page.

## Response `200`

OK

- object
  - `active` object, nullable, required
    - `id` integer, required
    - `scope` string, required
    - `severity` string, required
    - `reasonShort` string, required
  - `pastCount` integer, required
  - `history` object[], required
    - `id` integer, required
    - `scope` string, required
    - `severity` string, required
    - `reasonShort` string, required
    - `active` boolean, required
    - `createdAt` string, date-time, required
    - `expiresAt` string, date-time, nullable, required
  - `nextCursor` number, nullable, 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)