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

> Get an event's details. Events you manage include host contact info and guest counts by status. public events return only what a visitor sees.

Get an event's details.

> [!NOTE]
>
> Tool ID: `luma_get_v1_events_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_get',
  {
    "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_get --input '{
  "event_id": "event_123"
}' --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

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

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

  ### Input JSON Schema

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

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

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