---
title: "Returns the latest player bans."
method: GET
path: "/bans"
tags: ["Player Bans"]
---

# Returns the latest player bans.

`GET /bans`

## Query parameters

- `player` union
  - string
  - string — a SteamID
- `banned_by` string, u-int64 — a 64-bit SteamID
- `reason` 'macro' | 'auto-bhop' | 'auto-strafe'
- `limit` integer
- `offset` integer

## Response `200`

- PaginatedBan
  - `total` integer, required — The total number of values available for fetching. Different endpoints have different hard-limits on how many values they will return at a time. They usually also have an `offset` query parameter you can use to fetch the next set of values. You can use `total` to infer when you can stop making requests.
  - `values` object[], required — The values returned for this request.
    - `id` integer, required
    - `player` PlayerInfo, required
      - `id` string, required — a SteamID
      - `name` string, required — The player's name on Steam.
    - `banned_by` union, required
      - object — The ban was issued by the Anti-Cheat on a CS2 server.
        - `id` integer, required — The ban was issued by the Anti-Cheat on a CS2 server.
        - `type` 'server', required
      - object — The ban was issued by an admin.
        - `id` string, u-int64, required — a 64-bit SteamID
        - `type` 'admin', required
    - `reason` 'macro' | 'auto-bhop' | 'auto-strafe', required
    - `unban` Unban
      - `admin_id` string, u-int64, required — a 64-bit SteamID
      - `reason` string, required
      - `created_at` string, date-time, required — a UTC timestamp
    - `created_at` string, date-time, required — a UTC timestamp

## Other responses

- `400` — invalid query parameters

---

[API](https://skmtc.dev/cs2kz/apis/cs2kz-api.md) · [All operations](https://skmtc.dev/cs2kz/apis/cs2kz-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cs2kz/cs2kz-api/revisions/73ecd7bbda3b/schema)