Skip to main content
GET
/
guilds
/
{guild_id}
/
channels
cURL
curl --request GET \
  --url https://discord.com/api/v10/guilds/{guild_id}/channels \
  --header 'Authorization: <api-key>'
[
  {
    "id": "<string>",
    "type": 0,
    "flags": 123,
    "guild_id": "<string>",
    "name": "<string>",
    "position": 123,
    "last_message_id": "<unknown>",
    "last_pin_timestamp": "2023-11-07T05:31:56Z",
    "parent_id": "<unknown>",
    "rate_limit_per_user": 123,
    "bitrate": 123,
    "user_limit": 123,
    "rtc_region": "<string>",
    "video_quality_mode": 123,
    "permissions": "<string>",
    "topic": "<string>",
    "default_auto_archive_duration": 123,
    "default_thread_rate_limit_per_user": 123,
    "permission_overwrites": [
      {
        "id": "<string>",
        "type": 123,
        "allow": "<string>",
        "deny": "<string>"
      }
    ],
    "nsfw": true,
    "available_tags": [
      {
        "id": "<string>",
        "name": "<string>",
        "moderated": true,
        "emoji_id": "<unknown>",
        "emoji_name": "<string>"
      }
    ],
    "default_reaction_emoji": "<unknown>",
    "default_sort_order": "<unknown>",
    "default_forum_layout": "<unknown>",
    "default_tag_setting": "<unknown>",
    "hd_streaming_until": "2023-11-07T05:31:56Z",
    "hd_streaming_buyer_id": "<string>"
  }
]

Authorizations

Authorization
string
header
required

Discord bot token

Path Parameters

guild_id
string<snowflake>
required

Response

object[] | null

200 response for list_guild_channels

id
string<snowflake>
required
type
required

A text channel within a server

Available options:
TitleConst
GUILD_TEXT0
GUILD_VOICE2
GUILD_CATEGORY4
GUILD_ANNOUNCEMENT5
GUILD_STAGE_VOICE13
GUILD_DIRECTORY14
GUILD_FORUM15
flags
integer<int32>
required
guild_id
string<snowflake>
required
name
string
required
position
integer<int32>
required
last_message_id
null | string<snowflake>
last_pin_timestamp
string<date-time> | null
parent_id
null | string<snowflake>
rate_limit_per_user
integer<int32>
bitrate
integer<int32>
user_limit
integer<int32>
rtc_region
string | null
video_quality_mode

Discord chooses the quality for optimal performance

permissions
string | null
topic
string | null
default_auto_archive_duration

One hour

default_thread_rate_limit_per_user
integer<int32>
permission_overwrites
object[]
nsfw
boolean
available_tags
object[]
default_reaction_emoji
object
default_sort_order

Sort forum posts by activity

default_forum_layout

No default has been set for forum channel

default_tag_setting

The thread tags must contain all tags in the search query

Allowed value: "match_all"
hd_streaming_until
string<date-time>
hd_streaming_buyer_id
string<snowflake>