GET fixtures

Turnuva ID, spor ID, katılımcı ID, tarih aralığı ve dil gibi belirtilen parametrelere göre fikstür listesini getirir.

Uç nokta

GET /v4/fixtures

İstek

Parametreler

• tournamentId (number) — Turnuva için benzersiz tanımlayıcı. Bu ID mevcut bir turnuvaya karşılık gelmelidir.
• sportId (number) — Spor için benzersiz tanımlayıcı. Bu ID mevcut bir spora karşılık gelmelidir.
• participantId (number) — Katılımcı için benzersiz tanımlayıcı. Bu ID mevcut bir katılımcıya karşılık gelmelidir.
• from (string) — Fikstürler için başlangıç tarih ve saati, ISO 8601 formatında (e.g., YYYY-MM-DDTHH:MM:SSZ)
• to (string) — Fikstürler için bitiş tarih ve saati, ISO 8601 formatında (e.g., YYYY-MM-DDTHH:MM:SSZ)
• language (a2) — (İsteğe bağlı) Turnuva bilgilerinin döndürüleceği dil. Varsayılan değer en for English
• statusId (number: 0,1,2,3) — Döndürülecek fikstürlerin sahip olması gereken statusId (0: Henüz başlamadı, 1: Canlı, 2: Bitti, 3: İptal edildi).
• hasOdds (boolean) — Fikstür için oranların mevcut olup olmadığını belirtir.
• bookmakers (string) — (İsteğe bağlı) Virgülle ayrılmış bahis şirketi slug listesi. hasOdds filtresini değerlendirmek için kullanılır.

Koşullar

• tournamentId: Tek başına sağlanabilen tek parametre olabilir.
• participantId: Tek başına sağlanabilen tek parametre olabilir.
• sportId: Aşağıdakilerden herhangi biriyle birlikte kullanılmalıdır::
  • tournamentId
  • participantId
  • Her ikisi to ve from, ve her iki zaman da birbirinden 10 günden az olmalıdır.
• to ve from:
  • Eğer tournamentId veya participantId sağlanırsa, to and from zorunlu değildir ve yalnızca birinin sağlanması da kabul edilir.
  • Eğer yalnızca to ve from sağlanırsa, bu iki zaman arasındaki fark 48 saatten az olmalıdır.

Örnek İstek

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

Örnek Yanıt

[
  {
    "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"
  }
]

Yanıt (200 OK)

Başarılı bir istek üzerine sunucu şu durum koduyla yanıt verir 200 ve aşağıdaki alanları içeren fikstür nesnelerinden oluşan bir JSON dizisi döner:

• fixtureId (string) — Fikstür için benzersiz tanımlayıcı.
• participant1Id (number) — Birinci katılımcının ID’si.
• participant2Id (number) — İkinci katılımcının ID’si.
• sportId (number) — Fikstürle ilişkili sporun ID’si.
• tournamentId (number) — Fikstürle ilişkili turnuvanın ID’si.
• seasonId (number|null) — (İsteğe bağlı) Sezon ID’si.
• statusId (number) — Fikstürün mevcut durumu.
• hasOdds (boolean) — Fikstür için oranların mevcut olup olmadığını belirtir.
• startTime (string) — Fikstürün başlangıç zamanı.
• trueStartTime (string|null) — Varsa, fikstürün gerçek başlangıç zamanı.
• trueEndTime (string|null) — Varsa, fikstürün gerçek bitiş zamanı.
• updatedAt (string) — Fikstürün son güncellenme zaman damgası.
• statusName (string) — Okunabilir maç durumu (örn. «Pre-Game», «In-Play», «Ended»).
• participant1Name (string) — Birinci katılımcının adı (talep ettiğiniz dilde).
• participant1ShortName (string) — Birinci katılımcının kısa görüntü adı. language parametresi ayarlandığında çevrilir.
• participant1Abbr (string) — Birinci katılımcının 3 harfli kısaltması. language parametresi ayarlandığında çevrilir.
• participant2Name (string) — İkinci katılımcının adı (talep ettiğiniz dilde).
• participant2ShortName (string) — İkinci katılımcının kısa görüntü adı. language parametresi ayarlandığında çevrilir.
• participant2Abbr (string) — İkinci katılımcının 3 harfli kısaltması. language parametresi ayarlandığında çevrilir.
• sportName (string) — Fikstürle ilişkili sporun adı.
• tournamentSlug (string) — URL uyumlu turnuva tanımlayıcısı.
• categorySlug (string) — Yarışma kategorisinin slug değeri (örn. «england»).
• categoryName (string) — Turnuvanın ait olduğu kategori adı.
• tournamentName (string) — Turnuva adı.
• externalProviders (object) — Üçüncü taraf sağlayıcılardan gelen ID’ler:
  • betradarId (number|null) — (İsteğe bağlı) Betradar tarafından atanmış ID.
  • mollybetId (string|null) — (İsteğe bağlı) Mollybet tarafından atanmış benzersiz ID.
  • opticoddsId (string|null) — (İsteğe bağlı) Opticodds tarafından atanmış benzersiz ID.
  • lsportsId (number|null) — (İsteğe bağlı) LSports tarafından atanmış benzersiz ID.
  • txoddsId (number|null) — (İsteğe bağlı) TXOdds tarafından atanmış benzersiz ID.
  • sofascoreId (number|null) — (İsteğe bağlı) Sofascore tarafından atanmış ID.
  • betgeniusId (number|null) — (İsteğe bağlı) Betgenius tarafından atanmış ID.
  • flashscoreId (string|null) — (İsteğe bağlı) Flashscore tarafından atanmış ID.
  • pinnacleId (number|null) — (İsteğe bağlı) Pinnacle tarafından atanmış ID.
  • oddinId (number|null) — (İsteğe bağlı) Oddin tarafından atanmış ID.