--- title: "GET /guilds/{guild_id}/scheduled-events" method: GET path: "/guilds/{guild_id}/scheduled-events" --- # GET /guilds/{guild_id}/scheduled-events `GET /guilds/{guild_id}/scheduled-events` ## Query parameters - `with_user_count` boolean ## Response `200` 200 response for list_guild_scheduled_events - union[], nullable - 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 - `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 - … - `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 - 0 - 1 - 2 - 3 - 4 - 5 - 6 - `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 - 0 - 1 - 2 - 3 - 4 - 5 - 6 - `by_month` RecurrenceRuleMonths[], nullable, required — Set of specific months to recur on - union - 1 - 2 - 3 - 4 - 5 - 6 - 7 - 8 - 9 - 10 - 11 - 12 - `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 - `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 - `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 - … - `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 - … - `collectibles` UserCollectiblesResponse - … - `primary_guild` UserPrimaryGuildResponse, 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 - `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 - … - `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 - 0 - 1 - 2 - 3 - 4 - 5 - 6 - `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 - 0 - 1 - 2 - 3 - 4 - 5 - 6 - `by_month` RecurrenceRuleMonths[], nullable, required — Set of specific months to recur on - union - 1 - 2 - 3 - 4 - 5 - 6 - 7 - 8 - 9 - 10 - 11 - 12 - `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 - `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 - `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 - … - `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 - … - `collectibles` UserCollectiblesResponse - … - `primary_guild` UserPrimaryGuildResponse, 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 - `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 - … - `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 - 0 - 1 - 2 - 3 - 4 - 5 - 6 - `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 - 0 - 1 - 2 - 3 - 4 - 5 - 6 - `by_month` RecurrenceRuleMonths[], nullable, required — Set of specific months to recur on - union - 1 - 2 - 3 - 4 - 5 - 6 - 7 - 8 - 9 - 10 - 11 - 12 - `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 - `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 - `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 - … - `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 - … - `collectibles` UserCollectiblesResponse - … - `primary_guild` UserPrimaryGuildResponse, 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 ## Other responses - `429` — Client ratelimited response - `4XX` — Client error response ## Changes - **2026-06-05** `693bf1f99bba` — 12 breaking, 12 info - 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/oneOf[#/components/schemas/ExternalScheduledEventResponse]/creator/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/palette` response property `oneOf` list for the response status `200` - 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/oneOf[#/components/schemas/ExternalScheduledEventResponse]/user_rsvp/oneOf[#/components/schemas/ScheduledEventUserResponse]/member/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/palette` response property `oneOf` list for the response status `200` - 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/oneOf[#/components/schemas/ExternalScheduledEventResponse]/user_rsvp/oneOf[#/components/schemas/ScheduledEventUserResponse]/member/user/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/palette` response property `oneOf` list for the response status `200` - 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/oneOf[#/components/schemas/ExternalScheduledEventResponse]/user_rsvp/oneOf[#/components/schemas/ScheduledEventUserResponse]/user/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/palette` response property `oneOf` list for the response status `200` - …20 more - …earlier changes not shown [Full history](https://skmtc.dev/discord/apis/discord-http-api-preview/changes/guilds/:guild_id/scheduled-events/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/9fd91c50cf32/schema)