get_player

5 creditsStats + aggregationPOST /v1/get_player

Data refreshed Nov 12, 2026 · changelog

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

Use it when you are profiling a player: teams, and batting and bowling by format with hundreds, fifties and best figures.

Parameters

player_idstringrequired: Player id from search_players.
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 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 \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "player_id": "462411b3"
}'

Response

json

{
  "player": {
    "player_id": "462411b3",
    "name": "JJ Bumrah",
    "full_name": "Jasprit Bumrah",
    "matches": 402,
    "first_match": "2013-04-04",
    "last_match": "2026-10-03"
  },
  "teams": [
    {
      "team_id": "india",
      "name": "India",
      "matches": 235,
      "first": "2016-01-23",
      "last": "2026-10-03"
    },
    {
      "team_id": "mumbai-indians",
      "name": "Mumbai Indians",
      "matches": 158,
      "first": "2013-04-04",
      "last": "2026-05-20"
    },
    {
      "team_id": "gujarat",
      "name": "Gujarat",
      "matches": 9,
      "first": "2016-01-02",
      "last": "2016-01-18"
    }
  ],
  "batting_by_format": [
    {
      "group_key": "test",
      "matches": 47,
      "innings": 76,
      "runs": 348,
      "balls": 843,
      "outs": 53,
      "fours": 38,
      "sixes": 11,
      "dots": 673,
      "hundreds": 0,
      "fifties": 0,
      "highest": 34,
      "average": 6.57,
      "strike_rate": 41.28
    },
    {
      "group_key": "odi",
      "matches": 22,
      "innings": 22,
      "runs": 110,
      "balls": 171,
      "outs": 12,
      "fours": 13,
      "sixes": 2,
      "dots": 114,
      "hundreds": 0,
      "fifties": 0,
      "highest": 20,
      "average": 9.17,
      "strike_rate": 64.33
    },
    {
      "group_key": "t20",
      "matches": 37,
      "innings": 37,
      "runs": 89,
      "balls": 107,
      "outs": 15,
      "fours": 8,
      "sixes": 1,
      "dots": 50,
      "hundreds": 0,
      "fifties": 0,
      "highest": 16,
      "average": 5.93,
      "strike_rate": 83.18
    }
  ],
  "bowling_by_format": [
    {
      "group_key": "test",
      "matches": 52,
      "balls": 10031,
      "runs_conceded": 4631,
      "wickets": 234,
      "dots": 7767,
      "wides": 42,
      "noballs": 115,
      "five_wickets": 16,
      "best": "6/27",
      "overs": "1671.5",
      "average": 19.79,
      "economy": 2.77,
      "strike_rate": 42.9
    },
    {
      "group_key": "t20",
      "matches": 259,
      "balls": 5841,
      "runs_conceded": 6853,
      "wickets": 320,
      "dots": 2467,
      "wides": 191,
      "noballs": 55,
      "five_wickets": 2,
      "best": "5/10",
      "overs": "973.3",
      "average": 21.42,
      "economy": 7.04,
      "strike_rate": 18.3
    },
    {
      "group_key": "odi",
      "matches": 88,
      "balls": 4574,
      "runs_conceded": 3507,
      "wickets": 145,
      "dots": 2685,
      "wides": 146,
      "noballs": 22,
      "five_wickets": 2,
      "best": "6/19",
      "overs": "762.2",
      "average": 24.19,
      "economy": 4.6,
      "strike_rate": 31.5
    }
  ]
}