--- title: "List Events" method: GET path: "/v1/calendars/events/list" tags: ["Calendars"] --- # List Events `GET /v1/calendars/events/list` Every event and API key on Luma is managed by a [Luma Calendar](https://help.luma.com/p/luma-calendar-overview). By default this lists the events your Calendar manages. Each event includes an `access` field. Pass `access=manage&access=view` to also return events that are listed on the Calendar but managed elsewhere — those come back with `access: "view"`, their location obfuscated to city level, and host-only fields like `meeting_url`, `registration_questions`, and `feedback_email` omitted. Private events the Calendar doesn't manage are never returned. ## Query parameters - `before` string, date-time — ISO 8601 Datetime. For example, 2022-10-19T03:27:13.673Z - `after` string, date-time — ISO 8601 Datetime. For example, 2022-10-19T03:27:13.673Z - `pagination_cursor` string — Value of `next_cursor` from a previous request. - `pagination_limit` number — The number of items to return. The server will enforce a maximum number. - `platforms` string[] — Which event platforms to include. Defaults to `luma` for backwards compatibility. Pass as repeated query params, e.g. `?platforms=luma&platforms=external`. - `sort_column` 'start_at' - `sort_direction` 'asc' | 'desc' | 'asc nulls last' | 'desc nulls last' - `status` 'approved' | 'pending' — Filter by calendar submission status. Defaults to `approved`. - `access` string[] — Which access values to include (`manage`, `view`). Defaults to `manage`, returning only events the Calendar manages. Pass as repeated query params, e.g. `?access=manage&access=view`. Include `view` to also return events that are listed on the Calendar but managed elsewhere — those entries come back with `access: "view"`, their location obfuscated to city level, and host-only fields like `meeting_url`, `registration_questions`, and `feedback_email` omitted. ## Response `200` Successful response. - object - `entries` union[], required - union - object - `platform` 'luma', required - `id` string, required - `user_id` string, required - `calendar_id` string, required - `start_at` string, date-time, required — ISO 8601 Datetime. For example, 2022-10-19T03:27:13.673Z - `duration_interval` string, required - `end_at` string, date-time, required — ISO 8601 Datetime. For example, 2022-10-19T03:27:13.673Z - `created_at` string, date-time, required — ISO 8601 Datetime. For example, 2022-10-19T03:27:13.673Z - `timezone` string, required — IANA Timezone, e.g. America/New_York. https://en.wikipedia.org/wiki/List_of_tz_database_time_zones - `name` string, required - `cover_url` string, required - `url` string, required - `visibility` 'public' | 'members-only' | 'private', required - `location_type` 'discord' | 'meet' | 'twitch' | 'twitter' | 'youtube' | 'zoom' | 'offline' | 'missing' | 'unknown', required — `offline` for in-person events. Online events have the meeting platform (`zoom`, `meet`, etc.), or `unknown` if we don't recognize the meeting link. `missing` if the event has no location set. - `location_visibility` 'public' | 'guests-only', required — Whether the event's address is shown to everyone or only to approved guests. This API always returns the full address. - `waitlist_status` 'disabled' | 'enabled', required — `enabled` if the event has a waitlist. New registrations join the waitlist once the event reaches capacity. - `access` 'view', required - `geo_address_json` object, nullable, required — Address info for events you don't manage. When the host has set the address to be visible only to guests, only city-level fields (city, region, country, city_state) are populated. - `address` string, required - `city` string, nullable, required - `region` string, nullable, required - `country` string, nullable, required - `city_state` string, nullable, required - `full_address` string, nullable, required - `google_maps_place_id` string, nullable, required - `apple_maps_place_id` string, nullable, required - `description` string, nullable, required - `coordinate` object, nullable, required — Latitude and longitude of the event. Obfuscated to a coarse area when the host has set the address to be visible only to guests. Null for online events or when no coordinate is set. - `longitude` number, required - `latitude` number, required - `tags` object[], required - `id` string, required - `name` string, required - `submitted_by` object, nullable, required — The user who submitted or added this event to the calendar. Null when the submitter's account no longer exists or is blocked. - `id` string, required - `name` string, nullable, required - `avatar_url` string, required - `email` string, nullable, required — The submitter's account email. Null when not returned. - `first_name` string, nullable, required - `last_name` string, nullable, required - object - `platform` 'luma', required - `id` string, required - `user_id` string, required - `calendar_id` string, required - `start_at` string, date-time, required — ISO 8601 Datetime. For example, 2022-10-19T03:27:13.673Z - `duration_interval` string, required - `end_at` string, date-time, required — ISO 8601 Datetime. For example, 2022-10-19T03:27:13.673Z - `created_at` string, date-time, required — ISO 8601 Datetime. For example, 2022-10-19T03:27:13.673Z - `timezone` string, required — IANA Timezone, e.g. America/New_York. https://en.wikipedia.org/wiki/List_of_tz_database_time_zones - `name` string, required - `geo_address_json` object, nullable, required - `address` string, required - `city` string, nullable, required - `region` string, nullable, required - `country` string, nullable, required - `city_state` string, nullable, required - `full_address` string, nullable, required - `google_maps_place_id` string, nullable, required - `apple_maps_place_id` string, nullable, required - `description` string, nullable, required - `coordinate` object, nullable, required — Latitude and longitude of the event location. Null for online events or when the address can't be geocoded. - `longitude` number, required - `latitude` number, required - `meeting_url` string, nullable, required - `location_type` 'discord' | 'meet' | 'twitch' | 'twitter' | 'youtube' | 'zoom' | 'offline' | 'missing' | 'unknown', required — `offline` for in-person events. Online events have the meeting platform (`zoom`, `meet`, etc.), or `unknown` if we don't recognize the meeting link. `missing` if the event has no location set. - `location_visibility` 'public' | 'guests-only', required — Whether the event's address is shown to everyone or only to approved guests. This API always returns the full address. - `cover_url` string, required - `registration_questions` union[] - union - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - `url` string, required - `visibility` 'public' | 'members-only' | 'private', required - `waitlist_status` 'disabled' | 'enabled', required — `enabled` if the event has a waitlist. New registrations join the waitlist once the event reaches capacity. - `registration_open` boolean, required — Whether the host is accepting registrations. When `false`, registration is closed and new guests can't sign up. Independent of capacity — a sold-out event with `waitlist_status` disabled still reports `true`. - `require_approval` boolean, required — `true` if registering requires host approval — i.e. any currently available ticket has approval turned on. - `spots_remaining` number, nullable, required — Spots left before the event hits its max capacity. Null when the event has no capacity limit (even if individual ticket types are capped). Refreshed by a background job, so this can lag a few seconds behind registrations. - `display_price` object, nullable, required — The starting ticket price shown on the event card. Null when registration is free — or, rarely, when nothing is currently purchasable (e.g. all paid tickets have expired). Refreshed by a background job, so this can lag a few seconds behind ticket changes. - `amount` number, required — Starting (lowest) ticket price in the currency's minor unit (e.g. cents for USD), tax included. - `currency` 'solana_sol' | 'solana_usdc' | 'aed' | 'afn' | 'all' | 'amd' | 'ang' | 'aoa' | 'ars' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bhd' | 'bif' | 'bmd' | 'bnd' | 'bob' | 'brl' | 'bsd' | 'bwp' | 'byn' | 'bzd' | 'cad' | 'cdf' | 'chf' | 'clp' | 'cny' | 'cop' | 'crc' | 'cve' | 'czk' | 'djf' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'etb' | 'eur' | 'fjd' | 'fkp' | 'gbp' | 'gel' | 'ghs' | 'gip' | 'gmd' | 'gnf' | 'gtq' | 'gyd' | 'hkd' | 'hnl' | 'htg' | 'huf' | 'idr' | 'ils' | 'inr' | 'isk' | 'jmd' | 'jod' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kwd' | 'kyd' | 'kzt' | 'lak' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mur' | 'mvr' | 'mwk' | 'mxn' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nio' | 'nok' | 'npr' | 'nzd' | 'omr' | 'pab' | 'pen' | 'pgk' | 'php' | 'pkr' | 'pln' | 'pyg' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sek' | 'sgd' | 'shp' | 'sle' | 'sos' | 'srd' | 'std' | 'szl' | 'thb' | 'tjs' | 'tnd' | 'top' | 'try' | 'ttd' | 'twd' | 'tzs' | 'uah' | 'ugx' | 'usd' | 'uyu' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'xof' | 'xpf' | 'yer' | 'zar' | 'zmw', required — Lowercase ISO 4217 currency code, e.g. `usd`. - `is_flexible` boolean, required — `true` for pay-what-you-want pricing — `amount` is the suggested price and guests can pay more. - `feedback_email` object, required — Settings for the post-event feedback email sent to guests. - `enabled` boolean, required — Whether to send the feedback email. - `delay` string — How long after the event ends to send the feedback email. Defaults to PT0M (immediately). Maximum is P7D (7 days). - `access` 'manage', required - `tags` object[], required - `id` string, required - `name` string, required - `submitted_by` object, nullable, required — The user who submitted or added this event to the calendar. Null when the submitter's account no longer exists or is blocked. - `id` string, required - `name` string, nullable, required - `avatar_url` string, required - `email` string, nullable, required — The submitter's account email. Null when not returned. - `first_name` string, nullable, required - `last_name` string, nullable, required - object - `platform` 'external', required - `id` string, required - `calendar_id` string, required - `start_at` string, date-time, required — ISO 8601 Datetime. For example, 2022-10-19T03:27:13.673Z - `duration_interval` string, required - `end_at` string, date-time, required — ISO 8601 Datetime. For example, 2022-10-19T03:27:13.673Z - `created_at` string, date-time, required — ISO 8601 Datetime. For example, 2022-10-19T03:27:13.673Z - `timezone` string, required — IANA Timezone, e.g. America/New_York. https://en.wikipedia.org/wiki/List_of_tz_database_time_zones - `name` string, required - `geo_address_json` object, nullable, required - `address` string, required - `city` string, nullable, required - `region` string, nullable, required - `country` string, nullable, required - `city_state` string, nullable, required - `full_address` string, nullable, required - `google_maps_place_id` string, nullable, required - `apple_maps_place_id` string, nullable, required - `description` string, nullable, required - `coordinate` object, nullable, required — Latitude and longitude of the event location. Null for online events or when the address can't be geocoded. - `longitude` number, required - `latitude` number, required - `url` string, required - `host` string, nullable, required - `tags` object[], required - `id` string, required - `name` string, required - `submitted_by` object, nullable, required — The user who submitted or added this event to the calendar. Null when the submitter's account no longer exists or is blocked. - `id` string, required - `name` string, nullable, required - `avatar_url` string, required - `email` string, nullable, required — The submitter's account email. Null when not returned. - `first_name` string, nullable, required - `last_name` string, nullable, required - `has_more` boolean, required - `next_cursor` string --- [API](https://skmtc.net/luma/apis/luma-api.md) · [All operations](https://skmtc.net/luma/apis/luma-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/luma/luma-api/versions/12835be09062/schema)