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

> Get one event guest by ID, including ticket orders and any coupon applied. Includes SDK V2 examples, input constraints, response fields, and Deepline cost.

Get one event guest by ID, including ticket orders and any coupon applied.

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

## 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_get',
  {
    "event_id": "event_123",
    "id": "id_123"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute luma_get_v1_events_guests_get --input '{
  "event_id": "event_123",
  "id": "id_123"
}' --json
```

## Example response

The static output schema lacks the details for a reliable example. Use `deepline describe luma_get_v1_events_guests_get --json` for the complete live contract.

## Input reference

Get detailed information for an event guest by looking them up by their ID. This supports looking them up by different parameters. This response includes `event_ticket_orders`, which includes `coupon_info` when a coupon was applied.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.event_id` | `string` | Yes | — | Event ID, this usually starts with evt- |
| `payload.id` | `string` | Yes | — | Guest identifier — the guest ID (gst-), a ticket key, a guest key (g-), or the user's email. |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Get detailed information for an event guest by looking them up by their ID. This supports looking them up by different parameters. This response includes `event_ticket_orders`, which includes `coupon_info` when a coupon was applied.",
    "properties": {
      "event_id": {
        "type": "string",
        "description": "Event ID, this usually starts with evt-"
      },
      "id": {
        "type": "string",
        "description": "Guest identifier — the guest ID (gst-), a ticket key, a guest key (g-), or the user's email."
      }
    },
    "required": [
      "event_id",
      "id"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.id` | `string` | Yes | — | — |
| `result.data.user_id` | `string` | Yes | — | — |
| `result.data.user_email` | `string` | Yes | — | — |
| `result.data.user_name` | `string \| null` | Yes | — | — |
| `result.data.user_first_name` | `string \| null` | Yes | — | — |
| `result.data.user_last_name` | `string \| null` | Yes | — | — |
| `result.data.approval_status` | `"approved" \| "session" \| "pending_approval" \| "invited" \| "declined" \| "waitlist"` | Yes | — | Allowed: `approved`, `session`, `pending_approval`, `invited`, `declined`, `waitlist`. |
| `result.data.check_in_qr_code` | `string` | Yes | — | — |
| `result.data.eth_address` | `string \| null` | Yes | — | Pattern: `^0x[0-9a-fA-F]&#123;40&#125;$`. |
| `result.data.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.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.phone_number` | `string \| null` | Yes | — | — |
| `result.data.registered_at` | `string \| null` | Yes | — | When the guest registered for the event. Format: `date-time`. |
| `result.data.registration_answers` | `array \| null` | Yes | — | — |
| `result.data.registration_answers[].label` | `string` | Yes | — | — |
| `result.data.registration_answers[].question_id` | `string` | Yes | — | — |
| `result.data.registration_answers[].value` | `boolean` | Yes | — | — |
| `result.data.registration_answers[].question_type` | `"agree-check"` | Yes | — | — |
| `result.data.registration_answers[].value.company` | `string \| null` | No | — | — |
| `result.data.registration_answers[].value.job_title` | `string \| null` | No | — | — |
| `result.data.registration_answers[].multiple` | `false` | No | — | — |
| `result.data.registration_answers[].multiline` | `boolean \| null` | No | — | — |
| `result.data.solana_address` | `string \| null` | Yes | — | Pattern: `^[5KL1-9A-HJ-NP-Za-km-z]&#123;32,44&#125;$`. |
| `result.data.utm_source` | `string \| null` | Yes | — | The UTM source parameter captured when the guest registered (from the `?utm_source=` query parameter). |
| `result.data.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.event_tickets` | `array` | Yes | — | — |
| `result.data.event_tickets[].id` | `string` | Yes | — | — |
| `result.data.event_tickets[].amount` | `number` | Yes | — | — |
| `result.data.event_tickets[].amount_discount` | `number` | Yes | — | — |
| `result.data.event_tickets[].amount_tax` | `number` | Yes | — | — |
| `result.data.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.event_tickets[].checked_in_at` | `string \| null` | Yes | — | ISO 8601 Datetime. For example, 2022-10-19T03:27:13.673Z Format: `date-time`. |
| `result.data.event_tickets[].event_ticket_type_id` | `string` | Yes | — | — |
| `result.data.event_tickets[].is_captured` | `boolean` | Yes | — | — |
| `result.data.event_tickets[].name` | `string` | Yes | — | — |
| `result.data.event_ticket_orders` | `array` | Yes | — | Detailed ticket orders for this guest. Use this to inspect applied coupon\_info per order. |
| `result.data.event_ticket_orders[].id` | `string` | Yes | — | — |
| `result.data.event_ticket_orders[].amount` | `number` | Yes | — | — |
| `result.data.event_ticket_orders[].amount_discount` | `number` | Yes | — | — |
| `result.data.event_ticket_orders[].amount_tax` | `number` | Yes | — | — |
| `result.data.event_ticket_orders[].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.event_ticket_orders[].coupon_info` | `object \| null` | Yes | — | The coupon that was applied to this ticket order, if any. |
| `result.data.event_ticket_orders[].coupon_info.api_id` | `string` | Yes | — | — |
| `result.data.event_ticket_orders[].coupon_info.percent_off` | `number \| null` | Yes | — | — |
| `result.data.event_ticket_orders[].coupon_info.cents_off` | `number \| null` | Yes | — | — |
| `result.data.event_ticket_orders[].coupon_info.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.event_ticket_orders[].coupon_info.code` | `string` | Yes | — | — |
| `result.data.event_ticket_orders[].is_captured` | `boolean` | Yes | — | — |
| `result.data.event_ticket_orders[].amount_refunded` | `number` | Yes | — | Total amount refunded on this order so far, in minor units of `currency`. Includes partial refunds. `amount - amount_refunded` is the amount kept. |

The table shows the first 50 fields. Expand the raw schema below for every field.

> [!NOTE]
>
> This output schema is too large for an inline display. Read the complete live contract with `deepline describe luma_get_v1_events_guests_get --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.