Document role member counts endpoint (#8025)

* Document role member counts endpoint

* changelog

Author: advaith1

docs/change-log/2025-12-09-get-guild-role-member-counts-endpoint.md

@@ -0,0 +1,8 @@
+---
+title: "Get Guild Role Member Counts Endpoint"
+date: "2025-12-09"
+topics:
+- "HTTP API"
+---
+
+Apps can now use the [Get Guild Role Member Counts](/docs/resources/guild#get-guild-role-member-counts) endpoint to access the number of members that have each role!

docs/resources/guild.mdx

@@ -1153,6 +1153,21 @@ Returns a list of [role](/docs/topics/permissions#role-object) objects for the g
 
 Returns a [role](/docs/topics/permissions#role-object) object for the specified role.
 
+## Get Guild Role Member Counts
+<Route method="GET">/guilds/[\{guild.id\}](/docs/resources/guild#guild-object)/roles/member-counts</Route>
+
+Returns a map of role IDs to the number of members with the role. Does not include the @everyone role.
+
+###### Example Response
+
+```json
+{
+  "613425648685547541": 1337,
+  "1409696176629878905": 2,
+  "697138785317814292": 67
+}
+```
+
 ## Create Guild Role
 <Route method="POST">/guilds/[\{guild.id\}](/docs/resources/guild#guild-object)/roles</Route>