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.

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=2025-07-14T00:00:00Z&to=2025-07-21T00:00:00Z&hasOdds=true

Esempio di risposta

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

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:

• hasOdds (boolean) — Indica se l’incontro ha quote disponibili.
• startTime (string) — L’orario di inizio dell’incontro.
• participant1Id (number) — L’ID del primo partecipante.
• participant2Id (number) — L’ID del secondo partecipante.
• fixtureId (string) — L’identificatore univoco dell’incontro.
• sportId (number) — L’ID dello sport associato all’incontro.
• sportName (string) — Il nome dello sport associato all'evento.
• updatedAt (string) — Il timestamp dell’ultimo aggiornamento dell’incontro.
• tournamentId (number) — L’ID del torneo associato all’incontro.
• seasonId (number) — (Opzionale) L’ID della stagione.
• statusId (number) — Lo stato attuale 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.
• externalProviders (object) — ID di provider di terze parti:
  • betradarId (number|null) — (Opzionale) ID assegnato da Betradar.
  • 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.
  • mollybetId (number|null) — (Opzionale) L’ID univoco assegnato da Mollybet.
  • opticoddsId (number|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.
• participant1Name (string) — Il nome del primo partecipante (nella lingua richiesta).
• participant2Name (string) — Il nome del secondo partecipante (nella lingua richiesta).
• tournamentName (string) — Il nome del torneo.
• categoryName (string) — Il nome della categoria a cui appartiene il torneo.