openapi: 3.1.0
info:
title: MLB API
version: '1.0'
description: MLB API - OpenAPI 3.1 Specification
servers:
- url: https://api.sportsdata.io
description: Production server
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
/v3/mlb/projections/{format}/PlayerGameProjectionStatsByDate/{date}:
get:
description: SportsDataIO's proprietary projections, including DFS salary information
and injuries, for fantasy players, called by date.
operationId: mlb_v3_projections_projected_player_game_stats___by_date
summary: Projected Player Game Stats - 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 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/PlayerGameProjection'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Projections
/v3/mlb/projections/{format}/PlayerSeasonProjectionStats/{season}:
get:
description: SportsDataIO's proprietary projections, including average draft
position, for all active players for the season.
operationId: mlb_v3_projections_projected_player_season_stats_with_adp
summary: Projected Player Season Stats With ADP
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/PlayerSeasonProjection'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Projections
/v3/mlb/projections/{format}/DfsSlatesByDate/{date}:
get:
description: Returns DFS Slates which have not yet started for which we have
DFS projections.
operationId: mlb_v3_projections_dfs_slates___by_date
summary: DFS Slates - 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 slates.
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/DfsSlate'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Projections
/v3/mlb/projections/{format}/InjuredPlayers:
get:
description: This endpoint provides all currently injured MLB players, along
with injury details.
operationId: mlb_v3_projections_player_details___by_injured
summary: Player Details - by Injured
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 Projections
/v3/mlb/projections/{format}/StartingLineupsByDate/{date}:
get:
description: Returns both projected and confirmed starting lineups for all games
on a given date.
operationId: mlb_v3_projections_starting_lineups___by_date
summary: Starting Lineups - 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 slates.
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/StartingLineups'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Projections
/v3/mlb/projections/{format}/DepthCharts:
get:
description: Returns Depth Charts for all active MLB teams.
operationId: mlb_v3_projections_depth_charts
summary: Depth Charts
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/TeamDepthChart'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Projections
/v3/mlb/projections/{format}/DfsSlateOwnershipProjectionsBySlateID/{slateId}:
get:
description: Slate Ownership Projections for a specific slate. Projections are
for Guaranteed Prize Pool (GPP) format ownership. Will return an empty list
if the slate is not yet projected or not a slate we have projections for.
operationId: mlb_v3_projections_dfs_slate_ownership_projections___by_slate
summary: DFS Slate Ownership Projections - by Slate
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: slateId
in: path
description: SlateID of the DFS Slate you wish to get ownership projections
for. Will have an empty SlateOwnershipProjections if this slate was not
projected
required: true
schema:
type: integer
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/DfsSlateWithOwnershipProjection'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Projections
/v3/mlb/projections/{format}/UpcomingDfsSlateOwnershipProjections:
get:
description: Returns DFS Slates which have not yet started for which we have
DFS Ownership projections.
operationId: mlb_v3_projections_dfs_slate_ownership_projections___upcoming
summary: DFS Slate Ownership Projections - Upcoming
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/DfsSlateWithOwnershipProjection'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Projections
/v3/mlb/news-rotoballer/{format}/RotoBallerPremiumNews:
get:
description: RotoBaller's Premium News feed, with the latest updated stories
in greater detail.
operationId: mlb_v3_news_rotoballer_premium_news
summary: Premium 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 RotoBaller Premium News
/v3/mlb/news-rotoballer/{format}/RotoBallerPremiumNewsByDate/{date}:
get:
description: RotoBaller's Premium News feed, with the latest updated stories
in greater detail called by date.
operationId: mlb_v3_news_rotoballer_premium_news___by_date
summary: Premium 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 RotoBaller Premium News
/v3/mlb/odds/{format}/GameOddsByDate/{date}:
get:
description: Returns full game odds (spread, moneyline, total) for games on
a given date. Only returns the most recently seen odds, not inclusive of line
movement.
operationId: mlb_v3_odds_pre_game_odds___by_date
summary: Pre-Game Odds - 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 game(s).
Examples: 2018-06-20,
2018-06-23.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/GameInfo'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/GameOddsLineMovement/{gameid}:
get:
description: Returns the non-full-game odds (spread, moneyline, total) for games
in a given week and season. Non-full-game means 1st-half or 1st-quarter, for
example, rather than full game. Returns the full line movement for the given
game. This endpoint has a longer cache as it is meant for historical data/line
movement rather than the most up to the second line.
operationId: mlb_v3_odds_pre_game_odds_line_movement
summary: Pre-Game Odds Line Movement
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: gameid
in: path
description: The GameID of an MLB game. GameIDs can be found in the Games
API. Valid entries are 51735 or 51745
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/GameInfo'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/LiveGameOddsByDate/{date}:
get:
description: Returns in-play game odds (spread, moneyline, total) for games
on a given date. Only returns the most recently seen odds, not inclusive of
line movement. As this is in-game, it will only return results while the game
is in progress.
operationId: mlb_v3_odds_in_game_odds___by_date
summary: In-Game Odds - 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 game(s).
Examples: 2018-06-20,
2018-06-23.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/GameInfo'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/LiveGameOddsLineMovement/{gameid}:
get:
description: Returns in-play game odds (spread, moneyline, total) for games
on a given date. Returns the full line movement for the given game. This endpoint
has a longer cache as it is meant for historical data/line movement rather
than the most up to the second line.
operationId: mlb_v3_odds_in_game_odds_line_movement
summary: In-Game Odds Line Movement
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: gameid
in: path
description: The GameID of an MLB game. GameIDs can be found in the Games
API. Valid entries are 51735 or 51745
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/GameInfo'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/AlternateMarketGameOddsByDate/{date}:
get:
description: Returns the non-full-game odds (spread, moneyline, total) for games
on a given date. Non-full-game means first five innings, for example, rather
than full game. Only returns the most recently seen odds, not inclusive of
line movement.
operationId: mlb_v3_odds_period_game_odds___by_date
summary: Period Game Odds - 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 game(s).
Examples: 2018-06-20,
2018-06-23.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/GameInfo'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/AlternateMarketGameOddsLineMovement/{gameid}:
get:
description: Returns the non-full-game odds (spread, moneyline, total) for games
on a given date. Non-full-game means first five innings, for example, rather
than full game. Returns the full line movement for the given game. This endpoint
has a longer cache as it is meant for historical data/line movement rather
than the most up to the second line.
operationId: mlb_v3_odds_period_game_odds_line_movement
summary: Period Game Odds Line Movement
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: gameid
in: path
description: The GameID of an MLB game. GameIDs can be found in the Games
API. Valid entries are 51735 or 51745
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/GameInfo'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/TeamTrends/{team}:
get:
description: Describes recent team trends and performance against betting data
in recent sets of games.
operationId: mlb_v3_odds_betting_trends___by_team
summary: Betting Trends - 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: PHI,
MIN, DET, etc.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/TeamTrends'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/MatchupTrends/{team}/{opponent}:
get:
description: Returns trends data for a given pairing of teams. Will return data
even if the teams are not set to play this season. Intended for use on a specific
game, though it will work for other comparisons if applicable.
operationId: mlb_v3_odds_betting_trends___by_matchup
summary: Betting Trends - by Matchup
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: PHI,
MIN, DET, etc.'
required: true
schema:
type: string
- name: opponent
in: path
description: 'The abbreviation of the requested opponent.
Examples: PHI,
MIN, DET, etc.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/MatchupTrends'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/BettingEventsByDate/{date}:
get:
description: The list of current BettingEvents for the given date, from which
Betting Market data can be gathered via the Betting Markets by Event endpoint,
for all available Betting Market types (e.g. Player Props, Team Props.)
operationId: mlb_v3_odds_betting_events___by_date
summary: Betting Events - 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 game(s).
Examples: 2020-08-20,
2020-08-23.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BettingEvent'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/BettingEvents/{season}:
get:
description: The list of current BettingEvents for the given season, from which
Betting Market data can be gathered via the Betting Markets by Event endpoint,
for all available Betting Market types (e.g. Player Props, Team Props.)
operationId: mlb_v3_odds_betting_events___by_season
summary: Betting Events - 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: 'Year of the season (with optional season type).
Examples:
2020, 2020PRE, 2020POST, 2020STAR,
2021, etc.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BettingEvent'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/BettingFuturesBySeason/{season}:
get:
description: Returns available Futures markets for the given season. Does not
include line movement.
operationId: mlb_v3_odds_betting_futures___by_season
summary: Betting Futures - 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: 'Year of the season (with optional season type).
Examples:
2020, 2020PRE, 2020POST, 2020STAR,
2021, etc.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BettingEvent'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/BettingMarkets/{eventId}:
get:
description: Returns the markets of all available types (e.g. Player Props,
Team Props) and available outcomes for a given BettingEventID.
operationId: mlb_v3_odds_betting_markets___by_event
summary: Betting Markets - by Event
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: eventId
in: path
description: The EventId of the desired event/game for which to pull all betting
markets (includes outcomes/bets).
required: true
schema:
type: string
- name: include
in: query
description: 'This parameter indicates which BettingOutcome records
to return in the payload. By default, this endpoint only returns available
outcomes, excluding the unlisted bets.
Important Note: the
default parameter of available is much faster and provides
the best performance. Passing unlisted will return unlisted odds, but these
are cached for much longer and may be several minutes old. For best performance,
the default parameter is highly recommended.
Possible values include:
available - excludes any betting outcomes that have
been removed/unlisted by the respective sportsbook. This is more lightweight
and delivers odds much faster than using unlisted.
unlisted
- includes the most recently available betting outcome per sportsbook, for
each listed market, even those outcomes are expired/unlisted or otherwise
unavailable from the respective sportsbook. This is a far heavier payload,
and it''s cached for much longer than available.
'
schema:
type: string
enum:
- available
- unlisted
default: available
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BettingMarket'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/BettingMarket/{marketId}:
get:
description: Returns full line movement for a given BettingMarket. Due to the
sheer size of the output and the level of detail, it is intended for historical
data purposes and not for the most up-to-the-second lines.
operationId: mlb_v3_odds_betting_market
summary: Betting Market
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: marketId
in: path
description: The MarketId of the desired market for which to pull all outcomes/bets.
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/BettingMarket'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/BettingMarketsByMarketType/{eventId}/{marketTypeID}:
get:
description: Returns Markets and available outcomes for a given event and market
type requested. A lighter call than by BettingEventID as it only includes
markets tagged with the specific MarketType, a full list of which is available
for each sport in its Betting Metadata endpoint.
operationId: mlb_v3_odds_betting_markets___by_market_type
summary: Betting Markets - by Market Type
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: eventId
in: path
description: The EventId of the desired event/game for which to pull all betting
markets (includes outcomes/bets).
required: true
schema:
type: string
- name: marketTypeID
in: path
description: 'The Market Type ID of the desired MarketTypes to pull. Some
common types include: 1 for Game Lines, 2 for
Player Props, 3 for Team Props, 6 for Game Props'
required: true
schema:
type: string
- name: include
in: query
description: 'This parameter indicates which BettingOutcome records
to return in the payload. By default, this endpoint only returns available
outcomes, excluding the unlisted bets.
Important Note: the
default parameter of available is much faster and provides
the best performance. Passing unlisted will return unlisted odds, but these
are cached for much longer and may be several minutes old. For best performance,
the default parameter is highly recommended.
Possible values include:
available - excludes any betting outcomes that have
been removed/unlisted by the respective sportsbook. This is more lightweight
and delivers odds much faster than using unlisted.
unlisted
- includes the most recently available betting outcome per sportsbook, for
each listed market, even those outcomes are expired/unlisted or otherwise
unavailable from the respective sportsbook. This is a far heavier payload,
and it''s cached for much longer than available.
'
schema:
type: string
enum:
- available
- unlisted
default: available
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BettingMarket'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/BettingMarketsByGameID/{gameID}:
get:
description: Returns the markets of all available types (e.g. Player Props,
Team Props) and available outcomes for a given GameID.
operationId: mlb_v3_odds_betting_markets___by_game
summary: Betting Markets - by Game
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: gameID
in: path
description: The GameID of the desired game for which to pull all betting
markets (includes outcomes/bets).
required: true
schema:
type: string
- name: include
in: query
description: 'This parameter indicates which BettingOutcome records
to return in the payload. By default, this endpoint only returns available
outcomes, excluding the unlisted bets.
Important Note: the
default parameter of available is much faster and provides
the best performance. Passing unlisted will return unlisted odds, but these
are cached for much longer and may be several minutes old. For best performance,
the default parameter is highly recommended.
Possible values include:
available - excludes any betting outcomes that have
been removed/unlisted by the respective sportsbook. This is more lightweight
and delivers odds much faster than using unlisted.
unlisted
- includes the most recently available betting outcome per sportsbook, for
each listed market, even those outcomes are expired/unlisted or otherwise
unavailable from the respective sportsbook. This is a far heavier payload,
and it''s cached for much longer than available.
'
schema:
type: string
enum:
- available
- unlisted
default: available
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BettingMarket'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/BettingMetadata:
get:
description: Returns the list of MarketTypes, BetTypes, PeriodTypes, OutcomeTypes,
and ResultTypes to map the IDs to descriptive names. Also includes a list
of the MarketType, BetType & PeriodType combinations which we will have resulting
for.
operationId: mlb_v3_odds_betting_metadata
summary: Betting Metadata
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/BettingEntityMetadataCollection'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/ActiveSportsbooks:
get:
description: A list of all available sportsbooks with their associated unique
IDs.
operationId: mlb_v3_odds_sportsbooks___by_active
summary: Sportsbooks - 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/Sportsbook'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/BettingMarketResults/{marketId}:
get:
description: Returns all outcomes under this market which have a result type
associated. Will return empty list if resulting has not yet processed for
the given game. Resulting processes shortly after game closing.
operationId: mlb_v3_odds_betting_results___by_market
summary: Betting Results - by Market
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: marketId
in: path
description: The MarketId of the desired market for which to pull all outcomes/bets.
Valid IDs include 837872, 841068
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/BettingMarketResult'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/BettingSplitsByMarketId/{marketId}:
get:
description: List of Money and Bet Percentage splits for each outcome type available
in this market. This specific endpoint will return the movement from this
market as well as the most recent.
operationId: mlb_v3_odds_betting_splits_by___betting_market
summary: Betting Splits by - Betting Market
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: marketId
in: path
description: The MarketId of the desired market for which to pull splits..
Valid IDs include 837872
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/BettingMarketSplit'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/BettingSplitsByGameId/{gameId}:
get:
description: List of Money and Bet Percentage splits for each market and their
respective outcome types available in this game. This specific endpoint will
return current splits for each available market and no line movement.
operationId: mlb_v3_odds_betting_splits___by_game
summary: Betting Splits - by Game
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: gameId
in: path
description: The ID of the game for which you want to receive splits for.
Example 63266.
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/GameBettingSplit'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/BettingPlayerPropsByGameID/{gameId}:
get:
description: This works in the same way as Betting Markets by Market Type but
is prefiltered to the Player Props type only. Ideal if your application will
only ever require Player Props, but if you also want Team Props etc. it is
recommended to use the by Market Type endpoint.
operationId: mlb_v3_odds_betting_player_props___by_game
summary: Betting Player Props - by Game
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: gameId
in: path
description: The unique GameID of the game in question.
required: true
schema:
type: string
- name: include
in: query
description: 'This parameter indicates which BettingOutcome records
to return in the payload. By default, this endpoint only returns available
outcomes, excluding the unlisted bets.
Important Note: the
default parameter of available is much faster and provides
the best performance. Passing unlisted will return unlisted odds, but these
are cached for much longer and may be several minutes old. For best performance,
the default parameter is highly recommended.
Possible values include:
available - excludes any betting outcomes that have
been removed/unlisted by the respective sportsbook. This is more lightweight
and delivers odds much faster than using unlisted.
unlisted
- includes the most recently available betting outcome per sportsbook, for
each listed market, even those outcomes are expired/unlisted or otherwise
unavailable from the respective sportsbook. This is a far heavier payload,
and it''s cached for much longer than available.
'
schema:
type: string
enum:
- available
- unlisted
default: available
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BettingMarket'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/BettingMarketsByEvent/{eventId}/{sportsbookGroup}:
get:
description: Returns the markets and available outcomes for a given BettingEventID.
A Sportsbook Group must be specified as a URL parameter.
operationId: mlb_v3_odds_betting_markets___by_event__sportsbook_group
summary: Betting Markets - by Event [Sportsbook Group]
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: eventId
in: path
description: The EventId of the desired event/game for which to pull all betting
markets (includes outcomes/bets).
required: true
schema:
type: string
- name: sportsbookGroup
in: path
description: The name of the sportsbook group that will filter outcomes.
required: true
schema:
type: string
- name: include
in: query
description: 'This parameter indicates which BettingOutcome records
to return in the payload. By default, this endpoint only returns available
outcomes, excluding the unlisted bets.
Important Note: the
default parameter of available is much faster and provides
the best performance. Passing unlisted will return unlisted odds, but these
are cached for much longer and may be several minutes old. For best performance,
the default parameter is highly recommended.
Possible values include:
available - excludes any betting outcomes that have
been removed/unlisted by the respective sportsbook. This is more lightweight
and delivers odds much faster than using unlisted.
unlisted
- includes the most recently available betting outcome per sportsbook, for
each listed market, even those outcomes are expired/unlisted or otherwise
unavailable from the respective sportsbook. This is a far heavier payload,
and it''s cached for much longer than available.
'
schema:
type: string
enum:
- available
- unlisted
default: available
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BettingMarket'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/BettingMarketsByGameID/{gameID}/{sportsbookGroup}:
get:
description: Returns the markets of all available types (e.g. Player Props,
Team Props) and available outcomes for a given GameID. A Sportsbook Group
must be specified as a URL parameter.
operationId: mlb_v3_odds_betting_markets___by_game__sportsbook_group
summary: Betting Markets - by Game [Sportsbook Group]
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: gameID
in: path
description: The GameID of the desired game for which to pull all betting
markets (includes outcomes/bets).
required: true
schema:
type: string
- name: sportsbookGroup
in: path
description: The name of the sportsbook group that will filter outcomes.
required: true
schema:
type: string
- name: include
in: query
description: 'This parameter indicates which BettingOutcome records
to return in the payload. By default, this endpoint only returns available
outcomes, excluding the unlisted bets.
Important Note: the
default parameter of available is much faster and provides
the best performance. Passing unlisted will return unlisted odds, but these
are cached for much longer and may be several minutes old. For best performance,
the default parameter is highly recommended.
Possible values include:
available - excludes any betting outcomes that have
been removed/unlisted by the respective sportsbook. This is more lightweight
and delivers odds much faster than using unlisted.
unlisted
- includes the most recently available betting outcome per sportsbook, for
each listed market, even those outcomes are expired/unlisted or otherwise
unavailable from the respective sportsbook. This is a far heavier payload,
and it''s cached for much longer than available.
'
schema:
type: string
enum:
- available
- unlisted
default: available
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BettingMarket'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/BettingMarket/{marketId}/{sportsbookGroup}:
get:
description: Returns full line movement for a given BettingMarket. Due to the
sheer size of the output and the level of detail, it is intended for historical
data purposes and not for the most up-to-the-second lines. A Sportsbook Group
must be specified as a URL parameter.
operationId: mlb_v3_odds_betting_market____sportsbook_group
summary: Betting Market - [Sportsbook Group]
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: marketId
in: path
description: The MarketId of the desired market for which to pull all outcomes/bets.
required: true
schema:
type: string
- name: sportsbookGroup
in: path
description: The name of the sportsbook group that will filter outcomes.
required: true
schema:
type: string
- name: include
in: query
description: 'This parameter indicates which BettingOutcome records
to return in the payload. By default, this endpoint only returns available
outcomes, excluding the unlisted bets.
Important Note: the default parameter of available is much faster
and provides the best performance. Passing unlisted will return unlisted
odds, but these are cached for much longer and may be several minutes old.
For best performance, the default parameter is highly recommended.
Possible values include:
available - excludes any betting outcomes that have been removed/unlisted
by the respective sportsbook. This is more lightweight and delivers odds
much faster than using unlisted.
unlisted - includes the most recently available betting outcome
per sportsbook, for each listed market, even those outcomes are expired/unlisted
or otherwise unavailable from the respective sportsbook. This is a far heavier
payload, and it''s cached for much longer than available.
'
schema:
type: string
enum:
- available
- unlisted
default: available
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/BettingMarket'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/BettingFuturesBySeason/{season}/{sportsbookGroup}:
get:
description: Returns available Futures markets for the given season. Does not
include line movement. A Sportsbook Group must be specified as a URL parameter.
operationId: mlb_v3_odds_betting_futures___by_season__sportsbook_group
summary: Betting Futures - by Season [Sportsbook Group]
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:
2020, 2020PRE, 2020POST, 2020STAR,
2021, etc.'
required: true
schema:
type: string
- name: sportsbookGroup
in: path
description: The name of the sportsbook group that will filter outcomes.
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BettingEvent'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/BettingMarketsByMarketType/{eventID}/{marketTypeID}/{sportsbookGroup}:
get:
description: Returns Markets and available outcomes for a given event and market
type requested. A lighter call than by BettingEventID as it only includes
markets tagged with the specific MarketType, a full list of which is available
for each sport in its Betting Metadata endpoint. A Sportsbook Group must be
specified as a URL parameter.
operationId: mlb_v3_odds_betting_markets___by_market_type__sportsbook_group
summary: Betting Markets - by Market Type [Sportsbook Group]
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: eventID
in: path
description: The EventId of the desired event/game for which to pull all betting
markets (includes outcomes/bets).
required: true
schema:
type: string
- name: marketTypeID
in: path
description: 'The Market Type ID of the desired MarketTypes to pull. Some
common types include: 1 for Game Lines, 2 for
Player Props, 3 for Team Props, 6 for Game Props'
required: true
schema:
type: string
- name: sportsbookGroup
in: path
description: The name of the sportsbook group that will filter outcomes.
required: true
schema:
type: string
- name: include
in: query
description: 'This parameter indicates which BettingOutcome records
to return in the payload. By default, this endpoint only returns available
outcomes, excluding the unlisted bets.
Important Note: the
default parameter of available is much faster and provides
the best performance. Passing unlisted will return unlisted odds, but these
are cached for much longer and may be several minutes old. For best performance,
the default parameter is highly recommended.
Possible values include:
available - excludes any betting outcomes that have
been removed/unlisted by the respective sportsbook. This is more lightweight
and delivers odds much faster than using unlisted.
unlisted
- includes the most recently available betting outcome per sportsbook, for
each listed market, even those outcomes are expired/unlisted or otherwise
unavailable from the respective sportsbook. This is a far heavier payload,
and it''s cached for much longer than available.
'
schema:
type: string
enum:
- available
- unlisted
default: available
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BettingMarket'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/BettingPlayerPropsByGameID/{gameId}/{sportsbookGroup}:
get:
description: This works in the same way as Betting Markets by Market Type but
is prefiltered to the Player Props type only. Ideal if your application will
only ever require Player Props, but if you also want Team Props etc. it is
recommended to use the by Market Type endpoint. A Sportsbook Group must be
specified as a URL parameter.
operationId: mlb_v3_odds_betting_player_props___by_game__sportsbook_group
summary: Betting Player Props - by Game [Sportsbook Group]
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: gameId
in: path
description: The unique GameID of the game in question.
required: true
schema:
type: string
- name: sportsbookGroup
in: path
description: The name of the sportsbook group that will filter outcomes.
required: true
schema:
type: string
- name: include
in: query
description: 'This parameter indicates which BettingOutcome records
to return in the payload. By default, this endpoint only returns available
outcomes, excluding the unlisted bets.
Important Note: the
default parameter of available is much faster and provides
the best performance. Passing unlisted will return unlisted odds, but these
are cached for much longer and may be several minutes old. For best performance,
the default parameter is highly recommended.
Possible values include:
available - excludes any betting outcomes that have
been removed/unlisted by the respective sportsbook. This is more lightweight
and delivers odds much faster than using unlisted.
unlisted
- includes the most recently available betting outcome per sportsbook, for
each listed market, even those outcomes are expired/unlisted or otherwise
unavailable from the respective sportsbook. This is a far heavier payload,
and it''s cached for much longer than available.
'
schema:
type: string
enum:
- available
- unlisted
default: available
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BettingMarket'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/BettingResultsByMarket/{marketID}/{sportsbookGroup}:
get:
description: 'Provide a market ID that supports resulting (i.e. has a ResultType)
and this endpoint will return a result: for markets with a ResultType, each
line will be graded and it will be determined whether the bet would have won
or lost. A Sportsbook Group must be specified as a URL parameter.'
operationId: mlb_v3_odds_betting_results___by_market__sportsbook_group
summary: Betting Results - by Market [Sportsbook Group]
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: marketID
in: path
description: The MarketId of the desired market for which to pull all outcomes/bets.
Valid IDs include 837872, 841068
required: true
schema:
type: string
- name: sportsbookGroup
in: path
description: The name of the sportsbook group that will filter outcomes.
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/BettingMarketResult'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/PreGameOddsByDate/{date}/{sportsbookGroup}:
get:
description: Returns the full-game and non-full-game odds (spread, moneyline,
total) for games on a given date. Only returns the most recently seen odds,
not inclusive of line movement. A Sportsbook Group must be specified as a
URL parameter.
operationId: mlb_v3_odds_pre_game_and_period_game_odds___by_date__sportsbook_group
summary: Pre-Game and Period Game Odds - by Date [Sportsbook Group]
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: 2018-06-20,
2018-06-23.'
required: true
schema:
type: string
- name: sportsbookGroup
in: path
description: The name of the sportsbook group that will filter outcomes.
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/GameInfo'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/PreGameOddsLineMovement/{gameid}/{sportsbookGroup}:
get:
description: Returns the game odds ( for games in a given week and season. In
this endpoint both full-game and partial-game odds are included. Returns the
full line movement for the given game. This endpoint has a longer cache as
it is meant for historical data/line movement rather than the most up to the
second line. A Sportsbook Group must be specified as a URL parameter.
operationId: mlb_v3_odds_pre_game_and_period_game_odds_line_movement__sportsbook_group
summary: Pre-Game and Period Game Odds Line Movement [Sportsbook Group]
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: gameid
in: path
description: The GameID of an MLB game. GameIDs can be found in the Games
API. Valid entries are 51735 or 51745
required: true
schema:
type: string
- name: sportsbookGroup
in: path
description: The name of the sportsbook group that will filter outcomes.
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/GameInfo'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/InGameOddsByDate/{date}/{sportsbookGroup}:
get:
description: Returns in-play game odds (spread, moneyline, total) for games
on a given date. Only returns the most recently seen odds, not inclusive of
line movement. As this is in-game, it will only return results while the game
is in progress. A Sportsbook Group must be specified as a URL parameter.
operationId: mlb_v3_odds_in_game_odds___by_date__sportsbook_group
summary: In-Game Odds - by Date [Sportsbook Group]
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: 2018-06-20,
2018-06-23.'
required: true
schema:
type: string
- name: sportsbookGroup
in: path
description: The name of the sportsbook group that will filter outcomes.
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/GameInfo'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/InGameOddsLineMovement/{gameid}/{sportsbookGroup}:
get:
description: Returns in-play game odds (spread, moneyline, total) for games
in a given week and season. Returns the full line movement for the given game.
This endpoint has a longer cache as it is meant for historical data/line movement
rather than the most up to the second line. A Sportsbook Group must be specified
as a URL parameter.
operationId: mlb_v3_odds_in_game_odds_line_movement__sportsbook_group
summary: In-Game Odds Line Movement [Sportsbook Group]
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: gameid
in: path
description: The GameID of an MLB game. GameIDs can be found in the Games
API. Valid entries are 51735 or 51745
required: true
schema:
type: string
- name: sportsbookGroup
in: path
description: The name of the sportsbook group that will filter outcomes.
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/GameInfo'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/InGameOddsLineMovementWithResulting/{gameid}/{sportsbookGroup}:
get:
description: 'Returns in-play game odds (spread, moneyline, total) for games
in a given week and season. This also includes Resulting: for markets with
a ResultType, each line will be graded and it will be determined whether the
bet would have won or lost. Returns the full line movement for the given game.
This endpoint has a longer cache as it is meant for historical data/line movement
rather than the most up to the second line. A Sportsbook Group must be specified
as a URL parameter.'
operationId: mlb_v3_odds_in_game_odds_line_movement_with_resulting__sportsbook_group
summary: In-Game Odds Line Movement with Resulting [Sportsbook Group]
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: gameid
in: path
description: The GameID of an MLB game. GameIDs can be found in the Games
API. Valid entries are 51735 or 51745
required: true
schema:
type: string
- name: sportsbookGroup
in: path
description: The name of the sportsbook group that will filter outcomes.
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/GameInfoResult'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/odds/{format}/PreGameOddsLineMovementWithResulting/{gameid}/{sportsbookGroup}:
get:
description: 'Returns the game odds ( for games in a given week and season.
In this endpoint both full-game and partial-game odds are included. This also
includes Resulting: for markets with a ResultType, each line will be graded
and it will be determined whether the bet would have won or lost. Returns
the full line movement for the given game. This endpoint has a longer cache
as it is meant for historical data/line movement rather than the most up to
the second line. A Sportsbook Group must be specified as a URL parameter.'
operationId: mlb_v3_odds_pre_game_and_period_game_odds_line_movement_with_resulting__sportsbook_group
summary: Pre-Game and Period Game Odds Line Movement with Resulting [Sportsbook
Group]
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: gameid
in: path
description: The GameID of an MLB game. GameIDs can be found in the Games
API. Valid entries are 51735 or 51745
required: true
schema:
type: string
- name: sportsbookGroup
in: path
description: The name of the sportsbook group that will filter outcomes.
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/GameInfoResult'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Odds
/v3/mlb/stats/{format}/PlayerGameStatsByDate/{date}:
get:
description: Returns the box score statistical record for all involved players
across a given date, updated live as the game takes place.
operationId: mlb_v3_stats_player_game_stats___by_date__live___final
summary: Player 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/PlayerGame'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Stats
/v3/mlb/stats/{format}/PlayerSeasonStats/{season}:
get:
description: Returns all season-long stats (i.e. the season total, not each
individual game record) for all players for a given season.
operationId: mlb_v3_stats_player_season_stats
summary: Player 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/PlayerSeason'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Stats
/v3/mlb/stats/{format}/PlayerSeasonStatsByTeam/{season}/{team}:
get:
description: Returns all season-long stats (i.e. the season total, not each
individual game record) for a given team's players in a given season.
operationId: mlb_v3_stats_player_season_stats___by_team
summary: Player Season Stats - 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: season
in: path
description: 'Year of the season.
Examples: 2017, 2018.
'
required: true
schema:
type: string
- 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/PlayerSeason'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Stats
/v3/mlb/stats/{format}/BoxScores/{date}:
get:
description: Full statistical information for a specified game, down to the
team and player stat level, delivered live during the game, called for all
games on a given date.
operationId: mlb_v3_stats_box_scores___by_date__live___final
summary: Box Scores - 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/BoxScore'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Stats
/v3/mlb/stats/{format}/BoxScore/{gameid}:
get:
description: Full statistical information for a specified game, down to the
team and player stat level, delivered live during the game, called per individual
game.
operationId: mlb_v3_stats_box_score__live___final
summary: Box Score [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: gameid
in: path
description: The GameID of an MLB game. GameIDs can be found in the Games
API. Valid entries are 14620 or 16905
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/BoxScore'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Stats
/v3/mlb/stats/{format}/BoxScoresDelta/{date}/{minutes}:
get:
description: This method returns all box scores for a given date, but only returns
player stats that have changed in the last X minutes as specified in your
API call. By definition this is a live endpoint, not final.
operationId: mlb_v3_stats_box_scores_delta___by_date
summary: Box Scores Delta - 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 game(s).
Examples: 2017-JUL-31, 2017-SEP-01.'
required: true
schema:
type: string
- name: minutes
in: path
description: 'Only returns player statistics that have changed in the last
X minutes. You specify how many minutes in time to go back. Valid entries
are:
1, 2 ... all.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BoxScore'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Stats
/v3/mlb/stats/{format}/PlayerSeasonSplitStats/{season}/{split}:
get:
description: All players' split stats for the season. Split stats are available
for left, right, and switch-handed pitchers and hitters.
operationId: mlb_v3_stats_player_season_split_stats
summary: Player Season Split 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
- name: split
in: path
description: 'The desired split of stats. Currently, we support vs. Left/Right/Switch
handed pitchers/hitters. Possible values are: L, R
and S'
required: true
schema:
type: string
enum:
- L
- R
- S
default: L
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PlayerSeason'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Stats
/v3/mlb/stats/{format}/HitterVsPitcher/{hitterid}/{pitcherid}:
get:
description: Stat records for a given hitter and a given pitcher, called by
PlayerId in both cases.
operationId: mlb_v3_stats_batter_vs__pitcher_stats
summary: Batter vs. Pitcher 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: hitterid
in: path
description: 'Unique FantasyData Player ID.
Example:10000031.'
required: true
schema:
type: string
- name: pitcherid
in: path
description: 'Unique FantasyData Player ID.
Example:10000618.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PlayerSeason'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Stats
/v3/mlb/stats/{format}/PlayerSeasonStatsSplitByTeam/{season}:
get:
description: All a given team's players' split stats for the season. Split stats
are available for left, right, and switch-handed pitchers and hitters.
operationId: mlb_v3_stats_player_season_stats_split___by_team
summary: Player Season Stats Split - 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: 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/PlayerSeason'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Stats
/v3/mlb/stats/{format}/PlayerSeasonHomeStats/{season}:
get:
description: All players' stats for the season taken only from their home games.
operationId: mlb_v3_stats_player_season_stats___by_home
summary: Player Season Stats - by Home
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/PlayerSeason'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Stats
/v3/mlb/stats/{format}/PlayerSeasonAwayStats/{season}:
get:
description: All players' stats for the season taken only from their road games.
operationId: mlb_v3_stats_player_season_stats___by_away
summary: Player Season Stats - by Away
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/PlayerSeason'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Stats
/v3/mlb/stats/{format}/TeamHittersVsPitcher/{gameid}/{team}:
get:
description: For a given game, returns a team's hitting record versus the projected
or confirmed starting pitcher for the game in question.
operationId: mlb_v3_stats_team_hitting_vs__starting_pitcher
summary: Team Hitting vs. Starting Pitcher
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: gameid
in: path
description: The GameID of an MLB game. GameIDs can be found in the Games
API. Valid entries are 14620 or 16905
required: true
schema:
type: string
- 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/PlayerSeason'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Stats
/v3/mlb/stats/{format}/PlayerGameStatsBySeason/{season}/{playerid}/{numberofgames}:
get:
description: Specify a season, a player, and number of games (either an integer
or all) to see all of their box score logs. Refreshed after their
most recent game is complete.
operationId: mlb_v3_stats_player_game_logs___by_season
summary: Player 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: playerid
in: path
description: 'Unique SportsDataIO Player ID.
Example:10001365.'
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/PlayerGame'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Stats
/v3/mlb/stats/{format}/PlayerGameStatsByDateFinal/{date}:
get:
description: Returns the box score statistical record for all involved players
across all teams' games on a given date after each game has concluded.
operationId: mlb_v3_stats_player_game_stats___by_date__final
summary: Player 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/PlayerGame'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Stats
/v3/mlb/stats/{format}/BoxScoreFinal/{gameid}:
get:
description: Full statistical information for a specified game, down to the
team and player stat level, delivered after the game is complete.
operationId: mlb_v3_stats_box_score__final
summary: Box Score [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: gameid
in: path
description: The GameID of an MLB game. GameIDs can be found in the Games
API. Valid entries are 14620 or 16905
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/BoxScore'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Stats
/v3/mlb/stats/{format}/BoxScoresFinal/{date}:
get:
description: Full statistical information for a specified date for each game
that took place, down to the team and player stat level, delivered after the
game is complete.
operationId: mlb_v3_stats_box_scores___by_date__final
summary: Box Scores - 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/BoxScore'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Stats
/v3/mlb/stats/{format}/FantasyGameStatsByDate/{date}:
get:
description: Returns a simple list of fantasy points and stats for each player
for a given date.
operationId: mlb_v3_stats_fantasy_points___by_date
summary: Fantasy Points - 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 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/FantasyGame'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Stats
/v3/mlb/pbp/{format}/PlayByPlay/{gameid}:
get:
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.
operationId: mlb_v3_pbp_play_by_play__live___final
summary: Play By Play [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: gameid
in: path
description: The GameID of an MLB game. GameIDs can be found in the Games
API. Valid entries are 14620 or 16905
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/PlayByPlay'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Play-by-Play
/v3/mlb/pbp/{format}/PlayByPlayDelta/{date}/{minutes}:
get:
description: This method returns all play-by-plays for a given season and week,
but only returns plays that have changed in the last X minutes as specified
in your API call. By definition this is a live endpoint, not final.
operationId: mlb_v3_pbp_play_by_play_delta
summary: Play By Play Delta
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
- name: minutes
in: path
description: 'Only returns plays that have changed in the last X minutes. You
specify how many minutes in time to go back. Valid entries are:
1, 2 ... all.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PlayByPlay'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Play-by-Play
/v3/mlb/pbp/{format}/PlayByPlayFinal/{gameid}:
get:
description: Each invididual play, its type and outcome, complete with player
and team stats down to the play level, delivered final (after the game ends),
called by game.
operationId: mlb_v3_pbp_play_by_play__final
summary: Play By Play [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: gameid
in: path
description: The GameID of an MLB game. GameIDs can be found in the Games
API. Valid entries are 14620 or 16905
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/PlayByPlay'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Play-by-Play
/v3/mlb/headshots/{format}/Headshots:
get:
description: USA Today/IMAGN cropped action headshots for all active NFL players,
delivered shortly after the season starts.
operationId: mlb_v3_headshots_headshots
summary: Headshots
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/Headshot'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Headshots
components:
schemas:
Unauthorized:
properties:
HttpStatusCode:
type: integer
Code:
type: integer
Description:
type: string
Help:
type: string
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'
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)'
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.
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
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.'
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.
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
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
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
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.).
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
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.
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.)
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.
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)
PlayerGameProjection:
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
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'
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: Player's full name
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
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'
PositionCategory:
type:
- string
- 'null'
description: 'The player''s position category. Possible values: DH; IF;
OF; P; PH; PR'
Started:
type:
- integer
- 'null'
description: 'Whether the player started in the game. Note: started = 1
and not starting = 0'
BattingOrder:
type:
- integer
- 'null'
description: Where the player batted in the lineup for the game (1;2;3;
etc.)
FanDuelSalary:
type:
- integer
- 'null'
description: The player's salary for FanDuel daily fantasy contests.
DraftKingsSalary:
type:
- integer
- 'null'
description: The player's salary for DraftKings daily fantasy contests.
FantasyDataSalary:
type:
- integer
- 'null'
description: The player's salary as calculated by SportsDataIO (formerly
known as FantasyData). Based on the same salary cap as DraftKings contests
($50,000)
YahooSalary:
type:
- integer
- 'null'
description: The player's salary for Yahoo daily fantasy contests
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
FanDuelPosition:
type:
- string
- 'null'
description: The player's eligible position in FanDuel's daily fantasy sports
platform.
DraftKingsPosition:
type:
- string
- 'null'
description: The player's eligible position in DraftKings' daily fantasy
sports platform.
YahooPosition:
type:
- string
- 'null'
description: The player's eligible position in Yahoo's daily fantasy sports
platform
OpponentRank:
type:
- integer
- 'null'
description: The ranking of the player's opponent with regards to fantasy
points allowed
OpponentPositionRank:
type:
- integer
- 'null'
description: The ranking of the player's opponent by position with regards
to fantasy points allowed
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team. This value is guaranteed
to be unique across all sports/leagues
FantasyDraftSalary:
type:
- integer
- 'null'
description: The player's salary for Fantasy Draft daily fantasy contests.
FantasyDraftPosition:
type:
- string
- 'null'
description: The player's eligible position in Fantasy Drafts daily fantasy
sports platform.
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
PlayerSeasonProjection:
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
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'
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: Player's full name
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
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'
PositionCategory:
type:
- string
- 'null'
description: 'The player''s position category. Possible values: DH; IF;
OF; P; PH; PR'
Started:
type:
- integer
- 'null'
description: Number of games started in the season
BattingOrder:
type:
- integer
- 'null'
description: This field is expected to be NULL
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team. This value is guaranteed
to be unique across all sports/leagues
AverageDraftPosition:
type:
- number
- 'null'
description: The auction value for this player as it pertains to auction-style
drafts for season-long fantasy baseball
AuctionValue:
type:
- integer
- 'null'
description: The auction value for this player as it pertains to auction-style
drafts for season-long fantasy baseball
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
DfsSlate:
properties:
SlateID:
type: integer
description: The SlateID that this SlateGame refers to
Operator:
type:
- string
- 'null'
description: 'The name of the operator who is running contests for this
slate Possible values: FanDuel; DraftKings; Yahoo; FantasyDraft; etc.'
OperatorSlateID:
type:
- integer
- 'null'
description: Unique ID of a slate (assigned by the operator).
OperatorName:
type:
- string
- 'null'
description: 'The name of the slate (assigned by the operator). Possible
values: Main, Express, Arcade, Late Night, etc.'
OperatorDay:
type:
- string
- 'null'
description: The day (in EST/EDT) that the slate begins (assigned by the
operator)
OperatorStartTime:
type:
- string
- 'null'
description: The date/time (in EST/EDT) that the slate begins (assigned
by the operator).
NumberOfGames:
type:
- integer
- 'null'
description: The number of actual games that this slate covers
IsMultiDaySlate:
type:
- boolean
- 'null'
description: Whether or not this slate uses games that take place on different
days (true/false)
RemovedByOperator:
type:
- boolean
- 'null'
description: Indicates whether this slate was removed/deleted by the operator.
OperatorGameType:
type:
- string
- 'null'
description: 'The game type of the slate. Note: Will often be null as most
operators only have one game type'
DfsSlateGames:
type: array
items:
$ref: '#/components/schemas/DfsSlateGame'
description: The games that are included in this slate
DfsSlatePlayers:
type: array
items:
$ref: '#/components/schemas/DfsSlatePlayer'
description: The players that are included in this slate
SlateRosterSlots:
type: array
items:
type:
- string
- 'null'
description: The positions that need to be filled for this particular slate
SalaryCap:
type:
- integer
- 'null'
description: The salary cap for the current slate (is null for slates with
no salary cap such a Tiers gametypes)
DfsSlateGame:
properties:
SlateGameID:
type: integer
description: The SlateGameID that this SlatePlayer refers to
SlateID:
type: integer
description: The SlateID that this SlateGame refers to
GameID:
type:
- integer
- 'null'
description: The unique ID of the game tied to this SlateGame
Game:
$ref: '#/components/schemas/Game'
description: The details of the Game that this SlateGame refers to
OperatorGameID:
type:
- integer
- 'null'
description: Unique ID of a SlateGame (assigned by the operator)
RemovedByOperator:
type:
- boolean
- 'null'
description: Indicates whether this game was removed/deleted by the operator.
DfsSlatePlayer:
properties:
SlatePlayerID:
type: integer
description: Unique ID of a SlatePlayer (assigned by SportsDataIO)
SlateID:
type: integer
description: The SlateID that this SlatePlayer refers to
SlateGameID:
type:
- integer
- 'null'
description: The SlateGameID that this SlatePlayer refers to
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'
PlayerGameProjectionStatID:
type:
- integer
- 'null'
description: The SportsDataIO StatID that this SlatePlayer refers to. This
points to data in the respective sports' projected player game stats feeds.
OperatorPlayerID:
type:
- string
- 'null'
description: Unique ID of the Player (assigned by the operator)
OperatorSlatePlayerID:
type:
- string
- 'null'
description: Unique ID of the SlatePlayer (assigned by the operator)
OperatorPlayerName:
type:
- string
- 'null'
description: The player's name (assigned by the operator)
OperatorPosition:
type:
- string
- 'null'
description: The player's eligible positions for the contest (assigned by
the operator)
OperatorSalary:
type:
- integer
- 'null'
description: The player's salary for the contest (assigned by the operator)
OperatorRosterSlots:
type: array
items:
type:
- string
- 'null'
description: 'The player''s eligible positions to be played in the contest
(assigned by the operator). Note: this would include UTIL; etc plays
for those that are eligible.'
RemovedByOperator:
type:
- boolean
- 'null'
description: Indicates whether this player was removed/deleted by the operator
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
TeamID:
type:
- integer
- 'null'
description: The team's unique TeamID as assigned by SportsDataIO
StartingLineups:
properties:
GameID:
type: integer
description: The unique ID of the game tied to the StartingLineups
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)
Day:
type:
- string
- 'null'
description: The day of the game
DateTime:
type:
- string
- 'null'
description: The date and time of the game in US Eastern Time
Status:
type:
- string
- 'null'
description: 'Indicates the game''s status. Possible values include: Scheduled;
InProgress; Final; Suspended; Delayed; Postponed; Canceled; Forfeit; NotNecessary.'
HomeTeamID:
type:
- integer
- 'null'
description: The unique ID of the home team tied to these StartingLineups
HomeTeam:
type:
- string
- 'null'
description: The abbreviation [Key] of the Home Team
AwayTeamID:
type:
- integer
- 'null'
description: The unique TeamID of the away team
AwayTeam:
type:
- string
- 'null'
description: The abbreviation [Key] of the away team
HomeStartingPitcher:
$ref: '#/components/schemas/Lineup'
description: 'Home team starting pitcher. Note: this is a probable pitcher
until confirmed field = TRUE.'
HomeBattingLineup:
type: array
items:
$ref: '#/components/schemas/Lineup'
description: The batting lineup of the home team
AwayStartingPitcher:
$ref: '#/components/schemas/Lineup'
description: 'Away team starting pitcher. Note: this is a probable pitcher
until confirmed field = TRUE.'
AwayBattingLineup:
type: array
items:
$ref: '#/components/schemas/Lineup'
description: Away team batting lineup for the game
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.'
Lineup:
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'
TeamID:
type: integer
description: The team's unique TeamID as assigned by SportsDataIO
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
FirstName:
type:
- string
- 'null'
description: The player's first name
LastName:
type:
- string
- 'null'
description: The player's last name
BattingOrder:
type:
- integer
- 'null'
description: Where the player batted in the lineup for the game (1;2;3;
etc.)
Position:
type:
- string
- 'null'
description: Player's position in the starting lineup (if started); otherwise
the position he substituted for
Starting:
type:
- boolean
- 'null'
description: 'Indicates if this player is starting. Note: started = 1 and
non starting= 0'
Confirmed:
type:
- boolean
- 'null'
description: Indicates if batting order has been confirmed (true/false)
TeamDepthChart:
properties:
DepthCharts:
type: array
items:
$ref: '#/components/schemas/DepthChart'
description: List of Depth Chart Records for Team
TeamID:
type: integer
description: The team's unique TeamID as assigned by SportsDataIO
DepthChart:
properties:
DepthChartID:
type: integer
description: The unique ID of the Depth Chard record
TeamID:
type: integer
description: The team's unique TeamID as assigned by SportsDataIO
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'
Name:
type:
- string
- 'null'
description: Player's full name
PositionCategory:
type:
- string
- 'null'
description: 'The player''s position category. Possible values: DH; IF;
OF; P; PH; PR'
Position:
type:
- string
- 'null'
description: 'Player''s position in the depth chart. Note: a player can
be listed in multiple positions of the depth chart'
DepthOrder:
type:
- integer
- 'null'
description: The Depth Chart order of the player and where they are placed
in the depth chart
Updated:
type:
- string
- 'null'
description: The date and time of the last update made to this depth chart
(in US Eastern Time)
DfsSlateWithOwnershipProjection:
properties:
SlateID:
type: integer
description: Unique ID of a Slate (assigned by SportsDataIO).
Operator:
type:
- string
- 'null'
description: 'The name of the operator who is running contests for this
slate. Possible values: FanDuel, DraftKings, Yahoo, FantasyDraft, etc.'
OperatorSlateID:
type:
- integer
- 'null'
description: Unique ID of a slate (assigned by the operator).
OperatorName:
type:
- string
- 'null'
description: 'The name of the slate (assigned by the operator). Possible
values: Main, Express, Arcade, Late Night, etc.'
OperatorDay:
type:
- string
- 'null'
description: The day (in EST/EDT) that the slate begins (assigned by the
operator).
OperatorStartTime:
type:
- string
- 'null'
description: The date/time (in EST/EDT) that the slate begins (assigned
by the operator).
SlateOwnershipProjections:
type: array
items:
$ref: '#/components/schemas/DfsSlatePlayerOwnershipProjection'
description: The list of projected ownership
DfsSlatePlayerOwnershipProjection:
properties:
SlateID:
type: integer
description: Unique ID of a Slate (assigned by SportsDataIO).
PlayerID:
type: integer
description: Unique ID of the Associated Player.
ProjectedOwnershipPercentage:
type: number
description: Projected Ownership Percentage (0-100)
IsCaptain:
type: boolean
description: Indicates if this is the MVP/Captain slot for single game slates
GameInfo:
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 that this record corresponds to (1=Regular
Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar).
Day:
type:
- string
- 'null'
description: The day of the game
DateTime:
type:
- string
- 'null'
description: The date and time of the game in US Eastern Time
Status:
type:
- string
- 'null'
description: 'Indicates the game''s status. Possible values include: Scheduled;
InProgress; Final; Suspended; Delayed; Postponed; Canceled; Forfeit; NotNecessary'
AwayTeamId:
type:
- integer
- 'null'
description: The unique TeamID of the away team
HomeTeamId:
type:
- integer
- 'null'
description: The unique ID of the home team
AwayTeamName:
type:
- string
- 'null'
description: The abbreviation [Key] of the away team
HomeTeamName:
type:
- string
- 'null'
description: The abbreviation [Key] of the home team
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
- 'null'
description: A globally unique ID for the away team. This value is guaranteed
to be unique across all sports/leagues
GlobalHomeTeamId:
type:
- integer
- 'null'
description: A globally unique ID for the home team. This value is guaranteed
to be unique across all sports/leagues.
PregameOdds:
type: array
items:
$ref: '#/components/schemas/GameOdd'
description: List of Pregame GameOdds from different sportsbooks
LiveOdds:
type: array
items:
$ref: '#/components/schemas/GameOdd'
description: Shows a list of live odds from different sportsbooks
HomeTeamScore:
type:
- integer
- 'null'
description: Score of the home team (updated after game ends to allow for
resolving bets)
AwayTeamScore:
type:
- integer
- 'null'
description: Score of the away team (updated after game ends to allow for
resolving bets)
TotalScore:
type:
- integer
- 'null'
description: The combined scores of the home and away team of the game tied
to this event (post-game)
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
AlternateMarketPregameOdds:
type: array
items:
$ref: '#/components/schemas/GameOdd'
description: List of Alternate Market Game Odds from different sportsbooks.
GameOdd:
properties:
GameOddId:
type: integer
description: Unique ID of this odd
Sportsbook:
type:
- string
- 'null'
description: Name of sportsbook
GameId:
type: integer
description: The unique ID of this game
Created:
type:
- string
- 'null'
description: The date and time when these odds were first created in US
Eastern Time
Updated:
type:
- string
- 'null'
description: The date and time of when these odds were last updated (in
US Eatern Time) If these are the latest odds for this game; and they have
not been updated within the last few minutes; then it indicates that there
were problems connecting to the sportsbook.
HomeMoneyLine:
type:
- integer
- 'null'
description: The sportsbook's moneyline for the home team
AwayMoneyLine:
type:
- integer
- 'null'
description: The sportsbook's moneyline for the away team
HomePointSpread:
type:
- number
- 'null'
description: The sportsbook's run line for the home team
AwayPointSpread:
type:
- number
- 'null'
description: The sportsbook's run line for the away team
HomePointSpreadPayout:
type:
- integer
- 'null'
description: The sportsbook's run line payout for the home team
AwayPointSpreadPayout:
type:
- integer
- 'null'
description: The sportsbook's run line payout for the away team
OverUnder:
type:
- number
- 'null'
description: The total points line as given by the sportsbook
OverPayout:
type:
- integer
- 'null'
description: The sportsbook's payout for the over
UnderPayout:
type:
- integer
- 'null'
description: The sportsbook's payout for the under
SportsbookId:
type:
- integer
- 'null'
description: Unique ID of the sportsbook
SportsbookUrl:
type:
- string
- 'null'
description: The URL for sportsbook event
OddType:
type:
- string
- 'null'
description: 'The market type of the odd (ex: live; pregame; 1st inning;
etc)'
Unlisted:
type:
- string
- 'null'
description: The timestamp of when these odds were first made unavailable
to be bet on any further (In US Eastern Time)
TeamTrends:
properties:
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
TeamID:
type:
- integer
- 'null'
description: The team's unique TeamID as assigned by SportsDataIO
UpcomingGame:
$ref: '#/components/schemas/Game'
description: Next scheduled game for the team
TeamGameTrends:
type: array
items:
$ref: '#/components/schemas/TeamGameTrends'
description: The collection of Game Trends for this team
TeamGameTrends:
properties:
Scope:
type:
- string
- 'null'
description: The type of trend (e.g. Last 5 games; Last 10 games; Last 5
home games; etc.)
TeamID:
type: integer
description: The team's unique TeamID as assigned by SportsDataIO
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
OpponentID:
type:
- integer
- 'null'
description: The TeamID of the opposing team related to the scop of the
search
Opponent:
type:
- string
- 'null'
description: The name [Key] of the team's opponent related to the scop of
the search
Wins:
type: integer
description: The total number of wins by the team relating to the scope
Losses:
type: integer
description: Team losses relating to the scope
Ties:
type: integer
description: Ties by a team relating to the scope of the search
WinsAgainstTheSpread:
type:
- integer
- 'null'
description: Total number of wins against the run line relating to the scope
LossesAgainstTheSpread:
type:
- integer
- 'null'
description: Team losses against the run line relating to the scope
PushesAgainstTheSpread:
type:
- integer
- 'null'
description: The amount of times a given team's final score of their game
has pushed the run line (a push is neither a win nor a loss)
Overs:
type:
- integer
- 'null'
description: Amount of times the total score goes over the OverUnder
Unders:
type:
- integer
- 'null'
description: Amount of times the total score goes under the OverUnder
OverUnderPushes:
type:
- integer
- 'null'
description: The amount of times a given team's final score of their game
has pushed the point total (a push is neither a win nor a loss)
AverageScore:
type:
- number
- 'null'
description: Average score of team
AverageOpponentScore:
type:
- number
- 'null'
description: Average score of the opposing team
MatchupTrends:
properties:
UpcomingGame:
$ref: '#/components/schemas/Game'
description: Next scheduled game for the team with a specified opposing
team
TeamTrends:
type: array
items:
$ref: '#/components/schemas/TeamTrends'
description: The collection of team trends between each team
TeamMatchupTrends:
type: array
items:
$ref: '#/components/schemas/TeamGameTrends'
description: The collection of team game trends against opponent
OpponentMatchupTrends:
type: array
items:
$ref: '#/components/schemas/TeamGameTrends'
description: The collection of opponent game trends against the team
PreviousGames:
type: array
items:
$ref: '#/components/schemas/Game'
description: The collection of last 10 game scores between each team
BettingEvent:
properties:
BettingEventID:
type: integer
description: The unique ID assocated with the betting event
Name:
type:
- string
- 'null'
description: The name of this betting event
Season:
type:
- integer
- 'null'
description: The MLB season of the betting event
BettingEventTypeID:
type: integer
description: The ID associated with the type of betting event
BettingEventType:
type:
- string
- 'null'
description: Indicates the type of betting event - Game or Future
StartDate:
type:
- string
- 'null'
description: The furthest forward time any book has a market set to close
for this betting event
Created:
type:
- string
- 'null'
description: The date and time when this betting event was created in US
Eastern Time
Updated:
type:
- string
- 'null'
description: The date and time of the last update made to this betting event
(in US Eastern Time)
GameID:
type:
- integer
- 'null'
description: The unique ID of the game tied to this BettingEvent
GlobalGameID:
type:
- integer
- 'null'
description: A globally unique ID for the game tied to this BettingEvent.
This value is guaranteed to be unique across all sports/leagues.
GameStatus:
type:
- string
- 'null'
description: The status of the game in tied to this event
Quarter:
type:
- string
- 'null'
description: The quarter of the game tied to this event
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 in the game tied to this
BettingEvent
HomeTeamID:
type:
- integer
- 'null'
description: The unique ID of the home team tied to this BettingEvent
GlobalAwayTeamID:
type:
- integer
- 'null'
description: A globally unique ID for the away team tied to this BettingEvent
This value is guaranteed to be unique across all sports/leagues
GlobalHomeTeamID:
type:
- integer
- 'null'
description: A globally unique ID for the home team tied to this BettingEvent.
This value is guaranteed to be unique across all sports/leagues.
AwayTeamScore:
type:
- integer
- 'null'
description: Score of the away team tied to this betting event (updated
after game ends to allow for resolving bets)
HomeTeamScore:
type:
- integer
- 'null'
description: Score of the home team tied to this betting event (updated
after game ends to allow for resolving bets)
TotalScore:
type:
- integer
- 'null'
description: The combined scores of the home and away team of the game tied
to this event (post-game)
AwayRotationNumber:
type:
- integer
- 'null'
description: Rotation number of away team for this game
HomeRotationNumber:
type:
- integer
- 'null'
description: Rotation number of home team for this game
BettingMarkets:
type: array
items:
$ref: '#/components/schemas/BettingMarket'
description: The list of betting markets for this event
GameStartTime:
type:
- string
- 'null'
description: The date and time the game starts
BettingMarket:
properties:
BettingMarketID:
type: integer
description: The unique ID associated with the betting market
BettingEventID:
type: integer
description: The unique ID assocated with the betting event
BettingMarketTypeID:
type:
- integer
- 'null'
description: The unique ID associated with the market type of the betting
market
BettingMarketType:
type:
- string
- 'null'
description: The name of the market type within a market (e.g. Player Prop,
Team Prop, Game Prop, etc.)
BettingBetTypeID:
type:
- integer
- 'null'
description: The ID associated with the name of the bet type within a market
BettingBetType:
type:
- string
- 'null'
description: The name of the bet type within a market (e.g. Total Runs,
Moneyline, Run Line, etc.)
BettingPeriodTypeID:
type:
- integer
- 'null'
description: The BettingPeriodTypeID of this market
BettingPeriodType:
type:
- string
- 'null'
description: The BettingPeriodType of this market (e.g. Full Game; 1st-5th
Inning; 2nd Inning; Regular Season)
Name:
type:
- string
- 'null'
description: The generic name of this market
TeamID:
type:
- integer
- 'null'
description: The team's unique TeamID as assigned by SportsDataIO tied this
market (if applicable)
TeamKey:
type:
- string
- 'null'
description: The abbreviation [Key] of the team tied to this market (if
applicable)
PlayerID:
type:
- integer
- 'null'
description: 'The player''s unique PlayerID as assigned by SportsDataIO
tied to this market (if applicable) Note: this ID will stay with the player
throughout their MLB career'
PlayerName:
type:
- string
- 'null'
description: The full name of the player associated with this market
Created:
type:
- string
- 'null'
description: The date and time when this betting market was created in US
Eastern Time
Updated:
type:
- string
- 'null'
description: The date and time of the last update made to this betting market
(in US Eastern Time)
AvailableSportsbooks:
type: array
items:
$ref: '#/components/schemas/Sportsbook'
description: The sportsbooks that have had odds in this market
AnyBetsAvailable:
type:
- boolean
- 'null'
description: A field that returns "True" if there are any available bets
to make within the market in question. If there are no bets available
to make, the field returns "False"
BettingOutcomes:
type: array
items:
$ref: '#/components/schemas/BettingOutcome'
description: The list of betting outcomes from each sportsbook in this market
ConsensusOutcomes:
type: array
items:
$ref: '#/components/schemas/ConsensusOutcome'
description: The single set of consensus outcomes of this market
IsArchived:
type: boolean
description: Indicates whether a BettingOutcome has been archived or not
(true/false)
ArchiveLocation:
type:
- string
- 'null'
description: If IsArchived is true, this returns the URL that can be used
to retrieve the archived BettingOutcomes. An API Key and Sportsbook Grouping
will be required to retrieve this information. If IsArchived is false,
this returns an emtpy string
Sportsbook:
properties:
SportsbookID:
type: integer
description: Unique ID of the sportsbook
Name:
type:
- string
- 'null'
description: The name of the sportsbook(s)
BettingOutcome:
properties:
BettingOutcomeID:
type:
- integer
- 'null'
description: The unique ID associated with the betting outcome
BettingMarketID:
type:
- integer
- 'null'
description: The unique ID associated with the betting market
SportsBook:
$ref: '#/components/schemas/Sportsbook'
description: Name of sportsbook
BettingOutcomeTypeID:
type:
- integer
- 'null'
description: The unique ID associated with this BettingOutcomeType
BettingOutcomeType:
type:
- string
- 'null'
description: The name of BettingOutcomeType (e.g. Home; Away; Under; Over)
PayoutAmerican:
type:
- integer
- 'null'
description: The payout of the bet, shown in American odds format
PayoutDecimal:
type:
- number
- 'null'
description: The payout of the bet, shown in decimal odds format
Value:
type:
- number
- 'null'
description: The number associated with the outcome of a market (e.g. the
run line, game total, etc.)
Participant:
type:
- string
- 'null'
description: 'The name of the participant (typically team or player) associated
with the outcome. NOTE: This is provided by the sportsbook. In the case
of Player odds, we highly recommend using PlayerID as names of players
can be inconsistent between sportsbooks.'
IsAvailable:
type:
- boolean
- 'null'
description: Indicates whether a BettingOutcome is available for betting
or not (true/false)
IsAlternate:
type:
- boolean
- 'null'
description: Indicates whether this is an alternate value or the core value
(true/false)
Created:
type:
- string
- 'null'
description: The date and time when this betting outcome was created in
US Eastern Time.
Updated:
type:
- string
- 'null'
description: The date and time of the last update made to this betting outcome
(in US Eastern Time)
Unlisted:
type:
- string
- 'null'
description: The timestamp of when these odds were first made unavailable
to be bet on any further (In US Eastern Time)
TeamID:
type:
- integer
- 'null'
description: The team's unique TeamID as assigned by SportsDataIO tied this
outcome (if applicable)
PlayerID:
type:
- integer
- 'null'
description: 'The player''s unique PlayerID as assigned by SportsDataIO
tied to this outcome (if applicable) Note: this ID will stay with the
player throughout their MLB career'
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team tied to this outcome. This
value is guaranteed to be unique across all sports/leagues (where applicable)
SportsbookUrl:
type:
- string
- 'null'
description: The URL for sportsbook event
IsInPlay:
type:
- boolean
- 'null'
description: Was this outcome created after the start time of the game (only
applies when the betting event is of type game; true/false)
SportsbookMarketID:
type:
- string
- 'null'
description: The market ID on the given sportsbook for deeplinking (when
available)
SportsbookOutcomeID:
type:
- string
- 'null'
description: The outcome ID on the given sportsbook for deeplinking (when
available)
ConsensusOutcome:
properties:
NumberOfSportsbooks:
type: integer
description: The number of sportsbooks odds that went into creating this
consensus outcome
BettingOutcomeID:
type:
- integer
- 'null'
description: The unique ID associated with the betting outcome
BettingMarketID:
type:
- integer
- 'null'
description: The unique ID associated with the betting market
SportsBook:
$ref: '#/components/schemas/Sportsbook'
description: Name of sportsbook
BettingOutcomeTypeID:
type:
- integer
- 'null'
description: The unique ID associated with this BettingOutcomeType
BettingOutcomeType:
type:
- string
- 'null'
description: The name of BettingOutcomeType (e.g. Home; Away; Under; Over)
PayoutAmerican:
type:
- integer
- 'null'
description: The payout of the bet, shown in American odds format
PayoutDecimal:
type:
- number
- 'null'
description: The payout of the bet, shown in decimal odds format
Value:
type:
- number
- 'null'
description: The number associated with the outcome of a market (e.g. the
run line, game total, etc.)
Participant:
type:
- string
- 'null'
description: 'The name of the participant (typically team or player) associated
with the outcome. NOTE: This is provided by the sportsbook. In the case
of Player odds, we highly recommend using PlayerID as names of players
can be inconsistent between sportsbooks.'
IsAvailable:
type:
- boolean
- 'null'
description: Indicates whether a BettingOutcome is available for betting
or not (true/false)
IsAlternate:
type:
- boolean
- 'null'
description: Indicates whether this is an alternate value or the core value
(true/false)
Created:
type:
- string
- 'null'
description: The date and time when this betting outcome was created in
US Eastern Time.
Updated:
type:
- string
- 'null'
description: The date and time of the last update made to this betting outcome
(in US Eastern Time)
Unlisted:
type:
- string
- 'null'
description: The timestamp of when these odds were first made unavailable
to be bet on any further (In US Eastern Time)
TeamID:
type:
- integer
- 'null'
description: The team's unique TeamID as assigned by SportsDataIO tied this
outcome (if applicable)
PlayerID:
type:
- integer
- 'null'
description: 'The player''s unique PlayerID as assigned by SportsDataIO
tied to this outcome (if applicable) Note: this ID will stay with the
player throughout their MLB career'
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team tied to this outcome. This
value is guaranteed to be unique across all sports/leagues (where applicable)
SportsbookUrl:
type:
- string
- 'null'
description: The URL for sportsbook event
IsInPlay:
type:
- boolean
- 'null'
description: Was this outcome created after the start time of the game (only
applies when the betting event is of type game; true/false)
SportsbookMarketID:
type:
- string
- 'null'
description: The market ID on the given sportsbook for deeplinking (when
available)
SportsbookOutcomeID:
type:
- string
- 'null'
description: The outcome ID on the given sportsbook for deeplinking (when
available)
BettingEntityMetadataCollection:
properties:
BettingBetTypes:
type: array
items:
$ref: '#/components/schemas/BettingEntityMetadata'
description: The list of the bet types that can be found within a market
BettingMarketTypes:
type: array
items:
$ref: '#/components/schemas/BettingEntityMetadata'
description: A list of the possible Market Types within a Betting Event
(e.g. Game Line, Team prop, Player Future, etc.)
BettingPeriodTypes:
type: array
items:
$ref: '#/components/schemas/BettingEntityMetadata'
description: A list of the possible BettingPeriodTypes (e.g. Full Game;
1st-5th Inning; 1st Inning)
BettingEventTypes:
type: array
items:
$ref: '#/components/schemas/BettingEntityMetadata'
description: A list of the possible BettingEventTypes (e.g. Game, Future)
BettingOutcomeTypes:
type: array
items:
$ref: '#/components/schemas/BettingEntityMetadata'
description: A list of the possible BettingOutcomeTypes (e.g. Home; Away;
Under; Over)
ResultedMarketMetaData:
type: array
items:
$ref: '#/components/schemas/BettingResultingMetadata'
description: A list of the combinations of MarketType, BetType, & PeriodType
which we willl provide automated resulting for
BettingResultTypes:
type: array
items:
$ref: '#/components/schemas/BettingEntityMetadata'
description: A list of the possible BettingResultTypes (e.g. Win; Loss;
Push; Not Resulted; Incomplete)
BettingEntityMetadata:
properties:
RecordId:
type: integer
description: The ID of the record; unique only within the same entity type
(i.e. BettingMarketType IDs overlap with BettingBetType IDs)
Name:
type:
- string
- 'null'
description: Denotes the name of the Type (e.g. Betting Market Type, Betting
Event Type, Betting Period Type)
Active:
type:
- boolean
- 'null'
description: Whether or not this betting entity is active
BettingResultingMetadata:
properties:
BettingMarketTypeId:
type: integer
description: The unique ID associated with the market type of the betting
market
BettingBetTypeId:
type: integer
description: The ID associated with the name of the bet type within a market
BettingPeriodTypeId:
type: integer
description: The BettingPeriodTypeID of this market
BettingMarketResult:
properties:
BettingMarketID:
type: integer
description: The unique ID associated with the betting market
BettingMarketTypeID:
type: integer
description: The unique ID associated with the market type of the betting
market
BettingMarketType:
type:
- string
- 'null'
description: The name of the market type within a market (e.g. Player Prop,
Team Prop, Game Prop, etc.)
BettingBetTypeID:
type: integer
description: The ID associated with the name of the bet type within a market
BettingBetType:
type:
- string
- 'null'
description: The name of the bet type within a market (e.g. Total Runs,
Moneyline, Run Line, etc.)
BettingPeriodTypeID:
type: integer
description: The BettingPeriodTypeID of this market
BettingPeriodType:
type:
- string
- 'null'
description: The BettingPeriodType of this market (e.g. Full Game; 1st-5th
Inning; 2nd Inning; Regular Season)
Name:
type:
- string
- 'null'
description: The generic name of this market
TeamID:
type:
- integer
- 'null'
description: The team's unique TeamID as assigned by SportsDataIO tied this
market (if applicable)
TeamKey:
type:
- string
- 'null'
description: The abbreviation [Key] of the team tied to this market (if
applicable)
PlayerID:
type:
- integer
- 'null'
description: 'The player''s unique PlayerID as assigned by SportsDataIO
tied to this result (if applicable) Note: this ID will stay with the player
throughout their MLB career'
PlayerName:
type:
- string
- 'null'
description: The full name of the player associated with this market
BettingOutcomeResults:
type: array
items:
$ref: '#/components/schemas/BettingOutcomeResult'
description: The list of outcomes under this market with results
IsMarketResultingSupported:
type: boolean
description: Indicates whether resulting is supported for this kind of BettingMarket (true/false)
BettingOutcomeResult:
properties:
BettingOutcomeID:
type: integer
description: The unique ID associated with the betting outcome
BettingResultTypeID:
type:
- integer
- 'null'
description: The BettingResultTypeID of this outcome
BettingResultType:
type:
- string
- 'null'
description: The string identifier of the BettingResultType of this outcome
(e.g. Win; Loss; Push; Not Resulted; Incomplete)
BettingOutcomeTypeID:
type:
- integer
- 'null'
description: The unique ID associated with this BettingOutcomeType
BettingOutcomeType:
type:
- string
- 'null'
description: The name of BettingOutcomeType (e.g. Home; Away; Under; Over)
BetValue:
type:
- number
- 'null'
description: The offered betting line from a sportsbook for a game (i.e.
If a team won a game by 2 and the run line was -1.5, the actual value
would be 2 and the bet value would be -1.5)
ActualValue:
type:
- number
- 'null'
description: The value of the actual result that occured in game (i.e. If
a team won a game by 2 and the spread was -1.5, the actual value would
be 2 and the bet value would be -1.5)
BettingMarketSplit:
properties:
BettingMarketID:
type: integer
description: The unique ID associated with the betting market
BettingEventID:
type: integer
description: The unique id of the associated betting event
BettingMarketTypeID:
type: integer
description: The unique ID associated with the market type of the betting
market
BettingMarketType:
type:
- string
- 'null'
description: The name of the market type within a market (e.g. Player Prop,
Team Prop, Game Prop, etc.)
BettingBetTypeID:
type: integer
description: The ID associated with the name of the bet type within a market
BettingBetType:
type:
- string
- 'null'
description: The name of the bet type within a market (e.g. Total Runs,
Moneyline, Run Line, etc.)
BettingPeriodTypeID:
type: integer
description: The BettingPeriodTypeID of this market
BettingPeriodType:
type:
- string
- 'null'
description: The BettingPeriodType of this market (e.g. Full Game; 1st-5th
Inning; 2nd Inning; Regular Season)
TeamID:
type:
- integer
- 'null'
description: The team's unique TeamID as assigned by SportsDataIO tied this
market (if applicable)
TeamKey:
type:
- string
- 'null'
description: The abbreviation [Key] of the team tied to this market (if
applicable)
PlayerID:
type:
- integer
- 'null'
description: 'The player''s unique PlayerID as assigned by SportsDataIO
tied to this market (if applicable) Note: this ID will stay with the player
throughout their MLB career'
PlayerName:
type:
- string
- 'null'
description: The full name of the player associated with this market
BettingSplits:
type: array
items:
$ref: '#/components/schemas/BettingSplit'
description: A list of betting splits for the BettingMarket
BettingSplit:
properties:
BettingMarketSplitID:
type: integer
description: The unique ID assciated with the betting split
BettingMarketID:
type: integer
description: The unique ID associated with the betting market
BettingOutcomeTypeID:
type:
- integer
- 'null'
description: The unique ID associated with this BettingOutcomeType
BettingOutcomeType:
type:
- string
- 'null'
description: The name of BettingOutcomeType (e.g. Home; Away; Under; Over)
BetPercentage:
type:
- integer
- 'null'
description: Percentage of bets placed on a specific outcome
MoneyPercentage:
type:
- integer
- 'null'
description: The percentage of the money placed in wagers on this market
taken by this type of bet
Created:
type:
- string
- 'null'
description: The date and time this betting split was created in US Eastern
Time
LastSeen:
type:
- string
- 'null'
description: The date and time this set of values was last seen
GameBettingSplit:
properties:
GameID:
type: integer
description: The unique ID of the game tied to the BettingSplits
SeasonType:
type: integer
description: The type of season that this record corresponds to (1=Regular
Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=AllStar).
Season:
type: integer
description: The MLB season of the betting split
Day:
type:
- string
- 'null'
description: The day of the game
AwayTeam:
type:
- string
- 'null'
description: The abbreviation [Key] of the away team
HomeTeam:
type:
- string
- 'null'
description: The abbreviation [Key] of the Home Team
BettingMarketSplits:
type: array
items:
$ref: '#/components/schemas/BettingMarketSplit'
description: Shows the BettingMarkets that have splits included for them
in a given game
GameInfoResult:
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 that this record corresponds to (1=Regular
Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar).
Day:
type:
- string
- 'null'
description: The day of the game
DateTime:
type:
- string
- 'null'
description: The date and time of the game in US Eastern Time
Status:
type:
- string
- 'null'
description: 'Indicates the game''s status. Possible values include: Scheduled;
InProgress; Final; Suspended; Delayed; Postponed; Canceled; Forfeit; NotNecessary'
AwayTeamID:
type:
- integer
- 'null'
description: The unique TeamID of the away team
HomeTeamID:
type:
- integer
- 'null'
description: The unique TeamID of the home team
AwayTeamName:
type:
- string
- 'null'
description: The abbreviation [Key] of the away team
HomeTeamName:
type:
- string
- 'null'
description: The abbreviation [Key] of the home team
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
- 'null'
description: A globally unique ID for the away team. This value is guaranteed
to be unique across all sports/leagues
GlobalHomeTeamID:
type:
- integer
- 'null'
description: A globally unique ID for the home team. This value is guaranteed
to be unique across all sports/leagues.
PregameOdds:
type: array
items:
$ref: '#/components/schemas/GameOddResult'
description: List of Pregame GameOdds from different sportsbooks with results
HomeTeamScore:
type:
- integer
- 'null'
description: Score of the home team (updated after game ends to allow for
resolving bets)
AwayTeamScore:
type:
- integer
- 'null'
description: Score of the away team (updated after game ends to allow for
resolving bets)
TotalScore:
type:
- integer
- 'null'
description: The combined scores of the home and away team of the game tied
to this event (post-game)
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
AlternateMarketPregameOdds:
type: array
items:
$ref: '#/components/schemas/GameOddResult'
description: List of Alternate Market Game Odds from different sportsbooks
with results
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)'
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'
Innings:
type: array
items:
$ref: '#/components/schemas/Inning'
description: The inning details associated with the game
LiveOdds:
type: array
items:
$ref: '#/components/schemas/GameOddResult'
description: Shows a list of live odds from different sportsbooks with results
GameOddResult:
properties:
GameOddID:
type: integer
description: Unique ID of this odd
Sportsbook:
type:
- string
- 'null'
description: Name of sportsbook
GameID:
type: integer
description: The unique ID of this game
Created:
type:
- string
- 'null'
description: The date and time when these odds were first created in US
Eastern Time
Updated:
type:
- string
- 'null'
description: The date and time of when these odds were last updated (in
US Eatern Time). If these are the latest odds for this game; and they
have not been updated within the last few minutes; then it indicates that
there were problems connecting to the sportsbook.
HomeMoneyLine:
type:
- integer
- 'null'
description: The sportsbook's moneyline for the home team
AwayMoneyLine:
type:
- integer
- 'null'
description: The sportsbook's moneyline for the away team
HomePointSpread:
type:
- number
- 'null'
description: The sportsbook's run line for the home team
AwayPointSpread:
type:
- number
- 'null'
description: The sportsbook's run line for the away team
HomePointSpreadPayout:
type:
- integer
- 'null'
description: The sportsbook's run line payout for the home team
AwayPointSpreadPayout:
type:
- integer
- 'null'
description: The sportsbook's run line payout for the away team
OverUnder:
type:
- number
- 'null'
description: The total points line as given by the sportsbook
OverPayout:
type:
- integer
- 'null'
description: The sportsbook's payout for the over
UnderPayout:
type:
- integer
- 'null'
description: The sportsbook's payout for the under
SportsbookID:
type:
- integer
- 'null'
description: Unique ID of the sportsbook
SportsbookUrl:
type:
- string
- 'null'
description: The URL for sportsbook event
OddType:
type:
- string
- 'null'
description: 'The market type of the odd (ex: live; pregame; 1st inning;
etc)'
GameOddOutcomeResults:
type: array
items:
$ref: '#/components/schemas/GameOddOutcome'
description: List of outcomes showing results of betting markets that were
bet on for the given game
GameOddOutcome:
properties:
GameOddId:
type:
- integer
- 'null'
description: Unique ID of this odd
GameOddResultTypeId:
type:
- integer
- 'null'
description: The unique ID of this GameOddResultType
GameOddResultType:
type:
- string
- 'null'
description: The result/outcome of a bet (e.g. Won; Lost; Push; Not Resulted;
Incomplete)
OddType:
type:
- string
- 'null'
description: 'The market type of the odd (ex: live; pregame; 1st inning;
etc)'
GameOddType:
type:
- string
- 'null'
description: The GameOddResultType of an outcome in the form of a string
BetValue:
type:
- number
- 'null'
description: The offered betting line from a sportsbook for a game (i.e.
If a team won a game by 2 and the run line was -1.5, the actual value
would be 2 and the bet value would be -1.5)
ActualValue:
type:
- number
- 'null'
description: The value of the actual result that occured in game (i.e. If
a team won a game by 2 and the spread was -1.5, the actual value would
be 2 and the bet value would be -1.5)
PlayerGame:
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
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'
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: Player's full name
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
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'
PositionCategory:
type:
- string
- 'null'
description: 'The player''s position category. Possible values: DH; IF;
OF; P; PH; PR'
Started:
type:
- integer
- 'null'
description: 'Whether the player started in the game. Note: started = 1
and not starting = 0'
BattingOrder:
type:
- integer
- 'null'
description: Where the player batted in the lineup for the game (1;2;3;
etc.)
FanDuelSalary:
type:
- integer
- 'null'
description: The player's salary for FanDuel daily fantasy contests.
DraftKingsSalary:
type:
- integer
- 'null'
description: The player's salary for DraftKings daily fantasy contests.
FantasyDataSalary:
type:
- integer
- 'null'
description: The player's salary as calculated by SportsDataIO (formerly
known as FantasyData). Based on the same salary cap as DraftKings contests
($50,000)
YahooSalary:
type:
- integer
- 'null'
description: The player's salary for Yahoo daily fantasy contests
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
FanDuelPosition:
type:
- string
- 'null'
description: The player's eligible position in FanDuel's daily fantasy sports
platform.
DraftKingsPosition:
type:
- string
- 'null'
description: The player's eligible position in DraftKings' daily fantasy
sports platform.
YahooPosition:
type:
- string
- 'null'
description: The player's eligible position in Yahoo's daily fantasy sports
platform
OpponentRank:
type:
- integer
- 'null'
description: The ranking of the player's opponent with regards to fantasy
points allowed
OpponentPositionRank:
type:
- integer
- 'null'
description: The ranking of the player's opponent by position with regards
to fantasy points allowed
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team. This value is guaranteed
to be unique across all sports/leagues
FantasyDraftSalary:
type:
- integer
- 'null'
description: The player's salary for Fantasy Draft daily fantasy contests.
FantasyDraftPosition:
type:
- string
- 'null'
description: The player's eligible position in Fantasy Drafts daily fantasy
sports platform.
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
PlayerSeason:
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
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'
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: Player's full name
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
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'
PositionCategory:
type:
- string
- 'null'
description: 'The player''s position category. Possible values: DH; IF;
OF; P; PH; PR'
Started:
type:
- integer
- 'null'
description: Number of games started in the season
BattingOrder:
type:
- integer
- 'null'
description: This field is expected to be NULL
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team. This value is guaranteed
to be unique across all sports/leagues
AverageDraftPosition:
type:
- number
- 'null'
description: The auction value for this player as it pertains to auction-style
drafts for season-long fantasy baseball
AuctionValue:
type:
- integer
- 'null'
description: The auction value for this player as it pertains to auction-style
drafts for season-long fantasy baseball
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
BoxScore:
properties:
Game:
$ref: '#/components/schemas/Game'
description: The details of the game associated with this box score
Innings:
type: array
items:
$ref: '#/components/schemas/Inning'
description: The inning details associated with the box score
TeamGames:
type: array
items:
$ref: '#/components/schemas/TeamGame'
description: The team game stats associated with this box score
PlayerGames:
type: array
items:
$ref: '#/components/schemas/PlayerGame'
description: The player game stats associated with this box score
FantasyGame:
properties:
GameID:
type: integer
description: The unique ID of this game
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'
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
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
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
Opponent:
type:
- string
- 'null'
description: The name [Key] of the player's opponent in the game
HomeOrAway:
type:
- string
- 'null'
description: Whether the team is home or away
Jersey:
type:
- integer
- 'null'
description: The player's jersey number.
Name:
type:
- string
- 'null'
description: Player's full name
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'
PositionCategory:
type:
- string
- 'null'
description: 'The player''s position category. Possible values: DH; IF;
OF; P; PH; PR'
Games:
type:
- integer
- 'null'
description: 'The number of games played by the player. Note: for game feeds
this will always = 1'
Started:
type:
- integer
- 'null'
description: 'Whether the player started in the game. Note: started = 1
and not starting = 0'
FantasyPoints:
type:
- number
- 'null'
description: Total fantasy points by the player during the game
FantasyPointsBatting:
type:
- number
- 'null'
description: Total batting fantasy points by the player in the game
FantasyPointsPitching:
type:
- number
- 'null'
description: Total pitching fantasy points by the player in the game
IsGameOver:
type:
- boolean
- 'null'
description: Whether or not the game is over (returns ture/false)
FantasyPointsFanDuel:
type:
- number
- 'null'
description: Total FanDuel fantasy points by the player in the game
FantasyPointsYahoo:
type:
- number
- 'null'
description: Total Yahoo fantasy points by the player in the game
FantasyPointsDraftKings:
type:
- number
- 'null'
description: Total DraftKings fantasy points by the player in the game
FanDuelPosition:
type:
- string
- 'null'
description: The player's eligible position in FanDuel's daily fantasy sports
platform.
DraftKingsPosition:
type:
- string
- 'null'
description: The player's eligible position in DraftKings' daily fantasy
sports platform.
YahooPosition:
type:
- string
- 'null'
description: The player's eligible position in Yahoo's daily fantasy sports
platform
OpponentRank:
type:
- integer
- 'null'
description: The ranking of the player's opponent with regards to fantasy
points allowed
OppositionPositionRank:
type:
- integer
- 'null'
description: The ranking of the player's opponent by position with regards
to fantasy points allowed
GlobalGameID:
type:
- integer
- 'null'
description: A globally unique ID for this game. This value is guaranteed
to be unique across all sports/leagues.
Updated:
type:
- string
- 'null'
description: The date and time of the late update made to this record (in
US Eastern Time)
PlayByPlay:
properties:
Game:
$ref: '#/components/schemas/Game'
description: The details of the game associated with this play-by-play
Plays:
type: array
items:
$ref: '#/components/schemas/Play'
description: The details of the plays associated with this play-by-play
Play:
properties:
PlayID:
type: integer
description: The unique ID of the play assigned by SportsDataIO
InningID:
type: integer
description: The unique ID associated with this specific inning in which
the play occurred
InningNumber:
type:
- integer
- 'null'
description: The inning number in which the particular play occurred
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)'
PlayNumber:
type:
- integer
- 'null'
description: The order in which plays occurred in a game
InningBatterNumber:
type:
- integer
- 'null'
description: The batter number in the inning where the play occurred.
AwayTeamRuns:
type:
- integer
- 'null'
description: Number of runs scored by the away team on this specific play
HomeTeamRuns:
type:
- integer
- 'null'
description: Number of runs scored by the home team on this specific play
HitterID:
type:
- integer
- 'null'
description: The unique PlayerID of the hitter involved with the play
PitcherID:
type:
- integer
- 'null'
description: The PlayerID of the pitcher involved in the play
HitterTeamID:
type:
- integer
- 'null'
description: The TeamID of the hitter's team.
PitcherTeamID:
type:
- integer
- 'null'
description: The ID of the pitcher's team
HitterName:
type:
- string
- 'null'
description: The first and last name of the hitter involved in the play
PitcherName:
type:
- string
- 'null'
description: The full name of the pitcher involved in the play
PitcherThrowHand:
type:
- string
- 'null'
description: The throwing hand of the pitcher in which the play occurred.
(right or left)
HitterBatHand:
type:
- string
- 'null'
description: The batter's handedness for which the play occurred. (R; L;
S)
HitterPosition:
type:
- string
- 'null'
description: The position of the player in which the play occrred. (e.g.
P;C;1B; SS; OF)
Outs:
type:
- integer
- 'null'
description: The number of outs in which the play occurred
Balls:
type:
- integer
- 'null'
description: The number of balls in the count in which the play occurred
Strikes:
type:
- integer
- 'null'
description: The number of strikes in the count in which the play occurred
PitchNumberThisAtBat:
type:
- integer
- 'null'
description: The number of pitches in the at bat in which the play occurred
Result:
type:
- string
- 'null'
description: 'The result of the play. Possible values include: Batter''s
Interference, Bunted into Double Play, Catcher''s Interference, Double,
Error, Fielder''s Choice, Fly into Double Play, Fly Out, Foul Out, Fouled
into Double Play, Ground into Double Play, Ground Out, Hit by Pitch, Home
Run, Infield Fly Out, Intentional Walk, Line into Double Play, Lineout,
Pop Out, Popped into Double Play, Sacrifice, Sacrifice Fly, Single, Strikeout
Bunting, Strikeout Looking, Strikeout Swinging, Triple, Triple Play, Walk,
Stolen Base, Caught Stealing, Passed Ball, Wild Pitch, Pick Off, Balk,
Error, Fielders Indifference'
NumberOfOutsOnPlay:
type:
- integer
- 'null'
description: The number of outs recorded on the play
RunsBattedIn:
type:
- integer
- 'null'
description: The number of runs batted in on the play
AtBat:
type:
- boolean
- 'null'
description: Whether this plate appearance resulted in an at bat
Strikeout:
type:
- boolean
- 'null'
description: Whether the play resulted with a strikeout (returns true/false)
Walk:
type:
- boolean
- 'null'
description: Indicates whether the play resulted in a walk for the hitter
(returns true/false)
Hit:
type:
- boolean
- 'null'
description: Whether this play resulted in a hit (true/false)
Out:
type:
- boolean
- 'null'
description: Whether this play resutled in an out (true/false)
Sacrifice:
type:
- boolean
- 'null'
description: Whether the play resulted in a sacrifice (returns true/false)
Error:
type:
- boolean
- 'null'
description: Whether this play resulted in an error (true/false)
Updated:
type:
- string
- 'null'
description: The database generated timestamp of when this record was last
updated (in US Eastern Time)
Description:
type:
- string
- 'null'
description: The description of the play for display purposes
Pitches:
type: array
items:
$ref: '#/components/schemas/Pitch'
description: The details of the pitches associated with this play
Runner1ID:
type:
- integer
- 'null'
description: The PlayerID of the player on first as a result of the play
(post-play)
Runner2ID:
type:
- integer
- 'null'
description: The PlayerID of the player on second as a result of the play
(post-play)
Runner3ID:
type:
- integer
- 'null'
description: The PlayerID of the player on third as a result of the play
(post-play)
Pitch:
properties:
PitchID:
type: integer
description: The unique ID of the pitch
PlayID:
type: integer
description: The unique ID of the play assigned by SportsDataIO
PitchNumberThisAtBat:
type:
- integer
- 'null'
description: The number of pitches in the at bat in which the pitch occurred.
PitcherID:
type:
- integer
- 'null'
description: The PlayerID of the pitcher who threw the pitch
HitterID:
type:
- integer
- 'null'
description: The unique PlayerID of the hitter who represents the play
Outs:
type:
- integer
- 'null'
description: The number of outs when the pitch occurred
BallsBeforePitch:
type:
- integer
- 'null'
description: The number of balls the pitcher has thrown before the current
pitch
StrikesBeforePitch:
type:
- integer
- 'null'
description: The number of strikes the pitcher has thrown before the current
pitch
Strike:
type:
- boolean
- 'null'
description: Whether the pitch was a strike (true/false)
Ball:
type:
- boolean
- 'null'
description: Whether the pitch was a ball (true/false)
Foul:
type:
- boolean
- 'null'
description: Whether the pitch was hit foul (true/false)
Swinging:
type:
- boolean
- 'null'
description: Whether the hitter struck out swinging (true/false)
Looking:
type:
- boolean
- 'null'
description: Whether or not the hitter struck out looking (returns true/false)
Headshot:
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
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
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'
PreferredHostedHeadshotUrl:
type:
- string
- 'null'
description: The player's preferred hosted headshot URL. This returns the
headshot with transparent background, if available.
PreferredHostedHeadshotUpdated:
type:
- string
- 'null'
description: The last updated date of the player's preferred hosted headshot.
HostedHeadshotWithBackgroundUrl:
type:
- string
- 'null'
description: The player's hosted headshot URL
HostedHeadshotWithBackgroundUpdated:
type:
- string
- 'null'
description: The last date and time the player's hosted headshot was updated
in US Eastern Time
HostedHeadshotNoBackgroundUrl:
type:
- string
- 'null'
description: The player's transparent background hosted headshot URL
HostedHeadshotNoBackgroundUpdated:
type:
- string
- 'null'
description: The last date and time the player's transparent background
hosted headshot was updated in US Eastern Time
securitySchemes:
apiKeyHeader:
type: apiKey
name: Ocp-Apim-Subscription-Key
in: header
apiKeyQuery:
type: apiKey
name: key
in: query
security:
- apiKeyHeader: []
- apiKeyQuery: []