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) — Показывает, есть ли для матча доступные коэффициенты.

Условия

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

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

GET /v4/fixtures?sportId=10&from=2025-07-14T00:00:00Z&to=2025-07-21T00:00:00Z&hasOdds=true

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

[
  {
    "fixtureId": "id1000015561098461",
    "participant1Id": 3209,
    "participant2Id": 3210,
    "providerId": 61098461,
    "seasonId": 127421,
    "sportId": 10,
    "startTime": "2025-07-21T00:00:00.000Z",
    "statusId": 2,
    "tournamentId": 155,
    "trueEndTime": "2025-07-21T01:58:12.073Z",
    "trueStartTime": "2025-07-21T00:00:02.751Z",
    "updatedAt": "2025-07-21T01:58:12.073Z",
    "hasOdds": true,
    "externalProviders": {
      "betradarId": 61098461,
      "sofascoreId": 14069376,
      "betgeniusId": 11833149,
      "flashscoreId": "pbXYexxB",
      "pinnacleId": 1611618343,
      "oddinId": null,
      "mollybetId": null,
      "opticoddsId": null,
      "lsportsId": null,
      "txoddsId": null
    },
    "participant1Name": "CA Independiente Avellaneda",
    "participant2Name": "CA Talleres de Cordoba",
    "tournamentName": "Liga Profesional",
    "categoryName": "Argentina"
  }
]

Ответ (200 OK)

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

• hasOdds (boolean) — Показывает, есть ли для матча доступные коэффициенты.
• startTime (string) — Время начала матча.
• participant1Id (number) — ID первого участника.
• participant2Id (number) — ID второго участника.
• fixtureId (string) — Уникальный идентификатор матча.
• sportId (number) — ID вида спорта, связанного с матчем.
• sportName (string) — Название вида спорта, связанного с событием.
• updatedAt (string) — Время последнего обновления матча.
• tournamentId (number) — ID турнира, связанного с матчем.
• seasonId (number) — (Необязательно) ID сезона.
• statusId (number) — Текущий статус матча.
• trueStartTime (string|null) — Фактическое время начала матча, если известно.
• trueEndTime (string|null) — Фактическое время завершения матча, если известно.
• externalProviders (object) — ID сторонних провайдеров:
  • betradarId (number|null) — (Необязательно) ID, присвоенный Betradar.
  • 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.
  • mollybetId (number|null) — (Необязательно) Уникальный ID, присвоенный Mollybet.
  • opticoddsId (number|null) — (Необязательно) Уникальный ID, присвоенный Opticodds.
  • lsportsId (number|null) — (Необязательно) Уникальный ID, присвоенный LSports.
  • txoddsId (number|null) — (Необязательно) Уникальный ID, присвоенный TXOdds.
• participant1Name (string) — Имя первого участника (на запрошенном языке).
• participant2Name (string) — Имя второго участника (на запрошенном языке).
• tournamentName (string) — Название турнира.
• categoryName (string) — Название категории, к которой относится турнир.