Fixture
/
View as MarkdownTry in Playground →
One fixture in full: both teams, score, status, match clock, winner, league, season, round, venue, the referee (career cards per game), the two managers (homeManager / awayManager) and previousLegFixtureId. That field holds our id for the first leg or the previous game in a series, and on a completed second leg aggregateWinner names the side that went through. Some sports add more: seeds (homeSeed / awaySeed); in tennis, surface (hard / clay / grass / carpet, indoor), discipline (singles or doubles) and serving (who is serving at the moment); in darts, servedFirst (the side that threw the opening dart of the match); in cricket, battingSide, note, toss (winner, bat / bowl), tvUmpire and umpires; in MMA and boxing, fightResult (method, round and, for a stoppage, the time), fightCard (main card / prelims, order, weight class) and fightDiscipline (boxing, kickboxing, muayThai, …, if the source tags one); attendance (spectators, when reported); matchFormat (best of sets / legs in darts, best of games in esports); in baseball, inningState (inning, top / bottom, outs, count, runners); in basketball, timeouts (left per side) and bonus (which sides are in the bonus); in American football, downAndDistance (down, yards to go, field position, possession, play type); in football, varCheck (a VAR review in progress and the side it concerns); finalResultOnly (true when the source has nothing beyond the result); and, in set or round sports, durations (seconds per completed set or round, plus the total).
Parameters
idpathrequired
fixture id issued by DataSportsAPI, a positive integer
Response
- data
Fixture
Any /v2 call can also come back with one of the common errors.
curl -H "Authorization: Bearer sk_live_…" \
"https://api.datasportsapi.com/v2/fixtures/{id}"{ "data": { "id": 201324, "sport": "football", "startTime": "2026-10-18T15:30:00.000Z",
"status": { "type": "finished", "phase": "finished", "code": 120, "description": "After penalties",
"period": null, "finish": "penalties" },
"homeScore": { "current": 1, "penalties": 2,
"periods": { "period1": 0, "period2": 1, "extra1": 0, "extra2": 0 }, … },
"awayScore": { "current": 1, "penalties": 4, … },
"winner": "away", "clock": null,
"round": { "number": 4, "name": "Round 4", "slug": "round-4", "prefix": null },
"season": { "id": 200386, "name": "FA Cup 25/26", "year": "25/26", "startYear": 2025, "endYear": 2026 },
"venue": { "id": 157902, "name": "St. Andrew's", "city": "Birmingham",
"country": { "code": "EN", "name": "England" }, "capacity": 29409 },
"referee": { "id": 51022, "name": "Michael Oliver", "slug": "michael-oliver", "country": { "code": "EN", "name": "England" },
"games": 612, "yellowCards": 2190, "redCards": 61, "yellowRedCards": 38,
"image": "https://cdn.datasportsapi.com/v2/referees/51022/photo" },
"homeManager": { "id": 912070, "name": "Chris Davies", "slug": "chris-davies", "shortName": "C. Davies", "image": "https://cdn.datasportsapi.com/v2/managers/912070/photo" },
"awayManager": { "id": 794942, "name": "Mikel Arteta", "slug": "mikel-arteta", "shortName": "M. Arteta", "image": null },
"previousLegFixtureId": null, "aggregateWinner": null, "surface": null, "toss": null, "umpires": null, "tvUmpire": null, "fightCard": null, … } }
// Second leg: "previousLegFixtureId": 582371, "aggregateWinner": "home" (homeScore.aggregated 2, awayScore.aggregated 2, penalties 5-3)
// Tennis: "serving": "home", "surface": { "type": "hard", "indoor": true, "name": "Hardcourt indoor" }
// Cricket: "toss": { "winner": "away", "decision": "bowl" }, "umpires": ["Chris Gaffaney", "Richard Illingworth"], "tvUmpire": "Joel Wilson"
// MMA: "fightCard": { "section": "mainCard", "order": 12, "weightClass": "light" }
// Basketball (in play): "attendance": 19156, "timeouts": { "homeRemaining": 3, "awayRemaining": 5, "perTeam": 7 }, "bonus": { "home": true, "away": false }
// American football (in play): "downAndDistance": { "down": 2, "yardsToGo": 6, "possession": "away", "ballOn": "away", "yardLine": 34,
// "goalToGo": false, "playType": "scrimmage" }
// Football (VAR review in progress): "varCheck": { "side": "home" } · every fixture: "finalResultOnly": false
// Tennis (finished): "durations": { "periods": { "period1": 3893, "period2": 3810, "period3": 2886, "period4": 2982 }, "totalSeconds": 13571 }
// Baseball (in play): "inningState": { "inning": 7, "half": "bottom", "battingSide": "home", "balls": 2, "strikes": 1, "outs": 1,
// "bases": { "first": true, "second": false, "third": true } }
// Darts: "matchFormat": { "bestOfSets": 5, "bestOfLegs": 5, "bestOfGames": null } (a legs match: bestOfSets 1, bestOfLegs 7)
// Esports: "matchFormat": { "bestOfSets": null, "bestOfLegs": null, "bestOfGames": 3 }