Scorecard
GET
/
View as MarkdownTry in Playground →
Full cricket scorecard by innings: total, extras, batting card (runs, balls, fours, sixes, strike rate, state, dismissal, bowler, fielder) and bowling card (overs, maidens, runs, wickets, economy, wides, no-balls). Falls of wicket and partnerships follow.
Any other sport, or a cricket match before the first delivery, returns 200 with an empty innings list. Overs follow cricket notation, so 19.3 is 19 overs plus 3 balls; once an over is complete the figure moves up to the next whole number (5 rather than the source’s 4.6), and the same goes for falls of wicket. Partnerships are frequently missing for multi-day matches. Refreshed about every 30 seconds during a live match. current (CricketState) describes the crease in the live innings — striker, non-striker, bowler, over and ball — which we compute from the ball-by-ball data instead of relying on the source’s unreliable current-batsman field. It is null when no innings is under way or the match lacks ball-by-ball coverage, and right after a delivery its batters can briefly read null until the ball-by-ball data and the scorecard agree again. The only ambiguous case is a run out, where it is unclear at which end the batter was dismissed.
Parameters
idpathrequired
fixture id issued by DataSportsAPI, a positive integer
Response
- data
Scorecard
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}/scorecard"Example
{ "data": { "innings": [ { "inning": "inning1", "battingSide": "away",
"battingTeam": { "id": 207233, "name": "West Indies", … }, "bowlingTeam": { "id": 207238, "name": "India", … },
"runs": 247, "wickets": 3, "overs": 20,
"extras": { "total": 18, "wides": 13, "noBalls": 1, "byes": 0, "legByes": 4, "penalties": 0 },
"batting": [ { "batter": { "id": 880113, "name": "Shai Hope", … }, "state": "notOut", "dismissal": null,
"description": "Not out", "bowler": null, "fielder": null,
"runs": 102, "balls": 50, "fours": 4, "sixes": 9, "strikeRate": 204 },
{ "batter": { "name": "Shimron Hetmyer", … }, "state": "out", "dismissal": "caughtAndBowled",
"description": "Caught & Bowled", "bowler": { "name": "Prince Yadav", … },
"fielder": { "name": "Prince Yadav", … }, "runs": 33, "balls": 12, … }, … ],
"bowling": [ { "bowler": { "name": "Arshdeep Singh", … }, "overs": 4, "maidens": 0, "runs": 52,
"wickets": 1, "wides": 6, "noBalls": 0, "economy": 13 }, … ],
"fallOfWickets": [ { "wicket": 1, "runs": 52, "overs": 4.2, "batter": { "name": "Jewel Andrew", … } }, … ],
"partnerships": [ { "batter1": { "name": "Shai Hope", … }, "batter2": { "name": "Jewel Andrew", … },
"runs": 52, "balls": 27 }, … ] }, … ],
"current": null } }
// In play — the crease, derived from the ball-by-ball:
"current": { "inning": "inning1", "battingSide": "home", "striker": { "name": "Emma de Broughe", … },
"nonStriker": { "name": "Ellie Johnston", … }, "bowler": null, "over": 3, "ball": 0 }