--- title: "GET /guilds/{guild_id}/integrations" method: GET path: "/guilds/{guild_id}/integrations" --- # GET /guilds/{guild_id}/integrations `GET /guilds/{guild_id}/integrations` ## Response `200` 200 response for list_guild_integrations - union[], nullable - union - DiscordIntegrationResponse - `type` union, required - 'discord' - 'twitch' - 'youtube' - 'guild_subscription' - `name` string, nullable, required - `account` AccountResponse, required - `id` string, required - `name` string, nullable, required - `enabled` boolean, required - `id` string, snowflake, required - `application` IntegrationApplicationResponse, required - `id` string, snowflake, required - `name` string, required - `icon` string, nullable, required - `description` string, required - `type` 4, required - `cover_image` string - `primary_sku_id` string, snowflake - `bot` 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 - `scopes` OAuth2Scopes[], required - union - 'identify' — allows /users/@me without email - 'email' — enables /users/@me to return an email - 'connections' — allows /users/@me/connections to return linked third-party accounts - 'guilds' — allows /users/@me/guilds to return basic information about all of a user's guilds - 'guilds.join' — allows /guilds/{guild.id}/members/{user.id} to be used for joining users to a guild - 'guilds.members.read' — allows /users/@me/guilds/{guild.id}/member to return a user's member information in a guild - 'gdm.join' — allows your app to join users to a group dm - 'bot' — for oauth2 bots, this puts the bot in the user's selected guild by default - 'rpc' — for local rpc server access, this allows you to control a user's local Discord client - requires Discord approval - 'rpc.notifications.read' — for local rpc server access, this allows you to receive notifications pushed out to the user - requires Discord approval - 'rpc.voice.read' — for local rpc server access, this allows you to read a user's voice settings and listen for voice events - requires Discord approval - 'rpc.voice.write' — for local rpc server access, this allows you to update a user's voice settings - requires Discord approval - 'rpc.video.read' — for local rpc server access, this allows you to read a user's video status - requires Discord approval - 'rpc.video.write' — for local rpc server access, this allows you to update a user's video settings - requires Discord approval - 'rpc.screenshare.read' — for local rpc server access, this allows you to read a user's screenshare status- requires Discord approval - 'rpc.screenshare.write' — for local rpc server access, this allows you to update a user's screenshare settings- requires Discord approval - 'rpc.activities.write' — for local rpc server access, this allows you to update a user's activity - requires Discord approval - 'webhook.incoming' — this generates a webhook that is returned in the oauth token response for authorization code grants - 'messages.read' — for local rpc server api access, this allows you to read messages from all client channels (otherwise restricted to channels/guilds your app creates) - 'applications.builds.upload' — allows your app to upload/update builds for a user's applications - requires Discord approval - 'applications.builds.read' — allows your app to read build data for a user's applications - 'applications.commands' — allows your app to use commands in a guild - 'applications.commands.permissions.update' — allows your app to update permissions for its commands in a guild a user has permissions to - 'applications.commands.update' — allows your app to update its commands using a Bearer token - client credentials grant only - 'applications.store.update' — allows your app to read and update store data (SKUs, store listings, achievements, etc.) for a user's applications - 'applications.entitlements' — allows your app to read entitlements for a user's applications - 'activities.read' — allows your app to fetch data from a user's "Now Playing/Recently Played" list - requires Discord approval - 'activities.write' — allows your app to update a user's activity - requires Discord approval (NOT REQUIRED FOR GAMESDK ACTIVITY MANAGER) - 'activities.invites.write' — allows your app to send activity invites - requires Discord approval (NOT REQUIRED FOR GAMESDK ACTIVITY MANAGER) - 'relationships.read' — allows your app to know a user's friends and implicit relationships - requires Discord approval - 'voice' — allows your app to connect to voice on user's behalf and see all the voice members - requires Discord approval - 'dm_channels.read' — allows your app to see information about the user's DMs and group DMs - requires Discord approval - 'role_connections.write' — allows your app to update a user's connection and metadata for the app - 'openid' — for OpenID Connect, this allows your app to receive user id and basic profile information - `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 - … - `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 - ExternalConnectionIntegrationResponse - `type` union, required - 'discord' - 'twitch' - 'youtube' - 'guild_subscription' - `name` string, nullable, required - `account` AccountResponse, required - `id` string, required - `name` string, nullable, required - `enabled` boolean, required - `id` string, 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 - `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 - `revoked` boolean - `expire_behavior` union - 0 — Remove role - 1 — Kick - `expire_grace_period` union - 1 — 1 day - 3 — 3 days - 7 — 7 days - 14 — 14 days - 30 — 30 days - `subscriber_count` integer - `synced_at` string, date-time - `role_id` string, snowflake - `syncing` boolean - `enable_emoticons` boolean - GuildSubscriptionIntegrationResponse - `type` union, required - 'discord' - 'twitch' - 'youtube' - 'guild_subscription' - `name` string, nullable, required - `account` AccountResponse, required - `id` string, required - `name` string, nullable, required - `enabled` boolean, required - `id` string, snowflake, required ## Other responses - `429` — Client ratelimited response - `4XX` — Client error response ## Changes > 58 revisions in range; 1 could not be searched. - **2026-06-05** `693bf1f99bba` — 3 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 `items/oneOf[#/components/schemas/DiscordIntegrationResponse]/application/bot/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/DiscordIntegrationResponse]/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/ExternalConnectionIntegrationResponse]/user/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/palette` response property `oneOf` list for the response status `200` - …earlier changes not shown [Full history](https://skmtc.dev/discord/apis/discord-http-api-preview/changes/guilds/:guild_id/integrations/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)