--- title: "GET /guilds/{guild_id}/requests" method: GET path: "/guilds/{guild_id}/requests" --- # GET /guilds/{guild_id}/requests `GET /guilds/{guild_id}/requests` List join requests for guild, optionally filtered by application status ## Query parameters - `status` union - 'STARTED' — Applicant started but not yet submitted join request - 'SUBMITTED' — Applicant submitted join request that is awaiting review - 'REJECTED' — Join request rejected - 'APPROVED' — Join request approved - `limit` integer - `before` string, snowflake - `after` string, snowflake ## Response `200` 200 response for get_guild_join_requests - GuildJoinRequestsListResponse - `total` integer - `guild_join_requests` GuildJoinRequestResponse[] - `id` string, snowflake, required - `created_at` string, date-time, required - `reviewed_at` string, date-time, nullable, required - `application_status` union, required - 'STARTED' — Applicant started but not yet submitted join request - 'SUBMITTED' — Applicant submitted join request that is awaiting review - 'REJECTED' — Join request rejected - 'APPROVED' — Join request approved - `rejection_reason` string, nullable, required — Reason request was rejected. Only set when application_status is REJECTED - `guild_id` string, snowflake, required - `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 - `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 - `form_responses` union[], nullable — Applicant's responses on join request form - union - MultipleChoiceFormFieldResponse - `field_type` union, required - 'TERMS' — Field requiring applicant to acknowledge list of terms - 'TEXT_INPUT' — Short text input field - 'PARAGRAPH' — Long-form text input field - 'MULTIPLE_CHOICE' — Field where applicant selects one of many options - `label` string — Label shown above field - `description` string — Optional helper text shown below label - `required` boolean — Whether applicant must fill in field - `choices` string[], required — Choices applicant can select from - `response` integer — Index of choice selected by applicant - ParagraphFormFieldResponse - `field_type` union, required - 'TERMS' — Field requiring applicant to acknowledge list of terms - 'TEXT_INPUT' — Short text input field - 'PARAGRAPH' — Long-form text input field - 'MULTIPLE_CHOICE' — Field where applicant selects one of many options - `label` string — Label shown above field - `description` string — Optional helper text shown below label - `required` boolean — Whether applicant must fill in field - `placeholder` string — Placeholder text shown in empty input - `response` string — Applicant's text response - TermsFormFieldResponse - `field_type` union, required - 'TERMS' — Field requiring applicant to acknowledge list of terms - 'TEXT_INPUT' — Short text input field - 'PARAGRAPH' — Long-form text input field - 'MULTIPLE_CHOICE' — Field where applicant selects one of many options - `label` string — Label shown above field - `description` string — Optional helper text shown below label - `required` boolean — Whether applicant must fill in field - `values` string[], required — Terms applicant must acknowledge - `response` boolean — Whether applicant accepted terms - TextInputFormFieldResponse - `field_type` union, required - 'TERMS' — Field requiring applicant to acknowledge list of terms - 'TEXT_INPUT' — Short text input field - 'PARAGRAPH' — Long-form text input field - 'MULTIPLE_CHOICE' — Field where applicant selects one of many options - `label` string — Label shown above field - `description` string — Optional helper text shown below label - `required` boolean — Whether applicant must fill in field - `placeholder` string — Placeholder text shown in empty input - `response` string — Applicant's text response - `actioned_by_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 - `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 ## Other responses - `429` — Client ratelimited response - `4XX` — Client error response ## Changes - **2026-06-05** `693bf1f99bba` — 2 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 `guild_join_requests/items/actioned_by_user/oneOf[#/components/schemas/UserResponse]/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 `guild_join_requests/items/user/oneOf[#/components/schemas/UserResponse]/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/palette` response property `oneOf` list for the response status `200` - **2026-05-06** `902436547978` — 1 info - endpoint added [Change history](https://skmtc.dev/discord/apis/discord-http-api-preview/changes/guilds/:guild_id/requests/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)