{
  "openapi": "3.1.0",
  "info": {
    "title": "Masters Live Tracker API",
    "description": "Real-time Masters Tournament data from Augusta National — scoring, leaderboard, pairings, weather, and hole difficulty analytics.",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://masters-live-tracker.pages.dev"
    }
  ],
  "paths": {
    "/api/scores": {
      "get": {
        "operationId": "getScores",
        "summary": "Get hole-by-hole scoring data with difficulty ratings",
        "description": "Returns processed scoring data for all 18 holes in the current round, including difficulty ratings, scoring averages, birdie/bogey counts, and environmental impact factors.",
        "responses": {
          "200": {
            "description": "Scoring data with hole difficulty analysis",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/api/leaderboard": {
      "get": {
        "operationId": "getLeaderboard",
        "summary": "Get live tournament leaderboard",
        "description": "Returns the full tournament leaderboard sorted by total score. Includes player name, country, position, total to par, today score, holes completed, and round-by-round scores.",
        "responses": {
          "200": {
            "description": "Tournament leaderboard array",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/api/pairings": {
      "get": {
        "operationId": "getPairings",
        "summary": "Get pairings and tee times for a round",
        "description": "Returns pairings with tee times for the specified round. Each group includes player names, countries, scores, and group scoring average.",
        "parameters": [
          {
            "name": "round",
            "in": "query",
            "description": "Round number (1-4). Defaults to 1.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 4
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Pairings data for the specified round",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/api/weather": {
      "get": {
        "operationId": "getWeather",
        "summary": "Get current weather at Augusta National",
        "description": "Returns current weather conditions at Augusta National Golf Club including temperature, wind, humidity, green firmness estimate, and environmental impact on play.",
        "responses": {
          "200": {
            "description": "Current weather conditions",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/api/forecast": {
      "get": {
        "operationId": "getForecast",
        "summary": "Get tournament weather forecast (Thu-Sun)",
        "description": "Returns daily weather forecast for the tournament window (Thursday through Sunday) at Augusta National. Includes temperature, wind, precipitation, green firmness estimate, and playability rating.",
        "responses": {
          "200": {
            "description": "Daily forecast array",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    }
  }
}