GET fixtures

Recupera un elenco di incontri in base ai parametri specificati, come ID torneo, ID sport, ID partecipante, intervallo di date e lingua.

Endpoint

GET /v4/fixtures

Richiesta

Parametri

• tournamentId (number) — L’identificatore univoco del torneo. Questo ID deve corrispondere a un torneo esistente.
• sportId (number) — L’identificatore univoco dello sport. Questo ID deve corrispondere a uno sport esistente.
• participantId (number) — L’identificatore univoco del partecipante. Questo ID deve corrispondere a un partecipante esistente.
• from (string) — La data e l’ora di inizio degli incontri in formato ISO 8601 (e.g., YYYY-MM-DDTHH:MM:SSZ)
• to (string) — La data e l’ora di fine degli incontri in formato ISO 8601 (e.g., YYYY-MM-DDTHH:MM:SSZ)
• language (a2) — (Opzionale) La lingua in cui le informazioni sul torneo devono essere restituite. Per impostazione predefinita, il valore è en for English
• statusId (number: 0,1,2,3) — Lo statusId che gli incontri restituiti devono avere (0: Non ancora iniziato, 1: Live, 2: Terminato, 3: Annullato).
• hasOdds (boolean) — Indica se l’incontro ha quote disponibili.
• bookmakers (string) — (Opzionale) Elenco di slug di bookmaker separati da virgole. Usato per valutare il filtro hasOdds.

Condizioni

• tournamentId: Può essere l’unico parametro fornito.
• participantId: Può essere l’unico parametro fornito.
• sportId: Deve essere accompagnato da uno qualsiasi tra:
  • tournamentId
  • participantId
  • Entrambi to e from, dove entrambi gli orari distano meno di 10 giorni.
• to e from:
  • Se tournamentId oppure participantId sono forniti, to and from non sono obbligatori e fornirne solo uno è accettato.
  • Se solo to e from sono forniti, devono distare meno di 48 ore.

Esempio di richiesta

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

Esempio di risposta

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

Risposta (200 OK)

In caso di richiesta andata a buon fine, il server risponde con un codice di stato 200 e restituisce un array JSON contenente oggetti incontro con i seguenti campi:

• fixtureId (string) — L’identificatore univoco dell’incontro.
• participant1Id (number) — L’ID del primo partecipante.
• participant2Id (number) — L’ID del secondo partecipante.
• sportId (number) — L’ID dello sport associato all’incontro.
• tournamentId (number) — L’ID del torneo associato all’incontro.
• seasonId (number|null) — (Opzionale) L’ID della stagione.
• statusId (number) — Lo stato attuale dell’incontro.
• hasOdds (boolean) — Indica se l’incontro ha quote disponibili.
• startTime (string) — L’orario di inizio dell’incontro.
• trueStartTime (string|null) — L’orario effettivo di inizio dell’incontro, se disponibile.
• trueEndTime (string|null) — L’orario effettivo di fine dell’incontro, se disponibile.
• updatedAt (string) — Il timestamp dell’ultimo aggiornamento dell’incontro.
• statusName (string) — Stato dell'evento leggibile (p. es. «Pre-Game», «In-Play», «Ended»).
• participant1Name (string) — Il nome del primo partecipante (nella lingua richiesta).
• participant1ShortName (string) — Nome breve di visualizzazione del primo partecipante. Tradotto se il parametro language è impostato.
• participant1Abbr (string) — Abbreviazione di 3 lettere del primo partecipante. Tradotta se il parametro language è impostato.
• participant2Name (string) — Il nome del secondo partecipante (nella lingua richiesta).
• participant2ShortName (string) — Nome breve di visualizzazione del secondo partecipante. Tradotto se il parametro language è impostato.
• participant2Abbr (string) — Abbreviazione di 3 lettere del secondo partecipante. Tradotta se il parametro language è impostato.
• sportName (string) — Il nome dello sport associato all'evento.
• tournamentSlug (string) — Identificatore del torneo adatto per URL.
• categorySlug (string) — Slug della categoria di competizione (p. es. «england»).
• categoryName (string) — Il nome della categoria a cui appartiene il torneo.
• tournamentName (string) — Il nome del torneo.
• externalProviders (object) — ID di provider di terze parti:
  • betradarId (number|null) — (Opzionale) ID assegnato da Betradar.
  • mollybetId (string|null) — (Opzionale) L’ID univoco assegnato da Mollybet.
  • opticoddsId (string|null) — (Opzionale) L’ID univoco assegnato da Opticodds.
  • lsportsId (number|null) — (Opzionale) L’ID univoco assegnato da LSports.
  • txoddsId (number|null) — (Opzionale) L’ID univoco assegnato da TXOdds.
  • sofascoreId (number|null) — (Opzionale) L’ID assegnato da Sofascore.
  • betgeniusId (number|null) — (Opzionale) L’ID assegnato da Betgenius.
  • flashscoreId (string|null) — (Opzionale) L’ID assegnato da Flashscore.
  • pinnacleId (number|null) — (Opzionale) L’ID assegnato da Pinnacle.
  • oddinId (number|null) — (Opzionale) L’ID assegnato da Oddin.