get_head_to_head

5 creditsStats + aggregationPOST /v1/get_head_to_head

Two players' finishes and rounds in every tournament they both played

Use it when you are comparing two players: who finished ahead in the tournaments they both played, and round by round.

Parameters

player_astringrequired: First player id.
player_bstringrequired: Second player id.
seasonstring | numberoptional: Season year, e.g. 2025.

Notes

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

Response

json

{
  "player_a": {
    "player_id": "9478",
    "name": "Scottie Scheffler"
  },
  "player_b": {
    "player_id": "3470",
    "name": "Rory McIlroy"
  },
  "summary": {
    "tournaments": 13,
    "a_ahead": 11,
    "b_ahead": 2,
    "tied": 0,
    "no_decision": 0,
    "rounds": 49,
    "a_better_rounds": 31,
    "b_better_rounds": 17,
    "even_rounds": 1,
    "a_minus_b_strokes_per_round": -2.06
  },
  "meetings": [
    {
      "tournament_id": "401580366",
      "name": "TOUR Championship",
      "season": 2024,
      "start_date": "2024-08-29",
      "major": false,
      "a_position": "1",
      "a_status": "finished",
      "a_to_par": -30,
      "b_position": "T9",
      "b_status": "finished",
      "b_to_par": -16,
      "rounds": [
        {
          "round": 1,
          "a": 65,
          "b": 69
        },
        {
          "round": 2,
          "a": 66,
          "b": 69
        },
        {
          "round": 3,
          "a": 66,
          "b": 68
        }
      ],
      "finished_ahead": "9478"
    },
    {
      "tournament_id": "401580365",
      "name": "BMW Championship",
      "season": 2024,
      "start_date": "2024-08-22",
      "major": false,
      "a_position": "T33",
      "a_status": "finished",
      "a_to_par": 1,
      "b_position": "T11",
      "b_status": "finished",
      "b_to_par": -6,
      "rounds": [
        {
          "round": 1,
          "a": 71,
          "b": 70
        },
        {
          "round": 2,
          "a": 72,
          "b": 71
        },
        {
          "round": 3,
          "a": 74,
          "b": 70
        }
      ],
      "finished_ahead": "3470"
    },
    {
      "tournament_id": "401580364",
      "name": "FedEx St. Jude Championship",
      "season": 2024,
      "start_date": "2024-08-15",
      "major": false,
      "a_position": "4",
      "a_status": "finished",
      "a_to_par": -14,
      "b_position": "T68",
      "b_status": "finished",
      "b_to_par": 9,
      "rounds": [
        {
          "round": 1,
          "a": 66,
          "b": 68
        },
        {
          "round": 2,
          "a": 65,
          "b": 73
        },
        {
          "round": 3,
          "a": 69,
          "b": 74
        }
      ],
      "finished_ahead": "9478"
    }
  ],
  "count": 13
}