> ## 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 detailed information for an event guest by looking them up by their ID. Includes SDK V2 examples, input constraints, response fields, and Deepline cost.
Get detailed information for an event guest by looking them up by their ID.
Tool ID: `luma_get_v1_events_guests_get`
## 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_get',
{
"event_id": "event_123",
"id": "id_123"
},
);
console.log(result.toolResponse.raw);
```
### CLI
```bash theme={null}
deepline tools execute luma_get_v1_events_guests_get --input '{
"event_id": "event_123",
"id": "id_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_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. |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"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
}
```
## 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]{40}$`. |
| `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]{32,44}$`. |
| `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.
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_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](/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)