members_get_ban
members_get_ban
Section titled “members_get_ban”Category: members
Look up a single ban entry by user ID.
When to use
Section titled “When to use”- Confirm whether a user is currently banned and why.
When NOT to use
Section titled “When NOT to use”| Field | Type | Required | Description |
|---|---|---|---|
guild_id | string | yes | Guild to inspect |
user_id | string | yes | User to look up |
Returns
Section titled “Returns”\{user_id, username, reason\}. Discord returns 404 if not banned.
Output schema
Section titled “Output schema”| Field | Type | Required | Description |
|---|---|---|---|
user_id | string | yes | Discord user ID |
username | string | yes | |
reason | unknown | yes |
Annotations
Section titled “Annotations”| Property | Value |
|---|---|
| Read-only | yes |
| Destructive | no |
| Idempotent | yes |
| Open-world | yes |
| Confirmation required | no |