List guests

List Luma event guests with luma.events.guests.list(), returning a paginated response of guest entries with RSVP, approval, and check-in status.

Example

const { data: guests } = await luma.events.guests.list("evt-abc123", {
  pagination_limit: 50,
});

console.log(guests.length);

Response

{
  "data": [
    {
      "api_id": "gst-xyz789",
      "email": "[e-mail]",
      "name": "Jane Doe",
      "approval_status": "approved"
    }
  ],
  "hasMore": false,
  "nextCursor": null
}

SDK luma.events.guests.list(eventId: string, params?: GuestListParams): Promise<ListResponse<GuestListEntry>>

Returns a paginated list of guests for an event.

Example

const { data: guests } = await luma.events.guests.list("evt-abc123", {
  pagination_limit: 50,
});

console.log(guests.length);

Response

{
  "data": [
    {
      "api_id": "gst-xyz789",
      "email": "[e-mail]",
      "name": "Jane Doe",
      "approval_status": "approved"
    }
  ],
  "hasMore": false,
  "nextCursor": null
}

Parameters

eventId · string · required

Event api_id from events.list().

params · GuestListParams

Optional pagination and filter options. See the official Luma API docs for available fields.

See Client — List responses for the shared pagination shape.

Test it

Use an event ID from your calendar — run events.list() to find one:

const eventId = "evt-abc123";

const { data: guests } = await luma.events.guests.list(eventId, {
  pagination_limit: 5,
});
console.log(guests.length);