get_ratings

2 creditsBasic lookupPOST /v1/get_ratings

Our strokes-versus-field rating: every active player, field-strength adjusted

Use it when you want the best players right now, or on a past date, on one number that accounts for who they played against.

Parameters

limitintegeroptional: Max players (default 50).
as_ofstringoptional: A date (YYYY-MM-DD): the ratings as they stood then. Default the latest.
min_roundsintegeroptional: Minimum decay-weighted rounds behind a rating (default 20).

Notes

Over MCP, ask for it in plain English and the client calls get_ratings itself. Point any MCP client at https://mcp.birdieapi.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.birdieapi.com/v1/get_ratings \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "limit": 3
}'

Response

json

{
  "as_of": "2026-10-04",
  "min_rounds": 20,
  "ratings": [
    {
      "rank": 1,
      "player_id": "9478",
      "name": "Scottie Scheffler",
      "country": "USA",
      "rating": 3.31,
      "weighted_rounds": 133.1,
      "rated_after": "2026-08-30",
      "last_tournament_id": "401811964"
    },
    {
      "rank": 2,
      "player_id": "3470",
      "name": "Rory McIlroy",
      "country": "Northern Ireland",
      "rating": 2.39,
      "weighted_rounds": 96.8,
      "rated_after": "2026-08-30",
      "last_tournament_id": "401811964"
    },
    {
      "rank": 3,
      "player_id": "5539",
      "name": "Tommy Fleetwood",
      "country": "England",
      "rating": 2.19,
      "weighted_rounds": 119.8,
      "rated_after": "2026-08-30",
      "last_tournament_id": "401811964"
    }
  ],
  "count": 3,
  "method": "Strokes per round better than an average player in the same field, from every full round: each round is compared with the field's average on the same course that day, adjusted for how strong that field was, weighted toward recent rounds (half-life one year) and shrunk toward zero for players with few rounds. Positive is better. Measured within one tour."
}