> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Luma: Get V1 Events Guests List
> Get list of guests who have registered or been invited to an event. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.
Get list of guests who have registered or been invited to an event.
Tool ID: `luma_get_v1_events_guests_list`
## Run this action
Use the TypeScript SDK for a single call. Put `ctx.tools.execute(...)` inside a Play when the call should be durable, scheduled, or run across a CSV.
```ts theme={null}
import { Deepline } from 'deepline';
const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
'luma_get_v1_events_guests_list',
{
"event_id": "event_123"
},
);
console.log(result.toolResponse.raw);
```
### CLI
```bash theme={null}
deepline tools execute luma_get_v1_events_guests_list --input '{
"event_id": "event_123"
}' --json
```
## Example response
The static output schema is not detailed enough to generate a reliable example. Use `deepline tools get luma_get_v1_events_guests_list --json` for the complete live contract.
## Input reference
Get list of guests who have registered or been invited to an event. This list response includes guest summaries and `event_tickets`, but not order-level details like `event_ticket_orders`. Use `/v1/events/guests/get` when you need detailed ticket order data for a specific guest.
| Name | Type | Required | Default | Details |
| --------------------------- | ---------------------------------------------------------------------------------------- | -------- | ------- | -------------------------------------------------------------------------------------- |
| `payload.event_id` | `string` | Yes | — | Event ID, this usually starts with evt- |
| `payload.approval_status` | `"approved" \| "session" \| "pending_approval" \| "invited" \| "declined" \| "waitlist"` | No | — | Allowed: `approved`, `session`, `pending_approval`, `invited`, `declined`, `waitlist`. |
| `payload.pagination_cursor` | `string` | No | — | Value of `next_cursor` from a previous request. |
| `payload.pagination_limit` | `number` | No | — | The number of items to return. The server will enforce a maximum number. |
| `payload.sort_column` | `"name" \| "email" \| "created_at" \| "registered_at" \| "checked_in_at"` | No | — | Allowed: `name`, `email`, `created_at`, `registered_at`, `checked_in_at`. |
| `payload.sort_direction` | `"asc" \| "desc" \| "asc nulls last" \| "desc nulls last"` | No | — | Allowed: `asc`, `desc`, `asc nulls last`, `desc nulls last`. |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "Get list of guests who have registered or been invited to an event. This list response includes guest summaries and `event_tickets`, but not order-level details like `event_ticket_orders`. Use `/v1/events/guests/get` when you need detailed ticket order data for a specific guest.",
"properties": {
"event_id": {
"type": "string",
"description": "Event ID, this usually starts with evt-"
},
"approval_status": {
"type": "string",
"enum": [
"approved",
"session",
"pending_approval",
"invited",
"declined",
"waitlist"
]
},
"pagination_cursor": {
"type": "string",
"description": "Value of `next_cursor` from a previous request."
},
"pagination_limit": {
"type": "number",
"description": "The number of items to return. The server will enforce a maximum number."
},
"sort_column": {
"type": "string",
"enum": [
"name",
"email",
"created_at",
"registered_at",
"checked_in_at"
]
},
"sort_direction": {
"type": "string",
"enum": [
"asc",
"desc",
"asc nulls last",
"desc nulls last"
]
}
},
"required": [
"event_id"
],
"additionalProperties": false
}
```
## Output reference
Standard tool result payload.
| Name | Type | Required | Default | Details |
| -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.entries` | `array` | Yes | — | — |
| `result.data.entries[].id` | `string` | Yes | — | — |
| `result.data.entries[].user_id` | `string` | Yes | — | — |
| `result.data.entries[].user_email` | `string` | Yes | — | — |
| `result.data.entries[].user_name` | `string \| null` | Yes | — | — |
| `result.data.entries[].user_first_name` | `string \| null` | Yes | — | — |
| `result.data.entries[].user_last_name` | `string \| null` | Yes | — | — |
| `result.data.entries[].approval_status` | `"approved" \| "session" \| "pending_approval" \| "invited" \| "declined" \| "waitlist"` | Yes | — | Allowed: `approved`, `session`, `pending_approval`, `invited`, `declined`, `waitlist`. |
| `result.data.entries[].check_in_qr_code` | `string` | Yes | — | — |
| `result.data.entries[].eth_address` | `string \| null` | Yes | — | Pattern: `^0x[0-9a-fA-F]{40}$`. |
| `result.data.entries[].invited_at` | `string \| null` | Yes | — | When the guest was invited to the event. Null if they registered on their own. Format: `date-time`. |
| `result.data.entries[].joined_at` | `string \| null` | Yes | — | When the guest first clicked the virtual join link (luma.com/join/...). Only set for online events. Null if the guest has not joined. Format: `date-time`. |
| `result.data.entries[].phone_number` | `string \| null` | Yes | — | — |
| `result.data.entries[].registered_at` | `string \| null` | Yes | — | When the guest registered for the event. Format: `date-time`. |
| `result.data.entries[].registration_answers` | `array \| null` | Yes | — | — |
| `result.data.entries[].registration_answers[].label` | `string` | Yes | — | — |
| `result.data.entries[].registration_answers[].question_id` | `string` | Yes | — | — |
| `result.data.entries[].registration_answers[].value` | `boolean` | Yes | — | — |
| `result.data.entries[].registration_answers[].question_type` | `"agree-check"` | Yes | — | — |
| `result.data.entries[].registration_answers[].value.company` | `string \| null` | No | — | — |
| `result.data.entries[].registration_answers[].value.job_title` | `string \| null` | No | — | — |
| `result.data.entries[].registration_answers[].multiple` | `false` | No | — | — |
| `result.data.entries[].registration_answers[].multiline` | `boolean \| null` | No | — | — |
| `result.data.entries[].solana_address` | `string \| null` | Yes | — | Pattern: `^[5KL1-9A-HJ-NP-Za-km-z]{32,44}$`. |
| `result.data.entries[].utm_source` | `string \| null` | Yes | — | The UTM source parameter captured when the guest registered (from the `?utm_source=` query parameter). |
| `result.data.entries[].attribution_params` | `object \| null` | Yes | — | Marketing parameters captured from the URL when the guest registered: `utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content`, and ad click IDs such as `gclid` or `fbclid`. Only parameters present on the URL are included. Null when none were captured. |
| `result.data.entries[].event_tickets` | `array` | Yes | — | — |
| `result.data.entries[].event_tickets[].id` | `string` | Yes | — | — |
| `result.data.entries[].event_tickets[].amount` | `number` | Yes | — | — |
| `result.data.entries[].event_tickets[].amount_discount` | `number` | Yes | — | — |
| `result.data.entries[].event_tickets[].amount_tax` | `number` | Yes | — | — |
| `result.data.entries[].event_tickets[].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"` | Yes | — | Allowed: `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`, See the live schema for the complete constraint. |
| `result.data.entries[].event_tickets[].checked_in_at` | `string \| null` | Yes | — | ISO 8601 Datetime. For example, 2022-10-19T03:27:13.673Z Format: `date-time`. |
| `result.data.entries[].event_tickets[].event_ticket_type_id` | `string` | Yes | — | — |
| `result.data.entries[].event_tickets[].is_captured` | `boolean` | Yes | — | — |
| `result.data.entries[].event_tickets[].name` | `string` | Yes | — | — |
| `result.data.has_more` | `boolean` | Yes | — | — |
| `result.data.next_cursor` | `string` | No | — | — |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |
This output schema is too large to embed without slowing the page. Get the complete live contract with `deepline tools get luma_get_v1_events_guests_list --json`.
## Deepline cost
* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.
## Related documentation
* [Luma provider guide](/docs/providers/luma/guide)
* [SDK V2 quickstart](/docs/sdk-v2/quickstart)
* [SDK reference](/docs/sdk-v2/sdk-reference)
* [Run tools across a CSV](/docs/sdk-v2/batch-csv)