get_deliveries

10 creditsTime-seriesPOST /v1/get_deliveries

Data refreshed Nov 12, 2026 · changelog

Ball-by-ball rows for a match, a batter or a bowler, with our win probability

Use it when you want ball-by-ball rows: one innings of a match, or every ball a batter faced or a bowler bowled in a competition.

Parameters

match_idstringoptional: Match id from get_matches.
inningsintegeroptional
batter_idstringoptional: Player id from search_players.
bowler_idstringoptional: Player id from search_players.
competitionstringoptional: Competition key from list_competitions (ipl, bbl, psl, blast, hundred, county, test, odi, t20i, ...).
seasonstringoptional: Season: a year (2024) or a split season (2024/25); a year also finds the split season that starts in it.
over_fromintegeroptional: First over, 0-based as scorers count (0 is the first over).
over_tointegeroptional: Last over, 0-based.
wickets_onlybooleanoptional
boundaries_onlybooleanoptional
limitintegeroptional: Max balls (default 600 for a match, 200 otherwise).
offsetintegeroptional
leagueenum: cricket | test | odi | t20i | ipl | bbl | psl | cpl | blast | hundred | sa20 | ilt20 | county | wbbl | wpl | hundred_womenoptional: League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women.

Notes

Over MCP, ask for it in plain English and the client calls get_deliveries itself. Point any MCP client at https://mcp.yorkerapi.com/mcp?key=YOUR_API_KEY.
Each call costs 10 credits, taken before it runs and refunded if the server errors.
Not the call you need? Find the right call by what you are trying to answer.

Request

curl -X POST https://mcp.yorkerapi.com/v1/get_deliveries \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "match_id": "1473511",
  "innings": 2,
  "over_from": 18
}'

Response

json

{
  "deliveries": [
    {
      "match_id": "1473511",
      "date": "2025-06-03",
      "innings": 2,
      "over": 18,
      "ball": 1,
      "delivery": "18.1",
      "legal": true,
      "batter_id": "26989d80",
      "batter": "Shashank Singh",
      "bowler_id": "2e81a32d",
      "bowler": "B Kumar",
      "non_striker_id": "68c56d09",
      "runs_batter": 6,
      "runs_extras": 0,
      "runs_total": 6,
      "wides": null,
      "noballs": null,
      "byes": null,
      "legbyes": null,
      "penalty": null,
      "non_boundary": null,
      "wicket_kind": null,
      "player_out_id": null,
      "fielder_ids": null,
      "review": null,
      "team_runs": 155,
      "team_wickets": 7,
      "team_legal_balls": 109,
      "win_prob": 0.0027
    },
    {
      "match_id": "1473511",
      "date": "2025-06-03",
      "innings": 2,
      "over": 18,
      "ball": 2,
      "delivery": "18.2",
      "legal": true,
      "batter_id": "26989d80",
      "batter": "Shashank Singh",
      "bowler_id": "2e81a32d",
      "bowler": "B Kumar",
      "non_striker_id": "68c56d09",
      "runs_batter": 0,
      "runs_extras": 0,
      "runs_total": 0,
      "wides": null,
      "noballs": null,
      "byes": null,
      "legbyes": null,
      "penalty": null,
      "non_boundary": null,
      "wicket_kind": null,
      "player_out_id": null,
      "fielder_ids": null,
      "review": null,
      "team_runs": 155,
      "team_wickets": 7,
      "team_legal_balls": 110,
      "win_prob": 0.0013
    },
    {
      "match_id": "1473511",
      "date": "2025-06-03",
      "innings": 2,
      "over": 18,
      "ball": 3,
      "delivery": "18.3",
      "legal": true,
      "batter_id": "26989d80",
      "batter": "Shashank Singh",
      "bowler_id": "2e81a32d",
      "bowler": "B Kumar",
      "non_striker_id": "68c56d09",
      "runs_batter": 0,
      "runs_extras": 0,
      "runs_total": 0,
      "wides": null,
      "noballs": null,
      "byes": null,
      "legbyes": null,
      "penalty": null,
      "non_boundary": null,
      "wicket_kind": null,
      "player_out_id": null,
      "fielder_ids": null,
      "review": null,
      "team_runs": 155,
      "team_wickets": 7,
      "team_legal_balls": 111,
      "win_prob": 0.0005
    }
  ],
  "count": 12,
  "next_offset": null
}