get_ratings

2 creditsBasic lookupPOST /v1/get_ratings

Our Elo ratings by format, best first

Use it when you want our Elo ratings in one format, best first, for international sides or franchises.

Parameters

formatenum: test | odi | t20 | first_class | list_arequired
genderenum: male | femaleoptional
team_typeenum: international | cluboptional
active_sincestringoptional: Only teams with a match since this date (YYYY-MM-DD; default two years ago).
limitintegeroptional
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_ratings itself. Point any MCP client at https://mcp.yorkerapi.com/mcp?key=YOUR_API_KEY.
Each call costs 2 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_ratings \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "format": "test",
  "team_type": "international",
  "limit": 5
}'

Response

json

{
  "format": "test",
  "active_since": "2024-11-04",
  "ratings": [
    {
      "rank": 1,
      "team_id": "australia",
      "name": "Australia",
      "gender": "male",
      "team_type": "international",
      "rating": 1658,
      "matches": 233,
      "as_of": "2026-10-27"
    },
    {
      "rank": 2,
      "team_id": "south-africa",
      "name": "South Africa",
      "gender": "male",
      "team_type": "international",
      "rating": 1618,
      "matches": 195,
      "as_of": "2026-10-27"
    },
    {
      "rank": 3,
      "team_id": "india",
      "name": "India",
      "gender": "male",
      "team_type": "international",
      "rating": 1610,
      "matches": 219,
      "as_of": "2026-08-23"
    }
  ],
  "count": 5,
  "method": "Our Elo per format from every decided, tied or drawn match since 2001 in the record: start 1500, a tie or draw scores a half, K shrinks with matches played. Franchises and countries are separate pools by fixture, men's and women's sides separate teams."
}