Skip to content
datasportsAPI

FixturesScorecard

Documentation

/

Type to filter the docs by title or path.

FixturesEndpoint 25 of 116

Scorecard

GET

/v2/fixtures/{id}/scorecard

Plan
All plans
Auth
Bearer dsa_live_…
Parameters
1 required · 0 optional
Returns
Scorecard
Try in Playground

Complete cricket scorecard, broken down per innings. Each innings lists its total and extras, a batting card (state, dismissal, bowler, fielder, runs, balls, fours, sixes, strike rate) and a bowling card (overs, maidens, runs, wickets, wides, no-balls, economy), followed by falls of wicket and partnerships.

Worth knowing

  • 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.

01Parameters

  • idpathRequired

    fixture id issued by DataSportsAPI, a positive integer

02Request

The same call from the command line and each SDK. The SDK lines assume a client created with your key; left out, it is read from DATASPORTSAPI_API_KEY. Installing a client: SDKs & CLI.

curl -H "Authorization: Bearer dsa_live_…" \
    "https://api.datasportsapi.com/v2/fixtures/{id}/scorecard"

03Response

The top-level keys of the JSON body. Each object links to its full shape in the data reference.

data
Scorecard
ObjectsScorecard
Example response
{ "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 }

04Errors

Nothing specific to this endpoint: only the account-wide errors below apply.

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code