GET fixtures

Возвращает список матчей (fixtures) на основе указанных параметров: ID турнира, ID вида спорта, ID участника, диапазон дат и язык.

Эндпоинт

GET /v4/fixtures

Запрос

Параметры

• tournamentId (number) — Уникальный идентификатор турнира. Этот ID должен соответствовать существующему турниру.
• sportId (number) — Уникальный идентификатор вида спорта. Этот ID должен соответствовать существующему виду спорта.
• participantId (number) — Уникальный идентификатор участника. Этот ID должен соответствовать существующему участнику.
• from (string) — Дата и время начала диапазона матчей в формате ISO 8601 (e.g., YYYY-MM-DDTHH:MM:SSZ)
• to (string) — Дата и время конца диапазона матчей в формате ISO 8601 (e.g., YYYY-MM-DDTHH:MM:SSZ)
• language (a2) — (Необязательно) Язык, на котором должна быть возвращена информация о турнире. По умолчанию используется значение en for English
• statusId (number: 0,1,2,3) — Значение statusId, которое должны иметь возвращаемые матчи (0: ещё не начался, 1: лайв, 2: завершён, 3: отменён).
• hasOdds (boolean) — Показывает, есть ли для матча доступные коэффициенты.
• bookmakers (string) — (Необязательно) Список slug букмекеров, разделённый запятыми. Используется для оценки фильтра hasOdds.

Условия

• tournamentId: Может быть единственным переданным параметром.
• participantId: Может быть единственным переданным параметром.
• sportId: Должен сопровождаться любым из параметров:
  • tournamentId
  • participantId
  • Оба to и from, если разница между двумя временами не превышает 10 дней.
• to и from:
  • Если tournamentId или participantId указаны, to and from они не являются обязательными, и передача только одного параметра допустима.
  • Если только to и from передан, диапазон между временами должен быть меньше 48 часов.

Пример запроса

GET /v4/fixtures?sportId=10&from=2026-04-12&to=2026-04-17&statusId=0&hasOdds=true&bookmakers=pinnacle

Пример ответа

[
  {
    "fixtureId": "id1000001761301153",
    "participant1Id": 35,
    "participant2Id": 34,
    "sportId": 10,
    "tournamentId": 17,
    "seasonId": 130281,
    "statusId": 0,
    "hasOdds": true,
    "startTime": "2026-04-13T19:00:00.000Z",
    "trueStartTime": null,
    "trueEndTime": null,
    "updatedAt": "2026-04-06T23:17:08.202Z",
    "externalProviders": {
      "betradarId": 61301153,
      "mollybetId": "2026-04-13,35,34",
      "opticoddsId": "20260413A1B2C3D4",
      "lsportsId": null,
      "txoddsId": null,
      "sofascoreId": 15676100,
      "betgeniusId": 13670012,
      "flashscoreId": "xK4pLm2n",
      "pinnacleId": 1626291706,
      "oddinId": null
    },
    "statusName": "Pre-Game",
    "participant1Name": "Liverpool FC",
    "participant1ShortName": "Liverpool",
    "participant1Abbr": "LIV",
    "participant2Name": "Manchester United",
    "participant2ShortName": "Man Utd",
    "participant2Abbr": "MNU",
    "sportName": "Soccer",
    "tournamentSlug": "premier-league",
    "categorySlug": "england",
    "categoryName": "England",
    "tournamentName": "Premier League"
  }
]

Ответ (200 OK)

При успешном запросе сервер возвращает код статуса 200 и возвращает JSON-массив с объектами матчей со следующими полями:

• fixtureId (string) — Уникальный идентификатор матча.
• participant1Id (number) — ID первого участника.
• participant2Id (number) — ID второго участника.
• sportId (number) — ID вида спорта, связанного с матчем.
• tournamentId (number) — ID турнира, связанного с матчем.
• seasonId (number|null) — (Необязательно) ID сезона.
• statusId (number) — Текущий статус матча.
• hasOdds (boolean) — Показывает, есть ли для матча доступные коэффициенты.
• startTime (string) — Время начала матча.
• trueStartTime (string|null) — Фактическое время начала матча, если известно.
• trueEndTime (string|null) — Фактическое время завершения матча, если известно.
• updatedAt (string) — Время последнего обновления матча.
• statusName (string) — Читаемый статус матча (например, «Pre-Game», «In-Play», «Ended»).
• participant1Name (string) — Имя первого участника (на запрошенном языке).
• participant1ShortName (string) — Короткое отображаемое имя первого участника. Переводится, если задан параметр language.
• participant1Abbr (string) — Трёхбуквенная аббревиатура первого участника. Переводится, если задан параметр language.
• participant2Name (string) — Имя второго участника (на запрошенном языке).
• participant2ShortName (string) — Короткое отображаемое имя второго участника. Переводится, если задан параметр language.
• participant2Abbr (string) — Трёхбуквенная аббревиатура второго участника. Переводится, если задан параметр language.
• sportName (string) — Название вида спорта, связанного с событием.
• tournamentSlug (string) — URL-совместимый идентификатор турнира.
• categorySlug (string) — Slug категории соревнования (например, «england»).
• categoryName (string) — Название категории, к которой относится турнир.
• tournamentName (string) — Название турнира.
• externalProviders (object) — ID сторонних провайдеров:
  • betradarId (number|null) — (Необязательно) ID, присвоенный Betradar.
  • mollybetId (string|null) — (Необязательно) Уникальный ID, присвоенный Mollybet.
  • opticoddsId (string|null) — (Необязательно) Уникальный ID, присвоенный Opticodds.
  • lsportsId (number|null) — (Необязательно) Уникальный ID, присвоенный LSports.
  • txoddsId (number|null) — (Необязательно) Уникальный ID, присвоенный TXOdds.
  • sofascoreId (number|null) — (Необязательно) ID, присвоенный Sofascore.
  • betgeniusId (number|null) — (Необязательно) ID, присвоенный Betgenius.
  • flashscoreId (string|null) — (Необязательно) ID, присвоенный Flashscore.
  • pinnacleId (number|null) — (Необязательно) ID, присвоенный Pinnacle.
  • oddinId (number|null) — (Необязательно) ID, присвоенный Oddin.