openapi: 3.1.0 info: title: MLB MLB v3 Headshots MLB v3 Scores API version: '1.0' description: MLB API - OpenAPI 3.1 Specification servers: - url: https://api.sportsdata.io description: Production server security: - apiKeyHeader: [] - apiKeyQuery: [] tags: - name: MLB v3 Scores paths: /v3/mlb/scores/{format}/teams: get: description: 'Full team information: team name and city, league and division, and colors. Also contains basic fantasy info such as IDs as well as full stadium data. This endpoint returns the teams currently active in the league.' operationId: mlb_v3_scores_team_profiles___by_active summary: Team Profiles - by Active parameters: - name: format in: path description: Desired response format. Valid entries are JSON or XML. required: true schema: type: string enum: - JSON - XML default: JSON responses: '200': description: Success content: application/json: schema: type: array items: $ref: '#/components/schemas/Team' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' tags: - MLB v3 Scores /v3/mlb/scores/{format}/Stadiums: get: description: Returns all stadiums in the league with capacity, surface, latitude/longitude, city and state (and where applicable country.) operationId: mlb_v3_scores_stadiums summary: Stadiums parameters: - name: format in: path description: Desired response format. Valid entries are JSON or XML. required: true schema: type: string enum: - JSON - XML default: JSON responses: '200': description: Success content: application/json: schema: type: array items: $ref: '#/components/schemas/Stadium' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' tags: - MLB v3 Scores /v3/mlb/scores/{format}/Games/{season}: get: description: Home and away teams, date and time, season type and week etc. are included. Also includes gameday information. This includes full stadium information (capacity, lat/long, surface etc.), top-line betting information (spread, moneyline, total), weather conditions, and broadcast information. operationId: mlb_v3_scores_schedules summary: Schedules parameters: - name: format in: path description: Desired response format. Valid entries are JSON or XML. required: true schema: type: string enum: - JSON - XML default: JSON - name: season in: path description: 'Year of the season (with optional season type).
Examples: 2018, 2018PRE, 2018POST, 2018STAR, 2019, etc.' required: true schema: type: string responses: '200': description: Success content: application/json: schema: type: array items: $ref: '#/components/schemas/Game' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' tags: - MLB v3 Scores /v3/mlb/scores/{format}/GamesByDate/{date}: get: description: Full scores and gameday info delivered live and post-game. Live data includes innings, scores, pitch count etc. Gameday info includes referee, weather, TV channel etc. operationId: mlb_v3_scores_games___by_date__live___final summary: Games - by Date [Live & Final] parameters: - name: format in: path description: Desired response format. Valid entries are JSON or XML. required: true schema: type: string enum: - JSON - XML default: JSON - name: date in: path description: 'The date of the game(s).
Examples: 2017-JUL-31, 2017-SEP-01.' required: true schema: type: string responses: '200': description: Success content: application/json: schema: type: array items: $ref: '#/components/schemas/Game' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' tags: - MLB v3 Scores /v3/mlb/scores/{format}/Players: get: description: Full player bio and details, including injury notes, for all active players. operationId: mlb_v3_scores_player_details___by_active summary: Player Details - by Active parameters: - name: format in: path description: Desired response format. Valid entries are JSON or XML. required: true schema: type: string enum: - JSON - XML default: JSON responses: '200': description: Success content: application/json: schema: type: array items: $ref: '#/components/schemas/Player' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' tags: - MLB v3 Scores /v3/mlb/scores/{format}/FreeAgents: get: description: Full player bio and details, including injury notes, for all available free agents unattached to a team. operationId: mlb_v3_scores_player_details___by_free_agents summary: Player Details - by Free Agents parameters: - name: format in: path description: Desired response format. Valid entries are JSON or XML. required: true schema: type: string enum: - JSON - XML default: JSON responses: '200': description: Success content: application/json: schema: type: array items: $ref: '#/components/schemas/Player' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' tags: - MLB v3 Scores /v3/mlb/scores/{format}/Players/{team}: get: description: Full player bio and details, including injury notes, for all available players by team. operationId: mlb_v3_scores_players_details___by_team summary: Players Details - by Team parameters: - name: format in: path description: Desired response format. Valid entries are JSON or XML. required: true schema: type: string enum: - JSON - XML default: JSON - name: team in: path description: 'The abbreviation of the requested team.
Examples: SF, NYY.' required: true schema: type: string responses: '200': description: Success content: application/json: schema: type: array items: $ref: '#/components/schemas/Player' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' tags: - MLB v3 Scores /v3/mlb/scores/{format}/TeamGameStatsByDate/{date}: get: description: Returns the box score statistical record team-wide (aggregated from all players) for a given team's game in a given week, both live and post-game. operationId: mlb_v3_scores_team_game_stats___by_date__live___final summary: Team Game Stats - by Date [Live & Final] parameters: - name: format in: path description: Desired response format. Valid entries are JSON or XML. required: true schema: type: string enum: - JSON - XML default: JSON - name: date in: path description: 'The date of the game(s).
Examples: 2017-JUL-31, 2017-SEP-01.' required: true schema: type: string responses: '200': description: Success content: application/json: schema: type: array items: $ref: '#/components/schemas/TeamGame' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' tags: - MLB v3 Scores /v3/mlb/scores/{format}/TeamSeasonStats/{season}: get: description: Returns all season-long stats (i.e. the season total, not each individual game record) for all teams (aggregated from all players) for a given season. operationId: mlb_v3_scores_team_season_stats summary: Team Season Stats parameters: - name: format in: path description: Desired response format. Valid entries are JSON or XML. required: true schema: type: string enum: - JSON - XML default: JSON - name: season in: path description: 'Year of the season.
Examples: 2017, 2018.' required: true schema: type: string responses: '200': description: Success content: application/json: schema: type: array items: $ref: '#/components/schemas/TeamSeason' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' tags: - MLB v3 Scores /v3/mlb/scores/{format}/NewsByDate/{date}: get: description: Basic RotoBaller news feed, with limited stories available - usually 0-1 stories per day. Ideal for test purposes. operationId: mlb_v3_scores_news___by_date summary: News - by Date parameters: - name: format in: path description: Desired response format. Valid entries are JSON or XML. required: true schema: type: string enum: - JSON - XML default: JSON - name: date in: path description: 'The date of the news.
Examples: 2017-JUL-31, 2017-SEP-01.' required: true schema: type: string responses: '200': description: Success content: application/json: schema: type: array items: $ref: '#/components/schemas/News' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' tags: - MLB v3 Scores /v3/mlb/scores/{format}/News: get: description: Basic RotoBaller news feed, with limited stories available - usually 0-1 stories per day. Ideal for test purposes. operationId: mlb_v3_scores_news summary: News parameters: - name: format in: path description: Desired response format. Valid entries are JSON or XML. required: true schema: type: string enum: - JSON - XML default: JSON responses: '200': description: Success content: application/json: schema: type: array items: $ref: '#/components/schemas/News' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' tags: - MLB v3 Scores /v3/mlb/scores/{format}/NewsByPlayerID/{playerid}: get: description: Basic RotoBaller news feed, with limited stories available - usually 0-1 stories per day. Ideal for test purposes. operationId: mlb_v3_scores_news___by_player summary: News - by Player parameters: - name: format in: path description: Desired response format. Valid entries are JSON or XML. required: true schema: type: string enum: - JSON - XML default: JSON - name: playerid in: path description: 'Unique FantasyData Player ID. Example:10000507.' required: true schema: type: string responses: '200': description: Success content: application/json: schema: type: array items: $ref: '#/components/schemas/News' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' tags: - MLB v3 Scores /v3/mlb/scores/{format}/AreAnyGamesInProgress: get: description: Returns true if there is at least one game being played at the time of the request or false if there are none. operationId: mlb_v3_scores_are_games_in_progress summary: Are Games In Progress parameters: - name: format in: path description: Desired response format. Valid entries are JSON or XML. required: true schema: type: string enum: - JSON - XML default: JSON responses: '200': description: Success content: application/json: schema: type: boolean '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' tags: - MLB v3 Scores /v3/mlb/scores/{format}/CurrentSeason: get: 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. operationId: mlb_v3_scores_season___current summary: Season - Current parameters: - name: format in: path description: Desired response format. Valid entries are JSON or XML. required: true schema: type: string enum: - JSON - XML default: JSON responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/Season' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' tags: - MLB v3 Scores /v3/mlb/scores/{format}/Standings/{season}: get: description: Includes regular season standings in division and league, from which postseason seeding can be derived. operationId: mlb_v3_scores_standings summary: Standings parameters: - name: format in: path description: Desired response format. Valid entries are JSON or XML. required: true schema: type: string enum: - JSON - XML default: JSON - name: season in: path description: 'Year of the season.
Examples: 2017, 2018.' required: true schema: type: string responses: '200': description: Success content: application/json: schema: type: array items: $ref: '#/components/schemas/Standing' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' tags: - MLB v3 Scores /v3/mlb/scores/{format}/AllTeams: get: description: 'Full team information: team name and city, league and division, and colors. Also contains basic fantasy info such as IDs as well as full stadium data. This endpoint returns all teams regardless of current active status.' operationId: mlb_v3_scores_team_profiles___all summary: Team Profiles - All parameters: - name: format in: path description: Desired response format. Valid entries are JSON or XML. required: true schema: type: string enum: - JSON - XML default: JSON responses: '200': description: Success content: application/json: schema: type: array items: $ref: '#/components/schemas/Team' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' tags: - MLB v3 Scores /v3/mlb/scores/{format}/TeamGameStatsBySeason/{season}/{teamid}/{numberofgames}: get: description: Game by game log of total team statistics. operationId: mlb_v3_scores_team_game_logs___by_season summary: Team Game Logs - by Season parameters: - name: format in: path description: Desired response format. Valid entries are JSON or XML. required: true schema: type: string enum: - JSON - XML default: JSON - name: season in: path description: Season to get games from. Example 2019POST, 2020 required: true schema: type: string - name: teamid in: path description: Unique ID of team. Example 12 required: true schema: type: string - name: numberofgames in: path description: How many games to return. Example all, 10, 25 required: true schema: type: string responses: '200': description: Success content: application/json: schema: type: array items: $ref: '#/components/schemas/TeamGame' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' tags: - MLB v3 Scores /v3/mlb/scores/{format}/SchedulesBasic/{season}: get: description: A lightweight schedule endpoint without gameday information. Home and away teams, the date and time of the game, and season type, week etc. are included. Ideal for the most basic information required to build a schedule. operationId: mlb_v3_scores_schedules__basic summary: Schedules (Basic) parameters: - name: format in: path description: Desired response format. Valid entries are JSON or XML. required: true schema: type: string enum: - JSON - XML default: JSON - name: season in: path description: 'Year of the season (with optional season type).
Examples: 2018, 2018PRE, 2018POST, 2018STAR, 2019, etc.' required: true schema: type: string responses: '200': description: Success content: application/json: schema: type: array items: $ref: '#/components/schemas/ScheduleBasic' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' tags: - MLB v3 Scores /v3/mlb/scores/{format}/PlayersBasic/{team}: get: description: A more stripped-down list of players on a given team, for simple applications. operationId: mlb_v3_scores_player_profiles___by_team summary: Player Profiles - by Team parameters: - name: format in: path description: Desired response format. Valid entries are JSON or XML. required: true schema: type: string enum: - JSON - XML default: JSON - name: team in: path description: 'The abbreviation of the requested team.
Examples: SF, NYY.' required: true schema: type: string responses: '200': description: Success content: application/json: schema: type: array items: $ref: '#/components/schemas/PlayerBasic' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' tags: - MLB v3 Scores /v3/mlb/scores/{format}/ScoresBasic/{date}: get: description: This endpoint simply delivers the innings count and total score live; no down and distance and no gameday info such as weather. operationId: mlb_v3_scores_games__basic____by_date__live___final summary: Games (Basic) - by Date [Live & Final] parameters: - name: format in: path description: Desired response format. Valid entries are JSON or XML. required: true schema: type: string enum: - JSON - XML default: JSON - name: date in: path description: 'The date of the game(s).
Examples: 2017-JUL-31, 2017-SEP-01.' required: true schema: type: string responses: '200': description: Success content: application/json: schema: type: array items: $ref: '#/components/schemas/ScoreBasic' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' tags: - MLB v3 Scores /v3/mlb/scores/{format}/PlayersByActive: get: description: A more stripped-down list of players on a given team, for simple applications, including all active players. operationId: mlb_v3_scores_player_profiles___by_active summary: Player Profiles - by Active parameters: - name: format in: path description: Desired response format. Valid entries are JSON or XML. required: true schema: type: string enum: - JSON - XML default: JSON responses: '200': description: Success content: application/json: schema: type: array items: $ref: '#/components/schemas/PlayerBasic' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' tags: - MLB v3 Scores /v3/mlb/scores/{format}/PlayersByFreeAgents: get: description: A more stripped-down list of players on a given team, for simple applications, sorted by free agents. operationId: mlb_v3_scores_player_profiles___by_free_agents summary: Player Profiles - by Free Agents parameters: - name: format in: path description: Desired response format. Valid entries are JSON or XML. required: true schema: type: string enum: - JSON - XML default: JSON responses: '200': description: Success content: application/json: schema: type: array items: $ref: '#/components/schemas/PlayerBasic' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' tags: - MLB v3 Scores /v3/mlb/scores/{format}/ScoresBasicFinal/{date}: get: description: A slimmed-down score endpoint, giving just the innings scores and final score, for simple applications. Delivered after the game ends. operationId: mlb_v3_scores_games__basic____by_date__final summary: Games (Basic) - by Date [Final] parameters: - name: format in: path description: Desired response format. Valid entries are JSON or XML. required: true schema: type: string enum: - JSON - XML default: JSON - name: date in: path description: 'The date of the game(s).
Examples: 2017-JUL-31, 2017-SEP-01.' required: true schema: type: string responses: '200': description: Success content: application/json: schema: type: array items: $ref: '#/components/schemas/ScoreBasic' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' tags: - MLB v3 Scores /v3/mlb/scores/{format}/GamesByDateFinal/{date}: get: description: Full scores and gameday info, including weather, referee, infotainment odds, as well as all of the innings scores and full-time score, delivered as the game ends. operationId: mlb_v3_scores_games___by_date__final summary: Games - by Date [Final] parameters: - name: format in: path description: Desired response format. Valid entries are JSON or XML. required: true schema: type: string enum: - JSON - XML default: JSON - name: date in: path description: 'The date of the game(s).
Examples: 2017-JUL-31, 2017-SEP-01.' required: true schema: type: string responses: '200': description: Success content: application/json: schema: type: array items: $ref: '#/components/schemas/Game' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' tags: - MLB v3 Scores /v3/mlb/scores/{format}/TeamGameStatsByDateFinal/{date}: get: description: Returns the box score statistical record team-wide (aggregated from all players) for all games on a given date after the game has concluded. operationId: mlb_v3_scores_team_game_stats___by_date__final summary: Team Game Stats - by Date [Final] parameters: - name: format in: path description: Desired response format. Valid entries are JSON or XML. required: true schema: type: string enum: - JSON - XML default: JSON - name: date in: path description: 'The date of the game(s).
Examples: 2017-JUL-31, 2017-SEP-01.' required: true schema: type: string responses: '200': description: Success content: application/json: schema: type: array items: $ref: '#/components/schemas/TeamGame' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' tags: - MLB v3 Scores /v3/mlb/scores/{format}/teams/{season}: get: description: List of teams playing in a specified season, with their profile info. operationId: mlb_v3_scores_team_profiles___by_season summary: Team Profiles - by Season parameters: - name: format in: path description: Desired response format. Valid entries are JSON or XML. required: true schema: type: string enum: - JSON - XML default: JSON - name: season in: path description: "\n Year of the season and the season type. If no season type is provided, then the default is regular season.\n
Examples: 2015REG, 2015PRE, 2015POST." required: true schema: type: string responses: '200': description: Success content: application/json: schema: type: array items: $ref: '#/components/schemas/Team' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' tags: - MLB v3 Scores /v3/mlb/scores/{format}/TransactionsByDate/{date}: get: description: A list of transactions, such as assignments, placement on the injury list, player trades etc., delivered by date. operationId: mlb_v3_scores_transactions summary: Transactions parameters: - name: format in: path description: Desired response format. Valid entries are JSON or XML. required: true schema: type: string enum: - JSON - XML default: JSON - name: date in: path description: 'The date of the news.
Examples: 2015-JUL-31, 2015-SEP-01.' required: true schema: type: string responses: '200': description: Success content: application/json: schema: type: array items: $ref: '#/components/schemas/Transaction' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' tags: - MLB v3 Scores components: schemas: PlayerBasic: properties: PlayerID: type: integer description: 'The player''s unique PlayerID as assigned by SportsDataIO. Note: this ID will stay with the player throughout their MLB career' SportsDataID: type: - string - 'null' description: Deprecated. Use SportRadarPlayerID instead. Status: type: - string - 'null' description: 'Indicates the player''s status of being on an Major League Active Roster. Possible values include: Active, 40 Man Active, Non-Roster Invitee, Minors, Inactive, 7 Day Injury List, 10 Day Injury List, 15 Day Injury List, 60 Day Injury List, Restricted List, Paternity List, Bereavement List, Military List' TeamID: type: - integer - 'null' description: The team's unique TeamID as assigned by SportsDataIO Team: type: - string - 'null' description: The abbreviation [Key] of the team Jersey: type: - integer - 'null' description: The player's jersey number PositionCategory: type: - string - 'null' description: 'The player''s position category. Possible values: DH, IF, OF, P, PH, PR' Position: type: - string - 'null' description: 'The player''s position associated with the given game or season. Possible values: 1B; 2B; 3B; C; CF; DH; IF; LF; OF; P; PH; PR; RF; RP; SP; SS' FirstName: type: - string - 'null' description: The player's first name LastName: type: - string - 'null' description: The player's last name BirthDate: type: - string - 'null' description: The player's date of birth BirthCity: type: - string - 'null' description: The city in which the player was born BirthState: type: - string - 'null' description: 'The state in which the player was born. Note: State will be NULL for all countries outside of North America and Australia' BirthCountry: type: - string - 'null' description: The country in which the player was born GlobalTeamID: type: - integer - 'null' description: A globally unique ID for this team. This value is guaranteed to be unique across all sports/leagues BatHand: type: - string - 'null' description: 'The player''s batting hand. Possible values: R, L, S' ThrowHand: type: - string - 'null' description: 'The player''s throwing hand. Possible values: R, L, S' Height: type: - integer - 'null' description: The player's height in inches Weight: type: - integer - 'null' description: The weight of the player in pounds (lbs.) Inning: properties: InningID: type: integer description: The unique ID of this specific inning GameID: type: integer description: The unique ID of the game tied to this Inning InningNumber: type: integer description: The current inning number of the game AwayTeamRuns: type: - integer - 'null' description: Number of runs scored by the away team in the specific inning HomeTeamRuns: type: - integer - 'null' description: Number of runs scored by the home team in the specific inning Team: properties: TeamID: type: integer description: The team's unique TeamID as assigned by SportsDataIO Key: type: - string - 'null' description: Abbreviation of the team (e.g. LAD, PHI, BOS, CHC, etc.) Active: type: boolean description: Whether or not this team is active City: type: - string - 'null' description: The city/location of the team (e.g. Los Angeles, Philadelphia, Boston, Chicago, etc.) Name: type: - string - 'null' description: The mascot of the team (e.g. Dodgers, Phillies, Red Sox, Cubs, etc.) StadiumID: type: - integer - 'null' description: The unique ID of the team's current home stadium League: type: - string - 'null' description: 'The league of the team (possible values: AL, NL)' Division: type: - string - 'null' description: The division of the team (e.g. East; Central; West) PrimaryColor: type: - string - 'null' description: The team's primary color. (This is not licensed for public or commercial use) SecondaryColor: type: - string - 'null' description: The team's secondary color. (This is not licensed for public or commercial use) TertiaryColor: type: - string - 'null' description: The team's tertiary color. (This is not licensed for public or commercial use) QuaternaryColor: type: - string - 'null' description: The team's quaternary color. (This is not licensed for public or commercial use) WikipediaLogoUrl: type: - string - 'null' description: The link to the team's logo hosted on Wikipedia. (This is not licensed for public or commercial use) WikipediaWordMarkUrl: type: - string - 'null' description: The link to the team's wordmark logo hosted on Wikipedia. (This is not licensed for public or commercial use) GlobalTeamID: type: integer description: A globally unique ID for this team. This value is guaranteed to be unique across all sports/leagues HeadCoach: type: - string - 'null' description: The current head coach (manager) of the team HittingCoach: type: - string - 'null' description: 'The current hitting coach of the team. Note: some teams may have multiple or no hitting coaches' PitchingCoach: type: - string - 'null' description: 'The current pitching coach of the team. Note: some teams may have multiple or no pitching coaches' News: properties: NewsID: type: integer description: The unique ID assigned to this news story Source: type: - string - 'null' description: The source of the story (RotoBaller, NBCSports.com, etc.) Updated: type: - string - 'null' description: The timestamp of when this news story was published TimeAgo: type: - string - 'null' description: A description of how long ago this content was published Title: type: - string - 'null' description: The brief title of the news story (typically less than 100 characters) Content: type: - string - 'null' description: The entirety of the content of the news story Url: type: - string - 'null' description: The website URL of the full news story TermsOfUse: type: - string - 'null' description: The terms of use with using this news item, credit must be given to the originator of the story when specified in the terms of use Author: type: - string - 'null' description: The author of the content Categories: type: - string - 'null' description: 'Comma delimited meta tags describing the categories of this content. Possible tags include: Top Headlines, Breaking News, Injury, Sit/Start, Waiver Wire, Risers, Fallers, Lineups, Transactions, Free Agents, Prospects/Rookies, Game Recap, Matchup Outlook' PlayerID: type: - integer - 'null' description: 'The player''s unique PlayerID as assigned by SportsDataIO. Note: this ID will stay with the player throughout their MLB career' TeamID: type: - integer - 'null' description: The team's unique TeamID as assigned by SportsDataIO Team: type: - string - 'null' description: The abbreviation [Key] of the team that relates to this story PlayerID2: type: - integer - 'null' description: The PlayerID of the player who relates to this story TeamID2: type: - integer - 'null' description: The TeamID of the second team that relates to this story Team2: type: - string - 'null' description: The abbreviation [Key] of the second team that relates to this story OriginalSource: type: - string - 'null' description: The original source who broke this news (before it was picked up by the publisher of this story) OriginalSourceUrl: type: - string - 'null' description: The URL of the original source who broke this news story ScoreBasic: properties: AwayTeamRuns: type: - integer - 'null' description: Number of runs scored by the away team in the game HomeTeamRuns: type: - integer - 'null' description: Number of runs scored by the home team in the game AwayTeamHits: type: - integer - 'null' description: Total hits by the away team in the game HomeTeamHits: type: - integer - 'null' description: Total hits by the home team in the game AwayTeamErrors: type: - integer - 'null' description: Total errors committed by the away team in the game HomeTeamErrors: type: - integer - 'null' description: Total errors committed by the home team in the game Attendance: type: - integer - 'null' description: Total number of people who attended the game GlobalGameID: type: integer description: A globally unique ID for this game. This value is guaranteed to be unique across all sports/leagues. GlobalAwayTeamID: type: integer description: A globally unique ID for the away team. This value is guaranteed to be unique across all sports/leagues. GlobalHomeTeamID: type: integer description: A globally unique ID for the home team. This value is guaranteed to be unique across all sports/leagues. NeutralVenue: type: - boolean - 'null' description: Indicates whether this game is played in a neutral venue Inning: type: - integer - 'null' description: 'The inning that the game is currently in, or the inning in which the game ended. Possible values include: NULL, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, etc)' InningHalf: type: - string - 'null' description: 'The inning half that the game is currently in; or the inning half in which the game ended (possible values: T; B; E: M: NULL)' GameID: type: - integer - 'null' description: The unique ID of this game Season: type: integer description: The MLB season of the game SeasonType: type: integer description: The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar) Status: type: - string - 'null' description: 'Indicates the game''s status. Possible values include: Scheduled, InProgress, Final, Suspended, Delayed, Postponed, Canceled, Forfeit, NotNecessary' Day: type: - string - 'null' description: The date of the game DateTime: type: - string - 'null' description: The date and time of the game in US Eastern Time AwayTeam: type: - string - 'null' description: The abbreviation [Key] of the away team HomeTeam: type: - string - 'null' description: The abbreviation [Key] of the Home Team AwayTeamID: type: - integer - 'null' description: The unique TeamID of the away team HomeTeamID: type: - integer - 'null' description: The unique ID of the home team RescheduledGameID: type: - integer - 'null' description: The GameID of the game that was rescheduled from this game. This only pertains to postponed games that require rescheduling. StadiumID: type: - integer - 'null' description: The unique ID of the stadium IsClosed: type: boolean description: 'Indicates whether the game is over and the final score has been verified and closed out. Note: it is recommend for bet resulting to use IsClosed = True rather than simply Final game status.' Updated: type: - string - 'null' description: The date and time of the late update made to this record (in US Eastern Time) GameEndDateTime: type: - string - 'null' description: The date and time that the game ended in US Eastern Time DateTimeUTC: type: - string - 'null' description: The date and time of the game in UTC SeriesInfo: $ref: '#/components/schemas/Series' description: Contains relevant series data for postseason series only - HomeTeamWins; AwayTeamWins; GameNumber; and MaxLength RescheduledFromGameID: type: - integer - 'null' description: The GameID of the originally scheduled, postponed game, that this game was rescheduled from. This only pertains to games that are scheduled as "make up" games. SuspensionResumeDay: type: - string - 'null' description: The date a game that was suspended in play will be resumed for play. Useful for tracking when a Suspended game will return to an InProgress status. SuspensionResumeDateTime: type: - string - 'null' description: The date and start-time that the suspended in play game will be resumed for play. Useful for tracking when a Suspended game will return to an InProgress status. ScheduleBasic: properties: GameID: type: - integer - 'null' description: The unique ID of this game Season: type: integer description: The MLB season of the game SeasonType: type: integer description: The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar) Status: type: - string - 'null' description: 'Indicates the game''s status. Possible values include: Scheduled, InProgress, Final, Suspended, Delayed, Postponed, Canceled, Forfeit, NotNecessary' Day: type: - string - 'null' description: The date of the game DateTime: type: - string - 'null' description: The date and time of the game in US Eastern Time AwayTeam: type: - string - 'null' description: The abbreviation [Key] of the away team HomeTeam: type: - string - 'null' description: The abbreviation [Key] of the Home Team AwayTeamID: type: - integer - 'null' description: The unique TeamID of the away team HomeTeamID: type: - integer - 'null' description: The unique ID of the home team RescheduledGameID: type: - integer - 'null' description: The GameID of the game that was rescheduled from this game. This only pertains to postponed games that require rescheduling. StadiumID: type: - integer - 'null' description: The unique ID of the stadium IsClosed: type: boolean description: 'Indicates whether the game is over and the final score has been verified and closed out. Note: it is recommend for bet resulting to use IsClosed = True rather than simply Final game status.' Updated: type: - string - 'null' description: The date and time of the late update made to this record (in US Eastern Time) GameEndDateTime: type: - string - 'null' description: The date and time that the game ended in US Eastern Time DateTimeUTC: type: - string - 'null' description: The date and time of the game in UTC SeriesInfo: $ref: '#/components/schemas/Series' description: Contains relevant series data for postseason series only - HomeTeamWins; AwayTeamWins; GameNumber; and MaxLength RescheduledFromGameID: type: - integer - 'null' description: The GameID of the originally scheduled, postponed game, that this game was rescheduled from. This only pertains to games that are scheduled as "make up" games. SuspensionResumeDay: type: - string - 'null' description: The date a game that was suspended in play will be resumed for play. Useful for tracking when a Suspended game will return to an InProgress status. SuspensionResumeDateTime: type: - string - 'null' description: The date and start-time that the suspended in play game will be resumed for play. Useful for tracking when a Suspended game will return to an InProgress status. Standing: properties: Season: type: integer description: The MLB season for which these totals apply SeasonType: type: integer description: The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar) TeamID: type: integer description: The team's unique TeamID as assigned by SportsDataIO Key: type: - string - 'null' description: Abbreviation of the team (e.g. LAD; PHI; BOS; CHC; etc.) City: type: - string - 'null' description: The city/location of the team (e.g. Los Angeles; Philadelphia; Boston; Chicago; etc.) Name: type: - string - 'null' description: Team's full name (city and mascot) League: type: - string - 'null' description: 'The league of the team (possible values: AL; NL)' Division: type: - string - 'null' description: The division of the team (e.g. East, Central, West) Wins: type: - integer - 'null' description: The total number of wins by a team in the season Losses: type: - integer - 'null' description: Total number of losses by the team in the season Percentage: type: - number - 'null' description: Winning percentage of a team DivisionWins: type: - integer - 'null' description: Total number of division wins in the season DivisionLosses: type: - integer - 'null' description: Total number of division losses in a season GamesBehind: type: - number - 'null' description: Number of games behind the first place team LastTenGamesWins: type: - integer - 'null' description: Total number of wins in the last ten games LastTenGamesLosses: type: - integer - 'null' description: Total number of losses in the last ten games Streak: type: - string - 'null' description: Current streak the team is on (e.g. Win 3, Lost 3) LeagueRank: type: - integer - 'null' description: The ranking in the league DivisionRank: type: - integer - 'null' description: The ranking in the division (e.g. 1, 2, 3, 4, 5) WildCardRank: type: - integer - 'null' description: The rank of the team in terms of Wild Card standings only WildCardGamesBehind: type: - number - 'null' description: The number of games behind a team is of the final Wild Card spot HomeWins: type: - integer - 'null' description: Total number of home wins in the season HomeLosses: type: - integer - 'null' description: Total number of home losses in the season AwayWins: type: - integer - 'null' description: Total number of away wins in the season AwayLosses: type: - integer - 'null' description: Total number of away losses in the season DayWins: type: - integer - 'null' description: Total number of wins in daytime games DayLosses: type: - integer - 'null' description: Total number of losses in daytime games NightWins: type: - integer - 'null' description: Total number of wins in nighttime games NightLosses: type: - integer - 'null' description: Total number of losses in nighttime games RunsScored: type: - integer - 'null' description: Total runs scored by the team in the season RunsAgainst: type: - integer - 'null' description: Total number of runs scored by the opponents of a specified team GlobalTeamID: type: - integer - 'null' description: A globally unique ID for this team. This value is guaranteed to be unique across all sports/leagues. ClinchedBestLeagueRecord: type: - boolean - 'null' description: Returns TRUE if team has clinched the best record in their respective league; FALSE if not ClinchedWildCard: type: - boolean - 'null' description: Returns TRUE if team has clinched Wild Card spot; FALSE if not ClinchedDivision: type: - boolean - 'null' description: Returns TRUE if team has clinched their division; FALSE if not EliminatedFromPlayoffContention: type: - boolean - 'null' description: Returns TRUE if team has been eliminated from playoff contention; FALSE if not Game: properties: GameID: type: integer description: The unique ID of this game Season: type: integer description: The MLB season of the game SeasonType: type: integer description: The type of season stage the game belongs to, e.g. Regular season, Post-season. For a description of possible values and how they work, see here. Status: type: - string - 'null' description: The status of the game. For a description of possible values, see here. For how suspended and postponed games are handled specifically, see here. Day: type: - string - 'null' description: The date of the game DateTime: type: - string - 'null' description: The date and time of the game (in US Eastern Time) AwayTeam: type: - string - 'null' description: The abbreviation [Key] of the away team HomeTeam: type: - string - 'null' description: The abbreviation [Key] of the home team AwayTeamID: type: integer description: The unique TeamID of the away team HomeTeamID: type: integer description: The unique ID of the home team RescheduledGameID: type: - integer - 'null' description: The GameID of the game that was rescheduled from this game. This only pertains to postponed games that require rescheduling. StadiumID: type: - integer - 'null' description: The unique ID of the stadium Channel: type: - string - 'null' description: The television station broadcasting the game Inning: type: - integer - 'null' description: 'The inning that the game is currently in, or the inning in which the game ended. Possible values include: NULL, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, etc)' InningHalf: type: - string - 'null' description: 'The inning half that the game is currently in; or the inning half in which the game ended (possible values: T; B; E: M: NULL)' AwayTeamRuns: type: - integer - 'null' description: Number of runs scored by the away team in the game HomeTeamRuns: type: - integer - 'null' description: Number of runs scored by the home team in the game AwayTeamHits: type: - integer - 'null' description: Total hits by the away team in the game HomeTeamHits: type: - integer - 'null' description: Total hits by the home team in the game AwayTeamErrors: type: - integer - 'null' description: Total errors committed by the away team in the game HomeTeamErrors: type: - integer - 'null' description: Total errors committed by the home team in the game WinningPitcherID: type: - integer - 'null' description: The PlayerID of the pitcher who recorded the win in the game LosingPitcherID: type: - integer - 'null' description: The PlayerID of the losing pitcher in the game SavingPitcherID: type: - integer - 'null' description: The PlayerID of the pitcher who recorded the save in the game Attendance: type: - integer - 'null' description: Total number of people who attended the game AwayTeamProbablePitcherID: type: - integer - 'null' description: The PlayerID of the away team's probable pitcher HomeTeamProbablePitcherID: type: - integer - 'null' description: The PlayerID of the home team's probable pitcher Outs: type: - integer - 'null' description: The number of outs recorded in the current inning of the game Balls: type: - integer - 'null' description: The number of balls thrown for the current at bat Strikes: type: - integer - 'null' description: The number of strikes thrown for the current at bat CurrentPitcherID: type: - integer - 'null' description: The PlayerID of the current pitcher CurrentHitterID: type: - integer - 'null' description: The PlayerID of the current hitter AwayTeamStartingPitcherID: type: - integer - 'null' description: The PlayerID of the away team's starting pitcher HomeTeamStartingPitcherID: type: - integer - 'null' description: The PlayerID of the home team starting pitcher in the game CurrentPitchingTeamID: type: - integer - 'null' description: The TeamID of the current pitcher's team CurrentHittingTeamID: type: - integer - 'null' description: The TeamID of the current hitter's team PointSpread: type: - number - 'null' description: 'The consensus Run Line at game start from the perspective of the HomeTeam (in the Game table, the PointSpread field''s negative numbers indicate the HomeTeam is favored; positive numbers indicate the AwayTeam is favored. Note that this rule does not hold in betting-related tables, where the run line is contingent on the bet line). Note: In MLB, Point Spread may also be referred to as Run Line' OverUnder: type: - number - 'null' description: The oddsmaker total points line at game start AwayTeamMoneyLine: type: - integer - 'null' description: Moneyline from the perspective of the away team HomeTeamMoneyLine: type: - integer - 'null' description: Moneyline from the perspective of the home team ForecastTempLow: type: - integer - 'null' description: The forecasted low temperature on game day at this venue (in Fahrenheit) ForecastTempHigh: type: - integer - 'null' description: The forecasted high temperature on game day at this venue (in Fahrenheit) ForecastDescription: type: - string - 'null' description: 'The description of the weather forecast. Posible values include: Broken Clouds, Clear Sky, Few Clouds, Heavy Intensity Rain, Light Rain, Moderate Rain, Mostly Cloudy, Mostly Sunny, Overcast Clouds, Partly Cloudy, Scattered Clouds, Showers, Thunderstorms' ForecastWindChill: type: - integer - 'null' description: The forecasted wind chill on game day at this venue. ForecastWindSpeed: type: - integer - 'null' description: The forecasted wind speed on game day at this venue. ForecastWindDirection: type: - integer - 'null' description: The wind direction isn't baseball specific. It refers to the direction that the wind is coming from. 90 would be wind coming from the east. 180 is wind from the south. 270 is a wind from the west ... and so on. RescheduledFromGameID: type: - integer - 'null' description: The GameID of the originally scheduled, postponed game, that this game was rescheduled from. This only pertains to games that are scheduled as "make up" games. RunnerOnFirst: type: - boolean - 'null' description: Indicates if there is a runner on first base RunnerOnSecond: type: - boolean - 'null' description: Indicates if there is a runner on second base RunnerOnThird: type: - boolean - 'null' description: Indicates if there is a runner on third base AwayTeamStartingPitcher: type: - string - 'null' description: The first and last name of the away team's starting pitcher for the game HomeTeamStartingPitcher: type: - string - 'null' description: The first and last name of the home team starting pitcher for the game CurrentPitcher: type: - string - 'null' description: Indicates the current pitcher's name CurrentHitter: type: - string - 'null' description: Indicates the current hitter's name WinningPitcher: type: - string - 'null' description: The name of the pitcher who recorded the win in the game LosingPitcher: type: - string - 'null' description: The first and last name of the losing pitcher in the game SavingPitcher: type: - string - 'null' description: The name of the pitcher who recorded the save in the game DueUpHitterID1: type: - integer - 'null' description: The PlayerID of the hitter due up first from the current hitter DueUpHitterID2: type: - integer - 'null' description: The PlayerID of the hitter due up second from the current hitter DueUpHitterID3: type: - integer - 'null' description: The PlayerID of the hitter due up third from the current hitter GlobalGameID: type: integer description: A globally unique ID for this game. This value is guaranteed to be unique across all sports/leagues GlobalAwayTeamID: type: integer description: A globally unique ID for the away team. This value is guaranteed to be unique across all sports/leagues GlobalHomeTeamID: type: integer description: A globally unique ID for the home team. This value is guaranteed to be unique across all sports/leagues. PointSpreadAwayTeamMoneyLine: type: - integer - 'null' description: The moneyline payout odds when betting on the away team with the run line PointSpreadHomeTeamMoneyLine: type: - integer - 'null' description: The moneyline payout odds when betting on the home team with the run line LastPlay: type: - string - 'null' description: The description of the most recent play/event of the game. This is for display purposes and does not include corresponding data points. IsClosed: type: boolean description: 'Indicates whether the game is over and the final score has been verified and closed out. Note: it is recommend for bet resulting to use IsClosed = True rather than simply Final game status' Updated: type: - string - 'null' description: The date and time of the late update made to this record (in US Eastern Time) Innings: type: array items: $ref: '#/components/schemas/Inning' description: The inning details associated with the game GameEndDateTime: type: - string - 'null' description: The date and time that the game ended in US Eastern Time HomeRotationNumber: type: - integer - 'null' description: Rotation number of home team for this game AwayRotationNumber: type: - integer - 'null' description: Rotation number of away team for this game NeutralVenue: type: - boolean - 'null' description: 'Indicates whether this game is played in a neutral venue. Note: Neutral = True, not neutral = False' InningDescription: type: - string - 'null' description: 'The current status of the inning for display purposes (possible values: Top 2, Mid 2, Bot 2, End 2, etc)' OverPayout: type: - integer - 'null' description: The sportsbook's payout for the over UnderPayout: type: - integer - 'null' description: The sportsbook's payout for the under SeriesInfo: $ref: '#/components/schemas/Series' description: Contains relevant series data for postseason series only - HomeTeamWins; AwayTeamWins; GameNumber; and MaxLength DateTimeUTC: type: - string - 'null' description: The date and time of the game in UTC HomeTeamOpener: type: - boolean - 'null' description: 'Indicates whether the home team will use an opener as the starting pitcher. NOTE: An opener is a pitcher (typically a relief pitcher) that is only scheduled to pitch the first 1-3 innings of the game' AwayTeamOpener: type: - boolean - 'null' description: 'Indicates whether the away team will use an opener as the starting pitcher.. NOTE: An opener is a pitcher (typically a relief pitcher) that is only scheduled to pitch the first 1-3 innings of the game' SuspensionResumeDay: type: - string - 'null' description: The date a game that was suspended in play will be resumed for play. Useful for tracking when a Suspended game will return to an InProgress status. SuspensionResumeDateTime: type: - string - 'null' description: The date and start-time that the suspended in play game will be resumed for play. Useful for tracking when a Suspended game will return to an InProgress status. Stadium: properties: StadiumID: type: integer description: The unique ID of the stadium Active: type: boolean description: Whether or not this stadium is active Name: type: - string - 'null' description: The full name of the stadium City: type: - string - 'null' description: The city where the stadium is located State: type: - string - 'null' description: The state where the stadium is located (only US and Canadian stadiums will have values) Country: type: - string - 'null' description: The 3-digit country code where the stadium is located Capacity: type: - integer - 'null' description: The estimated seating capacity of the stadium Surface: type: - string - 'null' description: The playing surface of the stadium (Grass, Artificial or Dome) LeftField: type: - integer - 'null' description: The estimated distance between home plate and the left field wall MidLeftField: type: - integer - 'null' description: The estimated distance between home plate and the mid left field wall LeftCenterField: type: - integer - 'null' description: The estimated distance between home plate and the left center field wall MidLeftCenterField: type: - integer - 'null' description: The estimated distance between home plate and the mid left center field wall CenterField: type: - integer - 'null' description: The estimated distance between home plate and the center field wall MidRightCenterField: type: - integer - 'null' description: The estimated distance between home plate and the mid right center field wall RightCenterField: type: - integer - 'null' description: The estimated distance between home plate and the right center field wall MidRightField: type: - integer - 'null' description: The estimated distance between home plate and the mid right field wall RightField: type: - integer - 'null' description: The estimated distance between home plate and the right field wall GeoLat: type: - number - 'null' description: The geographic latitude coordinate of this venue GeoLong: type: - number - 'null' description: The geographic longitude coordinate of this venue Altitude: type: - integer - 'null' description: The altitude of the stadium in feet HomePlateDirection: type: - integer - 'null' description: The direction that the batter is facing while looking at the pitcher's mound. If the home plate is at the north of the stadium, the batter is facing south, so the value is given as 180 degrees. If home plate is at the east the batter faces west, so it's 270 degrees. If the home plate is at the south the batter faces north, so it's 0 degrees. If the home plate is at the west the batter faces east, so it's 90 degrees. Type: type: - string - 'null' description: 'The type of the stadium (possible values: Outdoor, Dome, RetractableDome)' TeamSeason: properties: StatID: type: integer description: The unique ID of the stat TeamID: type: - integer - 'null' description: The team's unique TeamID as assigned by SportsDataIO SeasonType: type: - integer - 'null' description: The type of season that this record corresponds to (1=Regular Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=AllStar) Season: type: - integer - 'null' description: The MLB season for which these totals apply Name: type: - string - 'null' description: Team's full name (city and mascot) Team: type: - string - 'null' description: The abbreviation [Key] of the team GlobalTeamID: type: - integer - 'null' description: A globally unique ID for this team. This value is guaranteed to be unique across all sports/leagues Updated: type: - string - 'null' description: The timestamp of when the record was last updated (US Eastern Time). Games: type: - integer - 'null' description: The number of games played. FantasyPoints: type: - number - 'null' description: Total fantasy points AtBats: type: - number - 'null' description: At bats while hitting Runs: type: - number - 'null' description: Total runs scored. Hits: type: - number - 'null' description: Total hits Singles: type: - number - 'null' description: Total singles Doubles: type: - number - 'null' description: Total doubles Triples: type: - number - 'null' description: Total triples HomeRuns: type: - number - 'null' description: Total home runs RunsBattedIn: type: - number - 'null' description: Total runs batted in BattingAverage: type: - number - 'null' description: Total batting average Outs: type: - number - 'null' description: Total outs Strikeouts: type: - number - 'null' description: Total strikeouts Walks: type: - number - 'null' description: Total walks HitByPitch: type: - number - 'null' description: Total times hit by pitch Sacrifices: type: - number - 'null' description: Total sacrifices SacrificeFlies: type: - number - 'null' description: Total sacrifice flies GroundIntoDoublePlay: type: - number - 'null' description: Total times grounded into double play StolenBases: type: - number - 'null' description: Total stolen bases CaughtStealing: type: - number - 'null' description: Total caught stealing PitchesSeen: type: - number - 'null' description: Total pitches seen OnBasePercentage: type: - number - 'null' description: Total on base percentage SluggingPercentage: type: - number - 'null' description: Total slugging percentage OnBasePlusSlugging: type: - number - 'null' description: Total on base plus percentage  Errors: type: - number - 'null' description: Total errors Wins: type: - number - 'null' description: Total wins by the team/player Losses: type: - number - 'null' description: Total losses by the team/player Saves: type: - number - 'null' description: Total saves by team/player InningsPitchedDecimal: type: - number - 'null' description: Decimal representation of total innings pitched (e.g. 1.33, 7.66, etc) TotalOutsPitched: type: - number - 'null' description: Total outs pitched by team/player InningsPitchedFull: type: - number - 'null' description: Total full innings pitched (e.g. 6, 71, 89, etc) InningsPitchedOuts: type: - number - 'null' description: 'Outs pitched beyond InningsPitchedFull (possible values: 0, 1, 2)' EarnedRunAverage: type: - number - 'null' description: Total earned run average by team/player PitchingHits: type: - number - 'null' description: Hits allowed while pitching PitchingRuns: type: - number - 'null' description: Runs allowed while pitching PitchingEarnedRuns: type: - number - 'null' description: Earned runs allowed while pitching PitchingWalks: type: - number - 'null' description: Walks allowed while pitching PitchingStrikeouts: type: - number - 'null' description: Strikeouts allowed while pitching PitchingHomeRuns: type: - number - 'null' description: Home runs allowed while pitching PitchesThrown: type: - number - 'null' description: Total pitches thrown while pitching PitchesThrownStrikes: type: - number - 'null' description: Total pitches thrown for strikes while pitching WalksHitsPerInningsPitched: type: - number - 'null' description: Walks plus hits per innings pitched (WHIP) while pitching PitchingBattingAverageAgainst: type: - number - 'null' description: Total batting average against (BAA) while pitching GrandSlams: type: - number - 'null' description: Total grand slams FantasyPointsFanDuel: type: - number - 'null' description: Total FanDuel fantasy points FantasyPointsDraftKings: type: - number - 'null' description: Total DraftKings fantasy points FantasyPointsYahoo: type: - number - 'null' description: Total Yahoo fantasy points PlateAppearances: type: - number - 'null' description: Total plate appearances TotalBases: type: - number - 'null' description: Number of total bases FlyOuts: type: - number - 'null' description: Total fly outs GroundOuts: type: - number - 'null' description: Total ground outs LineOuts: type: - number - 'null' description: Total line outs PopOuts: type: - number - 'null' description: Total pop outs IntentionalWalks: type: - number - 'null' description: Total intentional walks ReachedOnError: type: - number - 'null' description: Total times reached on error BallsInPlay: type: - number - 'null' description: Total balls in play BattingAverageOnBallsInPlay: type: - number - 'null' description: Total batting average on balls in play (BABIP) WeightedOnBasePercentage: type: - number - 'null' description: Total weight on base percentage PitchingSingles: type: - number - 'null' description: Total singles allowed while pitching PitchingDoubles: type: - number - 'null' description: Total doubles allowed while pitching PitchingTriples: type: - number - 'null' description: Total triples allowed while pitching PitchingGrandSlams: type: - number - 'null' description: Total grand slams allowed while pitching PitchingHitByPitch: type: - number - 'null' description: Total batters hit by pitch while pitching PitchingSacrifices: type: - number - 'null' description: Total sacrifices while pitching PitchingSacrificeFlies: type: - number - 'null' description: Total sacrifice flies while pitching PitchingGroundIntoDoublePlay: type: - number - 'null' description: Total grounded into double plays while pitching PitchingCompleteGames: type: - number - 'null' description: Total complete games while pitching PitchingShutOuts: type: - number - 'null' description: Total shuouts while pitching PitchingNoHitters: type: - number - 'null' description: Total no hitters while pitching PitchingPerfectGames: type: - number - 'null' description: Total perfect games while pitching PitchingPlateAppearances: type: - number - 'null' description: Total plate appearances while pitching PitchingTotalBases: type: - number - 'null' description: Total bases while pitching PitchingFlyOuts: type: - number - 'null' description: Total fly outs while pitching PitchingGroundOuts: type: - number - 'null' description: Total ground outs while pitching PitchingLineOuts: type: - number - 'null' description: Total line outs while pitching PitchingPopOuts: type: - number - 'null' description: Total pop outs while pitching PitchingIntentionalWalks: type: - number - 'null' description: Total intentional walks while pitching PitchingReachedOnError: type: - number - 'null' description: Total times reached on error while pitching PitchingCatchersInterference: type: - number - 'null' description: Total catchers interference while pitching PitchingBallsInPlay: type: - number - 'null' description: Total balls in play while pitching PitchingOnBasePercentage: type: - number - 'null' description: Total on base percentage (OBP) while pitching PitchingSluggingPercentage: type: - number - 'null' description: Total slugging percentage (SLG) while pitching PitchingOnBasePlusSlugging: type: - number - 'null' description: Total on base plus slugging (OPS) while pitching PitchingStrikeoutsPerNineInnings: type: - number - 'null' description: Total strikeouts per nine innings (K/9) while pitching PitchingWalksPerNineInnings: type: - number - 'null' description: Total walks per nine innings (BB/9) while pitching PitchingBattingAverageOnBallsInPlay: type: - number - 'null' description: Total batting average on balls in play (BABIP) while pitching PitchingWeightedOnBasePercentage: type: - number - 'null' description: Total weighted on base percentage while pitching  DoublePlays: type: - number - 'null' description: 'Total double plays, defined as one of: Bunted into Double Play, Fly into Double Play, Fouled into Double Play, Ground into Double Pla,y Line into Double Play, Popped into Double Play' PitchingDoublePlays: type: - number - 'null' description: Total double plays while pitching BattingOrderConfirmed: type: - boolean - 'null' description: Whether the batting order is confirmed (true/false) IsolatedPower: type: - number - 'null' description: Total isolated power (ISO) FieldingIndependentPitching: type: - number - 'null' description: Total fielding independent pitching (FIP) PitchingQualityStarts: type: - number - 'null' description: Total quality starts pitched PitchingInningStarted: type: - integer - 'null' description: The inning that the pitcher entered the game (if any). LeftOnBase: type: - number - 'null' description: Total left on base percentage  PitchingHolds: type: - number - 'null' description: Total holds pitched PitchingBlownSaves: type: - number - 'null' description: Total blown saves pitched SubstituteBattingOrder: type: - integer - 'null' description: The position in the batting order where this player was substituted into the game (does not include players in the starting lineup) SubstituteBattingOrderSequence: type: - integer - 'null' description: The sequence in which this player was substituted into the game, within the particular batting order FantasyPointsFantasyDraft: type: - number - 'null' description: Total FantasyDraft fantasy points FantasyPointsBatting: type: - number - 'null' description: Total batting fantasy points FantasyPointsPitching: type: - number - 'null' description: Total pitching fantasy points Season: properties: Season: type: integer description: The MLB season for which these totals apply RegularSeasonStartDate: type: - string - 'null' description: The start date of the regular season PostSeasonStartDate: type: - string - 'null' description: The start date of the postseason SeasonType: type: - string - 'null' description: The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar). ApiSeason: type: - string - 'null' description: The string to pass into subsequent API calls in the season parameter (e.g. 2025REG, 2025POST, etc.). Series: properties: HomeTeamWins: type: integer description: 'Number of wins by the home team on in the series. Note: this is for postseason series only.' AwayTeamWins: type: integer description: 'Number of wins by the away team in the series. Note: This is for postseason series only.' GameNumber: type: integer description: 'Game number in series. Note: this applies to postseason series only.' MaxLength: type: integer description: 'Maximum number of games in the series. Note: this is for postseason series only.' Transaction: properties: PlayerID: type: integer description: 'The player''s unique PlayerID as assigned by SportsDataIO. Note: this ID will stay with the player throughout their MLB career.' Name: type: - string - 'null' description: Player's full name FormerTeamID: type: - integer - 'null' description: TeamID of player's former team FormerTeam: type: - string - 'null' description: Player's former team in abbreviated format [Key] (e.g. SD; PHI; LAD; ATL etc.) TeamID: type: - integer - 'null' description: The team's unique TeamID as assigned by SportsDataIO Team: type: - string - 'null' description: The abbreviation [Key] of the team Type: type: - string - 'null' description: Type of Transaction. Released, Waived, Signed, Promoted, Elevated, Demoted, and Traded. Date: type: - string - 'null' description: The date that this transaction took place Note: type: - string - 'null' description: A summary of the transaction (e.g. "Harris has signed with the Diamondbacks.") Created: type: - string - 'null' description: The date and time this transaction was created in US Eastern Time Updated: type: - string - 'null' description: The date and time of the last update made to this transaction (in US Eastern Time) TeamGame: properties: StatID: type: integer description: The unique ID of the stat TeamID: type: - integer - 'null' description: The team's unique TeamID as assigned by SportsDataIO SeasonType: type: - integer - 'null' description: The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar) Season: type: - integer - 'null' description: The MLB season of the game Name: type: - string - 'null' description: Team's full name (city and mascot) Team: type: - string - 'null' description: The abbreviation [Key] of the team GlobalTeamID: type: - integer - 'null' description: A globally unique ID for this team. This value is guaranteed to be unique across all sports/leagues GameID: type: - integer - 'null' description: The unique ID of this game OpponentID: type: - integer - 'null' description: The unique ID of the team's opponent Opponent: type: - string - 'null' description: The name of the opponent  Day: type: - string - 'null' description: The day of the game DateTime: type: - string - 'null' description: The date and time of the game HomeOrAway: type: - string - 'null' description: Whether the team is home or away IsGameOver: type: boolean description: Whether the game is over (true/false) GlobalGameID: type: - integer - 'null' description: A globally unique ID for this game. This value is guaranteed to be unique across all sports/leagues. GlobalOpponentID: type: - integer - 'null' description: A globally unique ID for this opponent. This value is guaranteed to be unique across all sports/leagues. Updated: type: - string - 'null' description: The timestamp of when the record was last updated (US Eastern Time). Games: type: - integer - 'null' description: The number of games played. FantasyPoints: type: - number - 'null' description: Total fantasy points AtBats: type: - number - 'null' description: At bats while hitting Runs: type: - number - 'null' description: Total runs scored. Hits: type: - number - 'null' description: Total hits Singles: type: - number - 'null' description: Total singles Doubles: type: - number - 'null' description: Total doubles Triples: type: - number - 'null' description: Total triples HomeRuns: type: - number - 'null' description: Total home runs RunsBattedIn: type: - number - 'null' description: Total runs batted in BattingAverage: type: - number - 'null' description: Total batting average Outs: type: - number - 'null' description: Total outs Strikeouts: type: - number - 'null' description: Total strikeouts Walks: type: - number - 'null' description: Total walks HitByPitch: type: - number - 'null' description: Total times hit by pitch Sacrifices: type: - number - 'null' description: Total sacrifices SacrificeFlies: type: - number - 'null' description: Total sacrifice flies GroundIntoDoublePlay: type: - number - 'null' description: Total times grounded into double play StolenBases: type: - number - 'null' description: Total stolen bases CaughtStealing: type: - number - 'null' description: Total caught stealing PitchesSeen: type: - number - 'null' description: Total pitches seen OnBasePercentage: type: - number - 'null' description: Total on base percentage SluggingPercentage: type: - number - 'null' description: Total slugging percentage OnBasePlusSlugging: type: - number - 'null' description: Total on base plus percentage  Errors: type: - number - 'null' description: Total errors Wins: type: - number - 'null' description: Total wins by the team/player Losses: type: - number - 'null' description: Total losses by the team/player Saves: type: - number - 'null' description: Total saves by team/player InningsPitchedDecimal: type: - number - 'null' description: Decimal representation of total innings pitched (e.g. 1.33, 7.66, etc) TotalOutsPitched: type: - number - 'null' description: Total outs pitched by team/player InningsPitchedFull: type: - number - 'null' description: Total full innings pitched (e.g. 6, 71, 89, etc) InningsPitchedOuts: type: - number - 'null' description: 'Outs pitched beyond InningsPitchedFull (possible values: 0, 1, 2)' EarnedRunAverage: type: - number - 'null' description: Total earned run average by team/player PitchingHits: type: - number - 'null' description: Hits allowed while pitching PitchingRuns: type: - number - 'null' description: Runs allowed while pitching PitchingEarnedRuns: type: - number - 'null' description: Earned runs allowed while pitching PitchingWalks: type: - number - 'null' description: Walks allowed while pitching PitchingStrikeouts: type: - number - 'null' description: Strikeouts allowed while pitching PitchingHomeRuns: type: - number - 'null' description: Home runs allowed while pitching PitchesThrown: type: - number - 'null' description: Total pitches thrown while pitching PitchesThrownStrikes: type: - number - 'null' description: Total pitches thrown for strikes while pitching WalksHitsPerInningsPitched: type: - number - 'null' description: Walks plus hits per innings pitched (WHIP) while pitching PitchingBattingAverageAgainst: type: - number - 'null' description: Total batting average against (BAA) while pitching GrandSlams: type: - number - 'null' description: Total grand slams FantasyPointsFanDuel: type: - number - 'null' description: Total FanDuel fantasy points FantasyPointsDraftKings: type: - number - 'null' description: Total DraftKings fantasy points FantasyPointsYahoo: type: - number - 'null' description: Total Yahoo fantasy points PlateAppearances: type: - number - 'null' description: Total plate appearances TotalBases: type: - number - 'null' description: Number of total bases FlyOuts: type: - number - 'null' description: Total fly outs GroundOuts: type: - number - 'null' description: Total ground outs LineOuts: type: - number - 'null' description: Total line outs PopOuts: type: - number - 'null' description: Total pop outs IntentionalWalks: type: - number - 'null' description: Total intentional walks ReachedOnError: type: - number - 'null' description: Total times reached on error BallsInPlay: type: - number - 'null' description: Total balls in play BattingAverageOnBallsInPlay: type: - number - 'null' description: Total batting average on balls in play (BABIP) WeightedOnBasePercentage: type: - number - 'null' description: Total weight on base percentage PitchingSingles: type: - number - 'null' description: Total singles allowed while pitching PitchingDoubles: type: - number - 'null' description: Total doubles allowed while pitching PitchingTriples: type: - number - 'null' description: Total triples allowed while pitching PitchingGrandSlams: type: - number - 'null' description: Total grand slams allowed while pitching PitchingHitByPitch: type: - number - 'null' description: Total batters hit by pitch while pitching PitchingSacrifices: type: - number - 'null' description: Total sacrifices while pitching PitchingSacrificeFlies: type: - number - 'null' description: Total sacrifice flies while pitching PitchingGroundIntoDoublePlay: type: - number - 'null' description: Total grounded into double plays while pitching PitchingCompleteGames: type: - number - 'null' description: Total complete games while pitching PitchingShutOuts: type: - number - 'null' description: Total shuouts while pitching PitchingNoHitters: type: - number - 'null' description: Total no hitters while pitching PitchingPerfectGames: type: - number - 'null' description: Total perfect games while pitching PitchingPlateAppearances: type: - number - 'null' description: Total plate appearances while pitching PitchingTotalBases: type: - number - 'null' description: Total bases while pitching PitchingFlyOuts: type: - number - 'null' description: Total fly outs while pitching PitchingGroundOuts: type: - number - 'null' description: Total ground outs while pitching PitchingLineOuts: type: - number - 'null' description: Total line outs while pitching PitchingPopOuts: type: - number - 'null' description: Total pop outs while pitching PitchingIntentionalWalks: type: - number - 'null' description: Total intentional walks while pitching PitchingReachedOnError: type: - number - 'null' description: Total times reached on error while pitching PitchingCatchersInterference: type: - number - 'null' description: Total catchers interference while pitching PitchingBallsInPlay: type: - number - 'null' description: Total balls in play while pitching PitchingOnBasePercentage: type: - number - 'null' description: Total on base percentage (OBP) while pitching PitchingSluggingPercentage: type: - number - 'null' description: Total slugging percentage (SLG) while pitching PitchingOnBasePlusSlugging: type: - number - 'null' description: Total on base plus slugging (OPS) while pitching PitchingStrikeoutsPerNineInnings: type: - number - 'null' description: Total strikeouts per nine innings (K/9) while pitching PitchingWalksPerNineInnings: type: - number - 'null' description: Total walks per nine innings (BB/9) while pitching PitchingBattingAverageOnBallsInPlay: type: - number - 'null' description: Total batting average on balls in play (BABIP) while pitching PitchingWeightedOnBasePercentage: type: - number - 'null' description: Total weighted on base percentage while pitching  DoublePlays: type: - number - 'null' description: 'Total double plays, defined as one of: Bunted into Double Play, Fly into Double Play, Fouled into Double Play, Ground into Double Pla,y Line into Double Play, Popped into Double Play' PitchingDoublePlays: type: - number - 'null' description: Total double plays while pitching BattingOrderConfirmed: type: - boolean - 'null' description: Whether the batting order is confirmed (true/false) IsolatedPower: type: - number - 'null' description: Total isolated power (ISO) FieldingIndependentPitching: type: - number - 'null' description: Total fielding independent pitching (FIP) PitchingQualityStarts: type: - number - 'null' description: Total quality starts pitched PitchingInningStarted: type: - integer - 'null' description: The inning that the pitcher entered the game (if any). LeftOnBase: type: - number - 'null' description: Total left on base percentage  PitchingHolds: type: - number - 'null' description: Total holds pitched PitchingBlownSaves: type: - number - 'null' description: Total blown saves pitched SubstituteBattingOrder: type: - integer - 'null' description: The position in the batting order where this player was substituted into the game (does not include players in the starting lineup) SubstituteBattingOrderSequence: type: - integer - 'null' description: The sequence in which this player was substituted into the game, within the particular batting order FantasyPointsFantasyDraft: type: - number - 'null' description: Total FantasyDraft fantasy points FantasyPointsBatting: type: - number - 'null' description: Total batting fantasy points FantasyPointsPitching: type: - number - 'null' description: Total pitching fantasy points Unauthorized: properties: HttpStatusCode: type: integer Code: type: integer Description: type: string Help: type: string Player: properties: PlayerID: type: integer description: 'The player''s unique PlayerID as assigned by SportsDataIO. Note: this ID will stay with the player throughout their MLB career' SportsDataID: type: - string - 'null' description: Deprecated. Use SportRadarPlayerID instead. Status: type: - string - 'null' description: 'Indicates the player''s status of being on an Major League Active Roster. Possible values include: Active, 40 Man Active, Non-Roster Invitee, Minors, Inactive, 7 Day Injury List, 10 Day Injury List, 15 Day Injury List, 60 Day Injury List, Restricted List, Paternity List, Bereavement List, Military List' TeamID: type: - integer - 'null' description: The team's unique TeamID as assigned by SportsDataIO Team: type: - string - 'null' description: The abbreviation [Key] of the team that the player belongs to Jersey: type: - integer - 'null' description: The player's jersey number. PositionCategory: type: - string - 'null' description: 'The player''s position category. Possible values: DH, IF, OF, P, PH, PR' Position: type: - string - 'null' description: 'The player''s position associated with the given game or season. Possible values: 1B; 2B; 3B; C; CF; DH; IF; LF; OF; P; PH; PR; RF; RP; SP; SS' MLBAMID: type: - integer - 'null' description: The player's unique PlayerID for cross reference use with MLB AM FirstName: type: - string - 'null' description: The player's first name LastName: type: - string - 'null' description: The player's last name BatHand: type: - string - 'null' description: 'The player''s batting hand. Possible values: R, L, S' ThrowHand: type: - string - 'null' description: 'The player''s throwing hand. Possible values: R, L, S' Height: type: - integer - 'null' description: The player's height in inches Weight: type: - integer - 'null' description: The weight of the player in pounds (lbs). BirthDate: type: - string - 'null' description: The player's date of birth BirthCity: type: - string - 'null' description: The city in which the player was born BirthState: type: - string - 'null' description: 'The state in which the player was born. Note: State will be NULL for all countries outside of North America and Australia' BirthCountry: type: - string - 'null' description: The country in which the player was born HighSchool: type: - string - 'null' description: 'The high school that the player attended. Note: If the player attended a college, this field will be NULL' College: type: - string - 'null' description: 'The college that the player attended. Note: If player did not attend college this field will contain "None" and a high school will be added if applicable' ProDebut: type: - string - 'null' description: The date that this player made his MLB debut. Salary: type: - integer - 'null' description: Field is expected to be NULL PhotoUrl: type: - string - 'null' description: Field is expected to be NULL SportRadarPlayerID: type: - string - 'null' description: The player's unique PlayerID for cross reference use with Stats Player RotoworldPlayerID: type: - integer - 'null' description: The player's unique PlayerID for cross reference use with Rotoworld. RotoWirePlayerID: type: - integer - 'null' description: The player's unique PlayerID for cross reference use with RotoWire. FantasyAlarmPlayerID: type: - integer - 'null' description: The player's unique PlayerID for cross reference use with FantasyAlarm StatsPlayerID: type: - integer - 'null' description: The player's unique PlayerID for cross reference use with Stats Player. SportsDirectPlayerID: type: - integer - 'null' description: The player's cross reference PlayerID to the SportsDirect data feeds, now part of Nielsen GraceNote. XmlTeamPlayerID: type: - integer - 'null' description: The player's unique PlayerID for cross reference use with Xml Team InjuryStatus: type: - string - 'null' description: 'The player''s current injury status; in the form of likelihood that player plays. Possible values: Probable; Questionable; Doubtful; Out' InjuryBodyPart: type: - string - 'null' description: Indicates the player's injured body part. (e.g. ankle; knee; elbow; etc.) InjuryStartDate: type: - string - 'null' description: The day that the injury started or first discovered. InjuryNotes: type: - string - 'null' description: Brief description of the player's injury and expected availability FanDuelPlayerID: type: - integer - 'null' description: The player's unique PlayerID for cross reference use with FanDuel DraftKingsPlayerID: type: - integer - 'null' description: The player's unique PlayerID for cross reference use with DraftKings. YahooPlayerID: type: - integer - 'null' description: The player's unique PlayerID for cross reference use with Yahoo UpcomingGameID: type: - integer - 'null' description: The unique ID of a player's next upcoming game FanDuelName: type: - string - 'null' description: The player's name on FanDuel DraftKingsName: type: - string - 'null' description: The player's name on DraftKings YahooName: type: - string - 'null' description: The player's name as displayed on/by Yahoo GlobalTeamID: type: - integer - 'null' description: A globally unique ID for this team. This value is guaranteed to be unique across all sports/leagues FantasyDraftName: type: - string - 'null' description: The player's name on Fantasy Draft FantasyDraftPlayerID: type: - integer - 'null' description: The player's unique PlayerID for cross reference use with Fantasy Draft Experience: type: - string - 'null' description: The player's years of experience UsaTodayPlayerID: type: - integer - 'null' description: The player's cross reference PlayerID to USA Today headshot data feeds. UsaTodayHeadshotUrl: type: - string - 'null' description: The player's headshot URL as provided by USA Today. License from USA Today is required. UsaTodayHeadshotNoBackgroundUrl: type: - string - 'null' description: The player's transparent background headshot URL as provided by USA Today. License from USA Today is required. UsaTodayHeadshotUpdated: type: - string - 'null' description: The last updated date of the player's headshot as provided by USA Today. License from USA Today is required. UsaTodayHeadshotNoBackgroundUpdated: type: - string - 'null' description: The last updated date of the player's transparent background headshot as provided by USA Today. License from USA Today is required. securitySchemes: apiKeyHeader: type: apiKey name: Ocp-Apim-Subscription-Key in: header apiKeyQuery: type: apiKey name: key in: query