GET /guilds/:guild_id/members/search — discord-http-api-preview

get/guilds/{guild_id}/members/search

Query parameters

limitinteger

querystring required

Response

200 response for search_guild_members

avatarstring nullable required

the member's guild avatar hash

bannerstring nullable required

the member's guild banner hash

communication_disabled_untilstring 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

flagsinteger required

guild member flags represented as a bit set, defaults to 0

joined_atstring date-time required

when the user joined the guild

nickstring nullable required

this user's guild nickname

pendingboolean required

whether the user has not yet passed the guild's Membership Screening requirements

premium_sincestring date-time nullable required

when the user started boosting the guild

rolesSnowflakeType[] required

array of role object ids

muteboolean required

whether the user is muted in voice channels

deafboolean required

whether the user is deafened in voice channels

Changes

Changed in 2 of the 58 revisions of this API.218

Jun 5, 2026693bf1f99bba2See the full diff
- ▲
  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/collectibles/oneOf[UserCollectiblesResponse]/nameplate/oneOf[UserNameplateResponse]/palette response property oneOf list for the response status 200
  response-property-one-of-added
- ▲
  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/user/collectibles/oneOf[UserCollectiblesResponse]/nameplate/oneOf[UserNameplateResponse]/palette response property oneOf list for the response status 200
  response-property-one-of-added
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Feb 4, 2026e200830e509a18See the full diff
- ○
  the response property items/avatar became required for the status 200
  response-property-became-required
- ○
  the response property items/avatar_decoration_data/oneOf[UserAvatarDecorationResponse]/sku_id became required for the status 200
  response-property-became-required
- ○
  the response property items/banner became required for the status 200
  response-property-became-required
- ○
  the response property items/collectibles/oneOf[UserCollectiblesResponse]/nameplate became required for the status 200
  response-property-became-required
- ○
  the response property items/collectibles/oneOf[UserCollectiblesResponse]/nameplate/oneOf[UserNameplateResponse]/sku_id became required for the status 200
  response-property-became-required
- ○
  the response property items/communication_disabled_until became required for the status 200
  response-property-became-required
- ○
  the response property items/nick became required for the status 200
  response-property-became-required
- ○
  the response property items/premium_since became required for the status 200
  response-property-became-required
- ○
  the response property items/user/avatar became required for the status 200
  response-property-became-required
- ○
  the response property items/user/avatar_decoration_data/oneOf[UserAvatarDecorationResponse]/sku_id became required for the status 200
  response-property-became-required
- ○
  the response property items/user/collectibles/oneOf[UserCollectiblesResponse]/nameplate became required for the status 200
  response-property-became-required
- ○
  the response property items/user/collectibles/oneOf[UserCollectiblesResponse]/nameplate/oneOf[UserNameplateResponse]/sku_id became required for the status 200
  response-property-became-required
- ○
  the response property items/user/global_name became required for the status 200
  response-property-became-required
- ○
  the response property items/user/primary_guild became required for the status 200
  response-property-became-required
- ○
  the response property items/user/primary_guild/oneOf[UserPrimaryGuildResponse]/badge became required for the status 200
  response-property-became-required
- ○
  the response property items/user/primary_guild/oneOf[UserPrimaryGuildResponse]/identity_enabled became required for the status 200
  response-property-became-required
- ○
  the response property items/user/primary_guild/oneOf[UserPrimaryGuildResponse]/identity_guild_id became required for the status 200
  response-property-became-required
- ○
  the response property items/user/primary_guild/oneOf[UserPrimaryGuildResponse]/tag became required for the status 200
  response-property-became-required

Full history