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.

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

Exemple de réponse

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

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:

• hasOdds (boolean) — Indique si le match a des cotes disponibles.
• startTime (string) — Heure de début du match.
• participant1Id (number) — ID du premier participant.
• participant2Id (number) — ID du deuxième participant.
• fixtureId (string) — Identifiant unique du match.
• sportId (number) — ID du sport associé au match.
• sportName (string) — Le nom du sport associé à l'événement.
• updatedAt (string) — Horodatage de la dernière mise à jour du match.
• tournamentId (number) — ID du tournoi associé au match.
• seasonId (number) — (Optionnel) ID de la saison.
• statusId (number) — Statut actuel 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.
• externalProviders (object) — IDs de fournisseurs tiers:
  • betradarId (number|null) — (Optionnel) ID attribué par Betradar.
  • 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.
  • mollybetId (number|null) — (Optionnel) ID unique attribué par Mollybet.
  • opticoddsId (number|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.
• participant1Name (string) — Nom du premier participant (dans la langue demandée).
• participant2Name (string) — Nom du deuxième participant (dans la langue demandée).
• tournamentName (string) — Le nom du tournoi.
• categoryName (string) — Le nom de la catégorie à laquelle le tournoi appartient.