Skip to content
YorkerAPI

get_match

5 creditsMulti-tablePOST /v1/get_match

Data refreshed · changelog

One match in full: batting and bowling cards, ratings and every book's opening and closing price

Use it when you need one match in full: both batting and bowling cards, fall of wickets, ratings before and after, and every book's price.

Parameters

match_idstringrequired
Match id from get_matches or get_schedule.
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_match itself. Point any MCP client at https://mcp.yorkerapi.com/mcp?key=YOUR_API_KEY.
  • Each call costs 5 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_match \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "match_id": "1473511"
}'

Response

json
{
  "match": {
    "match_id": "1473511",
    "competition": "ipl",
    "event_name": "Indian Premier League",
    "season": "2025",
    "start_date": "2025-06-03",
    "end_date": "2025-06-03",
    "match_type": "T20",
    "format": "t20",
    "gender": "male",
    "event_stage": "Final",
    "event_match_number": null,
    "team1_id": "royal-challengers-bengaluru",
    "team1": "Royal Challengers Bengaluru",
    "team2_id": "punjab-kings",
    "team2": "Punjab Kings",
    "venue": "Narendra Modi Stadium, Ahmedabad",
    "city": "Ahmedabad",
    "toss_winner_id": "punjab-kings",
    "toss_decision": "field",
    "winner_id": "royal-challengers-bengaluru",
    "result": "win",
    "win_by_runs": 6,
    "win_by_wickets": null,
    "win_by_innings": null,
    "method": null,
    "team1_score": "190/9",
    "team2_score": "184/7",
    "officials": {
      "umpires": [
        "J Madanagopal",
        "Nitin Menon"
      ],
      "tv_umpires": [
        "CB Gaffaney"
      ],
      "match_referees": [
        "J Srinath"
      ],
      "reserve_umpires": [
        "KN Ananthapadmanabhan"
      ]
    },
    "overs": 20,
    "balls_per_over": 6,
    "par_score": 191.16547,
    "player_of_match": [
      {
        "player_id": "5b8c830e",
        "name": "KH Pandya"
      }
    ]
  },
  "innings": [
    {
      "innings": 1,
      "batting_team_id": "royal-challengers-bengaluru",
      "batting_team": "Royal Challengers Bengaluru",
      "runs": 190,
      "wickets": 9,
      "legal_balls": 120,
      "declared": false,
      "forfeited": false,
      "super_over": false,
      "target_runs": null,
      "target_overs": null,
      "extras": 9,
      "overs": "20",
      "batting": [
        {
          "player_id": "3d284ca3",
          "name": "PD Salt",
          "position": 1,
          "runs": 16,
          "balls": 9,
          "fours": 2,
          "sixes": 1,
          "how_out": "caught",
          "bowler": "KA Jamieson",
          "fielders": "SS Iyer",
          "fall_of_wicket": "18-1",
          "not_out": false,
          "strike_rate": 177.78
        },
        {
          "player_id": "ba607b88",
          "name": "V Kohli",
          "position": 2,
          "runs": 43,
          "balls": 35,
          "fours": 3,
          "sixes": 0,
          "how_out": "caught and bowled",
          "bowler": "Azmatullah Omarzai",
          "fielders": null,
          "fall_of_wicket": "131-4",
          "not_out": false,
          "strike_rate": 122.86
        },
        {
          "player_id": "00ea847a",
          "name": "MA Agarwal",
          "position": 3,
          "runs": 24,
          "balls": 18,
          "fours": 2,
          "sixes": 1,
          "how_out": "caught",
          "bowler": "YS Chahal",
          "fielders": "Arshdeep Singh",
          "fall_of_wicket": "56-2",
          "not_out": false,
          "strike_rate": 133.33
        }
      ],
      "bowling": [
        {
          "player_id": "244048f6",
          "name": "Arshdeep Singh",
          "balls": 24,
          "maidens": 0,
          "runs": 40,
          "wickets": 3,
          "dots": 8,
          "wides": 2,
          "noballs": 0,
          "overs": "4",
          "economy": 10
        },
        {
          "player_id": "68c56d09",
          "name": "KA Jamieson",
          "balls": 24,
          "maidens": 0,
          "runs": 48,
          "wickets": 3,
          "dots": 9,
          "wides": 3,
          "noballs": 0,
          "overs": "4",
          "economy": 12
        },
        {
          "player_id": "8f6dd463",
          "name": "Azmatullah Omarzai",
          "balls": 24,
          "maidens": 0,
          "runs": 35,
          "wickets": 1,
          "dots": 3,
          "wides": 2,
          "noballs": 0,
          "overs": "4",
          "economy": 8.75
        }
      ]
    },
    {
      "innings": 2,
      "batting_team_id": "punjab-kings",
      "batting_team": "Punjab Kings",
      "runs": 184,
      "wickets": 7,
      "legal_balls": 120,
      "declared": false,
      "forfeited": false,
      "super_over": false,
      "target_runs": 191,
      "target_overs": 20,
      "extras": 11,
      "overs": "20",
      "batting": [
        {
          "player_id": "9418198b",
          "name": "P Simran Singh",
          "position": 1,
          "runs": 26,
          "balls": 22,
          "fours": 0,
          "sixes": 2,
          "how_out": "caught",
          "bowler": "KH Pandya",
          "fielders": "B Kumar",
          "fall_of_wicket": "72-2",
          "not_out": false,
          "strike_rate": 118.18
        },
        {
          "player_id": "b5797845",
          "name": "Priyansh Arya",
          "position": 2,
          "runs": 24,
          "balls": 19,
          "fours": 4,
          "sixes": 0,
          "how_out": "caught",
          "bowler": "JR Hazlewood",
          "fielders": "PD Salt",
          "fall_of_wicket": "43-1",
          "not_out": false,
          "strike_rate": 126.32
        },
        {
          "player_id": "989889ff",
          "name": "JP Inglis",
          "position": 3,
          "runs": 39,
          "balls": 23,
          "fours": 1,
          "sixes": 4,
          "how_out": "caught",
          "bowler": "KH Pandya",
          "fielders": "LS Livingstone",
          "fall_of_wicket": "98-4",
          "not_out": false,
          "strike_rate": 169.57
        }
      ],
      "bowling": [
        {
          "player_id": "2e81a32d",
          "name": "B Kumar",
          "balls": 24,
          "maidens": 0,
          "runs": 38,
          "wickets": 2,
          "dots": 9,
          "wides": 0,
          "noballs": 0,
          "overs": "4",
          "economy": 9.5
        },
        {
          "player_id": "7210d461",
          "name": "Yash Dayal",
          "balls": 18,
          "maidens": 0,
          "runs": 18,
          "wickets": 1,
          "dots": 7,
          "wides": 0,
          "noballs": 0,
          "overs": "3",
          "economy": 6
        },
        {
          "player_id": "03806cf8",
          "name": "JR Hazlewood",
          "balls": 24,
          "maidens": 0,
          "runs": 54,
          "wickets": 1,
          "dots": 6,
          "wides": 2,
          "noballs": 0,
          "overs": "4",
          "economy": 13.5
        }
      ]
    }
  ],
  "ratings": [
    {
      "team_id": "royal-challengers-bengaluru",
      "rating_before": 1574,
      "rating_after": 1581
    },
    {
      "team_id": "punjab-kings",
      "rating_before": 1529,
      "rating_after": 1522
    }
  ],
  "odds": [
    {
      "bookmaker": "betfair_ex_au",
      "outcome": "Punjab Kings",
      "open_decimal": 2.1,
      "close_decimal": 1.99,
      "open_american": 110,
      "close_american": -101,
      "opened_at": "2025-06-02 11:55:36+00",
      "closed_at": "2025-06-03 13:45:36+00"
    },
    {
      "bookmaker": "betfair_ex_au",
      "outcome": "Royal Challengers Bangalore",
      "open_decimal": 1.9,
      "close_decimal": 2,
      "open_american": -111,
      "close_american": 100,
      "opened_at": "2025-06-02 11:55:36+00",
      "closed_at": "2025-06-03 13:45:36+00"
    },
    {
      "bookmaker": "betfair_ex_eu",
      "outcome": "Punjab Kings",
      "open_decimal": 2.1,
      "close_decimal": 1.99,
      "open_american": 110,
      "close_american": -101,
      "opened_at": "2025-06-02 11:55:36+00",
      "closed_at": "2025-06-03 13:45:36+00"
    }
  ]
}

Response fields

matchobject
match.match_idstring
match.competitionstring
match.event_namestring
match.seasonstring
match.start_datestring
match.end_datestring
match.match_typestring
match.formatstring
match.genderstring
match.event_stagestring
match.event_match_numbernull
match.team1_idstring
match.team1string
match.team2_idstring
match.team2string
match.venuestring
match.citystring
match.toss_winner_idstring
match.toss_decisionstring
match.winner_idstring
match.resultstring
match.win_by_runsnumber
match.win_by_wicketsnull
match.win_by_inningsnull
match.methodnull
match.team1_scorestring
match.team2_scorestring
match.officialsobject
match.officials.umpires[]array
List of string
match.officials.tv_umpires[]array
List of string
match.officials.match_referees[]array
List of string
match.officials.reserve_umpires[]array
List of string
match.oversnumber
match.balls_per_overnumber
match.par_scorenumber
match.player_of_match[]array
List of objects
match.player_of_match[].player_idstring
match.player_of_match[].namestring
innings[]array
List of objects

Related endpoints

get_player5 cr

Takes the player_id this one returns.

A career by format: runs, average, strike rate, wickets, economy, hundreds, best figures

get_player_stats5 cr

Takes the player_id this one returns.

A player split by season, competition, phase (powerplay, middle, death) or format

get_leaders5 cr

Filters by the same league.

Leaders in runs, average, strike rate, sixes, wickets, economy

get_deliveries10 cr

Filters by the same match_id and league.

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

Try it

500 free credits every month: 100 calls to get_match, and no card.

Get a free keyAll cricket endpoints