GET fixture

Récupère un seul match à partir de son ID. La réponse inclut des informations détaillées sur le match, notamment les noms des participants, leurs IDs et les correspondances avec les fournisseurs externes. Ce point d'accès ne renvoie pas les cotes des bookmakers pour le match donné.

Endpoint

GET /v4/fixture

Paramètres de requête

  • fixtureId* (string)ID unique du match (p. ex. id1000001761301153).
  • language (string) (Optionnel) Code de langue pour les libellés traduits (p. ex. en, de, es). Par défaut : en.

Exemple de requête

GET /v4/fixture?fixtureId=id1000001761301153&language=en

Réponse d’exemple

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

Détail des champs de la réponse

Champs de premier niveau

  • fixtureId (string) Identifiant interne unique du match.
  • participant1Id (number) ID du premier participant.
  • participant2Id (number) ID du second participant.
  • sportId (number) ID représentant le sport (p. ex. 10 = Football, 12 = Tennis).
  • tournamentId (number) ID du tournoi.
  • seasonId (number|null) ID de la saison, le cas échéant.
  • statusId (number) Code de statut du match (p. ex. 0 = Avant-match, 1 = Programmé, 2 = En jeu, 3 = Terminé).
  • hasOdds (boolean) Indique si des cotes sont disponibles pour ce match.
  • startTime (string) Horodatage ISO 8601 du début prévu (UTC).
  • trueStartTime (string|null) Heure de début réelle si différente de l'heure prévue (p. ex. coup d'envoi retardé).
  • trueEndTime (string|null) Heure de fin réelle du match, si disponible.
  • updatedAt (string) Horodatage ISO 8601 de la dernière mise à jour (UTC).
  • statusName (string) Statut du match lisible (p. ex. « Pre-Game », « In-Play », « Ended »).
  • participant1Name (string) Nom complet du premier participant. Traduit si le paramètre language est défini.
  • 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 complet du second participant. Traduit si le paramètre language est défini.
  • 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) Nom du sport.
  • tournamentSlug (string) Identifiant de tournoi compatible URL.
  • categorySlug (string) Slug de la catégorie de compétition (p. ex. « england »).
  • categoryName (string) Nom d'affichage de la catégorie (p. ex. « England »).
  • tournamentName (string) Nom complet du tournoi (traduit si le paramètre language est défini).
  • externalProviders (object) Identifiants de fournisseurs tiers.:
    • betradarId (number|null) ID du flux Betradar.
    • mollybetId (string|null) Identifiant composite Mollybet.
    • opticoddsId (string|null) Identifiant OpticOdds.
    • lsportsId (number|null) Identifiant LSports.
    • txoddsId (number|null) Identifiant TXOdds.
    • sofascoreId (number|null) ID de match Sofascore.
    • betgeniusId (number|null) ID de match Betgenius.
    • flashscoreId (string|null) ID de match Flashscore.
    • pinnacleId (number|null) ID interne du match Pinnacle.
    • oddinId (number|null) ID de match Oddin.

Notes

  • Temps de refroidissement de l’endpoint (limite de débit) : 500ms
  • Tous les horodatages sont en UTC (ISO 8601).
  • Ce point d'accès n'inclut pas les cotes des bookmakers. Utilisez /v4/odds pour récupérer les cotes d'un match.
Page précédenteGET fixtures
Page suivanteGET markets
Signaler un problème
OddsPapi | Docs GET fixture