Skip to content
datasportsAPI

No. 11 · Bat & ball · Fixture sport

CricketThe full scorecard, ball by ball.

Tests, ODIs, T20 leagues: the full scorecard innings by innings, the toss, batting side, umpires and ball-by-ball flow.

Get a free key See the 12 endpoints
11Bat & ball
Cricket12 endpoints · fixtures

Scouting report

What you get for Cricket

Cricket comes with the full scorecard, innings by innings: totals and extras, a batting card with dismissal, bowler and fielder, runs, balls, fours, sixes and strike rate, and a bowling card with overs, maidens and economy.

Each fixture records the toss, the umpires and the TV umpire. The ball-by-ball feed gives every delivery its outcome, runs and wicket, along with the commentary line, the wagon-wheel zone and where the ball pitched.

First request

Every cricket match in play, one call.

The live board filtered to cricket: each match with its score, status and clock. The same request in four forms; pick yours.

  1. 1Create a key in the dashboard. Free gives you 1,000 requests a day during the beta.
  2. 2Put it in DATASPORTSAPI_API_KEY so the SDKs and the dsa command find it.
  3. 3Call /v2/livescores?sport=cricket.
curl -H "Authorization: Bearer dsa_live_…" \
  "https://api.datasportsapi.com/v2/livescores?sport=cricket"

The catalog

Cricket, endpoint by endpoint

Its own detail first, then the shared spine every fixture sport answers on. Each row opens the endpoint’s reference page.

All 116 endpoints

Where cricket goes deeper

2 endpoints with detail specific to the sport.

  1. GETScorecard/v2/fixtures/{id}/scorecardComplete cricket scorecard, broken down per innings.All plans
  2. GETPoint by point/v2/fixtures/{id}/pointsA point-by-point breakdown of the match.Pro + Business

The shared spine

10 endpoints that behave the same for every fixture sport.

  1. GETLive scores/v2/livescoresReturns every live fixture across all sports, or a single sport’s in-play board when ?sport= is given.All plans
  2. GETFixtures by date/v2/fixturesLists the fixtures that start on a given UTC date.All plans
  3. GETFixture/v2/fixtures/{id}Everything we hold on one fixture.All plans
  4. GETEvents/v2/fixtures/{id}/eventsThe match’s incidents in chronological order, oldest first: goals, cards, substitutions, period markers and added-time announcements.All plans
  5. GETStatistics/v2/fixtures/{id}/statisticsTeam statistics for the match, organised by period and by category.All plans
  6. GETHead to head/v2/fixtures/{id}/h2hThe two teams’ head-to-head record as tallied by the source, seen from this fixture’s home / away point of view.All plans
  7. GETStandings/v2/leagues/{id}/standingsLeague tables for a single season.All plans
  8. GETTeam/v2/teams/{id}Returns a team’s profile — sport, country, venue, colours, logo, gender, whether it is a club or a national team, kind (team / individual / pair), manager and founding date (foundedOn, pres…All plans
  9. GETLeague/v2/leagues/{id}Returns a league’s profile: its tier (where it sits in the national pyramid), gender, the reigning champion with its title count, the clubs holding the most titles, the divisions directly a…All plans
  10. GETSearch/v2/searchA single search over teams (individual competitors included), players, managers, referees, leagues, fixtures, venues, racing series and races.All plans

What comes back

Scorecard, as served

A T20 innings: totals, extras and the batting card, as the scorecard endpoint serves it.

GET/v2/fixtures/{id}/scorecardAll plans

Sample from the docs, trimmed with …

GET /v2/fixtures/{id}/scorecard
{ "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 } }

Switch sport

Coverage across all 24

Same family · Bat & ball

The rest of the table

Cricket is one query string away.

Swap ?sport=cricket for any other fixture sport and the same code keeps working. Free key, no card.

Get a free key Read the quickstart