---
title: "List events"
method: GET
path: "/v1/events"
tags: ["events"]
---

# List events

`GET /v1/events`

## Request

- Base URL: `https://sofiastage.com/api`
- URL: `https://sofiastage.com/api/v1/events`
- Auth: none declared

Defaults to tz=Europe/Sofia when interpreting local starts_after/starts_before values. For 'today' queries, use date_from=date_to=<today in tz>. For 'tonight', combine a single-day date range with starts_after (for example 19:30).

## Query parameters

- `date_from` string, date
- `date_to` string, date
- `starts_after` string
- `starts_before` string
- `tz` string
- `scope` 'sofia' | 'all'
- `city` string
- `venue` string
- `title` string
- `star` string
- `extra` string
- `extra_id` integer
- `limit` integer
- `cursor` string
- `include` string

## Response `200`

Paginated event list

- EventsResponse
  - `data` Event[], required
    - `id` string, required
    - `source_id` string, required
    - `title` string, nullable, required
    - `venue` string, nullable, required
    - `city` string, required
    - `address` string, nullable, required
    - `stage` string, nullable, required
    - `starts_at` string, date-time, required
    - `event_date` string, date, required
    - `ticket_url` string, uri, nullable, required
    - `ticket_links` string[], required
    - `info_url` string, uri, nullable, required
    - `image_url` string, uri, nullable, required
    - `canonical_url` string, uri, nullable, required
    - `venue_url` string, uri, nullable, required
    - `city_url` string, uri, nullable, required
    - `stars` EventStarReference[]
      - `id` integer, required
      - `name` string, required
      - `occupation` string, nullable, required
      - `image_url` string, uri, nullable, required
      - `profile_url` string, uri, nullable, required
    - `extras` EventExtraReference[]
      - `id` integer, required
      - `title` string, required
      - `subtitle` string, nullable, required
      - `image_url` string, uri, nullable, required
      - `is_open` 0 | 1, required
      - `open_label` string, nullable, required
      - `profile_image_link` string, uri, nullable, required
      - `article` string, nullable, required: Top article body in markdown.
      - `bottom_article` string, nullable, required: Bottom article body in markdown.
      - `has_top_article` 0 | 1, required
      - `has_bottom_article` 0 | 1, required
      - `upcoming_events_count` integer, required
  - `page` EventsPage, required
    - `limit` integer, required
    - `has_more` boolean, required
    - `next_cursor` string, nullable, required
  - `filters` EventsFilters, required
    - `date_from` string, date, nullable, required
    - `date_to` string, date, nullable, required
    - `starts_after` string, date-time, nullable, required: Echo of starts_after normalized by the API to RFC3339 UTC (Z).
    - `starts_before` string, date-time, nullable, required: Echo of starts_before normalized by the API to RFC3339 UTC (Z).
    - `tz` string, nullable, required
    - `scope` 'sofia' | 'all', required
    - `city` string, nullable, required
    - `venue` string, nullable, required
    - `title` string, nullable, required
    - `star` string, nullable, required
    - `extra` string, nullable, required
    - `extra_id` integer, nullable, required
    - `include` string[], required

## Other responses

- `400`: Bad request
- `429`: Too many requests (retry with backoff)

---

[API](https://skmtc.dev/sofiastage/apis/sofiastage-agent-api.md) · [All operations](https://skmtc.dev/sofiastage/apis/sofiastage-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sofiastage/apis/sofiastage-agent-api/revisions/ad9101e211ac?raw)