---
title: "GET /guilds/{guild_id}/bans"
method: GET
path: "/guilds/{guild_id}/bans"
---

# GET /guilds/{guild_id}/bans

`GET /guilds/{guild_id}/bans`

## Query parameters

- `limit` integer
- `before` string, snowflake
- `after` string, snowflake

## Response `200`

200 response for list_guild_bans

- GuildBanResponse[], nullable
  - `user` UserResponse, required
    - `id` string, snowflake, required
    - `username` string, required — the user's username, not unique across the platform
    - `avatar` string, nullable, required — the user's avatar hash
    - `discriminator` string, required — the user's Discord-tag
    - `public_flags` integer, required — the public flags on a user's account
    - `flags` integer, required
    - `bot` boolean — whether the user belongs to an OAuth2 application
    - `system` boolean — whether the user is an Official Discord System user (part of the urgent message system)
    - `banner` string, nullable — the user's banner hash
    - `accent_color` integer, nullable — the user's banner color encoded as an integer representation of hexadecimal color code
    - `global_name` string, nullable, required — the user's display name, if it is set
    - `avatar_decoration_data` UserAvatarDecorationResponse
      - `asset` string, required — the avatar decoration hash
      - `sku_id` string, snowflake, required
    - `collectibles` UserCollectiblesResponse
      - `nameplate` UserNameplateResponse, required
        - `sku_id` string, snowflake, required
        - `asset` string, required — Path to the nameplate asset
        - `label` string, required — The label of this nameplate. Currently unused
        - `palette` union, required
          - 'crimson' — Crimson color palette
          - 'berry' — Berry color palette
          - 'sky' — Sky color palette
          - 'teal' — Teal color palette
          - 'forest' — Forest color palette
          - 'bubble_gum' — Bubble gum color palette
          - 'violet' — Violet color palette
          - 'cobalt' — Cobalt color palette
          - 'clover' — Clover color palette
          - 'lemon' — Lemon color palette
          - 'white' — White color palette
          - 'black' — Black color palette
    - `primary_guild` UserPrimaryGuildResponse, required
      - `identity_guild_id` string, snowflake, required
      - `identity_enabled` boolean, nullable, required — whether the user is displaying the primary guild's server tag
      - `tag` string, nullable, required — the text of the user's server tag, limited to 4 characters
      - `badge` string, nullable, required — the server tag badge hash
  - `reason` string, nullable, required

## Other responses

- `429` — Client ratelimited response
- `4XX` — Client error response

## Changes

- **2026-06-05** `693bf1f99bba` — 1 breaking
  - added `subschema #1: CRIMSON, subschema #2: BERRY, subschema #3: SKY, subschema #4: TEAL, subschema #5: FOREST, subschema #6: BUBBLE_GUM, subschema #7: VIOLET, subschema #8: COBALT, subschema #9: CLOVER, subschema #10: LEMON, subschema #11: WHITE, subschema #12: BLACK` to the `items/user/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/palette` response property `oneOf` list for the response status `200`
- **2026-02-04** `e200830e509a` — 11 info
  - the response property `items/reason` became required for the status `200`
  - the response property `items/user/avatar` became required for the status `200`
  - the response property `items/user/avatar_decoration_data/oneOf[#/components/schemas/UserAvatarDecorationResponse]/sku_id` became required for the status `200`
  - the response property `items/user/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate` became required for the status `200`
  - …7 more

[Change history](https://skmtc.dev/discord/apis/discord-http-api-preview/changes/guilds/:guild_id/bans/get.md)

---

[API](https://skmtc.dev/discord/apis/discord-http-api-preview.md) · [All operations](https://skmtc.dev/discord/apis/discord-http-api-preview/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/discord/discord-http-api-preview/revisions/49efa428e0dd/schema)