---
title: "Retrieve a single event by ID"
method: GET
path: "/saas/v2/event/{event_id}"
tags: ["Event v2"]
---

# Retrieve a single event by ID

`GET /saas/v2/event/{event_id}`

## Path parameters

- `event_id` string, uuid4, required

## Response `200`

Successful Response

- GenericResponsePayloadGetEventV2ByIdResponseData
  - `ok` boolean — Indicates if the request was successful or not.
  - `data` GetEventV2ByIdResponseDataOutput, required
    - `event_id` string, uuid, required — Event ID
    - `title` string, required — Event title
    - `description` string — Event description
    - `event_type` 'in-person' | 'online', required
    - `location` string — Event location
    - `timezone` string — Event IANA timezone
    - `utc_start_dt` string, date-time, required — Event start date and time in UTC
    - `utc_end_dt` string, date-time, required — Event end date and time in UTC
    - `is_recurring` boolean — Indicates if the event is recurring
    - `cover_image_key` string — Event cover image S3 key
    - `cover_image_url` string, uri — Event cover image URL
    - `qr_code_url` string, uri, required — Event QR code URL
    - `lifecycle_status` 'setup_required' | 'upcoming' | 'ready' | 'live' | 'finished', required
    - `finished_at` string, date-time — Event completion time in UTC
    - `access_code` string — Event access code
    - `input_languages` string[] — Event input languages (aggregated from channels)
    - `output_languages` string[] — Event output languages (aggregated from channels)
    - `target_languages` string[] — Organizer-configured default translation languages; pre-fills the language list when creating channels
    - `listener_language_mode` 'off' | 'approval' | 'auto'
    - `utc_created_at` string, date-time, required — Event creation time in UTC
    - `utc_updated_at` string, date-time, required — Event last update time in UTC
    - `stages` StageWithChannelRefsDTOOutput[] — Event stages with derived status and their channel refs (id + live runtime status)
      - `stage_id` string, uuid, required — Stage ID
      - `event_id` string, uuid, required — Parent event ID
      - `name` string, required — Stage name
      - `status` 'setup_required' | 'ready' | 'live', required
      - `qr_code_url` string, uri, required — Stage QR code URL
      - `greenscreen_settings` object — Stage caption rendering settings
      - `utc_created_at` string, date-time, required — Stage creation time in UTC
      - `utc_updated_at` string, date-time, required — Stage last update time in UTC
      - `channels` ChannelRefDTO[] — Channels in the stage (lean ref: id, broadcast link, live runtime status)
        - `channel_id` string, uuid, required — Channel ID
        - `broadcast_id` string, uuid — Underlying broadcast ID for direct streaming access
        - `runtime_status` 'pending' | 'running' | 'errored'

## Other responses

- `default` — Default Response

---

[API](https://skmtc.dev/palabra/apis/palabra-api.md) · [All operations](https://skmtc.dev/palabra/apis/palabra-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/palabra/palabra-api/revisions/cb8721654525/schema)