From 1b9394244b2f3813b6c372fc05dad7d13b783b72 Mon Sep 17 00:00:00 2001
From: Fleny <Fleny113@outlook.com>
Date: Wed, 7 Jan 2026 20:55:42 +0100
Subject: [PATCH] api-docs: Guild Role Member Counts endpoint (#4628)

---
 packages/bot/src/helpers.ts         |  4 ++++
 packages/rest/src/manager.ts        |  4 ++++
 packages/rest/src/routes.ts         |  3 +++
 packages/rest/src/types.ts          | 10 ++++++++++
 packages/rest/src/typings/routes.ts |  2 ++
 5 files changed, 23 insertions(+)

diff --git a/packages/bot/src/helpers.ts b/packages/bot/src/helpers.ts
index 5a7f2d492..52b1620d8 100644
--- a/packages/bot/src/helpers.ts
+++ b/packages/bot/src/helpers.ts
@@ -180,6 +180,9 @@ export function createBotHelpers<TProps extends TransformersDesiredProperties, T
     createInvite: async (channelId, options, reason) => {
       return await bot.rest.createInvite(channelId, options, reason)
     },
+    getGuildRoleMemberCounts: async (guildId) => {
+      return await bot.rest.getGuildRoleMemberCounts(guildId)
+    },
     createRole: async (guildId, options, reason) => {
       return bot.transformers.role(bot, snakelize(await bot.rest.createRole(guildId, options, reason)), { guildId })
     },
@@ -866,6 +869,7 @@ export type BotHelpers<TProps extends TransformersDesiredProperties, TBehavior e
   ) => Promise<SetupDesiredProps<Sticker, TProps, TBehavior>>
   createGuildTemplate: (guildId: BigString, options: CreateTemplate) => Promise<Template>
   createInvite: (channelId: BigString, options?: CreateChannelInvite, reason?: string) => Promise<Camelize<DiscordInvite>>
+  getGuildRoleMemberCounts: (guildId: BigString) => Promise<Record<string, number>>
   createRole: (guildId: BigString, options: CreateGuildRole, reason?: string) => Promise<SetupDesiredProps<Role, TProps, TBehavior>>
   createScheduledEvent: (
     guildId: BigString,
diff --git a/packages/rest/src/manager.ts b/packages/rest/src/manager.ts
index aa7a8a1f3..026b008ba 100644
--- a/packages/rest/src/manager.ts
+++ b/packages/rest/src/manager.ts
@@ -819,6 +819,10 @@ export function createRestManager(options: CreateRestManagerOptions): RestManage
       return await rest.post<DiscordInvite>(rest.routes.channels.invites(channelId), { body, reason })
     },
 
+    async getGuildRoleMemberCounts(guildId) {
+      return await rest.get<Record<string, number>>(rest.routes.guilds.roles.memberCounts(guildId))
+    },
+
     async createRole(guildId, body, reason) {
       return await rest.post<DiscordRole>(rest.routes.guilds.roles.all(guildId), { body, reason })
     },
diff --git a/packages/rest/src/routes.ts b/packages/rest/src/routes.ts
index e4c22633c..235d7cf03 100644
--- a/packages/rest/src/routes.ts
+++ b/packages/rest/src/routes.ts
@@ -458,6 +458,9 @@ export function createRoutes(): RestRoutes {
         member: (guildId, memberId, roleId) => {
           return `/guilds/${guildId}/members/${memberId}/roles/${roleId}`
         },
+        memberCounts: (guildId) => {
+          return `/guilds/${guildId}/roles/member-counts`
+        },
       },
       stickers: (guildId) => {
         return `/guilds/${guildId}/stickers`
diff --git a/packages/rest/src/types.ts b/packages/rest/src/types.ts
index 8e505f6c1..ac00d0946 100644
--- a/packages/rest/src/types.ts
+++ b/packages/rest/src/types.ts
@@ -558,6 +558,16 @@ export interface RestManager {
    * @see {@link https://discord.com/developers/docs/resources/channel#create-channel-invite}
    */
   createInvite: (channelId: BigString, options?: CreateChannelInvite, reason?: string) => Promise<Camelize<DiscordInvite>>
+  /**
+   * Get guild role member counts
+   *
+   * Returns a map of role IDs to the number of members with the role. Does not include the \@everyone role.
+   *
+   * @param guildId - The ID of the guild to get role member counts for.
+   *
+   * @see {@link https://discord.com/developers/docs/resources/guild#get-guild-role-member-counts}
+   */
+  getGuildRoleMemberCounts: (guildId: BigString) => Promise<Record<string, number>>
   /**
    * Creates a role in a guild.
    *
diff --git a/packages/rest/src/typings/routes.ts b/packages/rest/src/typings/routes.ts
index 59c4c08d3..e9ea0b6c7 100644
--- a/packages/rest/src/typings/routes.ts
+++ b/packages/rest/src/typings/routes.ts
@@ -215,6 +215,8 @@ export interface RestRoutes {
       all: (guildId: BigString) => string
       /** Route for handling a members roles in a guild. */
       member: (guildId: BigString, memberId: BigString, roleId: BigString) => string
+      /** Route for the role member counts */
+      memberCounts: (guildId: BigString) => string
     }
     /** Route for handling a specific guild sticker. */
     stickers: (guildId: BigString) => string