members_list_bans
members_list_bans
Section titled “members_list_bans”Category: members
List bans in a guild (paginated).
When to use
Section titled “When to use”- Audit moderation history; export ban list.
When NOT to use
Section titled “When NOT to use”| Field | Type | Required | Description |
|---|---|---|---|
guild_id | string | yes | Guild to list bans for |
limit | integer | no | Max bans per page (1-1000, default 1000) |
before | string | no | Pagination cursor: bans with user-id < this |
after | string | no | Pagination cursor: bans with user-id > this |
Returns
Section titled “Returns”\{bans:[\{user_id, username, reason\}], count\}.
Output schema
Section titled “Output schema”| Field | Type | Required | Description |
|---|---|---|---|
bans | array | yes | |
count | integer | yes |
Annotations
Section titled “Annotations”| Property | Value |
|---|---|
| Read-only | yes |
| Destructive | no |
| Idempotent | yes |
| Open-world | yes |
| Confirmation required | no |