diff --git a/docs/resources/guild.mdx b/docs/resources/guild.mdx
index 3effec4e51..0bafb49942 100644
--- a/docs/resources/guild.mdx
+++ b/docs/resources/guild.mdx
@@ -1148,6 +1148,11 @@ If none of the users could be banned, an error response code `500000: Failed to
 
 Returns a list of [role](/docs/topics/permissions#role-object) objects for the guild.
 
+## Get Guild Roles Members Count
+<Route method="GET">/guilds/[\{guild.id\}](/developers/docs/resources/guild#guild-object)/roles/member-counts</Route>
+
+Returns a [role member counts](/developers/docs/topics/permissions#role-object-roles-member-counts-object) object for the guild.
+
 ## Get Guild Role
 <Route method="GET">/guilds/[\{guild.id\}](/docs/resources/guild#guild-object)/roles/[\{role.id\}](/docs/topics/permissions#role-object)</Route>
 
diff --git a/docs/topics/permissions.md b/docs/topics/permissions.md
index c8cc6b56b1..07743a353a 100644
--- a/docs/topics/permissions.md
+++ b/docs/topics/permissions.md
@@ -263,6 +263,14 @@ When sending `tertiary_color` the API enforces the role color to be a holographi
 }
 ```
 
+###### Roles Member Counts Object
+
+A mapping of role IDs to the number of members with that role.
+
+| Field      | Type      | Description                               |
+|------------|-----------|-------------------------------------------|
+| \{role.id} | integer   | number of members with the role           |
+
 ###### Example Role
 
 ```json