List Events

get

https://public-api.luma.com/v1/calendars/events/list

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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

before

date-time

^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$

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

after

date-time

^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$

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

array of strings

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

platforms

Allowed:

sort_column

string

enum

Allowed:

sort_direction

string

enum

Allowed:

status

string

enum

Filter by calendar submission status. Defaults to approved.

Allowed:

access

array of strings

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.

access

Allowed:

Response

200Successful response.