list_competitions

1 creditStatic referencePOST /v1/list_competitions

Every competition we hold with its key, format, match count and seasons

Use it when you need a competition's key for the other endpoints, or want to see what we hold and since when.

Parameters

genderenum: male | femaleoptional
formatenum: test | odi | t20 | first_class | list_aoptional: test, odi, t20 (T20Is and T20 leagues), first_class, list_a.
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 list_competitions itself. Point any MCP client at https://mcp.yorkerapi.com/mcp?key=YOUR_API_KEY.
Each call costs 1 credit, 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/list_competitions \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "format": "t20",
  "gender": "male"
}'

Response

json

{
  "competitions": [
    {
      "competition": "t20i",
      "name": "T20 Internationals",
      "format": "t20",
      "gender": "male",
      "team_type": "international",
      "matches": 3889,
      "first_match": "2005-02-17",
      "last_match": "2026-11-01",
      "seasons": 45
    },
    {
      "competition": "blast",
      "name": "T20 Blast",
      "format": "t20",
      "gender": "male",
      "team_type": "club",
      "matches": 1570,
      "first_match": "2014-05-16",
      "last_match": "2026-07-18",
      "seasons": 13
    },
    {
      "competition": "ipl",
      "name": "Indian Premier League",
      "format": "t20",
      "gender": "male",
      "team_type": "club",
      "matches": 1243,
      "first_match": "2008-04-18",
      "last_match": "2026-05-31",
      "seasons": 19
    }
  ],
  "count": 25
}