> ## Documentation Index
> Fetch the complete documentation index at: https://alhwyn.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<Badge color="purple">SDK</Badge> `luma.events.guests.list(eventId: string, params?: GuestListParams): Promise<ListResponse<GuestListEntry>>`

Returns a paginated list of guests for an event.

<RequestExample>
  ```typescript Example theme={null}
  const { data: guests } = await luma.events.guests.list("evt-abc123", {
    pagination_limit: 50,
  });

  console.log(guests.length);
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": [
      {
        "api_id": "gst-xyz789",
        "email": "jane@example.com",
        "name": "Jane Doe",
        "approval_status": "approved"
      }
    ],
    "hasMore": false,
    "nextCursor": null
  }
  ```
</ResponseExample>

### Parameters

<ParamField path="eventId" type="string" required>
  Event `api_id` from `events.list()`.
</ParamField>

<ParamField path="params" type="GuestListParams">
  Optional pagination and filter options. See the [official Luma API docs](https://docs.luma.com) for available fields.
</ParamField>

See [Client — List responses](/client#list-responses) for the shared pagination shape.

### Test it

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

```typescript theme={null}
const eventId = "evt-abc123";

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