Мероприятия

Список мероприятий

GET /api/v1/events

Возвращает мероприятия, у которых есть хотя бы один сеанс в продаже. Сортировка — по дате ближайшего сеанса. Какие мероприятия попадают в список — см. Какие мероприятия доступны.

Ответ кэшируется до 10 минут.

Параметры запроса

Параметр	Тип	По умолчанию	Описание
category_id	integer	—	Только мероприятия этой категории
limit	integer	100	Размер страницы, максимум 500
page	integer	1	Номер страницы

Пример

curl "https://gateway.ticket.kg/api/v1/events?category_id=1&limit=20" \
  -H "X-API-Key: $KEY"

{
  "data": [
    {
      "id": 1978,
      "name": "Симфонический оркестр. Осенний концерт",
      "organizer": { "id": 12, "name": "Филармония им. Т. Сатылганова" },
      "institution": { "id": 3, "name": "Кыргызская национальная филармония" },
      "slug": "simfonicheskiy-orkestr-osenniy-koncert",
      "text": "Программа: Чайковский, Рахманинов…",
      "duration": "2 часа",
      "image": "https://cdn.ticket.kg/images/events/1978/poster/poster.jpg",
      "image_blurhash": "LEHV6nWB2yk8pyo0adR*.7kCMdnj",
      "category": { "id": 1, "name": "Концерты", "slug": "concerts" },
      "is_active": 1,
      "age_limit": 6,
      "event_items": [
        {
          "id": 2505,
          "institution_place": { "id": 5, "name": "Большой зал" },
          "is_active": 1,
          "date": "2026-11-15T19:00:00+06:00",
          "date_to": null,
          "available_date": "2026-11-15T19:30:00+06:00",
          "type": 1
        }
      ]
    }
  ],
  "pagination": { "limit": 20, "page": 1, "count": 1, "total": 1 }
}

Поля ответа

• data — массив Event. В event_items — только сеансы, которые сейчас продаются, по дате.
• pagination — см. Пагинация.

Ошибки

HTTP	code	Причина
400	invalid_pagination	Неверный limit или page
400	invalid_category_id	category_id не положительное целое

---

Одно мероприятие

GET /api/v1/events/{eventID}

Возвращает мероприятие с сеансами, которые сейчас продаются.

Ответ кэшируется до 10 минут.

Параметры пути

Параметр	Тип	Описание
eventID	integer	ID мероприятия

Пример

curl https://gateway.ticket.kg/api/v1/events/1978 \
  -H "X-API-Key: $KEY"

{
  "data": {
    "id": 1978,
    "name": "Симфонический оркестр. Осенний концерт",
    "organizer": { "id": 12, "name": "Филармония им. Т. Сатылганова" },
    "institution": { "id": 3, "name": "Кыргызская национальная филармония" },
    "slug": "simfonicheskiy-orkestr-osenniy-koncert",
    "text": "Программа: Чайковский, Рахманинов…",
    "duration": "2 часа",
    "image": "https://cdn.ticket.kg/images/events/1978/poster/poster.jpg",
    "image_blurhash": "LEHV6nWB2yk8pyo0adR*.7kCMdnj",
    "category": { "id": 1, "name": "Концерты", "slug": "concerts" },
    "is_active": 1,
    "age_limit": 6,
    "event_items": [
      {
        "id": 2505,
        "institution_place": { "id": 5, "name": "Большой зал" },
        "is_active": 1,
        "date": "2026-11-15T19:00:00+06:00",
        "date_to": null,
        "available_date": "2026-11-15T19:30:00+06:00",
        "type": 1
      }
    ]
  }
}

Поля ответа

data — объект Event.

Если у мероприятия сейчас нет сеансов в продаже, оно всё равно возвращается, но event_items будет пустым массивом. Проверяйте is_active и наличие сеансов, прежде чем показывать кнопку покупки.

Ошибки

HTTP	code	Причина
400	invalid_event_id	eventID не положительное целое
404	not_found	Мероприятие не существует или не открыто для продажи через шлюз