--- title: "GET /guilds/{guild_id}/audit-logs" method: GET path: "/guilds/{guild_id}/audit-logs" --- # GET /guilds/{guild_id}/audit-logs `GET /guilds/{guild_id}/audit-logs` ## Query parameters - `user_id` string, snowflake - `target_id` string, snowflake - `action_type` union - 1 - 10 - 11 - 12 - 13 - 14 - 15 - 20 - 21 - 22 - 23 - 24 - 25 - 26 - 27 - 28 - 30 - 31 - 32 - 40 - 41 - 42 - 50 - 51 - 52 - 60 - 61 - 62 - 72 - 73 - 74 - 75 - 80 - 81 - 82 - 83 - 84 - 85 - 90 - 91 - 92 - 100 - 101 - 102 - 110 - 111 - 112 - 121 - 130 - 131 - 132 - 140 - 141 - 142 - 143 - 144 - 145 - 146 - 150 - 151 - 163 - 164 - 165 - 166 - 167 - 171 - 172 - 180 - 190 - 191 - 192 - 193 - 200 — Scheduled event exception was created - 201 — Scheduled event exception was updated - 202 — Scheduled event exception was deleted - 211 - `before` string, snowflake - `after` string, snowflake - `limit` integer ## Response `200` 200 response for list_guild_audit_log_entries - GuildAuditLogResponse - `audit_log_entries` AuditLogEntryResponse[], required - `id` string, snowflake, required - `action_type` union, required - 1 - 10 - 11 - 12 - 13 - 14 - 15 - 20 - 21 - 22 - 23 - 24 - 25 - 26 - 27 - 28 - 30 - 31 - 32 - 40 - 41 - 42 - 50 - 51 - 52 - 60 - 61 - 62 - 72 - 73 - 74 - 75 - 80 - 81 - 82 - 83 - 84 - 85 - 90 - 91 - 92 - 100 - 101 - 102 - 110 - 111 - 112 - 121 - 130 - 131 - 132 - 140 - 141 - 142 - 143 - 144 - 145 - 146 - 150 - 151 - 163 - 164 - 165 - 166 - 167 - 171 - 172 - 180 - 190 - 191 - 192 - 193 - 200 — Scheduled event exception was created - 201 — Scheduled event exception was updated - 202 — Scheduled event exception was deleted - 211 - `user_id` string, snowflake, required - `target_id` string, snowflake, required - `changes` AuditLogObjectChangeResponse[] - `key` string, nullable, required - `new_value` unknown - `old_value` unknown - `options` object - `reason` string - `users` 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 - `integrations` union[], required - union - PartialDiscordIntegrationResponse - `id` string, snowflake, required - `type` union, required - 'discord' - 'twitch' - 'youtube' - 'guild_subscription' - `name` string, nullable, required - `account` AccountResponse, required - `id` string, required - `name` string, nullable, required - `application_id` string, snowflake, required - PartialExternalConnectionIntegrationResponse - `id` string, snowflake, required - `type` union, required - 'discord' - 'twitch' - 'youtube' - 'guild_subscription' - `name` string, nullable, required - `account` AccountResponse, required - `id` string, required - `name` string, nullable, required - PartialGuildSubscriptionIntegrationResponse - `id` string, snowflake, required - `type` union, required - 'discord' - 'twitch' - 'youtube' - 'guild_subscription' - `name` string, nullable, required - `account` AccountResponse, required - `id` string, required - `name` string, nullable, required - `webhooks` union[], required - union - ApplicationIncomingWebhookResponse - `application_id` string, snowflake, required - `avatar` string, nullable, required - `channel_id` string, snowflake, required - `guild_id` string, snowflake - `id` string, snowflake, required - `name` string, required - `type` union, required - 1 — Incoming Webhooks can post messages to channels with a generated token - 2 — Channel Follower Webhooks are internal webhooks used with Channel Following to post new messages into channels - 3 — Application webhooks are webhooks used with Interactions - `user` UserResponse - `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 - … - `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 - ChannelFollowerWebhookResponse - `application_id` string, snowflake, required - `avatar` string, nullable, required - `channel_id` string, snowflake, required - `guild_id` string, snowflake - `id` string, snowflake, required - `name` string, required - `type` union, required - 1 — Incoming Webhooks can post messages to channels with a generated token - 2 — Channel Follower Webhooks are internal webhooks used with Channel Following to post new messages into channels - 3 — Application webhooks are webhooks used with Interactions - `user` UserResponse - `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 - … - `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 - `source_guild` WebhookSourceGuildResponse - `id` string, snowflake, required - `icon` string, nullable, required - `name` string, required - `source_channel` WebhookSourceChannelResponse - `id` string, snowflake, required - `name` string, required - GuildIncomingWebhookResponse - `application_id` string, snowflake, required - `avatar` string, nullable, required - `channel_id` string, snowflake, required - `guild_id` string, snowflake - `id` string, snowflake, required - `name` string, required - `type` union, required - 1 — Incoming Webhooks can post messages to channels with a generated token - 2 — Channel Follower Webhooks are internal webhooks used with Channel Following to post new messages into channels - 3 — Application webhooks are webhooks used with Interactions - `user` UserResponse - `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 - … - `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 - `token` string - `url` string, uri - `guild_scheduled_events` union[], required - union - ExternalScheduledEventResponse - `id` string, snowflake, required - `guild_id` string, snowflake, required - `name` string, required — Name of the scheduled event - `description` string, nullable, required — Description of the scheduled event - `channel_id` string, snowflake, required - `creator_id` string, snowflake, required - `creator` UserResponse - `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 - … - `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 - `image` string, nullable, required — Cover image hash of the scheduled event - `scheduled_start_time` string, date-time, required — When the scheduled event will start - `scheduled_end_time` string, date-time, nullable, required — When the scheduled event will end, or null if no end time - `status` union, required - 1 - 2 - 3 - 4 - `entity_type` union, required - 0 - 1 - 2 - 3 - `entity_id` string, snowflake, required - `recurrence_rule` RecurrenceRuleResponse, required - `start` string, date-time, required — Starting time of the recurrence interval - `end` string, date-time, nullable — Ending time of the recurrence interval - `frequency` union, required - 3 - 2 - 1 - 0 - `interval` integer, required — The spacing between events, defined by frequency - `by_weekday` RecurrenceRuleWeekdays[], nullable, required — Set of specific days within a week for the event to recur on - union - … - `by_n_weekday` ByNWeekdayResponse[], nullable, required — List of specific days within a specific week to recur on - `n` integer, required — The week to reoccur on (1-5, where 5 represents the last week) - `day` union, required - … - `by_month` RecurrenceRuleMonths[], nullable, required — Set of specific months to recur on - union - … - `by_month_day` integer[], nullable, required — Set of specific dates within a month to recur on - `by_year_day` integer[], nullable — Set of days within a year to recur on (1-364) - `count` integer, nullable — Total number of times the event is allowed to recur - `user_count` integer — Number of users subscribed to the scheduled event - `privacy_level` 2, required — the scheduled event is only accessible to guild members - `user_rsvp` ScheduledEventUserResponse - `guild_scheduled_event_id` string, snowflake, required - `guild_scheduled_event_exception_id` string, snowflake - `user_id` string, snowflake, required - `user` UserResponse - `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 - … - `collectibles` UserCollectiblesResponse - … - `primary_guild` UserPrimaryGuildResponse, required - … - `member` GuildMemberResponse - `avatar` string, nullable, required — the member's guild avatar hash - `avatar_decoration_data` UserAvatarDecorationResponse - … - `banner` string, nullable, required — the member's guild banner hash - `communication_disabled_until` string, date-time, nullable, required — when the user's timeout will expire and the user will be able to communicate in the guild again, null or a time in the past if the user is not timed out - `flags` integer, required — guild member flags represented as a bit set, defaults to 0 - `joined_at` string, date-time, required — when the user joined the guild - `nick` string, nullable, required — this user's guild nickname - `pending` boolean, required — whether the user has not yet passed the guild's Membership Screening requirements - `premium_since` string, date-time, nullable, required — when the user started boosting the guild - `roles` SnowflakeType[], required — array of role object ids - `collectibles` UserCollectiblesResponse - … - `user` UserResponse, required - … - `mute` boolean, required — whether the user is muted in voice channels - `deaf` boolean, required — whether the user is deafened in voice channels - `response` union, required - 0 — User is not interested in the event - 1 — User is interested in the event - `guild_scheduled_event_exceptions` GuildScheduledEventExceptionResponse[], required - `event_id` string, snowflake, required - `event_exception_id` string, snowflake, required - `scheduled_start_time` string, date-time, nullable, required — Overridden start time of this occurrence - `scheduled_end_time` string, date-time, nullable, required — Overridden end time of this occurrence - `is_canceled` boolean, required — Whether this occurrence is canceled - `entity_metadata` EntityMetadataExternalResponse, required - `location` string, required — Location of the external event - StageScheduledEventResponse - `id` string, snowflake, required - `guild_id` string, snowflake, required - `name` string, required — Name of the scheduled event - `description` string, nullable, required — Description of the scheduled event - `channel_id` string, snowflake, required - `creator_id` string, snowflake, required - `creator` UserResponse - `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 - … - `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 - `image` string, nullable, required — Cover image hash of the scheduled event - `scheduled_start_time` string, date-time, required — When the scheduled event will start - `scheduled_end_time` string, date-time, nullable, required — When the scheduled event will end, or null if no end time - `status` union, required - 1 - 2 - 3 - 4 - `entity_type` union, required - 0 - 1 - 2 - 3 - `entity_id` string, snowflake, required - `recurrence_rule` RecurrenceRuleResponse, required - `start` string, date-time, required — Starting time of the recurrence interval - `end` string, date-time, nullable — Ending time of the recurrence interval - `frequency` union, required - 3 - 2 - 1 - 0 - `interval` integer, required — The spacing between events, defined by frequency - `by_weekday` RecurrenceRuleWeekdays[], nullable, required — Set of specific days within a week for the event to recur on - union - … - `by_n_weekday` ByNWeekdayResponse[], nullable, required — List of specific days within a specific week to recur on - `n` integer, required — The week to reoccur on (1-5, where 5 represents the last week) - `day` union, required - … - `by_month` RecurrenceRuleMonths[], nullable, required — Set of specific months to recur on - union - … - `by_month_day` integer[], nullable, required — Set of specific dates within a month to recur on - `by_year_day` integer[], nullable — Set of days within a year to recur on (1-364) - `count` integer, nullable — Total number of times the event is allowed to recur - `user_count` integer — Number of users subscribed to the scheduled event - `privacy_level` 2, required — the scheduled event is only accessible to guild members - `user_rsvp` ScheduledEventUserResponse - `guild_scheduled_event_id` string, snowflake, required - `guild_scheduled_event_exception_id` string, snowflake - `user_id` string, snowflake, required - `user` UserResponse - `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 - … - `collectibles` UserCollectiblesResponse - … - `primary_guild` UserPrimaryGuildResponse, required - … - `member` GuildMemberResponse - `avatar` string, nullable, required — the member's guild avatar hash - `avatar_decoration_data` UserAvatarDecorationResponse - … - `banner` string, nullable, required — the member's guild banner hash - `communication_disabled_until` string, date-time, nullable, required — when the user's timeout will expire and the user will be able to communicate in the guild again, null or a time in the past if the user is not timed out - `flags` integer, required — guild member flags represented as a bit set, defaults to 0 - `joined_at` string, date-time, required — when the user joined the guild - `nick` string, nullable, required — this user's guild nickname - `pending` boolean, required — whether the user has not yet passed the guild's Membership Screening requirements - `premium_since` string, date-time, nullable, required — when the user started boosting the guild - `roles` SnowflakeType[], required — array of role object ids - `collectibles` UserCollectiblesResponse - … - `user` UserResponse, required - … - `mute` boolean, required — whether the user is muted in voice channels - `deaf` boolean, required — whether the user is deafened in voice channels - `response` union, required - 0 — User is not interested in the event - 1 — User is interested in the event - `guild_scheduled_event_exceptions` GuildScheduledEventExceptionResponse[], required - `event_id` string, snowflake, required - `event_exception_id` string, snowflake, required - `scheduled_start_time` string, date-time, nullable, required — Overridden start time of this occurrence - `scheduled_end_time` string, date-time, nullable, required — Overridden end time of this occurrence - `is_canceled` boolean, required — Whether this occurrence is canceled - `entity_metadata` EntityMetadataStageInstanceResponse, required - VoiceScheduledEventResponse - `id` string, snowflake, required - `guild_id` string, snowflake, required - `name` string, required — Name of the scheduled event - `description` string, nullable, required — Description of the scheduled event - `channel_id` string, snowflake, required - `creator_id` string, snowflake, required - `creator` UserResponse - `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 - … - `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 - `image` string, nullable, required — Cover image hash of the scheduled event - `scheduled_start_time` string, date-time, required — When the scheduled event will start - `scheduled_end_time` string, date-time, nullable, required — When the scheduled event will end, or null if no end time - `status` union, required - 1 - 2 - 3 - 4 - `entity_type` union, required - 0 - 1 - 2 - 3 - `entity_id` string, snowflake, required - `recurrence_rule` RecurrenceRuleResponse, required - `start` string, date-time, required — Starting time of the recurrence interval - `end` string, date-time, nullable — Ending time of the recurrence interval - `frequency` union, required - 3 - 2 - 1 - 0 - `interval` integer, required — The spacing between events, defined by frequency - `by_weekday` RecurrenceRuleWeekdays[], nullable, required — Set of specific days within a week for the event to recur on - union - … - `by_n_weekday` ByNWeekdayResponse[], nullable, required — List of specific days within a specific week to recur on - `n` integer, required — The week to reoccur on (1-5, where 5 represents the last week) - `day` union, required - … - `by_month` RecurrenceRuleMonths[], nullable, required — Set of specific months to recur on - union - … - `by_month_day` integer[], nullable, required — Set of specific dates within a month to recur on - `by_year_day` integer[], nullable — Set of days within a year to recur on (1-364) - `count` integer, nullable — Total number of times the event is allowed to recur - `user_count` integer — Number of users subscribed to the scheduled event - `privacy_level` 2, required — the scheduled event is only accessible to guild members - `user_rsvp` ScheduledEventUserResponse - `guild_scheduled_event_id` string, snowflake, required - `guild_scheduled_event_exception_id` string, snowflake - `user_id` string, snowflake, required - `user` UserResponse - `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 - … - `collectibles` UserCollectiblesResponse - … - `primary_guild` UserPrimaryGuildResponse, required - … - `member` GuildMemberResponse - `avatar` string, nullable, required — the member's guild avatar hash - `avatar_decoration_data` UserAvatarDecorationResponse - … - `banner` string, nullable, required — the member's guild banner hash - `communication_disabled_until` string, date-time, nullable, required — when the user's timeout will expire and the user will be able to communicate in the guild again, null or a time in the past if the user is not timed out - `flags` integer, required — guild member flags represented as a bit set, defaults to 0 - `joined_at` string, date-time, required — when the user joined the guild - `nick` string, nullable, required — this user's guild nickname - `pending` boolean, required — whether the user has not yet passed the guild's Membership Screening requirements - `premium_since` string, date-time, nullable, required — when the user started boosting the guild - `roles` SnowflakeType[], required — array of role object ids - `collectibles` UserCollectiblesResponse - … - `user` UserResponse, required - … - `mute` boolean, required — whether the user is muted in voice channels - `deaf` boolean, required — whether the user is deafened in voice channels - `response` union, required - 0 — User is not interested in the event - 1 — User is interested in the event - `guild_scheduled_event_exceptions` GuildScheduledEventExceptionResponse[], required - `event_id` string, snowflake, required - `event_exception_id` string, snowflake, required - `scheduled_start_time` string, date-time, nullable, required — Overridden start time of this occurrence - `scheduled_end_time` string, date-time, nullable, required — Overridden end time of this occurrence - `is_canceled` boolean, required — Whether this occurrence is canceled - `entity_metadata` EntityMetadataVoiceResponse, required - `threads` ThreadResponse[], required - `id` string, snowflake, required - `type` union, required - 1 — A direct message between users - 3 — A direct message between multiple users - 0 — A text channel within a server - 2 — A voice channel within a server - 4 — An organizational category that contains up to 50 channels - 5 — A channel that users can follow and crosspost into their own server (formerly news channels) - 10 — A temporary sub-channel within a GUILD_ANNOUNCEMENT channel - 11 — A temporary sub-channel within a GUILD_TEXT or GUILD_THREADS_ONLY channel type set - 12 — A temporary sub-channel within a GUILD_TEXT channel that is only viewable by those invited and those with the MANAGE_THREADS permission - 13 — A voice channel for hosting events with an audience - 14 — The channel in a hub containing the listed servers - 15 — Channel that can only contain threads - `last_message_id` string, snowflake - `flags` integer, required - `last_pin_timestamp` string, date-time, nullable - `guild_id` string, snowflake, required - `name` string, required - `parent_id` string, snowflake - `rate_limit_per_user` integer - `bitrate` integer - `user_limit` integer - `rtc_region` string, nullable - `video_quality_mode` union - 1 — Discord chooses the quality for optimal performance - 2 — 720p - `permissions` string - `owner_id` string, snowflake, required - `thread_metadata` ThreadMetadataResponse, required - `archived` boolean, required - `archive_timestamp` string, date-time, nullable, required - `auto_archive_duration` union, required - 60 — One hour - 1440 — One day - 4320 — Three days - 10080 — Seven days - `locked` boolean, required - `create_timestamp` string, date-time - `invitable` boolean - `message_count` integer, required - `member_count` integer, required - `total_message_sent` integer, required - `applied_tags` SnowflakeType[] - `member` ThreadMemberResponse - `id` string, snowflake, required - `user_id` string, snowflake, required - `join_timestamp` string, date-time, required - `flags` integer, required - `member` GuildMemberResponse - `avatar` string, nullable, required — the member's guild avatar hash - `avatar_decoration_data` UserAvatarDecorationResponse - `asset` string, required — the avatar decoration hash - `sku_id` string, snowflake, required - `banner` string, nullable, required — the member's guild banner hash - `communication_disabled_until` string, date-time, nullable, required — when the user's timeout will expire and the user will be able to communicate in the guild again, null or a time in the past if the user is not timed out - `flags` integer, required — guild member flags represented as a bit set, defaults to 0 - `joined_at` string, date-time, required — when the user joined the guild - `nick` string, nullable, required — this user's guild nickname - `pending` boolean, required — whether the user has not yet passed the guild's Membership Screening requirements - `premium_since` string, date-time, nullable, required — when the user started boosting the guild - `roles` SnowflakeType[], required — array of role object ids - `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 - … - `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 - … - `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 - `mute` boolean, required — whether the user is muted in voice channels - `deaf` boolean, required — whether the user is deafened in voice channels - `application_commands` ApplicationCommandResponse[], required - `id` string, snowflake, required - `application_id` string, snowflake, required - `version` string, snowflake, required - `default_member_permissions` string, nullable, required - `type` union, required - 1 — Slash commands; a text-based command that shows up when a user types / - 2 — A UI-based command that shows up when you right click or tap on a user - 3 — A UI-based command that shows up when you right click or tap on a message - 4 — A command that represents the primary way to use an application (e.g. launching an Activity) - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `guild_id` string, snowflake - `dm_permission` boolean - `contexts` InteractionContextType[], nullable - union - 0 — This command can be used within a Guild. - 1 — This command can be used within a DM with this application's bot. - 2 — This command can be used within DMs and Group DMs with users. - `integration_types` ApplicationIntegrationType[] - union - 0 — For Guild install. - 1 — For User install. - `options` union[] - union - ApplicationCommandAttachmentOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - `file_types` string[] - ApplicationCommandBooleanOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - ApplicationCommandChannelOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - `channel_types` ChannelTypes[] - union - … - ApplicationCommandIntegerOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - `autocomplete` boolean - `choices` ApplicationCommandOptionIntegerChoiceResponse[] - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `value` integer, required - `min_value` integer - `max_value` integer - ApplicationCommandMentionableOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - ApplicationCommandNumberOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - `autocomplete` boolean - `choices` ApplicationCommandOptionNumberChoiceResponse[] - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `value` number, double, required - `min_value` number, double - `max_value` number, double - ApplicationCommandRoleOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - ApplicationCommandStringOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - `autocomplete` boolean - `choices` ApplicationCommandOptionStringChoiceResponse[] - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `value` string, required - `min_length` integer - `max_length` integer - ApplicationCommandSubcommandGroupOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - `options` ApplicationCommandSubcommandOptionResponse[] - `type` union, required - … - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - `options` union[] - … - ApplicationCommandSubcommandOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - `options` union[] - union - … - ApplicationCommandUserOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - `nsfw` boolean - `handler` union - 1 — The app handles the interaction using an interaction token - 2 — Discord handles the interaction by launching an Activity and sending a follow-up message without coordinating with the app - `auto_moderation_rules` union[], required - union - DefaultKeywordRuleResponse - `id` string, snowflake, required - `guild_id` string, snowflake, required - `creator_id` string, snowflake, required - `name` string, required - `event_type` union, required - 1 — A user submitted a message to a channel - 2 — A user is attempting to join the server or a member's properties were updated. - `actions` union[], required - union - BlockMessageActionResponse - … - FlagToChannelActionResponse - … - QuarantineUserActionResponse - … - UserCommunicationDisabledActionResponse - … - `trigger_type` union, required - 1 — Check if content contains words from a list of keywords or matches regex - 3 — Check if content represents generic spam - 4 — Check if content contains words from internal pre-defined wordsets - 5 — Check if content contains more unique mentions than allowed - 6 — Check if user profile fields contains words from a list of keywords or matches regex - `enabled` boolean, required - `exempt_roles` SnowflakeType[], required - `exempt_channels` SnowflakeType[], required - `trigger_metadata` DefaultKeywordListTriggerMetadataResponse, required - `allow_list` string[], required - `presets` AutomodKeywordPresetType[], required - union - … - KeywordRuleResponse - `id` string, snowflake, required - `guild_id` string, snowflake, required - `creator_id` string, snowflake, required - `name` string, required - `event_type` union, required - 1 — A user submitted a message to a channel - 2 — A user is attempting to join the server or a member's properties were updated. - `actions` union[], required - union - BlockMessageActionResponse - … - FlagToChannelActionResponse - … - QuarantineUserActionResponse - … - UserCommunicationDisabledActionResponse - … - `trigger_type` union, required - 1 — Check if content contains words from a list of keywords or matches regex - 3 — Check if content represents generic spam - 4 — Check if content contains words from internal pre-defined wordsets - 5 — Check if content contains more unique mentions than allowed - 6 — Check if user profile fields contains words from a list of keywords or matches regex - `enabled` boolean, required - `exempt_roles` SnowflakeType[], required - `exempt_channels` SnowflakeType[], required - `trigger_metadata` KeywordTriggerMetadataResponse, required - `keyword_filter` string[], required - `regex_patterns` string[], required - `allow_list` string[], required - MLSpamRuleResponse - `id` string, snowflake, required - `guild_id` string, snowflake, required - `creator_id` string, snowflake, required - `name` string, required - `event_type` union, required - 1 — A user submitted a message to a channel - 2 — A user is attempting to join the server or a member's properties were updated. - `actions` union[], required - union - BlockMessageActionResponse - … - FlagToChannelActionResponse - … - QuarantineUserActionResponse - … - UserCommunicationDisabledActionResponse - … - `trigger_type` union, required - 1 — Check if content contains words from a list of keywords or matches regex - 3 — Check if content represents generic spam - 4 — Check if content contains words from internal pre-defined wordsets - 5 — Check if content contains more unique mentions than allowed - 6 — Check if user profile fields contains words from a list of keywords or matches regex - `enabled` boolean, required - `exempt_roles` SnowflakeType[], required - `exempt_channels` SnowflakeType[], required - `trigger_metadata` MLSpamTriggerMetadataResponse, required - MentionSpamRuleResponse - `id` string, snowflake, required - `guild_id` string, snowflake, required - `creator_id` string, snowflake, required - `name` string, required - `event_type` union, required - 1 — A user submitted a message to a channel - 2 — A user is attempting to join the server or a member's properties were updated. - `actions` union[], required - union - BlockMessageActionResponse - … - FlagToChannelActionResponse - … - QuarantineUserActionResponse - … - UserCommunicationDisabledActionResponse - … - `trigger_type` union, required - 1 — Check if content contains words from a list of keywords or matches regex - 3 — Check if content represents generic spam - 4 — Check if content contains words from internal pre-defined wordsets - 5 — Check if content contains more unique mentions than allowed - 6 — Check if user profile fields contains words from a list of keywords or matches regex - `enabled` boolean, required - `exempt_roles` SnowflakeType[], required - `exempt_channels` SnowflakeType[], required - `trigger_metadata` MentionSpamTriggerMetadataResponse, required - `mention_total_limit` integer, required - `mention_raid_protection_enabled` boolean, required - UserProfileRuleResponse - `id` string, snowflake, required - `guild_id` string, snowflake, required - `creator_id` string, snowflake, required - `name` string, required - `event_type` union, required - 1 — A user submitted a message to a channel - 2 — A user is attempting to join the server or a member's properties were updated. - `actions` union[], required - union - BlockMessageActionResponse - … - FlagToChannelActionResponse - … - QuarantineUserActionResponse - … - UserCommunicationDisabledActionResponse - … - `trigger_type` union, required - 1 — Check if content contains words from a list of keywords or matches regex - 3 — Check if content represents generic spam - 4 — Check if content contains words from internal pre-defined wordsets - 5 — Check if content contains more unique mentions than allowed - 6 — Check if user profile fields contains words from a list of keywords or matches regex - `enabled` boolean, required - `exempt_roles` SnowflakeType[], required - `exempt_channels` SnowflakeType[], required - `trigger_metadata` UserProfileMetadataResponse, required - `keyword_filter` string[], required - `regex_patterns` string[], required - `allow_list` string[], required ## Other responses - `429` — Client ratelimited response - `4XX` — Client error response ## Changes - **2026-08-06** `f6cd197cbe47` — 3 info - added the optional property `application_commands/items/options/items/oneOf[#/components/schemas/ApplicationCommandAttachmentOptionResponse]/file_types` to the response with the `200` status - added the optional property `application_commands/items/options/items/oneOf[#/components/schemas/ApplicationCommandSubcommandGroupOptionResponse]/options/items/options/items/oneOf[#/components/schemas/ApplicationCommandAttachmentOptionResponse]/file_types` to the response with the `200` status - added the optional property `application_commands/items/options/items/oneOf[#/components/schemas/ApplicationCommandSubcommandOptionResponse]/options/items/oneOf[#/components/schemas/ApplicationCommandAttachmentOptionResponse]/file_types` to the response with the `200` status - …earlier changes not shown [Full history](https://skmtc.dev/discord/apis/discord-http-api-preview/changes/guilds/:guild_id/audit-logs/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)