### GET /playergame/basic Source: https://sportsdata.io/developers/workflow-guide/soccer Retrieves projected and confirmed starting lineups and substitute benches for a given competition on a specific date. ```APIDOC ## GET /playergame/basic ### Description Retrieves projected and confirmed starting XIs and substitute benches for a given competition on a given date. ### Method GET ### Endpoint `/playergame/basic` ### Query Parameters - **competitionId** (integer) - Required - The ID of the competition. - **date** (string) - Required - The date in 'YYYY-MM-DD' format. ### Response #### Success Response (200) - **PlayerGameBasic[]** (array) - An array of player game basic information. #### Response Example ```json [ { "player": { "playerId": 123, "name": "John Doe", "teamId": 45, "teamName": "Team A" }, "status": "starter", "position": "Forward" } ] ``` ``` -------------------------------- ### GET /v3/nba/projections/json/StartingLineupsByDate/{date} Source: https://sportsdata.io/developers/api-documentation/nba Retrieves projected and confirmed starting lineups for a specified date. This endpoint is useful for getting the most up-to-date lineup information before games begin. ```APIDOC ## GET /v3/nba/projections/json/StartingLineupsByDate/{date} ### Description Returns projected and confirmed starting lineups for the specified date. ### Method GET ### Endpoint https://api.sportsdata.io/v3/nba/projections/json/StartingLineupsByDate/{date} ### Parameters #### Path Parameters - **date** (string) - Required - The date of the game(s). Examples: `2021-OCT-12`, `2021-DEC-09`. #### Query Parameters - **key** (string) - Required - Your unique API key for subscription. - **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`. ### Request Example ```json { "example": "https://api.sportsdata.io/v3/nba/projections/json/StartingLineupsByDate/2023-OCT-26?key=YOUR_API_KEY" } ``` ### Response #### Success Response (200) - **Lineup** (array) - An array of lineup information. - **StartingLineups** (array) - An array of starting lineup details. #### Response Example ```json { "example": "[StartingLineups[]]" } ``` ``` -------------------------------- ### GET /StartingLineups/{date} Source: https://sportsdata.io/developers/api-documentation/nba Retrieves projected and confirmed starting lineups for a specified date. Requires a valid API key. ```APIDOC ## GET /StartingLineups/{date} ### Description Returns projected and confirmed starting lineups for the specified date. ### Method GET ### Endpoint https://api.sportsdata.io/v3/nba/stats/json/StartingLineups/{date} ### Parameters #### Query Parameters - **key** (string) - Required - Your subscription API key. #### Path Parameters - **date** (string) - Required - The date for which to retrieve starting lineups (format YYYY-MM-DD). - **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`. ### Request Example ```json { "example": "https://api.sportsdata.io/v3/nba/stats/json/StartingLineups/2023-10-26?key=YOUR_API_KEY" } ``` ### Response #### Success Response (200) - **LineupStartingLineups[]** - An array of starting lineup objects. #### Response Example ```json { "example": "[LineupStartingLineups objects]" } ``` ``` -------------------------------- ### GET Lineups - by Date Source: https://sportsdata.io/developers/coverages/soccer Retrieves projected and confirmed starting lineups and substitute benches for a given competition on a specific date. ```APIDOC ## GET Lineups - by Date ### Description Projected and confirmed starting XIs and substitute benches for a given competition on a given date. ### Method GET ### Endpoint `/lineups/date/{date}` ### Parameters #### Path Parameters - **date** (string) - Required - The date in YYYY-MM-DD format. #### Query Parameters - **competitionId** (string) - Optional - The identifier for the competition. ### Response #### Success Response (200) - **PlayerGameBasic[]** (array) - An array of player lineup data. #### Response Example ```json [ { "gameId": "12345", "teamId": "teamA", "lineup": { "formation": "4-4-2", "startingXI": ["player1", "player2"], "substitutes": ["player3"] } } ] ``` ``` -------------------------------- ### GET /v3/mlb/projections/json/StartingLineupsByDate/{date} Source: https://sportsdata.io/developers/api-documentation/mlb Retrieves projected and confirmed starting lineups for games scheduled on a specific date. This is crucial for fantasy sports and betting. ```APIDOC ## GET /v3/mlb/projections/json/StartingLineupsByDate/{date} ### Description Returns projected and confirmed starting lineups for games on the specified date. ### Method GET ### Endpoint https://api.sportsdata.io/v3/mlb/projections/json/StartingLineupsByDate/{date} ### Parameters #### Path Parameters - **date** (string) - Required - The date of the slates. Examples: `2017-JUL-31`, `2017-SEP-01`. #### Query Parameters - **key** (string) - Required - Your subscription key. - **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`. ``` -------------------------------- ### Get NFL Standings - XML Example Source: https://sportsdata.io/developers/api-documentation/nfl Example of an HTTP GET request to retrieve regular season standings for NFL teams in a specified season. The response is returned in XML format. ```HTTP GET https://api.sportsdata.io/v3/nfl/scores/xml/Standings/**{season}** ``` -------------------------------- ### Get NFL Standings - JSON Example Source: https://sportsdata.io/developers/api-documentation/nfl Example of an HTTP GET request to retrieve regular season standings for NFL teams in a specified season. The response is returned in JSON format. ```HTTP GET https://api.sportsdata.io/v3/nfl/scores/json/Standings/**{season}** ``` -------------------------------- ### GET /v3/mlb/projections/json/DfsSlatesByDate/{date} Source: https://sportsdata.io/developers/api-documentation/mlb Returns DFS Slates which have not yet started for which we have DFS projections. ```APIDOC ## GET /v3/mlb/projections/json/DfsSlatesByDate/{date} ### Description Returns DFS Slates which have not yet started for which we have DFS projections. ### Method GET ### Endpoint https://api.sportsdata.io/v3/mlb/projections/json/DfsSlatesByDate/{date} ### Parameters #### Query Parameters - **key** (string) - Required - Your unique subscription key. - **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`. #### Path Parameters - **date** (string) - Required - The date of the slates. Examples: `2017-JUL-31`, `2017-SEP-01`. ### Response #### Success Response (200) - **DfsSlate[]** - An array of DfsSlate objects. #### Response Example ```json [ { "SlateID": 12345, "SlateName": "Main Slate", "Operator": "DraftKings", "OperatorDayId": "2023-10-27", "GameCount": 10, "StartTime": "2023-10-27T18:00:00Z", "EndTime": "2023-10-27T23:00:00Z" } ] ``` ``` -------------------------------- ### GET /CurrentSeason Source: https://sportsdata.io/developers/api-documentation/golf Retrieves the current golf season's calendar year, including its start and end dates. ```APIDOC ## GET /CurrentSeason ### Description Returns the calendar year of the current season with the start and end date. ### Method GET ### Endpoint https://api.sportsdata.io/golf/v2/json/CurrentSeason ### Parameters #### Query Parameters - **key** (string) - Required - Your unique API subscription key. - **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`. ### Response #### Success Response (200) - **Season** (object) - An object containing the current season's year, start date, and end date. #### Response Example ```json { "SeasonYear": 2024, "StartDate": "2024-01-01T00:00:00", "EndDate": "2024-12-31T23:59:59" } ``` ``` -------------------------------- ### Starting Lineups by Date Source: https://sportsdata.io/developers/data-dictionary/nba Retrieve starting lineups for games on a specific date, including team IDs, game status, and player lineups. ```APIDOC ## GET /lineups/starting ### Description Retrieves the starting lineups for games on a specified date. ### Method GET ### Endpoint /lineups/starting ### Parameters #### Query Parameters - **Date** (datetime) - Required - The day of the game - **GameID** (integer) - Optional - The unique ID of the game associated with this lineup - **Season** (integer) - Optional - The NBA season of the game that the lineups is associated with - **SeasonType** (integer) - Optional - The type of season that this record corresponds to (1=Regular Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=AllStar; 6=Exhibition) - **DateTime** (datetime) - Optional - Date and Time of Game - **Status** (string) - Optional - Indicates the game's status. Possible values include: Scheduled; InProgress; Final; F/OT; Suspended; Postponed; Delayed; Canceled; Forfeit - **HomeTeamID** (integer) - Optional - The unique ID of the home team - **HomeTeam** (string) - Optional - The abbreviation [Key] of the home team - **AwayTeamID** (integer) - Optional - Unique ID of Away Team - **AwayTeam** (string) - Optional - The abbreviation [Key] of the away team ### Response #### Success Response (200) - **GameID** (integer) - The unique ID of the game associated with this lineup - **Season** (integer) - The NBA season of the game that the lineups is associated with - **SeasonType** (integer) - The type of season that this record corresponds to (1=Regular Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=AllStar; 6=Exhibition) - **Day** (datetime) - The day of the game - **DateTime** (datetime) - Date and Time of Game - **Status** (string) - Indicates the game's status. - **HomeTeamID** (integer) - The unique ID of the home team - **HomeTeam** (string) - The abbreviation [Key] of the home team - **AwayTeamID** (integer) - Unique ID of Away Team - **AwayTeam** (string) - The abbreviation [Key] of the away team - **HomeLineup** (Lineup[]) - The lineup (starters and bench players) of the home team in a given game - **AwayLineup** (Lineup[]) - The lineup (starters and bench players) of the away team in a given game #### Response Example ```json { "GameID": 78901, "Season": 2023, "SeasonType": 1, "Day": "2023-10-24T00:00:00", "DateTime": "2023-10-24T19:00:00", "Status": "Scheduled", "HomeTeamID": 101, "HomeTeam": "LAL", "AwayTeamID": 102, "AwayTeam": "BOS", "HomeLineup": [ { "PlayerID": 1111, "Name": "LeBron James", "Position": "SF", "Started": true }, { "PlayerID": 2222, "Name": "Anthony Davis", "Position": "PF", "Started": true } ], "AwayLineup": [ { "PlayerID": 3333, "Name": "Jayson Tatum", "Position": "SF", "Started": true }, { "PlayerID": 4444, "Name": "Jaylen Brown", "Position": "SG", "Started": true } ] } ``` ``` -------------------------------- ### Example Widget HTML Snippet Source: https://sportsdata.io/developers/widgets-guide This is an example of an HTML tag used to embed a specific widget, such as the 'futures-comparison' widget for the NFL. The 'client' and 'league' parameters are configured through the widget builder and sales. ```html ``` -------------------------------- ### Starting Lineups API Source: https://sportsdata.io/developers/data-dictionary/nba Retrieve starting lineup information for a given date, including player details and their starting status. ```APIDOC ## GET /lineups/starting ### Description Retrieves the starting lineup for a specific date, detailing player information and their status in the lineup. ### Method GET ### Endpoint /lineups/starting ### Parameters #### Query Parameters - **date** (string) - Required - The date for which to retrieve the starting lineup (YYYY-MM-DD). ### Response #### Success Response (200) - **PlayerID** (integer) - The player's unique PlayerID. - **TeamID** (integer) - The unique ID of the team. - **Team** (string) - The abbreviation [Key] of the team. - **FirstName** (string) - The player's first name. - **LastName** (string) - The player's last name. - **Position** (string) - The player's primary position. - **Starting** (bool) - Indicates whether this player is in the starting lineup. - **Confirmed** (bool) - Indicates whether the 'Starting' field has been confirmed. - **LineupStatus** (string) - Indicates whether player is starting, active, or inactive. #### Response Example { "PlayerID": 67890, "TeamID": 2, "Team": "GSW", "FirstName": "Stephen", "LastName": "Curry", "Position": "PG", "Starting": true, "Confirmed": true, "LineupStatus": "starter" } ``` -------------------------------- ### Starting Lineups API Source: https://sportsdata.io/developers/coverages/nba Provides the projected and confirmed starting lineups for NBA games on a given date. ```APIDOC ## GET Starting Lineups - by Date ### Description This endpoint provides the projected & confirmed starting lineups for NBA games on a given date. ### Method GET ### Endpoint /LineupStartingLineups ### Parameters #### Query Parameters - **date** (string) - Required - The date for which to retrieve starting lineups (e.g., 'YYYY-MM-DD'). ### Response #### Success Response (200) - **StartingLineups[]** (array) - An array of starting lineup objects. - **game_id** (string) - Unique identifier for the game. - **home_team** (string) - The home team. - **away_team** (string) - The away team. - **starting_lineups** (object) - An object containing starting players for each team. - **home_starters** (array) - Array of home team starting player names. - **away_starters** (array) - Array of away team starting player names. #### Response Example ```json [ { "game_id": "game_abc123", "home_team": "Lakers", "away_team": "Celtics", "starting_lineups": { "home_starters": ["LeBron James", "Anthony Davis"], "away_starters": ["Jayson Tatum", "Jaylen Brown"] } } ] ``` ``` -------------------------------- ### GET /season/current Source: https://sportsdata.io/developers/workflow-guide/nfl Retrieves the current NFL season year. This value updates at the start of the new NFL league year. ```APIDOC ## GET /season/current ### Description Year of the current NFL season. This value changes at the start of the new NFL league year. ### Method GET ### Endpoint /season/current ### Parameters #### Query Parameters None ### Request Example None ### Response #### Success Response (200) - **integer?** (integer) - The year of the current NFL season. #### Response Example ```json 2023 ``` ``` -------------------------------- ### GET Play By Play [Live & Final] Source: https://sportsdata.io/developers/workflow-guide/nba Retrieves real-time play-by-play data for a specific game, updated live during the game. ```APIDOC ## GET Play By Play [Live & Final] ### Description Retrieves detailed play-by-play data for a specific game, delivered live in real-time. Updates typically occur 15-20 seconds behind the TV broadcast. This feed accounts for all substitutions. ### Method GET ### Endpoint `/PlayByPlayLive` ### Parameters #### Query Parameters * **gameId** (string) - Required - The unique identifier for the game. ### Request Example ```json { "example": "GET /PlayByPlayLive?gameId=12345" } ``` ### Response #### Success Response (200) - **PlayByPlay** (object) - Contains the live play-by-play events for the game. - **GamePlayPlayByPlayQuarterSeries** (object) - Contains aggregated game, play-by-play, quarter, and series information. #### Response Example ```json { "example": "{\"gameId\": \"12345\", \"plays\": [{\"playId\": \"P1\", \"clock\": \"11:55\", \"team\": \"Home\", \"player\": \"Player X\", \"type\": \"Made Shot\", \"points\": 2}, ...]}" } ``` ``` -------------------------------- ### GET Play By Play [Live & Final] Source: https://sportsdata.io/developers/coverages/nba Retrieves a detailed record of every play for a specific game, with live updates during the game and a final list of all plays once completed. ```APIDOC ## GET Play By Play [Live & Final] ### Description Retrieves a detailed record of each individual play within a game, including its type, outcome, involved players and teams, and associated statistics. This data is delivered live in real-time throughout the game and also includes the final list of all plays once the game is completed and verified. ### Method GET ### Endpoint `/PlayByPlayLive` ### Parameters #### Query Parameters * **gameId** (string) - Required - The unique identifier for the game. ### Request Example ```json { "example": "GET /PlayByPlayLive?gameId=12345" } ``` ### Response #### Success Response (200) - **PlayByPlay** (object) - Contains a list of all plays in the game, with detailed information for each play, updated live. #### Response Example ```json { "example": "{\"gameId\": \"12345\", \"plays\": [ {\"playId\": \"P1\", \"type\": \"3-pointer\", \"player\": \"PlayerA\", \"stats\": {...}}, ... ]}" } ``` ``` -------------------------------- ### Play By Play [Live & Final] Source: https://sportsdata.io/developers/coverages/mlb Delivers a real-time feed of every play in a game, including live updates and a final compilation of all plays once the game is completed. ```APIDOC ## GET Play By Play [Live & Final] ### Description Each invididual play, its type and outcome, complete with player and team stats down to the play level, delivered live in real-time, called by game. ### Method GET ### Endpoint /games/{gameId}/playbyplay/live ### Parameters #### Path Parameters - **gameId** (string) - Required - The unique identifier for the game. ### Response #### Success Response (200) - **PlayByPlay** (object) - The live play-by-play data for the specified game. #### Response Example ```json { "gameId": "string", "plays": [ { "playId": "string", "description": "string", "outcome": "string", "stats": {}, "playersInvolved": [] } ] } ``` ``` -------------------------------- ### Utility Endpoints - GET Season Source: https://sportsdata.io/developers/coverages/wnba Retrieves the current season year. This value updates at the start of the new league year. ```APIDOC ## GET Season - Current ### Description Year of the current season. This value changes at the start of the new league year. For leagues that run over two years, this is the year the season starts, not ends. ### Method GET ### Endpoint /season/current ### Parameters #### Query Parameters None #### Request Body None ### Request Example None ### Response #### Success Response (200) - **Season** (object) - **year** (integer) - The current season year. #### Response Example ```json { "year": 2024 } ``` ``` -------------------------------- ### GET /v3/nhl/projections/json/StartingGoaltendersByDate/{date} Source: https://sportsdata.io/developers/api-documentation/nhl Returns projected and confirmed starting goaltenders on the specified date. ```APIDOC ## GET /v3/nhl/projections/json/StartingGoaltendersByDate/{date} ### Description Returns projected and confirmed starting goaltenders on the specified date. ### Method GET ### Endpoint https://api.sportsdata.io/v3/nhl/projections/json/StartingGoaltendersByDate/{date} ### Query Parameters - **key** (string) - Required - Subscription Key for API access. ### URL Template Parameters - **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`. - **date** (string) - Required - The date of the game(s). Examples: `2021-OCT-12`, `2021-DEC-09`. ### Response #### Success Response (200) - **StartingGoaltenders[]** (array) - An array of starting goaltender objects. ### Response Example ```json [ { "GameID": 12345, "PlayerID": 11111, "TeamAbbreviation": "BOS", "GoaltenderName": "Linus Ullmark", "IsStarting": true, "ProjectedStart": true }, { "GameID": 12345, "PlayerID": 22222, "TeamAbbreviation": "TOR", "GoaltenderName": "Ilya Samsonov", "IsStarting": true, "ProjectedStart": false } ] ``` ``` -------------------------------- ### Lineups - by Date Source: https://sportsdata.io/developers/api-documentation/soccer Returns confirmed starting lineups and substitute benches for a specified competition and date. ```APIDOC ## GET /v4/soccer/stats/json/LineupsByDate/{competition}/{date} ### Description Returns confirmed starting lineups and substitute benches for a specified competition and date. ### Method GET ### Endpoint `https://api.sportsdata.io/v4/soccer/stats/json/LineupsByDate/{competition}/{date}` ### Parameters #### Path Parameters - **competition** (string) - Required - An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: `EPL`, `1`, `MLS`, `8`, etc. - **date** (string) - Required - The date of the game(s). Examples: `2017-02-27`, `2017-09-01`. #### Query Parameters - **key** (string) - Required - Subscription Key. ### Request Example ```json { "example": "https://api.sportsdata.io/v4/soccer/stats/json/LineupsByDate/EPL/2023-10-27?key=YOUR_KEY" } ``` ### Response #### Success Response (200) - **PlayerGameBasic[]** (array) - An array of PlayerGameBasic objects. #### Response Example ```json { "example": "[PlayerGameBasic Object Array]" } ``` ``` -------------------------------- ### GET Games (Basic) - by Date [Live & Final] Source: https://sportsdata.io/developers/workflow-guide/nba Retrieves basic live game data including quarter, time, and score information. This endpoint is suitable for real-time score updates without detailed game state. ```APIDOC ## GET Games (Basic) - by Date [Live & Final] ### Description This endpoint simply delivers the quarter, time, quarter scores, and total score live; no gameday info is provided. ### Method GET ### Endpoint `/games/basic` ### Query Parameters - **date** (string) - Required - The date for which to retrieve game data (e.g., YYYY-MM-DD). ### Request Example ``` GET /games/basic?date=2023-10-27 ``` ### Response #### Success Response (200) - **ScoreBasic[]** (array) - An array of ScoreBasic objects containing live score information. #### Response Example ```json [ { "quarter": "3", "time": "05:30", "homeScore": 75, "awayScore": 72, "totalScore": { "home": 75, "away": 72 } } ] ``` ``` -------------------------------- ### GET /v3/nhl/scores/json/StartingGoaltenders/{date} Source: https://sportsdata.io/developers/api-documentation/nhl Retrieves projected and confirmed starting goaltenders for a specified date. ```APIDOC ## GET /v3/nhl/scores/json/StartingGoaltenders/{date} ### Description Returns projected and confirmed starting goaltenders on the specified date. ### Method GET ### Endpoint https://api.sportsdata.io/v3/nhl/scores/json/StartingGoaltenders/{date} ### Parameters #### Query Parameters - **key** (string) - Required - Your unique API subscription key. #### URL Template Parameters - **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`. - **date** (string) - Required - The date for which to retrieve starting goaltenders. Examples: `2023-10-26`. ### Response #### Success Response (200) - **StartingGoaltenders[]** (array) - An array of starting goaltender objects. #### Response Example ```json [ { "GameID": 15000, "Date": "2023-10-26T00:00:00", "HomeTeam": "BOS", "AwayTeam": "TOR", "HomeStartingGoaltender": { "PlayerID": 1001, "Name": "Linus Ullmark", "Starts": 10, "Wins": 8, "Losses": 2, "OvertimeLosses": 0, "Shutouts": 1 }, "AwayStartingGoaltender": { "PlayerID": 1003, "Name": "Ilya Samsonov", "Starts": 9, "Wins": 6, "Losses": 3, "OvertimeLosses": 0, "Shutouts": 0 } } ] ``` ``` -------------------------------- ### Starting Goaltenders - by Date Source: https://sportsdata.io/developers/data-dictionary/nhl Retrieves starting goaltender information for games on a specific date. This endpoint provides details about the goaltenders for both the home and away teams. ```APIDOC ## GET /api/v1/StartingGoaltenders ### Description Retrieves starting goaltender information for games on a specific date. This endpoint provides details about the goaltenders for both the home and away teams. ### Method GET ### Endpoint /api/v1/StartingGoaltenders ### Parameters #### Query Parameters - **date** (string) - Required - The date for which to retrieve starting goaltender information (e.g., YYYY-MM-DD). - **season** (integer) - Optional - The season year (e.g., 2021 for the 2021-2022 season). - **seasonType** (integer) - Optional - The type of season (1=Regular Season; 2=Preseason; 3=Postseason; 5=AllStar; 6=Exhibition). ### Request Example ```json { "example": "GET /api/v1/StartingGoaltenders?date=2023-10-24&season=2023" } ``` ### Response #### Success Response (200) - **GameID** (integer) - The unique ID of the game. - **Season** (integer) - The end year of the season. - **SeasonType** (integer) - The type of season. - **Day** (datetime) - The date of the game. - **DateTime** (datetime) - The date and time of the game in US Eastern Time. - **Status** (string) - The game's status. - **HomeTeamID** (integer) - The unique ID of the home team. - **HomeTeam** (string) - The abbreviation of the home team. - **AwayTeamID** (integer) - The unique ID of the away team. - **AwayTeam** (string) - The abbreviation of the away team. - **HomeGoaltender** (object) - Information about the home goaltender. - **PlayerID** (integer) - **TeamID** (integer) - **Team** (string) - **FirstName** (string) - **LastName** (string) - **JerseyNumber** (integer) - **Confirmed** (boolean) - **AwayGoaltender** (object) - Information about the away goaltender. - **PlayerID** (integer) - **TeamID** (integer) - **Team** (string) - **FirstName** (string) - **LastName** (string) - **JerseyNumber** (integer) - **Confirmed** (boolean) #### Response Example ```json { "example": [ { "GameID": 12345, "Season": 2023, "SeasonType": 1, "Day": "2023-10-24T00:00:00", "DateTime": "2023-10-24T19:00:00", "Status": "Scheduled", "HomeTeamID": 1, "HomeTeam": "BOS", "AwayTeamID": 2, "AwayTeam": "TOR", "HomeGoaltender": { "PlayerID": 101, "TeamID": 1, "Team": "BOS", "FirstName": "Linus", "LastName": "Ullmark", "JerseyNumber": 35, "Confirmed": true }, "AwayGoaltender": { "PlayerID": 102, "TeamID": 2, "Team": "TOR", "FirstName": "Ilya", "LastName": "Samsonov", "JerseyNumber": 30, "Confirmed": true } } ] } ``` ``` -------------------------------- ### Get NFL Futures Data Example Source: https://sportsdata.io/developers/workflow-guide/nfl This JSON object represents an example of NFL Futures data, including event details, season information, and associated betting markets. It is used to display futures odds and related information for a given season. ```json { "BettingEventID": 1292, "Name": "NFL Futures 2025-26", "Season": 2025, "BettingEventTypeID": 2, "BettingEventType": "Future", "StartDate": "2026-02-15T00:00:00", "Created": "2024-04-29T08:56:12", "Updated": "2024-04-29T08:56:12", "ScoreID": null, "GlobalScoreID": null, "GameStatus": null, "Quarter": null, "AwayTeam": null, "HomeTeam": null, "AwayTeamID": null, "HomeTeamID": null, "GlobalAwayTeamID": null, "GlobalHomeTeamID": null, "AwayTeamScore": null, "HomeTeamScore": null, "TotalScore": null, "AwayRotationNumber": null, "HomeRotationNumber": null, "GameStartTime": null, "BettingMarkets": [] } ``` -------------------------------- ### GET /SchedulesBasic/{season} Source: https://sportsdata.io/developers/api-documentation/mlb Fetches a basic schedule of games for a specified season, including essential game details. ```APIDOC ## GET /SchedulesBasic/{season} ### Description Returns a full schedule of games for the specified season. Including home and away teams, date, start time, stadium, and game status. ### Method GET ### Endpoint https://api.sportsdata.io/v3/mlb/scores/json/SchedulesBasic/{season} ### Parameters #### Path Parameters - **season** (string) - Required - Year of the season (with optional season type). Examples: `2018`, `2018PRE`, `2018POST`, `2018STAR`, `2019`, etc. #### Query Parameters - **key** (string) - Required - Your unique API key. Subscription required. - **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`. ### Response #### Success Response (200) - **ScheduleBasic[]** - An array of basic schedule objects. #### Response Example ```json [ { "gameID": 12345, "season": "2023", "gameDate": "2023-07-20", "startTime": "18:00:00", "awayTeam": "Team A", "homeTeam": "Team B", "stadium": "Stadium Name", "gameStatus": "Scheduled" } ] ``` ``` -------------------------------- ### GET /v3/nfl/projections/json/UpcomingDfsSlateOwnershipProjections Source: https://sportsdata.io/developers/api-documentation Returns DFS Slates which have not yet started for which we have DFS Ownership projections. ```APIDOC ## GET /v3/nfl/projections/json/UpcomingDfsSlateOwnershipProjections ### Description Returns DFS Slates which have not yet started for which we have DFS Ownership projections. ### Method GET ### Endpoint https://api.sportsdata.io/v3/nfl/projections/json/UpcomingDfsSlateOwnershipProjections ### Parameters #### Query Parameters - **key** (string) - Required - Subscription Key - **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`. ### Request Example ```json { "example": "GET https://api.sportsdata.io/v3/nfl/projections/json/UpcomingDfsSlateOwnershipProjections?key=YOUR_API_KEY&format=JSON" } ``` ### Response #### Success Response (200) - **DfsSlateWithOwnershipProjection[]** (array) - An array of DFS slate objects with ownership projections. #### Response Example ```json { "example": "[ { \"SlateID\": 67890, \"SlateName\": \"Upcoming Slate 1\", \"Players\": [ { \"PlayerID\": 33333, \"Name\": \"Player C\", \"OwnershipPercentage\": 12.0 } ] }, { \"SlateID\": 54321, \"SlateName\": \"Upcoming Slate 2\", \"Players\": [ { \"PlayerID\": 44444, \"Name\": \"Player D\", \"OwnershipPercentage\": 8.5 } ] } ]" } ``` ``` -------------------------------- ### GET /SchedulesBasic/{season} Source: https://sportsdata.io/developers/api-documentation/nba Returns a lightweight schedule of games for the specified season, including essential game details like teams, date, time, and stadium. ```APIDOC ## GET /SchedulesBasic/{season} ### Description Returns a lightweight schedule of games for the specified season. Includes home and away teams, date, start time, stadium, and game status. ### Method GET ### Endpoint https://api.sportsdata.io/v3/nba/scores/json/SchedulesBasic/{season} ### Parameters #### Query Parameters - **key** (string) - Required - Your subscription key. - **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`. #### Path Parameters - **season** (string) - Required - Year of the season (with optional season type). Examples: `2018`, `2018PRE`, `2018POST`, `2018STAR`, `2019`. ### Request Example ```json { "example": "https://api.sportsdata.io/v3/nba/scores/json/SchedulesBasic/2019?key=YOUR_API_KEY&format=JSON" } ``` ### Response #### Success Response (200) - **ScheduleBasic[]** (array) - An array of basic schedule objects. #### Response Example ```json { "example": "[Basic Schedule Objects]" } ``` ``` -------------------------------- ### GET Play By Play [Live & Final] Source: https://sportsdata.io/developers/workflow-guide/nfl Retrieves live play-by-play data for a game, updating in near real-time (15-20 seconds behind broadcast). This data includes individual play details, player stats, and team stats. ```APIDOC ## GET Play By Play [Live & Final] ### Description Retrieves live play-by-play data for a game, updating in near real-time (15-20 seconds behind broadcast). This data includes individual play details, player stats, and team stats. ### Method GET ### Endpoint /PlayByPlay ### Parameters #### Query Parameters - **gameId** (string) - Required - The unique identifier for the game. ### Request Example ```json { "gameId": "example_game_id" } ``` ### Response #### Success Response (200) - **PlayByPlay** (object) - Contains detailed live play-by-play information. - **PlayPlayByPlayPlayStatQuarterScoreScoringPlayStadium** (object) - Contains related statistical and scoring data. #### Response Example ```json { "PlayByPlay": { "gameId": "example_game_id", "plays": [ { "playId": "play_1", "description": "Patrick Mahomes sacked for a loss of 5 yards.", "stats": { "sacks": 1 } } ] }, "PlayPlayByPlayPlayStatQuarterScoreScoringPlayStadium": { "quarter": 3, "score": { "home": 21, "away": 17 } } } ``` ``` -------------------------------- ### GET /betting/markets/bygame Source: https://sportsdata.io/developers/workflow-guide/ncaa-basketball Retrieves all available betting markets and their outcomes for a given game ID. ```APIDOC ## GET /betting/markets/bygame ### Description Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for a given GameID. ### Method GET ### Endpoint `/betting/markets/bygame` ### Parameters #### Query Parameters - **GameID** (string) - Required - The unique identifier for the game. ### Request Example ```json { "example": "GET /betting/markets/bygame?GameID=12345" } ``` ### Response #### Success Response (200) - **BettingMarket[]** (array) - An array of BettingMarket objects. #### Response Example ```json { "example": "[ { \"MarketID\": \"m1\", \"Name\": \"Player X Over Y.5 Rebounds\", \"Outcomes\": [ { \"OutcomeID\": \"o1\", \"Name\": \"Over\", \"Odds\": 1.90 } ] } ]" } ``` ``` -------------------------------- ### GET /games (Basic) - by Week [Live & Final] Source: https://sportsdata.io/developers/coverages/nfl Retrieves live game clock, quarter scores, and total scores for a given week. This endpoint does not include down and distance or other game day information. ```APIDOC ## GET /games (Basic) - by Week [Live & Final] ### Description This endpoint simply delivers the game clock and quarter and total scores live; no down and distance and no gameday info such as weather. This endpoint provides 'Live & Final' data. ### Method GET ### Endpoint /games (Basic) - by Week [Live & Final] ### Parameters #### Query Parameters - **week** (string) - Required - The week for which to retrieve game scores. ### Response #### Success Response (200) - **ScoreBasic[]** (array) - An array of basic score objects with live updates. #### Response Example { "example": "[ScoreBasic Object Array with live data]" } ``` -------------------------------- ### GET Player Season Stats Source: https://sportsdata.io/developers/workflow-guide/ncaa-basketball Returns all season-long stats for all players for a given season. ```APIDOC ## GET Player Season Stats ### Description Returns all season-long stats (i.e. the season total, not each individual game record) for all players for a given season. ### Method GET ### Endpoint /playerseasonstats/season/{season} ### Parameters #### Path Parameters - **season** (string) - Required - The season for which to retrieve player season stats. ### Response #### Success Response (200) - **PlayerSeason[]** (array) - An array of player season data. #### Response Example ```json [ { "example": "PlayerSeason data" } ] ``` ```