---
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` — Unauthorized
- `404` — Discord account not found or not in this guild.
- `502` — Bot lacks access to the guild's events.

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/versions/f81ca70ea6b9/schema)