---
title: "List channel invites"
method: GET
path: "/channels/{channel_id}/invites"
tags: ["Invites"]
---

# List channel invites

`GET /channels/{channel_id}/invites`

Retrieves all currently active invites for the specified channel, including invite codes, creators, expiration times, and usage statistics. The authenticated user must have permission to manage invites for the channel. Returns an array of invite metadata objects.

## Path parameters

- `channel_id` union, required
  - string, snowflake
  - integer

## Response `200`

Success

- InviteMetadataResponseSchema[]
  - union
    - GuildInviteMetadataResponse
      - `code` string, required — The unique invite code
      - `inviter` UserPartialResponse
        - `id` string, snowflake, required
        - `username` string, required — The username of the user, not unique across the platform
        - `discriminator` string, required — The four-digit discriminator tag of the user
        - `global_name` string, nullable, required — The display name of the user, if set
        - `avatar` string, nullable, required — The hash of the user avatar image
        - `avatar_color` integer, required
        - `bot` boolean — Whether the user is a bot account
        - `system` boolean — Whether the user is an official system user
        - `flags` integer, required — The public flags on the user account
        - `mention_flags` 0 | 1 | 2 — Reply mention preference
      - `expires_at` string, date-time, nullable — ISO8601 timestamp of when the invite expires
      - `temporary` boolean, required — Whether the invite grants temporary membership
      - `type` 0, required — The type of invite (guild)
      - `guild` GuildPartialResponse, required
        - `id` string, snowflake, required
        - `name` string, required — The name of the guild
        - `icon` string, nullable — The hash of the guild icon
        - `banner` string, nullable — The hash of the guild banner
        - `banner_width` integer
        - `banner_height` integer
        - `splash` string, nullable — The hash of the guild splash screen
        - `splash_width` integer
        - `splash_height` integer
        - `splash_card_alignment` 0 | 1 | 2, required — The alignment of the splash card
        - `embed_splash` string, nullable — The hash of the embedded invite splash
        - `embed_splash_width` integer
        - `embed_splash_height` integer
        - `features` GuildFeatureSchema[], required — Array of guild feature flags
      - `channel` ChannelPartialResponse, required
        - `id` string, snowflake, required
        - `name` string, nullable — The name of the channel
        - `type` 0 | 1 | 2 | 3 | 4 | 998 | 999, required — The type of the channel
        - `recipients` object[] — The recipients of the DM channel
          - `username` string, required — The username of the recipient
      - `member_count` integer, required
      - `presence_count` integer, required
      - `created_at` string, date-time, required — ISO8601 timestamp of when the invite was created
      - `uses` integer, required
      - `max_uses` integer, required
      - `max_age` integer, required
    - GroupDmInviteMetadataResponse
      - `code` string, required — The unique invite code
      - `inviter` UserPartialResponse
        - `id` string, snowflake, required
        - `username` string, required — The username of the user, not unique across the platform
        - `discriminator` string, required — The four-digit discriminator tag of the user
        - `global_name` string, nullable, required — The display name of the user, if set
        - `avatar` string, nullable, required — The hash of the user avatar image
        - `avatar_color` integer, required
        - `bot` boolean — Whether the user is a bot account
        - `system` boolean — Whether the user is an official system user
        - `flags` integer, required — The public flags on the user account
        - `mention_flags` 0 | 1 | 2 — Reply mention preference
      - `expires_at` string, date-time, nullable — ISO8601 timestamp of when the invite expires
      - `temporary` boolean, required — Whether the invite grants temporary membership
      - `type` 1, required — The type of invite (group DM)
      - `channel` ChannelPartialResponse, required
        - `id` string, snowflake, required
        - `name` string, nullable — The name of the channel
        - `type` 0 | 1 | 2 | 3 | 4 | 998 | 999, required — The type of the channel
        - `recipients` object[] — The recipients of the DM channel
          - `username` string, required — The username of the recipient
      - `member_count` integer, required
      - `created_at` string, date-time, required — ISO8601 timestamp of when the invite was created
      - `uses` integer, required
      - `max_uses` integer, required

## Other responses

- `400` — Bad Request - The request was malformed or contained invalid data
- `401` — Unauthorized - Authentication is required or the token is invalid
- `403` — Forbidden - You do not have permission to perform this action
- `429` — Too Many Requests - You are being rate limited
- `500` — Internal Server Error - An unexpected error occurred

## Changes

> 15 revisions in range; 1 not diffed.

- **2026-09-18** `dd0ad4ea1c88` — 10 breaking, 14 info
  - the response property `items/anyOf[#/components/schemas/GroupDmInviteMetadataResponse]/channel/name` became nullable for the status `200`
  - the response property `items/anyOf[#/components/schemas/GroupDmInviteMetadataResponse]/inviter/anyOf[#/components/schemas/UserPartialResponse]/avatar` became nullable for the status `200`
  - the response property `items/anyOf[#/components/schemas/GroupDmInviteMetadataResponse]/inviter/anyOf[#/components/schemas/UserPartialResponse]/global_name` became nullable for the status `200`
  - the response property `items/anyOf[#/components/schemas/GuildInviteMetadataResponse]/channel/name` became nullable for the status `200`
  - …20 more
- **2026-09-06** `a52a2cf49d9b` — 32 warning, 200 info
  - added the new `IP_BAN_DECLINED` enum value to the `code` response property for the response status `400`
  - added the new `IP_BAN_DECLINED` enum value to the `code` response property for the response status `401`
  - added the new `IP_BAN_DECLINED` enum value to the `code` response property for the response status `403`
  - added the new `IP_BAN_DECLINED` enum value to the `code` response property for the response status `500`
  - …228 more
  - …this revision’s changelog is incomplete
- …earlier changes not shown

[Full history](https://skmtc.dev/fluxer/apis/fluxer-api/changes/channels/:channel_id/invites/get.md)

---

[API](https://skmtc.dev/fluxer/apis/fluxer-api.md) · [All operations](https://skmtc.dev/fluxer/apis/fluxer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fluxer/apis/fluxer-api/revisions/5296f41cd55d?raw)