Skip to main content
GET
/
guilds
/
{guild_id}
/
roles
/
{role_id}
cURL
curl --request GET \
  --url https://discord.com/api/v10/guilds/{guild_id}/roles/{role_id} \
  --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
role_id
string<snowflake>
required

Response

200 response for get_guild_role

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