> ## 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 Get > Return details about an event. Includes SDK V2 and CLI requests, input constraints, response fields, and Deepline credit cost. Return details about an event. Tool ID: `luma_get_v1_events_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_get', { "event_id": "event_123" }, ); console.log(result.toolResponse.raw); ``` ### CLI ```bash theme={null} deepline tools execute luma_get_v1_events_get --input '{ "event_id": "event_123" }' --json ``` ## Example response The SDK exposes this shape at `result.toolResponse.raw`. Values below are representative. ```json theme={null} { "data": { "platform": "luma", "id": "id_123", "user_id": "user_123", "calendar_id": "calendar_123", "start_at": "2026-01-15T12:00:00Z", "duration_interval": "example", "end_at": "2026-01-15T12:00:00Z", "created_at": "2026-01-15T12:00:00Z", "timezone": "America/New_York", "name": "Example", "cover_url": "https://example.com", "url": "https://example.com", "visibility": "public", "location_type": "discord", "location_visibility": "public", "waitlist_status": "disabled", "registration_open": true, "require_approval": true, "spots_remaining": 1, "display_price": { "amount": 123, "currency": "solana_sol", "is_flexible": true }, "access": "view", "geo_address_json": { "address": "example", "city": "San Francisco", "region": "example", "country": "US", "city_state": "California", "full_address": "example", "google_maps_place_id": "google_maps_place_123", "apple_maps_place_id": "apple_maps_place_123", "description": "Example description" }, "coordinate": { "longitude": 123, "latitude": 123 }, "description": "Example description", "description_md": "example", "hosts": [ { "id": "id_123", "name": "Example", "avatar_url": "https://example.com" } ] } } ``` Use `deepline tools get luma_get_v1_events_get --json` for the latest machine-readable contract. ## Input reference Return details about an event. For events you manage (`access: "manage"`), this includes full detail, host contact info, and a breakdown of guest counts by status. For public events you don’t manage (`access: "view"`), only the fields a regular event-page visitor could see are returned. | Name | Type | Required | Default | Details | | ------------------ | -------- | -------- | ------- | --------------------------------------- | | `payload.event_id` | `string` | Yes | — | Event ID, this usually starts with evt- |
Show raw input schema ### Input JSON Schema ```json theme={null} { "type": "object", "description": "Return details about an event. For events you manage (`access: \"manage\"`), this includes full detail, host contact info, and a breakdown of guest counts by status. For public events you don’t manage (`access: \"view\"`), only the fields a regular event-page visitor could see are returned.", "properties": { "event_id": { "type": "string", "description": "Event ID, this usually starts with evt-" } }, "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.platform` | `"luma"` | Yes | — | — | | `result.data.id` | `string` | Yes | — | — | | `result.data.user_id` | `string` | Yes | — | — | | `result.data.calendar_id` | `string` | Yes | — | — | | `result.data.start_at` | `string` | Yes | — | ISO 8601 Datetime. For example, 2022-10-19T03:27:13.673Z | | `result.data.duration_interval` | `string` | Yes | — | ISO 8601 Duration. For example, PT2H | | `result.data.end_at` | `string` | Yes | — | ISO 8601 Datetime. For example, 2022-10-19T03:27:13.673Z | | `result.data.created_at` | `string` | Yes | — | ISO 8601 Datetime. For example, 2022-10-19T03:27:13.673Z | | `result.data.timezone` | `string` | Yes | — | IANA Timezone, e.g. America/New\_York. [https://en.wikipedia.org/wiki/List\_of\_tz\_database\_time\_zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) | | `result.data.name` | `string` | Yes | — | — | | `result.data.cover_url` | `string` | Yes | — | — | | `result.data.url` | `string` | Yes | — | — | | `result.data.visibility` | `"public" \| "members-only" \| "private"` | Yes | — | — | | `result.data.location_type` | `"discord" \| "meet" \| "twitch" \| "twitter" \| "youtube" \| "zoom" \| "offline" \| "missing" \| "unknown"` | Yes | — | `offline` for in-person events. Online events have the meeting platform (`zoom`, `meet`, etc.), or `unknown` if we don't recognize the meeting link. `missing` if the event has no location set. | | `result.data.location_visibility` | `"public" \| "guests-only"` | Yes | — | Whether the event's address is shown to everyone or only to approved guests. Events you manage always return the full address. | | `result.data.waitlist_status` | `"disabled" \| "enabled"` | Yes | — | `enabled` if the event has a waitlist. New registrations join the waitlist once the event reaches capacity. | | `result.data.registration_open` | `boolean` | Yes | — | Whether the host is accepting registrations. When `false`, registration is closed and new guests can't sign up. Independent of capacity — a sold-out event with `waitlist_status` disabled still reports `true`. | | `result.data.require_approval` | `boolean` | Yes | — | `true` if registering requires host approval — i.e. any currently available ticket has approval turned on. | | `result.data.spots_remaining` | `number \| null` | Yes | — | Spots left before the event hits its max capacity. Null when the event has no capacity limit (even if individual ticket types are capped). Refreshed by a background job, so this can lag a few seconds behind registrations. | | `result.data.display_price` | `object \| null` | Yes | — | The starting ticket price shown on the event card. Null when registration is free — or, rarely, when nothing is currently purchasable (e.g. all paid tickets have expired). Refreshed by a background job, so this can lag a few seconds behind ticket changes. | | `result.data.display_price.amount` | `number` | Yes | — | Starting (lowest) ticket price in the currency's minor unit (e.g. cents for USD), tax included. | | `result.data.display_price.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 | — | — | | `result.data.display_price.is_flexible` | `boolean` | Yes | — | `true` for pay-what-you-want pricing — `amount` is the suggested price and guests can pay more. | | `result.data.access` | `"view"` | Yes | — | — | | `result.data.geo_address_json` | `object \| null` | Yes | — | Address info for events you don't manage. When the host has set the address to be visible only to guests, only city-level fields (city, region, country, city\_state) are populated. | | `result.data.geo_address_json.address` | `string` | Yes | — | — | | `result.data.geo_address_json.city` | `string \| null` | Yes | — | — | | `result.data.geo_address_json.region` | `string \| null` | Yes | — | — | | `result.data.geo_address_json.country` | `string \| null` | Yes | — | — | | `result.data.geo_address_json.city_state` | `string \| null` | Yes | — | — | | `result.data.geo_address_json.full_address` | `string \| null` | Yes | — | — | | `result.data.geo_address_json.google_maps_place_id` | `string \| null` | Yes | — | — | | `result.data.geo_address_json.apple_maps_place_id` | `string \| null` | Yes | — | — | | `result.data.geo_address_json.description` | `string \| null` | Yes | — | — | | `result.data.coordinate` | `object \| null` | Yes | — | Latitude and longitude of the event. Obfuscated to a coarse area when the host has set the address to be visible only to guests. Null for online events or when no coordinate is set. | | `result.data.coordinate.longitude` | `number` | Yes | — | — | | `result.data.coordinate.latitude` | `number` | Yes | — | — | | `result.data.description` | `string` | Yes | — | — | | `result.data.description_md` | `string` | Yes | — | — | | `result.data.hosts` | `array` | Yes | — | — | | `result.data.hosts[].id` | `string` | Yes | — | — | | `result.data.hosts[].name` | `string \| null` | Yes | — | — | | `result.data.hosts[].avatar_url` | `string` | Yes | — | — | | `result.data.meeting_url` | `string \| null` | Yes | — | — | | `result.data.registration_questions` | `array` | No | — | — | | `result.data.registration_questions[].id` | `string` | Yes | — | — | | `result.data.registration_questions[].label` | `string` | Yes | — | — | | `result.data.registration_questions[].required` | `boolean` | Yes | — | — | | `result.data.registration_questions[].source` | `object` | No | — | — | The table shows the first 50 fields. Use the live contract 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_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)