events

List events

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

get/v1/events

Request

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

Query parameters

date_fromstring date

Lower inclusive date bound in YYYY-MM-DD format.

date_tostring date

Upper inclusive date bound in YYYY-MM-DD format.

starts_afterstring

Lower inclusive start-time bound. Supports HH:mm, local YYYY-MM-DDTHH:mm (with tz), or RFC3339 with offset/Z.

starts_beforestring

Upper inclusive start-time bound. Supports HH:mm, local YYYY-MM-DDTHH:mm (with tz), or RFC3339 with offset/Z.

tzstring
Example:Europe/Sofia

IANA timezone for local starts_* values. Defaults to Europe/Sofia.

scope'sofia' | 'all'

City coverage. Defaults to sofia; use all to search every available city.

citystring
Example:Шумен

Case-insensitive partial match against city name. Overrides the default Sofia scope.

venuestring

Case-insensitive partial match against venue name.

titlestring

Case-insensitive partial match against event title.

starstring

Case-insensitive match against linked star names.

extrastring

Case-insensitive match against linked extras titles.

extra_idinteger

Filter events linked to a specific extra ID.

limitinteger

Page size. Values above 100 are clamped to 100.

cursorstring

Opaque cursor from page.next_cursor. Reuse with the same filters.

includestring
Example:stars,extras

Optional related entities. Use comma-separated and/or repeated values. Allowed tokens: stars, extras.

Response

Paginated event list

Example response

{
  "data": [
    {
      "id": "sh_v1_6e1f0d4d5cf4c734b7e2d4803d5ff7a4",
      "source_id": "sh_v1_6e1f0d4d5cf4c734b7e2d4803d5ff7a4",
      "title": "Баба",
      "venue": "Топлоцентрала",
      "city": "София",
      "address": "бул. Витоша 15, София",
      "stage": "Зала 4",
      "starts_at": "2026-02-23T16:00:00+02:00",
      "event_date": "2026-02-23",
      "ticket_url": "https://payment.toplocentrala.bg/repertoires/193/baba",
      "ticket_links": [
        "https://payment.toplocentrala.bg/repertoires/193/baba",
        "https://tickets.example.com/baba"
      ],
      "info_url": "https://toplocentrala.bg/program/performance/baba?day=6",
      "stars": [
        {
          "id": 142,
          "name": "Иван Иванов",
          "occupation": "Актьор"
        }
      ],
      "extras": [
        {
          "id": 16,
          "title": "Sincerely Personal - ГРУПОВА ИЗЛОЖБА",
          "is_open": 1,
          "has_top_article": 1,
          "upcoming_events_count": 5
        }
      ]
    }
  ],
  "page": {
    "limit": 25,
    "has_more": true
  },
  "filters": {
    "date_from": "2026-02-23",
    "date_to": "2026-02-23",
    "starts_after": "2026-02-23T16:00:00.000Z",
    "starts_before": "2026-02-23T18:00:00.000Z",
    "tz": "Europe/Sofia",
    "scope": "sofia",
    "city": "Шумен",
    "venue": "Топлоцентрала",
    "title": "Баба",
    "star": "Александра Сърчаджиева",
    "extra": "Sincerely Personal",
    "extra_id": 16,
    "include": [
      "stars",
      "extras"
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.