---
title: "List Discord scheduled events"
method: GET
path: "/v1/discord/guilds/{guildId}/events"
tags: ["Discord"]
---

# List Discord scheduled events

`GET /v1/discord/guilds/{guildId}/events`

Return all scheduled events in the guild. Events are distinct from
messages: they appear in the server's Events panel and Discord
auto-notifies interested members ahead of start time.

Pass `withUserCount=true` to include `user_count` (number of members
who RSVP'd) on each event. Useful for surfacing engagement.

## Path parameters

- `guildId` string, required

## Query parameters

- `accountId` string, required
- `withUserCount` boolean

## Response `200`

List of scheduled events.

- object
  - `data` DiscordScheduledEvent[]
    - `id` string — Event snowflake ID
    - `guild_id` string
    - `channel_id` string, nullable — Voice/stage channel ID; null for external events.
    - `creator_id` string, nullable
    - `name` string
    - `description` string, nullable
    - `scheduled_start_time` string, date-time
    - `scheduled_end_time` string, date-time, nullable — Required for external events; optional for voice/stage.
    - `privacy_level` 2 — Always 2 (GUILD_ONLY). Discord deprecated PUBLIC events.
    - `status` 1 | 2 | 3 | 4 — 1=SCHEDULED, 2=ACTIVE, 3=COMPLETED, 4=CANCELED
    - `entity_type` 1 | 2 | 3 — 1=STAGE_INSTANCE, 2=VOICE, 3=EXTERNAL
    - `entity_id` string, nullable
    - `entity_metadata` object, nullable
      - `location` string — External event location string.
    - `user_count` integer — Number of members who RSVP'd. Only present when withUserCount=true on list.
    - `image` string, nullable — Cover image hash; build URL via cdn.discordapp.com.

## Other responses

- `400` — Invalid params.
- `401` — Missing or invalid API key. `code` is `missing_credentials` when no Authorization header was sent and `invalid_credentials` when the key is unknown, revoked or expired.
- `404` — Discord account not found or not in this guild.
- `502` — Bot lacks access to the guild's events.

## Changes

- **2026-10-06** `f8c8f34fb41a` — 1 warning
  - added the new `account` enum value to the `details/budgetScope` response property for the response status `401`
- **2026-10-02** `d556591af3f6` — 7 info
  - added the optional property `code` to the response with the `401` status
  - added the optional property `details` to the response with the `401` status
  - added the optional property `docUrl` to the response with the `401` status
  - added the optional property `param` to the response with the `401` status
  - …3 more

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/discord/guilds/:guildId/events/get.md)

---

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