GET fixtures

Ruft eine Liste von Spielen basierend auf den angegebenen Parametern wie Turnier-ID, Sport-ID, Teilnehmer-ID, Datumsbereich und Sprache ab.

Endpoint

GET /v4/fixtures

Anfrage

Parameter

• tournamentId (number) — Die eindeutige Kennung für das Turnier. Diese ID muss einem vorhandenen Turnier entsprechen.
• sportId (number) — Die eindeutige Kennung für den Sport. Diese ID muss einem vorhandenen Sport entsprechen.
• participantId (number) — Die eindeutige Kennung für den Teilnehmer. Diese ID muss einem vorhandenen Teilnehmer entsprechen.
• from (string) — Das Startdatum und die Startzeit für die Spiele im ISO 8601-Format (e.g., YYYY-MM-DDTHH:MM:SSZ)
• to (string) — Das Enddatum und die Endzeit für die Spiele im ISO 8601-Format (e.g., YYYY-MM-DDTHH:MM:SSZ)
• language (a2) — (Optional) Die Sprache, in der die Turnierinformationen zurückgegeben werden sollen. Standardmäßig ist der Wert en for English
• statusId (number: 0,1,2,3) — Die statusId, die die zurückgegebenen Spiele haben müssen (0: Noch nicht begonnen, 1: Live, 2: Beendet, 3: Abgebrochen).
• hasOdds (boolean) — Ob das Spiel Quoten hat.
• bookmakers (string) — (Optional) Komma-getrennte Liste von Buchmacher-Slugs. Wird zur Auswertung des hasOdds-Filters verwendet.

Bedingungen

• tournamentId: Kann der einzige bereitgestellte Parameter sein.
• participantId: Kann der einzige bereitgestellte Parameter sein.
• sportId: Muss begleitet sein von:
  • tournamentId
  • participantId
  • Beide to und from, wo beide Zeiten weniger als 10 Tage auseinander liegen.
• to und from:
  • Wenn tournamentId oder participantId werden bereitgestellt, to and from sind nicht obligatorisch und es ist akzeptabel, nur einen bereitzustellen.
  • Wenn nur to und from bereitgestellt werden, müssen sie weniger als 48 Stunden auseinander liegen.

Beispielanfrage

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

Beispielantwort

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

Antwort (200 OK)

Bei einer erfolgreichen Anfrage antwortet der Server mit einem Statuscode 200 und gibt ein JSON-Array mit Spielobjekten zurück, die die folgenden Felder enthalten:

• fixtureId (string) — Die eindeutige Kennung für das Spiel.
• participant1Id (number) — Die ID des ersten Teilnehmers.
• participant2Id (number) — Die ID des zweiten Teilnehmers.
• sportId (number) — Die ID des mit dem Spiel verbundenen Sports.
• tournamentId (number) — Die ID des mit dem Spiel verbundenen Turniers.
• seasonId (number|null) — (Optional) Die ID der Saison.
• statusId (number) — Der aktuelle Status des Spiels.
• hasOdds (boolean) — Ob das Spiel Quoten hat.
• startTime (string) — Die Startzeit des Spiels.
• trueStartTime (string|null) — Die tatsächliche Startzeit des Spiels, falls verfügbar.
• trueEndTime (string|null) — Die tatsächliche Endzeit des Spiels, falls verfügbar.
• updatedAt (string) — Der Zeitstempel der letzten Aktualisierung des Spiels.
• statusName (string) — Lesbarer Spielstatus (z. B. „Pre-Game", „In-Play", „Ended").
• participant1Name (string) — Der Name des ersten Teilnehmers (in der angeforderten Sprache).
• participant1ShortName (string) — Kurzanzeigename des ersten Teilnehmers. Übersetzt, wenn der Parameter „language" gesetzt ist.
• participant1Abbr (string) — 3-Buchstaben-Abkürzung des ersten Teilnehmers. Übersetzt, wenn der Parameter „language" gesetzt ist.
• participant2Name (string) — Der Name des zweiten Teilnehmers (in der angeforderten Sprache).
• participant2ShortName (string) — Kurzanzeigename des zweiten Teilnehmers. Übersetzt, wenn der Parameter „language" gesetzt ist.
• participant2Abbr (string) — 3-Buchstaben-Abkürzung des zweiten Teilnehmers. Übersetzt, wenn der Parameter „language" gesetzt ist.
• sportName (string) — Der Name des Sports, der mit dem Ereignis verbunden ist.
• tournamentSlug (string) — URL-freundliche Turnierkennung.
• categorySlug (string) — Slug der Wettbewerbskategorie (z. B. „england").
• categoryName (string) — Der Name der Kategorie, zu der das Turnier gehört.
• tournamentName (string) — Der Name des Turniers.
• externalProviders (object) — IDs von Drittanbietern:
  • betradarId (number|null) — (Optional) Die ID, die von Betradar zugewiesen wurde.
  • mollybetId (string|null) — (Optional) Die ID, die von Mollybet zugewiesen wurde.
  • opticoddsId (string|null) — (Optional) Die ID, die von Opticodds zugewiesen wurde.
  • lsportsId (number|null) — (Optional) Die ID, die von LSports zugewiesen wurde.
  • txoddsId (number|null) — (Optional) Die ID, die von TXOdds zugewiesen wurde.
  • sofascoreId (number|null) — (Optional) Die ID, die von Sofascore zugewiesen wurde.
  • betgeniusId (number|null) — (Optional) Die ID, die von Betgenius zugewiesen wurde.
  • flashscoreId (string|null) — (Optional) Die ID, die von Flashscore zugewiesen wurde.
  • pinnacleId (number|null) — (Optional) Die ID, die von Pinnacle zugewiesen wurde.
  • oddinId (number|null) — (Optional) Die ID, die von Oddin zugewiesen wurde.