get_player_matches

5 creditsStats + aggregationPOST /v1/get_player_matches

A player's matches with batting and bowling in each innings

Use it when you need a player's matches to chart form, with their batting and bowling in each innings.

Parameters

player_idstringrequired: Player id from search_players.
formatenum: test | odi | t20 | first_class | list_aoptional
competitionstringoptional: Competition key from list_competitions (ipl, bbl, test, odi, t20i, ...).
seasonstringoptional: Season: a year (2024) or a split season (2024/25).
limitintegeroptional: Max matches (default 50).
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_player_matches 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_player_matches \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "player_id": "a343262c",
  "format": "test",
  "limit": 3
}'

Response

json

{
  "player_id": "a343262c",
  "name": "JE Root",
  "matches": [
    {
      "match_id": "1496584",
      "date": "2026-09-09",
      "competition": "test",
      "format": "test",
      "team_id": "england",
      "opponent_id": "pakistan",
      "result": "won",
      "batting": [
        {
          "out": true,
          "runs": 8,
          "balls": 18,
          "fours": 0,
          "sixes": 0,
          "innings": 2
        },
        {
          "out": false,
          "runs": 62,
          "balls": 69,
          "fours": 8,
          "sixes": 0,
          "innings": 4
        }
      ],
      "bowling": null
    },
    {
      "match_id": "1496583",
      "date": "2026-08-27",
      "competition": "test",
      "format": "test",
      "team_id": "england",
      "opponent_id": "pakistan",
      "result": "won",
      "batting": [
        {
          "out": true,
          "runs": 4,
          "balls": 13,
          "fours": 0,
          "sixes": 0,
          "innings": 1
        },
        {
          "out": true,
          "runs": 24,
          "balls": 37,
          "fours": 3,
          "sixes": 0,
          "innings": 3
        }
      ],
      "bowling": null
    },
    {
      "match_id": "1496582",
      "date": "2026-08-19",
      "competition": "test",
      "format": "test",
      "team_id": "england",
      "opponent_id": "pakistan",
      "result": "won",
      "batting": [
        {
          "out": true,
          "runs": 66,
          "balls": 112,
          "fours": 10,
          "sixes": 0,
          "innings": 2
        }
      ],
      "bowling": null
    }
  ],
  "count": 3,
  "next_offset": 3
}