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

> List guests registered or invited to an event, with ticket summaries. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

List guests registered or invited to an event, with ticket summaries.

> [!NOTE]
>
> Tool ID: `luma_get_v1_events_guests_list`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
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={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute luma_get_v1_events_guests_list --input '{
  "event_id": "event_123"
}' --json
```

## Example response

The static output schema lacks the details for a reliable example. Use `deepline describe 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`. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "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
  }
  ```
</details>

## 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]&#123;40&#125;$`. |
| `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]&#123;32,44&#125;$`. |
| `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). |

> [!NOTE]
>
> This output schema is too large for an inline display. Read the complete live contract with `deepline describe 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](https://deepline.com/docs/providers/luma/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.