Skip to main content
GET
/
guilds
/
{guild_id}
/
roles
cURL
curl --request GET \
  --url https://discord.com/api/v10/guilds/{guild_id}/roles \
  --header 'Authorization: <api-key>'
[
  {
    "id": "<string>",
    "name": "<string>",
    "description": "<string>",
    "permissions": "<string>",
    "position": 123,
    "color": 123,
    "colors": {
      "primary_color": 123,
      "secondary_color": 123,
      "tertiary_color": 123
    },
    "hoist": true,
    "managed": true,
    "mentionable": true,
    "icon": "<string>",
    "unicode_emoji": "<string>",
    "flags": 123,
    "tags": {
      "premium_subscriber": "<unknown>",
      "bot_id": "<string>",
      "integration_id": "<string>",
      "subscription_listing_id": "<string>",
      "available_for_purchase": "<unknown>",
      "guild_connections": "<unknown>"
    }
  }
]

Authorizations

Authorization
string
header
required

Discord bot token

Path Parameters

guild_id
string<snowflake>
required

Response

200 response for list_guild_roles

id
string<snowflake>
required
name
string
required
description
string | null
required
permissions
string
required
position
integer<int32>
required
color
integer<int32>
required
colors
object
required
hoist
boolean
required
managed
boolean
required
mentionable
boolean
required
icon
string | null
required
unicode_emoji
string | null
required
flags
integer<int32>
required
tags
object