GET fixtures

Récupère une liste de matchs en fonction des paramètres spécifiés comme l’ID de tournoi, l’ID de sport, l’ID de participant, la plage de dates et la langue.

Endpoint

GET /v4/fixtures

Requête

Paramètres

• tournamentId (number) — Identifiant unique du tournoi. Cet ID doit correspondre à un tournoi existant.
• sportId (number) — Identifiant unique du sport. Cet ID doit correspondre à un sport existant.
• participantId (number) — Identifiant unique du participant. Cet ID doit correspondre à un participant existant.
• from (string) — Date et heure de début des matchs au format ISO 8601 (e.g., YYYY-MM-DDTHH:MM:SSZ)
• to (string) — Date et heure de fin des matchs au format ISO 8601 (e.g., YYYY-MM-DDTHH:MM:SSZ)
• language (a2) — (Optionnel) Langue dans laquelle les informations sur le tournoi doivent être renvoyées. Par défaut, la valeur est en for English
• statusId (number: 0,1,2,3) — Le statusId que les matchs renvoyés doivent avoir (0 : Pas encore commencé, 1 : En direct, 2 : Terminé, 3 : Annulé).
• hasOdds (boolean) — Indique si le match a des cotes disponibles.
• bookmakers (string) — (Optionnel) Liste de slugs de bookmakers séparés par des virgules. Utilisée pour évaluer le filtre hasOdds.

Conditions

• tournamentId: Peut être le seul paramètre fourni.
• participantId: Peut être le seul paramètre fourni.
• sportId: Doit être accompagné de l’un des paramètres:
  • tournamentId
  • participantId
  • Les deux to et from, où les deux horaires sont séparés de moins de 10 jours.
• to et from:
  • Si tournamentId ou participantId sont fournis, to and from ne sont pas obligatoires et le fait d’en fournir un seul est accepté.
  • Si seuls to et from sont fournis, ils doivent être séparés de moins de 48 heures.

Exemple de requête

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

Exemple de réponse

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

Réponse (200 OK)

En cas de requête réussie, le serveur répond avec un code de statut 200 et renvoie un tableau JSON contenant des objets de matchs avec les champs suivants:

• fixtureId (string) — Identifiant unique du match.
• participant1Id (number) — ID du premier participant.
• participant2Id (number) — ID du deuxième participant.
• sportId (number) — ID du sport associé au match.
• tournamentId (number) — ID du tournoi associé au match.
• seasonId (number|null) — (Optionnel) ID de la saison.
• statusId (number) — Statut actuel du match.
• hasOdds (boolean) — Indique si le match a des cotes disponibles.
• startTime (string) — Heure de début du match.
• trueStartTime (string|null) — Heure réelle de début du match, si disponible.
• trueEndTime (string|null) — Heure réelle de fin du match, si disponible.
• updatedAt (string) — Horodatage de la dernière mise à jour du match.
• statusName (string) — Statut du match lisible (p. ex. « Pre-Game », « In-Play », « Ended »).
• participant1Name (string) — Nom du premier participant (dans la langue demandée).
• participant1ShortName (string) — Nom court d'affichage du premier participant. Traduit si le paramètre language est défini.
• participant1Abbr (string) — Abréviation de 3 lettres du premier participant. Traduite si le paramètre language est défini.
• participant2Name (string) — Nom du deuxième participant (dans la langue demandée).
• participant2ShortName (string) — Nom court d'affichage du second participant. Traduit si le paramètre language est défini.
• participant2Abbr (string) — Abréviation de 3 lettres du second participant. Traduite si le paramètre language est défini.
• sportName (string) — Le nom du sport associé à l'événement.
• tournamentSlug (string) — Identifiant de tournoi compatible URL.
• categorySlug (string) — Slug de la catégorie de compétition (p. ex. « england »).
• categoryName (string) — Le nom de la catégorie à laquelle le tournoi appartient.
• tournamentName (string) — Le nom du tournoi.
• externalProviders (object) — IDs de fournisseurs tiers:
  • betradarId (number|null) — (Optionnel) ID attribué par Betradar.
  • mollybetId (string|null) — (Optionnel) ID unique attribué par Mollybet.
  • opticoddsId (string|null) — (Optionnel) ID unique attribué par Opticodds.
  • lsportsId (number|null) — (Optionnel) ID unique attribué par LSports.
  • txoddsId (number|null) — (Optionnel) ID unique attribué par TXOdds.
  • sofascoreId (number|null) — (Optionnel) ID attribué par Sofascore.
  • betgeniusId (number|null) — (Optionnel) ID attribué par Betgenius.
  • flashscoreId (string|null) — (Optionnel) ID attribué par Flashscore.
  • pinnacleId (number|null) — (Optionnel) ID attribué par Pinnacle.
  • oddinId (number|null) — (Optionnel) ID attribué par Oddin.