---
title: "Retrieve user-created events"
method: GET
path: "/saas/v2/events"
tags: ["Event v2"]
---

# Retrieve user-created events

`GET /saas/v2/events`

## Query parameters

- `pagination_token` string — Pagination token
- `status` 'setup_required' | 'upcoming' | 'ready' | 'live' | 'finished'
- `q` string — Full-text search over title and description

## Response `200`

Successful Response

- GenericResponsePayloadListEventsV2ResponseData
  - `ok` boolean — Indicates if the request was successful or not.
  - `data` ListEventsV2ResponseDataOutput, required
    - `events` EventV2DTO[] — User-created events
      - `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
    - `pagination_token` string — Pagination token for the next page

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