v1

latestOpenAPI 3.1.0Proprietary2026-07-24660315.0 KB
Calendars

List Events

Every event and API key on Luma is managed by a Luma Calendar. 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.

get/v1/calendars/events/list

Query parameters

beforestring date-time

ISO 8601 Datetime. For example, 2022-10-19T03:27:13.673Z

ISO 8601 Datetime. For example, 2022-10-19T03:27:13.673Z

afterstring date-time

ISO 8601 Datetime. For example, 2022-10-19T03:27:13.673Z

ISO 8601 Datetime. For example, 2022-10-19T03:27:13.673Z

pagination_cursorstring

Value of next_cursor from a previous request.

Value of next_cursor from a previous request.

pagination_limitnumber

The number of items to return. The server will enforce a maximum number.

The number of items to return. The server will enforce a maximum number.

platformsstring[]

Which event platforms to include. Defaults to luma for backwards compatibility. Pass as repeated query params, e.g. ?platforms=luma&platforms=external.

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.

Filter by calendar submission status. Defaults to approved.

accessstring[]

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.

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

Successful response.

has_moreboolean required
next_cursorstring