openapi: 3.1.0
info:
title: NBA API
version: '1.0'
description: NBA API - OpenAPI 3.1 Specification
servers:
- url: https://api.sportsdata.io
description: Production server
paths:
/v3/nba/scores/{format}/teams:
get:
description: 'Full team information: team name and city, conference 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: nba_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:
- NBA v3 Scores
/v3/nba/scores/{format}/GamesByDate/{date}:
get:
description: Full scores and gameday info delivered live and post-game. Live
data includes half and score info. Gameday info includes TV channel etc
operationId: nba_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: 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/Game'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NBA v3 Scores
/v3/nba/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: nba_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:
- NBA v3 Scores
/v3/nba/scores/{format}/News:
get:
description: Basic RotoBaller news feed, with limited stories available - usually
0-1 stories per day. Ideal for test purposes.
operationId: nba_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:
- NBA v3 Scores
/v3/nba/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: nba_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: 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/News'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NBA v3 Scores
/v3/nba/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: nba_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:
- NBA v3 Scores
/v3/nba/scores/{format}/Stadiums:
get:
description: Returns all stadiums in the league with capacity, surface, latitude/longitude,
city and state (and where applicable country.)
operationId: nba_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:
- NBA v3 Scores
/v3/nba/scores/{format}/TeamGameStatsByDate/{date}:
get:
description: Returns the box score statistical record team-wide (aggregated
from all players) for all games on a given date, both live and post-game.
operationId: nba_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: 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/TeamGame'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NBA v3 Scores
/v3/nba/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: nba_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: 2015, 2016.'
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:
- NBA v3 Scores
/v3/nba/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: nba_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:
- NBA v3 Scores
/v3/nba/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: nba_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:
- NBA v3 Scores
/v3/nba/scores/{format}/Standings/{season}:
get:
description: Includes regular season standings in division and conference, from
which postseason seeding can be derived.
operationId: nba_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: 2015, 2016.'
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:
- NBA v3 Scores
/v3/nba/scores/{format}/AllTeams:
get:
description: 'Full team information: team name and city, conference 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: nba_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:
- NBA v3 Scores
/v3/nba/scores/{format}/Players:
get:
description: Full player bio and details, including injury notes, for all active
players.
operationId: nba_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:
- NBA v3 Scores
/v3/nba/scores/{format}/FreeAgents:
get:
description: Full player bio and details, including injury notes, for all available
free agents unattached to a team.
operationId: nba_v3_scores_player_details___by_free_agent
summary: Player Details - by Free Agent
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:
- NBA v3 Scores
/v3/nba/scores/{format}/Referees:
get:
description: Returns the full list of NBA Referees.
operationId: nba_v3_scores_referees
summary: Referees
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/Referee'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NBA v3 Scores
/v3/nba/scores/{format}/Players/{team}:
get:
description: Full player bio and details, including injury notes, for all available
players by team.
operationId: nba_v3_scores_player_details___by_team
summary: Player 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: PHI,
BKN.'
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:
- NBA v3 Scores
/v3/nba/scores/{format}/TeamGameStatsBySeason/{season}/{teamid}/{numberofgames}:
get:
description: Game by game log of total team statistics.
operationId: nba_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 8
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:
- NBA v3 Scores
/v3/nba/scores/{format}/DepthCharts:
get:
description: Returns the full list of NBA Depth Charts as of the time of the
call.
operationId: nba_v3_scores_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:
- NBA v3 Scores
/v3/nba/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: nba_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:
- NBA v3 Scores
/v3/nba/scores/{format}/ScoresBasic/{date}:
get:
description: This endpoint simply delivers the quarter, time, quarter scores,
and total score live; no gameday info is provided.
operationId: nba_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: 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/ScoreBasic'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NBA v3 Scores
/v3/nba/scores/{format}/PlayersBasic/{team}:
get:
description: Roster information for a given team. Player profiles include basic
biographical information, position, college, and current team (if attached
to a team.) Specify a team tricode parameter to receive all players currently
on that team.
operationId: nba_v3_scores_players_profiles___by_team
summary: Players 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: PHI,
BKN.'
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:
- NBA v3 Scores
/v3/nba/scores/{format}/PlayersActiveBasic:
get:
description: Player profiles include basic biographical information, position,
college, and current team (if attached to a team.) This returns all players
currently active.
operationId: nba_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:
- NBA v3 Scores
/v3/nba/scores/{format}/PlayersByFreeAgents:
get:
description: Player profiles include basic biographical information, position,
college, and current team (if attached to a team.) This returns all free agents
not currently attached to a team.
operationId: nba_v3_scores_player_profiles___by_free_agent
summary: Player Profiles - by Free Agent
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:
- NBA v3 Scores
/v3/nba/scores/{format}/TransactionsByDate/{date}:
get:
description: A list of transactions, such as player trades, injuries, assignments
etc., delivered by date.
operationId: nba_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:
- NBA v3 Scores
/v3/nba/scores/{format}/teams/{season}:
get:
description: 'Full team information: team name and city, conference and division,
and colors. Also contains basic fantasy info such as IDs as well as full stadium
data. This endpoint returns the active teams for a given season.'
operationId: nba_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: "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:
- NBA v3 Scores
/v3/nba/scores/{format}/GamesByDateFinal/{date}:
get:
description: Full scores and gameday info, including referee, infotainment odds,
as well as all of the quarter scores and full-time score, delivered as the
game ends.
operationId: nba_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: 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/Game'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NBA v3 Scores
/v3/nba/scores/{format}/ScoresBasicFinal/{date}:
get:
description: A slimmed-down score endpoint, giving just the quarter scores and
final score, for simple applications.
operationId: nba_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: 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/ScoreBasic'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NBA v3 Scores
/v3/nba/projections/{format}/PlayerGameProjectionStatsByDate/{date}:
get:
description: SportsDataIO's proprietary projections, including DFS salary information
and injuries, for fantasy players, called by date.
operationId: nba_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: 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/PlayerGameProjection'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NBA v3 Projections
/v3/nba/projections/{format}/DfsSlatesByDate/{date}:
get:
description: Returns DFS Slates which have not yet started, with their player
and salary information.
operationId: nba_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 game(s).
Examples: 2017-DEC-01, 2018-FEB-15.'
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:
- NBA v3 Projections
/v3/nba/projections/{format}/PlayerSeasonProjectionStats/{season}:
get:
description: SportsDataIO's proprietary projections for all active players for
the season.
operationId: nba_v3_projections_projected_player_season_stats
summary: Projected 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 (with optional season type).
Examples:
2018, 2019, etc.'
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:
- NBA v3 Projections
/v3/nba/projections/{format}/PlayerSeasonProjectionStatsByTeam/{season}/{team}:
get:
description: SportsDataIO's proprietary projections for all active players for
the season, called by team
operationId: nba_v3_projections_projected_player_season_stats___by_team
summary: Projected 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 (with optional season type).
Examples:
2018, 2019, etc.'
required: true
schema:
type: string
- name: team
in: path
description: 'The abbreviation of the requested team.
Examples: MIA, PHI.'
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:
- NBA v3 Projections
/v3/nba/projections/{format}/StartingLineupsByDate/{date}:
get:
description: This endpoint provides the projected & confirmed starting lineups
for NBA games on a given date.
operationId: nba_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 game(s).
Examples: 2021-OCT-12,
2021-DEC-09.'
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:
- NBA v3 Projections
/v3/nba/projections/{format}/InjuredPlayers:
get:
description: This endpoint provides all currently injured NBA players, along
with injury details.
operationId: nba_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:
- NBA v3 Projections
/v3/nba/news-rotoballer/{format}/RotoBallerPremiumNews:
get:
description: RotoBaller's Premium News feed, with the latest updated stories
in greater detail.
operationId: nba_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:
- NBA v3 RotoBaller Premium News
/v3/nba/news-rotoballer/{format}/RotoBallerPremiumNewsByDate/{date}:
get:
description: RotoBaller's Premium News feed, with the latest updated stories
in greater detail called by date.
operationId: nba_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:
- NBA v3 RotoBaller Premium News
/v3/nba/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: nba_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:
- NBA v3 Odds
/v3/nba/odds/{format}/GameOddsLineMovement/{gameid}:
get:
description: Returns the non-full-game odds (spread, moneyline, total) for games
on a given date. 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: nba_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 NBA game. GameIDs can be found in the Games
API. Valid entries are 12780 or 12781
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:
- NBA v3 Odds
/v3/nba/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: nba_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:
- NBA v3 Odds
/v3/nba/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: nba_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 NBA game. GameIDs can be found in the Games
API. Valid entries are 12780 or 12781
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:
- NBA v3 Odds
/v3/nba/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 1st-half or 1st-quarter, for example,
rather than full game. Only returns the most recently seen odds, not inclusive
of line movement.
operationId: nba_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:
- NBA v3 Odds
/v3/nba/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 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: nba_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 NBA game. GameIDs can be found in the Games
API. Valid entries are 12780 or 12781
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:
- NBA v3 Odds
/v3/nba/odds/{format}/BettingEventsByDate/{date}:
get:
description: The list of current BettingEvents for the given date. Events in
this include market information but no outcomes will be included here. Intended
to allow both visibility to Events in order to match up Events -> Games via
the included GameID (where applicable) as well as provide a list of MarketIDs
which are included in the given event.
operationId: nba_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-02-15,
2020-02-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:
- NBA v3 Odds
/v3/nba/odds/{format}/BettingEvents/{season}:
get:
description: Returns the full list of BetttingEvents for the given season. Intended
for those who need to tie BettingEventIDs to GameIDs.
operationId: nba_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:
- NBA v3 Odds
/v3/nba/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: nba_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). Valid entries include: 134,
155, etc.'
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:
- NBA v3 Odds
/v3/nba/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: nba_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.
Valid entries include: 421, 1041, etc.'
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:
- NBA v3 Odds
/v3/nba/odds/{format}/BettingFuturesBySeason/{season}:
get:
description: Returns available Futures outcomes for the given season. Does not
include line movement.
operationId: nba_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
Examples: 2020, 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:
- NBA v3 Odds
/v3/nba/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: nba_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). Valid entries include: 134,
155, etc.'
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:
- NBA v3 Odds
/v3/nba/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: nba_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). Valid entries include: 14814'
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:
- NBA v3 Odds
/v3/nba/odds/{format}/TeamTrends/{team}:
get:
description: Describes recent team trends and performance against betting data
in recent sets of games.
operationId: nba_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:
- NBA v3 Odds
/v3/nba/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: nba_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:
- NBA v3 Odds
/v3/nba/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: nba_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:
- NBA v3 Odds
/v3/nba/odds/{format}/ActiveSportsbooks:
get:
description: A list of all available sportsbooks with their associated unique
IDs.
operationId: nba_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:
- NBA v3 Odds
/v3/nba/odds/{format}/BettingMarketResults/{marketId}:
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.'
operationId: nba_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 entries include: 406451, 404168, etc.'
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:
- NBA v3 Odds
/v3/nba/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: nba_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.
MarketIds are pulled from the Betting Markets endpoints.
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:
- NBA v3 Odds
/v3/nba/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: nba_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.
GameIds are pulled from the Schedules and Games by Date endpoints.
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:
- NBA v3 Odds
/v3/nba/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: nba_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:
- NBA v3 Odds
/v3/nba/odds/{format}/PreGameOddsByDate/{date}/{sportsbookgroup}:
get:
description: Returns the full-game and non-full-game odds (spread, moneyline,
total) for games in a given week and season. Only returns the most recently
seen odds, not inclusive of line movement. A Sportsbook Group must be specified
as a URL parameter.
operationId: nba_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 grouping.
Examples: G1100'
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:
- NBA v3 Odds
/v3/nba/odds/{format}/PreGameOddsLineMovement/{gameid}/{sportsbookgroup}:
get:
description: Returns the game odds ( for games on a given date. 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: nba_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 NBA game. GameIDs can be found in the Games
API. Valid entries are 12780 or 12781
required: true
schema:
type: string
- name: sportsbookgroup
in: path
description: 'The name of the Sportsbook grouping.
Examples: G1100'
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:
- NBA v3 Odds
/v3/nba/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: nba_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 grouping.
Examples: G1100'
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:
- NBA v3 Odds
/v3/nba/odds/{format}/InGameLineMovement/{gameid}/{sportsbookgroup}:
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. A Sportsbook Group must be specified
as a URL parameter.
operationId: nba_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 NBA game. GameIDs can be found in the Games
API. Valid entries are 12780 or 12781
required: true
schema:
type: string
- name: sportsbookgroup
in: path
description: 'The name of the Sportsbook grouping.
Examples: G1100'
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:
- NBA v3 Odds
/v3/nba/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: nba_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 grouping.
Examples: G1100'
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:
- NBA v3 Odds
/v3/nba/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: nba_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). Valid entries include: 134,
155, etc.'
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 grouping.
Examples: G1100'
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:
- NBA v3 Odds
/v3/nba/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: nba_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). Valid entries include: 14814'
required: true
schema:
type: string
- name: sportsbookgroup
in: path
description: 'The name of the Sportsbook grouping.
Examples: G1100'
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:
- NBA v3 Odds
/v3/nba/odds/{format}/BettingMarketsByEvent/{eventId}/{sportsbookgroup}:
get:
description: Returns the markets and available outcomes for a given BettingEventID.
operationId: nba_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). Valid entries include: 134,
155, etc.'
required: true
schema:
type: string
- name: sportsbookgroup
in: path
description: 'The name of the Sportsbook grouping.
Examples: G1100'
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:
- NBA v3 Odds
/v3/nba/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: nba_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.
Valid entries include: 421, 1041, etc.'
required: true
schema:
type: string
- name: sportsbookgroup
in: path
description: 'The name of the Sportsbook grouping.
Examples: G1100'
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:
- NBA v3 Odds
/v3/nba/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: nba_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 entries include: 406451, 404168, etc.'
required: true
schema:
type: string
- name: sportsbookgroup
in: path
description: 'The name of the Sportsbook grouping.
Examples: G1100'
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:
- NBA v3 Odds
/v3/nba/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: nba_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
Examples: 2020, 2021,
etc'
required: true
schema:
type: string
- name: sportsbookgroup
in: path
description: 'The name of the Sportsbook grouping.
Examples: G1100'
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:
- NBA v3 Odds
/v3/nba/odds/{format}/InGameLineMovementWithResulting/{gameid}/{sportsbookgroup}:
get:
description: 'Returns in-play game odds (spread, moneyline, total) for games
on a given date. 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: nba_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 NBA game. GameIDs can be found in the Games
API. Valid entries are 12780 or 12781
required: true
schema:
type: string
- name: sportsbookgroup
in: path
description: 'The name of the Sportsbook grouping.
Examples: G1100'
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:
- NBA v3 Odds
/v3/nba/odds/{format}/PreGameOddsLineMovementWithResulting/{gameid}/{sportsbookgroup}:
get:
description: 'Returns the game odds ( for games on a given date. 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: nba_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 NBA game. GameIDs can be found in the Games
API. Valid entries are 12780 or 12781
required: true
schema:
type: string
- name: sportsbookgroup
in: path
description: 'The name of the Sportsbook grouping.
Examples: G1100'
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:
- NBA v3 Odds
/v3/nba/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: nba_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 NBA game. GameIDs can be found in the Games
API. Valid entries are 14620, 16905, etc.
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:
- NBA v3 Stats
/v3/nba/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 games, called for all
games on a given date.
operationId: nba_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: 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/BoxScore'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NBA v3 Stats
/v3/nba/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: nba_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: 2015-JUL-31, 2015-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 or 2.'
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:
- NBA v3 Stats
/v3/nba/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: nba_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: 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/PlayerGame'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NBA v3 Stats
/v3/nba/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: nba_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: 2015, 2016.'
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:
- NBA v3 Stats
/v3/nba/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: nba_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: 2015, 2016.
'
required: true
schema:
type: string
- name: team
in: path
description: 'The abbreviation of the requested team.
Examples: MIA, PHI.'
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:
- NBA v3 Stats
/v3/nba/stats/{format}/TeamStatsAllowedByPosition/{season}:
get:
description: For each team, deliveres a season total of statistical records
for their opponents' positions (e.g. all field goals made against this team
by Centers.)
operationId: nba_v3_stats_team_stats_allowed___by_position
summary: Team Stats Allowed - by Position
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: 2015, 2016.'
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:
- NBA v3 Stats
/v3/nba/stats/{format}/AllStars/{season}:
get:
description: A list of players selected for the All-Star Game for a given season.
operationId: nba_v3_stats_all_stars
summary: All-Stars
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: 2015, 2016.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PlayerInfo'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NBA v3 Stats
/v3/nba/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: nba_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:20000571.'
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:
- NBA v3 Stats
/v3/nba/stats/{format}/TeamGameStatsByDateFinal/{date}:
get:
description: Returns the box score statistical record team-wide (aggregated
from all players) for a games on a given date, delivered as each game concludes.
operationId: nba_v3_stats_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: 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/TeamGame'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NBA v3 Stats
/v3/nba/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: nba_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: 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/PlayerGame'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NBA v3 Stats
/v3/nba/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: nba_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 NBA game. GameIDs can be found in the Games
API. Valid entries are 14620, 16905, etc.
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:
- NBA v3 Stats
/v3/nba/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: nba_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: 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/BoxScore'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NBA v3 Stats
/v3/nba/stats/{format}/FantasyGameStatsByDate/{date}:
get:
description: A simple list of fantasy points scored for all players who took
part in games on a given date.
operationId: nba_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: 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/FantasyGame'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NBA v3 Stats
/v3/nba/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: nba_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 NBA game. GameIDs can be found in the Games
API. Valid entries are 14620, 16905, etc.
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:
- NBA v3 Play-by-Play
/v3/nba/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: nba_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: 2016-OCT-31, 2017-JAN-15.'
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:
- NBA v3 Play-by-Play
/v3/nba/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: nba_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 NBA game. GameIDs can be found in the Games
API. Valid entries are 14620, 16905, etc.
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:
- NBA v3 Play-by-Play
/v3/nba/headshots/{format}/Headshots:
get:
description: Headshots
operationId: nba_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:
- NBA 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 unique ID of the team
Key:
type:
- string
- 'null'
description: Abbreviation of the team (e.g. LAL; PHI; BOS; CHI; 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. Lakers, 76ers, Celtics, Bulls,
etc.)
LeagueID:
type:
- integer
- 'null'
description: This is no longer used (deprecated)
StadiumID:
type:
- integer
- 'null'
description: The unique ID of the team's current home stadium
Conference:
type:
- string
- 'null'
description: 'The conference of the team (possible values: Eastern, Western)'
Division:
type:
- string
- 'null'
description: The division of the team (e.g. Atlantic, Central, Southeast,
etc)
PrimaryColor:
type:
- string
- 'null'
description: The team's first color. (This is not licensed for public or
commercial use)
SecondaryColor:
type:
- string
- 'null'
description: The team's second color. (This is not licensed for public or
commercial use)
TertiaryColor:
type:
- string
- 'null'
description: The team's third color. (This is not licensed for public or
commercial use)
QuaternaryColor:
type:
- string
- 'null'
description: The team's fourth 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.
NbaDotComTeamID:
type:
- integer
- 'null'
description: The team's ID on NBAdotCom
HeadCoach:
type:
- string
- 'null'
description: The current head coach of the team
Game:
properties:
GameID:
type: integer
description: The unique ID of this game
Season:
type: integer
description: The NBA 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; 6=Exhibition)
Status:
type:
- string
- 'null'
description: 'Indicates the game''s status. Possible values include: Scheduled,
InProgress, Final, F/OT, Suspended, Postponed, Delayed, 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
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 ID of the away team
HomeTeamID:
type: integer
description: The unique ID of the home team
StadiumID:
type:
- integer
- 'null'
description: The unique ID of the stadium
Channel:
type:
- string
- 'null'
description: The television station broadcasting the game
Attendance:
type:
- integer
- 'null'
description: The total number of people in attendance at the game
AwayTeamScore:
type:
- integer
- 'null'
description: Total number of points the away team scored in the game
HomeTeamScore:
type:
- integer
- 'null'
description: Total number of points the home team scored in this game
Updated:
type:
- string
- 'null'
description: The timestamp of when this game was last updated (in US Eastern
Time)
Quarter:
type:
- string
- 'null'
description: 'The current quarter in the game. Possible values include:
1, 2, 3, 4, Half, OT, NULL'
TimeRemainingMinutes:
type:
- integer
- 'null'
description: The number of minutes remaining in the quarter
TimeRemainingSeconds:
type:
- integer
- 'null'
description: The number of seconds remaining in the quarter
PointSpread:
type:
- number
- 'null'
description: The oddsmaker Point Spread at game start from the perspective
of the HomeTeam (negative numbers indicate the HomeTeam is favored; positive
numbers indicate the AwayTeam is favored)
OverUnder:
type:
- number
- 'null'
description: The sportsbook's total points scored over under for the game
AwayTeamMoneyLine:
type:
- integer
- 'null'
description: Money line from the perspective of the away team
HomeTeamMoneyLine:
type:
- integer
- 'null'
description: Money line from the perspective 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
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 money line payout odds when betting on the away team with
the point spread.
PointSpreadHomeTeamMoneyLine:
type:
- integer
- 'null'
description: The money line payout odds when betting on the away team with
the point spread.
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'
Quarters:
type: array
items:
$ref: '#/components/schemas/Quarter'
description: The details of the quarters (including overtime periods) for
this game.
GameEndDateTime:
type:
- string
- 'null'
description: The date and time that the game ended (in US Eastern Time)
HomeRotationNumber:
type:
- integer
- 'null'
description: The rotation number of the home team for this game
AwayRotationNumber:
type:
- integer
- 'null'
description: The rotation number of the away team for this game
NeutralVenue:
type:
- boolean
- 'null'
description: Indicates whether this game is played in a neutral venue
OverPayout:
type:
- integer
- 'null'
description: The sportsbook's payout for the over on the total points line
UnderPayout:
type:
- integer
- 'null'
description: The sportsbook's payout for the under on the total points line
CrewChiefID:
type:
- integer
- 'null'
description: Unique ID of officiating Crew Chief
UmpireID:
type:
- integer
- 'null'
description: Unique ID of officiating Umpire referee
RefereeID:
type:
- integer
- 'null'
description: Unique ID of officiating referee
AlternateID:
type:
- integer
- 'null'
description: Unique ID of officiating Alternate referee
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 playoff series only - HomeTeamWins,
AwayTeamWins, GameNumber, and MaxLength
InseasonTournament:
type:
- boolean
- 'null'
description: A flag to indicate this game is part of the inseason NBA tournament
(can be considered a part of regular season still) - a null would also
indicate false
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.
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.
Quarter:
properties:
QuarterID:
type: integer
description: Unique identifier for each Quarter.
GameID:
type: integer
description: The unique ID of the game associated with this quarter
Number:
type: integer
description: The Number (Order) of the Quarter in the scope of the Game.
Name:
type:
- string
- 'null'
description: 'The Name of the Quarter (possible values: 1, 2, 3, 4, OT,
OT2, OT3, etc)'
AwayScore:
type:
- integer
- 'null'
description: The total points scored by the away team in the given period
only
HomeScore:
type:
- integer
- 'null'
description: The total points scored by the home team in the given period
only
Series:
properties:
HomeTeamWins:
type: integer
description: Total number of wins by the home team in the series
AwayTeamWins:
type: integer
description: Total wins in the series by the away team
GameNumber:
type: integer
description: The game number in the series
MaxLength:
type: integer
description: The maximum number of games that can be played in a series
News:
properties:
NewsID:
type: integer
description: The unique ID of 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 last updated (in
US Eastern Time)
TimeAgo:
type:
- string
- 'null'
description: How long ago this news story was published
Title:
type:
- string
- 'null'
description: The headline of the news story (typically less than 100 characters)
Content:
type:
- string
- 'null'
description: The full body content of the story
Url:
type:
- string
- 'null'
description: The 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 responsible for writing the news posting
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 entire career'
TeamID:
type:
- integer
- 'null'
description: The unique ID of the team that relates to this story
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team that relates to this news
story
PlayerID2:
type:
- integer
- 'null'
description: The PlayerID of the additional player who relates to this story
(if applicable)
TeamID2:
type:
- integer
- 'null'
description: The unique ID of the additional team that relates to this news
story (if applicable)
Team2:
type:
- string
- 'null'
description: The abbreviation [Key] of the additional team that relates
to this story (if applicable)
OriginalSource:
type:
- string
- 'null'
description: The original source who broke this news (before it was picked
up by the publisher of this blurb)
OriginalSourceUrl:
type:
- string
- 'null'
description: The URL of the original source who broke this news blurb
Stadium:
properties:
StadiumID:
type: integer
description: The unique ID of the stadium
Active:
type: boolean
description: Whether or not this stadium is the home venue for an active
team
Name:
type:
- string
- 'null'
description: The full name of the stadium
Address:
type:
- string
- 'null'
description: The address where the stadium is located
City:
type:
- string
- 'null'
description: The city where the stadium is located
State:
type:
- string
- 'null'
description: 'The US state in which the stadium is located. Note: If the
stadium is outside of the US, this value is NULL'
Zip:
type:
- string
- 'null'
description: The zip code of the stadium
Country:
type:
- string
- 'null'
description: The 2-digit country code where the stadium is located
Capacity:
type:
- integer
- 'null'
description: The estimated seating capacity of the stadium
GeoLat:
type:
- number
- 'null'
description: The geographic latitude coordinate of this venue.
GeoLong:
type:
- number
- 'null'
description: The geographic longitude coordinate of this venue.
TeamGame:
properties:
StatID:
type: integer
description: The unique ID of the stat
TeamID:
type:
- integer
- 'null'
description: The unique ID of the team
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; 6=Exhibition)
Season:
type:
- integer
- 'null'
description: The NBA season of the game
Name:
type:
- string
- 'null'
description: Team's name
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
Wins:
type:
- integer
- 'null'
description: Total number of team wins
Losses:
type:
- integer
- 'null'
description: Total number of team losses
Possessions:
type:
- number
- 'null'
description: Total number of estimated possessions by the team in the game
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
Minutes:
type:
- integer
- 'null'
description: Total number of minutes played
Seconds:
type:
- integer
- 'null'
description: Total number of seconds played
FieldGoalsMade:
type:
- number
- 'null'
description: Total number of field goals made
FieldGoalsAttempted:
type:
- number
- 'null'
description: Total number of field goals attempted
FieldGoalsPercentage:
type:
- number
- 'null'
description: Total field goal percentage
EffectiveFieldGoalsPercentage:
type:
- number
- 'null'
description: Total effective field goals percentage
TwoPointersMade:
type:
- number
- 'null'
description: Total two pointers made
TwoPointersAttempted:
type:
- number
- 'null'
description: Total two pointers attempted
TwoPointersPercentage:
type:
- number
- 'null'
description: Total two pointers percentage
ThreePointersMade:
type:
- number
- 'null'
description: Total three pointers made
ThreePointersAttempted:
type:
- number
- 'null'
description: Total three pointers attempted
ThreePointersPercentage:
type:
- number
- 'null'
description: Total three pointers percentage
FreeThrowsMade:
type:
- number
- 'null'
description: Total free throws made
FreeThrowsAttempted:
type:
- number
- 'null'
description: Total free throws attempted
FreeThrowsPercentage:
type:
- number
- 'null'
description: Total free throws percentage
OffensiveRebounds:
type:
- number
- 'null'
description: Total offensive rebounds
DefensiveRebounds:
type:
- number
- 'null'
description: Total defensive rebounds
Rebounds:
type:
- number
- 'null'
description: Total rebounds
OffensiveReboundsPercentage:
type:
- number
- 'null'
description: Total offensive rebounds percentage
DefensiveReboundsPercentage:
type:
- number
- 'null'
description: Total defensive rebounds percentage
TotalReboundsPercentage:
type:
- number
- 'null'
description: The player/team total rebounds percentage
Assists:
type:
- number
- 'null'
description: Total assists
Steals:
type:
- number
- 'null'
description: Total steals
BlockedShots:
type:
- number
- 'null'
description: Total blocked shots
Turnovers:
type:
- number
- 'null'
description: Total turnovers
PersonalFouls:
type:
- number
- 'null'
description: Total personal fouls
Points:
type:
- number
- 'null'
description: Total points scored
TrueShootingAttempts:
type:
- number
- 'null'
description: 'The player''s true shooting attempts as defined here: http://www.basketball-reference.com/about/glossary.html'
TrueShootingPercentage:
type:
- number
- 'null'
description: 'The player''s true shooting percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
PlayerEfficiencyRating:
type:
- number
- 'null'
description: 'The player''s linear weight efficiency rating as defined here:
http://bleacherreport.com/articles/113144-cracking-the-code-how-to-calculate-hollingers-per-without-all-the-mess'
AssistsPercentage:
type:
- number
- 'null'
description: 'The player''s assist percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
StealsPercentage:
type:
- number
- 'null'
description: 'The player''s steal percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
BlocksPercentage:
type:
- number
- 'null'
description: 'The player''s block percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
TurnOversPercentage:
type:
- number
- 'null'
description: 'The player''s turnover percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
UsageRatePercentage:
type:
- number
- 'null'
description: 'The player''s usage rate percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
FantasyPointsFanDuel:
type:
- number
- 'null'
description: Total FanDuel daily fantasy points scored
FantasyPointsDraftKings:
type:
- number
- 'null'
description: Total DraftKings daily fantasy points scored
FantasyPointsYahoo:
type:
- number
- 'null'
description: Total Yahoo daily fantasy points scored
PlusMinus:
type:
- number
- 'null'
description: Total plus minus
DoubleDoubles:
type:
- number
- 'null'
description: Total double-doubles scored
TripleDoubles:
type:
- number
- 'null'
description: Total triple-doubles scored
FantasyPointsFantasyDraft:
type:
- number
- 'null'
description: Total FantasyDraft daily fantasy points scored
IsClosed:
type: boolean
description: Indicates whether the game is over and the stats for this player
have been verified and closed out.
LineupConfirmed:
type:
- boolean
- 'null'
description: Indicates whether starting lineup is confirmed
LineupStatus:
type:
- string
- 'null'
description: Indicates whether player is starting, active, or inactive
TeamSeason:
properties:
StatID:
type: integer
description: The unique ID of the stat
TeamID:
type:
- integer
- 'null'
description: The unique ID of the team
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; 6=Exhibition).
Season:
type:
- integer
- 'null'
description: The NBA season that these totals apply for
Name:
type:
- string
- 'null'
description: The name of the team
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
Wins:
type:
- integer
- 'null'
description: Total number of team wins on the season
Losses:
type:
- integer
- 'null'
description: Total number of team losses on the season
OpponentPosition:
type:
- string
- 'null'
description: This field is expected to be NULL
Possessions:
type:
- number
- 'null'
description: Total number of estimated possessions by the team in the season
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team. This value is guaranteed
to be unique across all sports/leagues.
OpponentStat:
$ref: '#/components/schemas/OpponentSeason'
description: The aggregated season stats for this team's opponents
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
Minutes:
type:
- integer
- 'null'
description: Total number of minutes played
Seconds:
type:
- integer
- 'null'
description: Total number of seconds played
FieldGoalsMade:
type:
- number
- 'null'
description: Total number of field goals made
FieldGoalsAttempted:
type:
- number
- 'null'
description: Total number of field goals attempted
FieldGoalsPercentage:
type:
- number
- 'null'
description: Total field goal percentage
EffectiveFieldGoalsPercentage:
type:
- number
- 'null'
description: Total effective field goals percentage
TwoPointersMade:
type:
- number
- 'null'
description: Total two pointers made
TwoPointersAttempted:
type:
- number
- 'null'
description: Total two pointers attempted
TwoPointersPercentage:
type:
- number
- 'null'
description: Total two pointers percentage
ThreePointersMade:
type:
- number
- 'null'
description: Total three pointers made
ThreePointersAttempted:
type:
- number
- 'null'
description: Total three pointers attempted
ThreePointersPercentage:
type:
- number
- 'null'
description: Total three pointers percentage
FreeThrowsMade:
type:
- number
- 'null'
description: Total free throws made
FreeThrowsAttempted:
type:
- number
- 'null'
description: Total free throws attempted
FreeThrowsPercentage:
type:
- number
- 'null'
description: Total free throws percentage
OffensiveRebounds:
type:
- number
- 'null'
description: Total offensive rebounds
DefensiveRebounds:
type:
- number
- 'null'
description: Total defensive rebounds
Rebounds:
type:
- number
- 'null'
description: Total rebounds
OffensiveReboundsPercentage:
type:
- number
- 'null'
description: Total offensive rebounds percentage
DefensiveReboundsPercentage:
type:
- number
- 'null'
description: Total defensive rebounds percentage
TotalReboundsPercentage:
type:
- number
- 'null'
description: The player/team total rebounds percentage
Assists:
type:
- number
- 'null'
description: Total assists
Steals:
type:
- number
- 'null'
description: Total steals
BlockedShots:
type:
- number
- 'null'
description: Total blocked shots
Turnovers:
type:
- number
- 'null'
description: Total turnovers
PersonalFouls:
type:
- number
- 'null'
description: Total personal fouls
Points:
type:
- number
- 'null'
description: Total points scored
TrueShootingAttempts:
type:
- number
- 'null'
description: 'The player''s true shooting attempts as defined here: http://www.basketball-reference.com/about/glossary.html'
TrueShootingPercentage:
type:
- number
- 'null'
description: 'The player''s true shooting percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
PlayerEfficiencyRating:
type:
- number
- 'null'
description: 'The player''s linear weight efficiency rating as defined here:
http://bleacherreport.com/articles/113144-cracking-the-code-how-to-calculate-hollingers-per-without-all-the-mess'
AssistsPercentage:
type:
- number
- 'null'
description: 'The player''s assist percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
StealsPercentage:
type:
- number
- 'null'
description: 'The player''s steal percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
BlocksPercentage:
type:
- number
- 'null'
description: 'The player''s block percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
TurnOversPercentage:
type:
- number
- 'null'
description: 'The player''s turnover percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
UsageRatePercentage:
type:
- number
- 'null'
description: 'The player''s usage rate percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
FantasyPointsFanDuel:
type:
- number
- 'null'
description: Total FanDuel daily fantasy points scored
FantasyPointsDraftKings:
type:
- number
- 'null'
description: Total DraftKings daily fantasy points scored
FantasyPointsYahoo:
type:
- number
- 'null'
description: Total Yahoo daily fantasy points scored
PlusMinus:
type:
- number
- 'null'
description: Total plus minus
DoubleDoubles:
type:
- number
- 'null'
description: Total double-doubles scored
TripleDoubles:
type:
- number
- 'null'
description: Total triple-doubles scored
FantasyPointsFantasyDraft:
type:
- number
- 'null'
description: Total FantasyDraft daily fantasy points scored
IsClosed:
type: boolean
description: Indicates whether the game is over and the stats for this player
have been verified and closed out.
LineupConfirmed:
type:
- boolean
- 'null'
description: Indicates whether starting lineup is confirmed
LineupStatus:
type:
- string
- 'null'
description: Indicates whether player is starting, active, or inactive
OpponentSeason:
properties:
StatID:
type: integer
description: The unique ID of the stat
TeamID:
type:
- integer
- 'null'
description: The unique ID of the team
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; 6=Exhibition).
Season:
type:
- integer
- 'null'
description: The NBA season that these totals apply for
Name:
type:
- string
- 'null'
description: The name of the team
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
Wins:
type:
- integer
- 'null'
description: Total number of team wins on the season
Losses:
type:
- integer
- 'null'
description: Total number of team losses on the season
OpponentPosition:
type:
- string
- 'null'
description: This field is expected to be NULL
Possessions:
type:
- number
- 'null'
description: Total number of estimated possessions by the team in the season
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
Minutes:
type:
- integer
- 'null'
description: Total number of minutes played
Seconds:
type:
- integer
- 'null'
description: Total number of seconds played
FieldGoalsMade:
type:
- number
- 'null'
description: Total number of field goals made
FieldGoalsAttempted:
type:
- number
- 'null'
description: Total number of field goals attempted
FieldGoalsPercentage:
type:
- number
- 'null'
description: Total field goal percentage
EffectiveFieldGoalsPercentage:
type:
- number
- 'null'
description: Total effective field goals percentage
TwoPointersMade:
type:
- number
- 'null'
description: Total two pointers made
TwoPointersAttempted:
type:
- number
- 'null'
description: Total two pointers attempted
TwoPointersPercentage:
type:
- number
- 'null'
description: Total two pointers percentage
ThreePointersMade:
type:
- number
- 'null'
description: Total three pointers made
ThreePointersAttempted:
type:
- number
- 'null'
description: Total three pointers attempted
ThreePointersPercentage:
type:
- number
- 'null'
description: Total three pointers percentage
FreeThrowsMade:
type:
- number
- 'null'
description: Total free throws made
FreeThrowsAttempted:
type:
- number
- 'null'
description: Total free throws attempted
FreeThrowsPercentage:
type:
- number
- 'null'
description: Total free throws percentage
OffensiveRebounds:
type:
- number
- 'null'
description: Total offensive rebounds
DefensiveRebounds:
type:
- number
- 'null'
description: Total defensive rebounds
Rebounds:
type:
- number
- 'null'
description: Total rebounds
OffensiveReboundsPercentage:
type:
- number
- 'null'
description: Total offensive rebounds percentage
DefensiveReboundsPercentage:
type:
- number
- 'null'
description: Total defensive rebounds percentage
TotalReboundsPercentage:
type:
- number
- 'null'
description: The player/team total rebounds percentage
Assists:
type:
- number
- 'null'
description: Total assists
Steals:
type:
- number
- 'null'
description: Total steals
BlockedShots:
type:
- number
- 'null'
description: Total blocked shots
Turnovers:
type:
- number
- 'null'
description: Total turnovers
PersonalFouls:
type:
- number
- 'null'
description: Total personal fouls
Points:
type:
- number
- 'null'
description: Total points scored
TrueShootingAttempts:
type:
- number
- 'null'
description: 'The player''s true shooting attempts as defined here: http://www.basketball-reference.com/about/glossary.html'
TrueShootingPercentage:
type:
- number
- 'null'
description: 'The player''s true shooting percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
PlayerEfficiencyRating:
type:
- number
- 'null'
description: 'The player''s linear weight efficiency rating as defined here:
http://bleacherreport.com/articles/113144-cracking-the-code-how-to-calculate-hollingers-per-without-all-the-mess'
AssistsPercentage:
type:
- number
- 'null'
description: 'The player''s assist percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
StealsPercentage:
type:
- number
- 'null'
description: 'The player''s steal percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
BlocksPercentage:
type:
- number
- 'null'
description: 'The player''s block percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
TurnOversPercentage:
type:
- number
- 'null'
description: 'The player''s turnover percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
UsageRatePercentage:
type:
- number
- 'null'
description: 'The player''s usage rate percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
FantasyPointsFanDuel:
type:
- number
- 'null'
description: Total FanDuel daily fantasy points scored
FantasyPointsDraftKings:
type:
- number
- 'null'
description: Total DraftKings daily fantasy points scored
FantasyPointsYahoo:
type:
- number
- 'null'
description: Total Yahoo daily fantasy points scored
PlusMinus:
type:
- number
- 'null'
description: Total plus minus
DoubleDoubles:
type:
- number
- 'null'
description: Total double-doubles scored
TripleDoubles:
type:
- number
- 'null'
description: Total triple-doubles scored
FantasyPointsFantasyDraft:
type:
- number
- 'null'
description: Total FantasyDraft daily fantasy points scored
IsClosed:
type: boolean
description: Indicates whether the game is over and the stats for this player
have been verified and closed out.
LineupConfirmed:
type:
- boolean
- 'null'
description: Indicates whether starting lineup is confirmed
LineupStatus:
type:
- string
- 'null'
description: Indicates whether player is starting, active, or inactive
Season:
properties:
Season:
type: integer
description: The NBA season that these totals apply for
StartYear:
type: integer
description: The year in which the season started
EndYear:
type: integer
description: The year in which the season ended
Description:
type:
- string
- 'null'
description: 'The description of the season for display purposes (possible
values include: 2017-18, 2018-19, etc)'
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; 6=Exhibition).
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 NBA season that these totals apply for
SeasonType:
type: integer
description: The type of season that this record corresponds to (1=Regular
Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=AllStar; 6=Exhibition).
TeamID:
type: integer
description: The unique ID for the team
Key:
type:
- string
- 'null'
description: The key (short team name) of the team
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 team's full name
Conference:
type:
- string
- 'null'
description: The conference of the team (can either be Eastern or Western)
Division:
type:
- string
- 'null'
description: The division of the team (e.g. Atlantic, Central, Southeast,
etc.)
Wins:
type:
- integer
- 'null'
description: Total wins by the team
Losses:
type:
- integer
- 'null'
description: Total losses by the team
Percentage:
type:
- number
- 'null'
description: The team's winning percentage
ConferenceWins:
type:
- integer
- 'null'
description: Total conference wins
ConferenceLosses:
type:
- integer
- 'null'
description: Total conference losses
DivisionWins:
type:
- integer
- 'null'
description: Total number of division wins
DivisionLosses:
type:
- integer
- 'null'
description: Total number of division losses
HomeWins:
type:
- integer
- 'null'
description: Total number of home game wins
HomeLosses:
type:
- integer
- 'null'
description: Total number of home game losses
AwayWins:
type:
- integer
- 'null'
description: Total number of away game wins
AwayLosses:
type:
- integer
- 'null'
description: Total number of away game losses
LastTenWins:
type:
- integer
- 'null'
description: Total wins in the last 10 games
LastTenLosses:
type:
- integer
- 'null'
description: Total losses in the last 10 games
PointsPerGameFor:
type:
- number
- 'null'
description: Average points scored by the team per game
PointsPerGameAgainst:
type:
- number
- 'null'
description: Average points scored against the team per game
Streak:
type:
- integer
- 'null'
description: Total games that the streak (winning or losing) has lasted
GamesBack:
type:
- number
- 'null'
description: Total number of games behind the top ranked team for a given
team
StreakDescription:
type:
- string
- 'null'
description: The winning or losing streak written in the form W5 or L1
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team. This value is guaranteed
to be unique across all sports/leagues.
ConferenceRank:
type:
- integer
- 'null'
description: Team rank at the conference level
DivisionRank:
type:
- integer
- 'null'
description: Team rank at the division level
ClinchedDivision:
type:
- boolean
- 'null'
description: Returns TRUE if a team has clinched their division; FALSE if
not
ClinchedPlayoffBerth:
type:
- boolean
- 'null'
description: Returns TRUE if a team has clinched a playoff spot; FALSE if
not
WonPlayInTournament:
type:
- boolean
- 'null'
description: Returns TRUE if a team has clinched a playoff spot through
the play-in; FALSE if not
ClinchedPlayInTournamentBerth:
type:
- boolean
- 'null'
description: Returns TRUE if a team has clinched a spot in the play-in;
FALSE if not
EliminatedFromPlayoffContention:
type:
- boolean
- 'null'
description: Returns TRUE if a team has been eliminated from playoff contention;
FALSE if not
ClinchedConference:
type:
- boolean
- 'null'
description: Returns TRUE if a team has clinched their conference; FALSE
if not
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 entire career'
SportsDataID:
type:
- string
- 'null'
description: Deprecated. Use SportRadarPlayerID instead.
Status:
type:
- string
- 'null'
description: 'Indicates the player''s status of being on an active roster.
Possible values include: Active, Inactive'
TeamID:
type:
- integer
- 'null'
description: The unique ID of the player's team
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the player's team
Jersey:
type:
- integer
- 'null'
description: The player's jersey number.
PositionCategory:
type:
- string
- 'null'
description: 'The player''s position category. Possible values: C, F, G'
Position:
type:
- string
- 'null'
description: 'The player''s primary position. Possible values: PG; SG; SF;
PF; C'
FirstName:
type:
- string
- 'null'
description: The player's first name.
LastName:
type:
- string
- 'null'
description: The player's last name.
Height:
type:
- integer
- 'null'
description: The player's height in inches.
Weight:
type:
- integer
- 'null'
description: The player's weight 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.
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.
College:
type:
- string
- 'null'
description: The college that the player attended.
Salary:
type:
- integer
- 'null'
description: Deprecated (do not use)
PhotoUrl:
type:
- string
- 'null'
description: This field is deprecated. Photos are no longer available through
it. Headshots are now delivered through IMAGN. Please see our Headshots
products for further information.
Experience:
type:
- integer
- 'null'
description: The number of years experience the player has in the NBA.
SportRadarPlayerID:
type:
- string
- 'null'
description: The player's cross reference PlayerID to the SportRadar API.
RotoworldPlayerID:
type:
- integer
- 'null'
description: The player's cross reference PlayerID to the Rotoworld news
feed.
RotoWirePlayerID:
type:
- integer
- 'null'
description: The player's cross reference PlayerID to the RotoWire news
feed.
FantasyAlarmPlayerID:
type:
- integer
- 'null'
description: The player's cross reference PlayerID to the FantasyAlarm news
feed.
StatsPlayerID:
type:
- integer
- 'null'
description: The player's cross reference PlayerID to the STATS data feeds.
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 cross reference PlayerID to the XML Team data
feeds.
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: The body part that is injured (Knee, Groin, Calf, Hamstring,
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 cross reference PlayerID to FanDuel.
DraftKingsPlayerID:
type:
- integer
- 'null'
description: The player's cross reference PlayerID to DraftKings.
YahooPlayerID:
type:
- integer
- 'null'
description: The player's cross reference PlayerID to Yahoo Daily Fantasy
Sports Contests.
FanDuelName:
type:
- string
- 'null'
description: The player's full name in FanDuel's daily fantasy sports platform.
DraftKingsName:
type:
- string
- 'null'
description: The player's full name in DraftKings' daily fantasy sports
platform.
YahooName:
type:
- string
- 'null'
description: The player's full name in Yahoo's daily fantasy sports platform.
DepthChartPosition:
type:
- string
- 'null'
description: The position of the player on the depth chart.
DepthChartOrder:
type:
- integer
- 'null'
description: The order of the player on the depth chart.
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 full name in FantasyDraft's daily fantasy sports
platform.
FantasyDraftPlayerID:
type:
- integer
- 'null'
description: The player's cross reference PlayerID to Fantasy Draft.
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.
NbaDotComPlayerID:
type:
- integer
- 'null'
description: The player's personID on nba dot com
Referee:
properties:
RefereeID:
type: integer
description: Unique ID of Referee
Name:
type:
- string
- 'null'
description: The referee's full name
Number:
type:
- integer
- 'null'
description: The number of the referee
Position:
type:
- string
- 'null'
description: The position of the referee in the crew
College:
type:
- string
- 'null'
description: The college of the referee
Experience:
type:
- integer
- 'null'
description: The number of years of experience the referee has in the NBA
TeamDepthChart:
properties:
DepthCharts:
type: array
items:
$ref: '#/components/schemas/DepthChart'
description: List of Depth Chart Records for Team
TeamID:
type: integer
description: The unique ID of the team
DepthChart:
properties:
TeamID:
type: integer
description: The unique ID of the team
PlayerID:
type:
- integer
- 'null'
description: 'The player''s unique PlayerID as assigned by SportsDataIO.
Note: this ID will stay with the player throughout their entire career'
Name:
type:
- string
- 'null'
description: The player's full name
PositionCategory:
type:
- string
- 'null'
description: 'The player''s position category. Possible values: C; F; G'
Position:
type:
- string
- 'null'
description: 'The player''s primary position. Possible values: C; PF; PG;
SF; SG'
DepthOrder:
type:
- integer
- 'null'
description: Depth Chart Order
Updated:
type:
- string
- 'null'
description: The date and time that this depth chart was last updated (in
US Eastern Time)
DepthChartID:
type: integer
description: Unique ID of Depth Chart Record
ScheduleBasic:
properties:
GameID:
type: integer
description: The unique ID of this game
Season:
type: integer
description: The NBA 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; 6=Exhibition).
Status:
type:
- string
- 'null'
description: 'Indicates the game''s status. Possible values include: Scheduled,
InProgress, Final, F/OT, Suspended, Postponed, Delayed, Canceled, Forfeit,
NotNecessary'
Day:
type:
- string
- 'null'
description: The day of the game
DateTime:
type:
- string
- 'null'
description: The date and time 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
AwayTeamID:
type: integer
description: The unique ID of the away team
HomeTeamID:
type: integer
description: The unique ID of the home team
StadiumID:
type:
- integer
- 'null'
description: The unique ID of the stadium
AwayTeamScore:
type:
- integer
- 'null'
description: Total number of points the away team scored in the game
HomeTeamScore:
type:
- integer
- 'null'
description: Total number of points the home team scored in this game
Updated:
type:
- string
- 'null'
description: The timestamp of when the record was last updated (US Eastern
Time).
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.
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'
NeutralVenue:
type:
- boolean
- 'null'
description: Indicates whether this game is played in a neutral venue or
not
DateTimeUTC:
type:
- string
- 'null'
description: The date and time of the game in UTC
GameEndDateTIme:
type:
- string
- 'null'
description: The date and time that the game ended in US Eastern Time
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.
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.
ScoreBasic:
properties:
GameEndDateTime:
type:
- string
- 'null'
description: The date and time that the game ended in US Eastern Time
SeriesInfo:
$ref: '#/components/schemas/Series'
description: Contains relevant series data for playoff series only - HomeTeamWins,
AwayTeamWins, GameNumber, and MaxLength
AwayTeamScore2:
type:
- integer
- 'null'
description: Total number of points the away team scored in the game
HomeTeamScore2:
type:
- integer
- 'null'
description: Total number of points the home team scored in this game
GameID:
type: integer
description: The unique ID of this game
Season:
type: integer
description: The NBA 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; 6=Exhibition).
Status:
type:
- string
- 'null'
description: 'Indicates the game''s status. Possible values include: Scheduled,
InProgress, Final, F/OT, Suspended, Postponed, Delayed, Canceled, Forfeit,
NotNecessary'
Day:
type:
- string
- 'null'
description: The day of the game
DateTime:
type:
- string
- 'null'
description: The date and time 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
AwayTeamID:
type: integer
description: The unique ID of the away team
HomeTeamID:
type: integer
description: The unique ID of the home team
StadiumID:
type:
- integer
- 'null'
description: The unique ID of the stadium
AwayTeamScore:
type:
- integer
- 'null'
description: Total number of points the away team scored in the game
HomeTeamScore:
type:
- integer
- 'null'
description: Total number of points the home team scored in this game
Updated:
type:
- string
- 'null'
description: The timestamp of when the record was last updated (US Eastern
Time).
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.
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'
NeutralVenue:
type:
- boolean
- 'null'
description: Indicates whether this game is played in a neutral venue or
not
DateTimeUTC:
type:
- string
- 'null'
description: The date and time of the game in UTC
GameEndDateTIme:
type:
- string
- 'null'
description: The date and time that the game ended in US Eastern Time
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.
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.
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 entire career'
SportsDataID:
type:
- string
- 'null'
description: Deprecated. Use SportRadarPlayerID instead.
Status:
type:
- string
- 'null'
description: 'Indicates the player''s status of being on an active roster.
Possible values include: Active, Inactive'
TeamID:
type:
- integer
- 'null'
description: The unique ID of the player's team
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the player's team
Jersey:
type:
- integer
- 'null'
description: The player's jersey number.
PositionCategory:
type:
- string
- 'null'
description: 'The player''s position category. Possible values: C, F, G'
Position:
type:
- string
- 'null'
description: 'The player''s primary position. Possible values: PG; SG; SF;
PF; C'
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.
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.
Height:
type:
- integer
- 'null'
description: The player's height in inches.
Weight:
type:
- integer
- 'null'
description: The player's weight in pounds (lbs).
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 entire career'
Name:
type:
- string
- 'null'
description: The player's full name
FormerTeamID:
type:
- integer
- 'null'
description: The unique ID of the player's former team
FormerTeam:
type:
- string
- 'null'
description: The abbreviation [Key] of the player's former team
TeamID:
type:
- integer
- 'null'
description: The unique ID of the team
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the player's team
Type:
type:
- string
- 'null'
description: 'The type of transaction that occurred for a player. Transaction
types can be: Released; Waived; Signed; Promoted; Elevated; Demoted; and
Traded.'
Date:
type:
- string
- 'null'
description: The date this transaction was created
Note:
type:
- string
- 'null'
description: A short summary of the transaction that occurred (e.g. "Harris
has signed with the Pelicans.")
Created:
type:
- string
- 'null'
description: The date and time this transaction took place
Updated:
type:
- string
- 'null'
description: The date and time that this transaction was last updated (US
Eastern Time)
PlayerGameProjection:
properties:
StatID:
type: integer
description: The unique ID of the stat
TeamID:
type:
- integer
- 'null'
description: The unique ID of the team
PlayerID:
type:
- integer
- 'null'
description: 'The player''s unique PlayerID as assigned by SportsDataIO.
Note: this ID will stay with the player throughout their entire 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; 6=Exhibition)
Season:
type:
- integer
- 'null'
description: The NBA season of the game
Name:
type:
- string
- 'null'
description: The name of the player
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the player's team
Position:
type:
- string
- 'null'
description: 'The player''s position associated with the given game or season.
Possible values: C, F, FC, G, GF, PF, PG, SF, SG'
Started:
type:
- integer
- 'null'
description: 'Indicates whether or not the player started the game Note:
this will be one or zero for single game feeds'
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: The body part that is injured (Knee, Groin, Calf, Hamstring,
etc.)
InjuryStartDate:
type:
- string
- 'null'
description: The day that the injury started or was 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's daily fantasy contests.
FantasyDraftPosition:
type:
- string
- 'null'
description: The player's eligible position in Fantasy Draft's 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
Minutes:
type:
- integer
- 'null'
description: Total number of minutes played
Seconds:
type:
- integer
- 'null'
description: Total number of seconds played
FieldGoalsMade:
type:
- number
- 'null'
description: Total number of field goals made
FieldGoalsAttempted:
type:
- number
- 'null'
description: Total number of field goals attempted
FieldGoalsPercentage:
type:
- number
- 'null'
description: Total field goal percentage
EffectiveFieldGoalsPercentage:
type:
- number
- 'null'
description: Total effective field goals percentage
TwoPointersMade:
type:
- number
- 'null'
description: Total two pointers made
TwoPointersAttempted:
type:
- number
- 'null'
description: Total two pointers attempted
TwoPointersPercentage:
type:
- number
- 'null'
description: Total two pointers percentage
ThreePointersMade:
type:
- number
- 'null'
description: Total three pointers made
ThreePointersAttempted:
type:
- number
- 'null'
description: Total three pointers attempted
ThreePointersPercentage:
type:
- number
- 'null'
description: Total three pointers percentage
FreeThrowsMade:
type:
- number
- 'null'
description: Total free throws made
FreeThrowsAttempted:
type:
- number
- 'null'
description: Total free throws attempted
FreeThrowsPercentage:
type:
- number
- 'null'
description: Total free throws percentage
OffensiveRebounds:
type:
- number
- 'null'
description: Total offensive rebounds
DefensiveRebounds:
type:
- number
- 'null'
description: Total defensive rebounds
Rebounds:
type:
- number
- 'null'
description: Total rebounds
OffensiveReboundsPercentage:
type:
- number
- 'null'
description: Total offensive rebounds percentage
DefensiveReboundsPercentage:
type:
- number
- 'null'
description: Total defensive rebounds percentage
TotalReboundsPercentage:
type:
- number
- 'null'
description: The player/team total rebounds percentage
Assists:
type:
- number
- 'null'
description: Total assists
Steals:
type:
- number
- 'null'
description: Total steals
BlockedShots:
type:
- number
- 'null'
description: Total blocked shots
Turnovers:
type:
- number
- 'null'
description: Total turnovers
PersonalFouls:
type:
- number
- 'null'
description: Total personal fouls
Points:
type:
- number
- 'null'
description: Total points scored
TrueShootingAttempts:
type:
- number
- 'null'
description: 'The player''s true shooting attempts as defined here: http://www.basketball-reference.com/about/glossary.html'
TrueShootingPercentage:
type:
- number
- 'null'
description: 'The player''s true shooting percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
PlayerEfficiencyRating:
type:
- number
- 'null'
description: 'The player''s linear weight efficiency rating as defined here:
http://bleacherreport.com/articles/113144-cracking-the-code-how-to-calculate-hollingers-per-without-all-the-mess'
AssistsPercentage:
type:
- number
- 'null'
description: 'The player''s assist percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
StealsPercentage:
type:
- number
- 'null'
description: 'The player''s steal percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
BlocksPercentage:
type:
- number
- 'null'
description: 'The player''s block percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
TurnOversPercentage:
type:
- number
- 'null'
description: 'The player''s turnover percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
UsageRatePercentage:
type:
- number
- 'null'
description: 'The player''s usage rate percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
FantasyPointsFanDuel:
type:
- number
- 'null'
description: Total FanDuel daily fantasy points scored
FantasyPointsDraftKings:
type:
- number
- 'null'
description: Total DraftKings daily fantasy points scored
FantasyPointsYahoo:
type:
- number
- 'null'
description: Total Yahoo daily fantasy points scored
PlusMinus:
type:
- number
- 'null'
description: Total plus minus
DoubleDoubles:
type:
- number
- 'null'
description: Total double-doubles scored
TripleDoubles:
type:
- number
- 'null'
description: Total triple-doubles scored
FantasyPointsFantasyDraft:
type:
- number
- 'null'
description: Total FantasyDraft daily fantasy points scored
IsClosed:
type: boolean
description: Indicates whether the game is over and the stats for this player
have been verified and closed out.
LineupConfirmed:
type:
- boolean
- 'null'
description: Indicates whether starting lineup is confirmed
LineupStatus:
type:
- string
- 'null'
description: Indicates whether player is starting, active, or inactive
DfsSlate:
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).
NumberOfGames:
type:
- integer
- 'null'
description: The number of actual games that this slate covers.
IsMultiDaySlate:
type:
- boolean
- 'null'
description: Whether this slate uses games that take place on different
days.
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. 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: Unique ID of a SlateGame (assigned by SportsDataIO).
SlateID:
type: integer
description: The SlateID that this SlateGame refers to.
GameID:
type:
- integer
- 'null'
description: The unique ID of the game associated with this SlateGame. This
points to data in the schedule/game/box score feeds.
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 entire 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). 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 player's team
TeamID:
type:
- integer
- 'null'
description: The unique ID of the player's team
PlayerSeasonProjection:
properties:
StatID:
type: integer
description: The unique ID of the stat
TeamID:
type:
- integer
- 'null'
description: The unique ID of the player's team
PlayerID:
type:
- integer
- 'null'
description: 'The player''s unique PlayerID as assigned by SportsDataIO.
Note: this ID will stay with the player throughout their entire 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; 6=Exhibition).
Season:
type:
- integer
- 'null'
description: The NBA season in which these totals apply
Name:
type:
- string
- 'null'
description: The name of the player
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the player's team
Position:
type:
- string
- 'null'
description: 'The player''s position associated with the given game or season.
Possible values: PG; SG; SF; PF; C'
Started:
type:
- integer
- 'null'
description: Indicates how many games the player has started in the season
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
Minutes:
type:
- integer
- 'null'
description: Total number of minutes played
Seconds:
type:
- integer
- 'null'
description: Total number of seconds played
FieldGoalsMade:
type:
- number
- 'null'
description: Total number of field goals made
FieldGoalsAttempted:
type:
- number
- 'null'
description: Total number of field goals attempted
FieldGoalsPercentage:
type:
- number
- 'null'
description: Total field goal percentage
EffectiveFieldGoalsPercentage:
type:
- number
- 'null'
description: Total effective field goals percentage
TwoPointersMade:
type:
- number
- 'null'
description: Total two pointers made
TwoPointersAttempted:
type:
- number
- 'null'
description: Total two pointers attempted
TwoPointersPercentage:
type:
- number
- 'null'
description: Total two pointers percentage
ThreePointersMade:
type:
- number
- 'null'
description: Total three pointers made
ThreePointersAttempted:
type:
- number
- 'null'
description: Total three pointers attempted
ThreePointersPercentage:
type:
- number
- 'null'
description: Total three pointers percentage
FreeThrowsMade:
type:
- number
- 'null'
description: Total free throws made
FreeThrowsAttempted:
type:
- number
- 'null'
description: Total free throws attempted
FreeThrowsPercentage:
type:
- number
- 'null'
description: Total free throws percentage
OffensiveRebounds:
type:
- number
- 'null'
description: Total offensive rebounds
DefensiveRebounds:
type:
- number
- 'null'
description: Total defensive rebounds
Rebounds:
type:
- number
- 'null'
description: Total rebounds
OffensiveReboundsPercentage:
type:
- number
- 'null'
description: Total offensive rebounds percentage
DefensiveReboundsPercentage:
type:
- number
- 'null'
description: Total defensive rebounds percentage
TotalReboundsPercentage:
type:
- number
- 'null'
description: The player/team total rebounds percentage
Assists:
type:
- number
- 'null'
description: Total assists
Steals:
type:
- number
- 'null'
description: Total steals
BlockedShots:
type:
- number
- 'null'
description: Total blocked shots
Turnovers:
type:
- number
- 'null'
description: Total turnovers
PersonalFouls:
type:
- number
- 'null'
description: Total personal fouls
Points:
type:
- number
- 'null'
description: Total points scored
TrueShootingAttempts:
type:
- number
- 'null'
description: 'The player''s true shooting attempts as defined here: http://www.basketball-reference.com/about/glossary.html'
TrueShootingPercentage:
type:
- number
- 'null'
description: 'The player''s true shooting percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
PlayerEfficiencyRating:
type:
- number
- 'null'
description: 'The player''s linear weight efficiency rating as defined here:
http://bleacherreport.com/articles/113144-cracking-the-code-how-to-calculate-hollingers-per-without-all-the-mess'
AssistsPercentage:
type:
- number
- 'null'
description: 'The player''s assist percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
StealsPercentage:
type:
- number
- 'null'
description: 'The player''s steal percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
BlocksPercentage:
type:
- number
- 'null'
description: 'The player''s block percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
TurnOversPercentage:
type:
- number
- 'null'
description: 'The player''s turnover percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
UsageRatePercentage:
type:
- number
- 'null'
description: 'The player''s usage rate percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
FantasyPointsFanDuel:
type:
- number
- 'null'
description: Total FanDuel daily fantasy points scored
FantasyPointsDraftKings:
type:
- number
- 'null'
description: Total DraftKings daily fantasy points scored
FantasyPointsYahoo:
type:
- number
- 'null'
description: Total Yahoo daily fantasy points scored
PlusMinus:
type:
- number
- 'null'
description: Total plus minus
DoubleDoubles:
type:
- number
- 'null'
description: Total double-doubles scored
TripleDoubles:
type:
- number
- 'null'
description: Total triple-doubles scored
FantasyPointsFantasyDraft:
type:
- number
- 'null'
description: Total FantasyDraft daily fantasy points scored
IsClosed:
type: boolean
description: Indicates whether the game is over and the stats for this player
have been verified and closed out.
LineupConfirmed:
type:
- boolean
- 'null'
description: Indicates whether starting lineup is confirmed
LineupStatus:
type:
- string
- 'null'
description: Indicates whether player is starting, active, or inactive
StartingLineups:
properties:
GameID:
type: integer
description: The unique ID of the game associated with this lineup
Season:
type: integer
description: The NBA season of the game that the lineups is associated with
SeasonType:
type: integer
description: The type of season that this record corresponds to (1=Regular
Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=AllStar; 6=Exhibition).
Day:
type:
- string
- 'null'
description: The day of the game
DateTime:
type:
- string
- 'null'
description: Date and Time of Game
Status:
type:
- string
- 'null'
description: 'Indicates the game''s status. Possible values include: Scheduled;
InProgress; Final; F/OT; Suspended; Postponed; Delayed; Canceled; Forfeit'
HomeTeamID:
type:
- integer
- 'null'
description: The unique ID of the home team
HomeTeam:
type:
- string
- 'null'
description: The abbreviation [Key] of the home team
AwayTeamID:
type:
- integer
- 'null'
description: Unique ID of Away Team
AwayTeam:
type:
- string
- 'null'
description: The abbreviation [Key] of the away team
HomeLineup:
type: array
items:
$ref: '#/components/schemas/Lineup'
description: The lineup (starters and bench players) of the home team in
a given game
AwayLineup:
type: array
items:
$ref: '#/components/schemas/Lineup'
description: The lineup (starters and bench players) of the away team in
a given 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 entire career'
TeamID:
type: integer
description: The unique ID of the team
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
Position:
type:
- string
- 'null'
description: 'The player''s primary position. Possible values: C; PF; PG;
SF; SG'
Starting:
type:
- boolean
- 'null'
description: Indicates whether this player is in the starting lineup or
on the bench
Confirmed:
type:
- boolean
- 'null'
description: Indicated whether the 'Starting' field has been confirmed for
a player
LineupStatus:
type:
- string
- 'null'
description: Indicates whether player is starting, active, or inactive
GameInfo:
properties:
GameId:
type: integer
description: The unique ID of the game.
Season:
type: integer
description: The NBA 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; 6=Exhibition)
Day:
type:
- string
- 'null'
description: The day of the game
DateTime:
type:
- string
- 'null'
description: The date and time of the game
Status:
type:
- string
- 'null'
description: 'Indicates the game''s status. Possible values include: Scheduled,
InProgress, Final, F/OT, Suspended, Postponed, Delayed, Canceled, Forfeit'
AwayTeamId:
type:
- integer
- 'null'
description: The unique ID 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: The rotation number of the home team for this game
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: List of Live GameOdds from different sportsbooks
HomeTeamScore:
type:
- integer
- 'null'
description: Total points scored by the home team in the game (updated after
the game ends to allow for resolving bets)
AwayTeamScore:
type:
- integer
- 'null'
description: Total number of points the away team scored in the game (updated
after game ends to allow for resolving bets)
TotalScore:
type:
- integer
- 'null'
description: The total amount of points scored in the game by both teams.
Updated after the game ends to allow for resulting bets
HomeRotationNumber:
type:
- integer
- 'null'
description: The Rotation number of the home team for this game
AwayRotationNumber:
type:
- integer
- 'null'
description: The rotation number of the away team for this game
AlternateMarketPregameOdds:
type: array
items:
$ref: '#/components/schemas/GameOdd'
description: A list of Alternate Market Pregame GameOdds from different
sportsbooks (such as 1st-half; 1st-qtr; etc)
GameOdd:
properties:
GameOddId:
type: integer
description: The unique ID of this odd
Sportsbook:
type:
- string
- 'null'
description: Name of sportsbook
GameId:
type: integer
description: The unique ID of the game associated with this GameOdd
Created:
type:
- string
- 'null'
description: The timestamp of when these odds were first created (in US
Eastern Time)
Updated:
type:
- string
- 'null'
description: The timestamp of when these odds were last updated (US Eastern
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 money line for the home team
AwayMoneyLine:
type:
- integer
- 'null'
description: The sportsbook's money line for the away team
HomePointSpread:
type:
- number
- 'null'
description: The sportsbook's point spread for the home team
AwayPointSpread:
type:
- number
- 'null'
description: The sportsbook's point spread for the away team
HomePointSpreadPayout:
type:
- integer
- 'null'
description: The sportsbook's point spread payout for the home team
AwayPointSpreadPayout:
type:
- integer
- 'null'
description: The sportsbook's point spread payout for the away team
OverUnder:
type:
- number
- 'null'
description: The sportsbook's total points scored over under for the game
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
OddType:
type:
- string
- 'null'
description: 'The market type of the odd (ex: live, pregame, 1st-half, 2nd-quarter)'
SportsbookUrl:
type:
- string
- 'null'
description: The URL for sportsbook event
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)
BettingEvent:
properties:
BettingEventID:
type: integer
description: The unique ID associated with the betting event
Name:
type:
- string
- 'null'
description: The name of this betting event
Season:
type:
- integer
- 'null'
description: The NBA season of the BettingEvent
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 sportsbook has an event or market
set to start 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 timestamp of the last time this betting event was updated
(in US Eastern Time)
GameID:
type:
- integer
- 'null'
description: The unique ID of the game associated with this BettingEvent
GlobalGameID:
type:
- integer
- 'null'
description: The GlobalGameID of the game tied to this event
GameStatus:
type:
- string
- 'null'
description: The status of the game in tied to this event
Quarter:
type:
- string
- 'null'
description: 'The current quarter in the game tied to this betting event.
Possible values include: 1; 2; 3; 4; Half; OT; NULL'
AwayTeam:
type:
- string
- 'null'
description: The abbreviation [Key] of the away team tied to the event
HomeTeam:
type:
- string
- 'null'
description: The abbreviation [Key] of the home team
AwayTeamID:
type:
- integer
- 'null'
description: The unique ID of the away team tied to the event
HomeTeamID:
type:
- integer
- 'null'
description: The unique ID of the home team tied to the event
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
AwayTeamScore:
type:
- integer
- 'null'
description: Total number of points the away team scored in the game tied
to the event (post-game)
HomeTeamScore:
type:
- integer
- 'null'
description: Total points scored by the home team in the game (post-game)
TotalScore:
type:
- integer
- 'null'
description: The total amount of points scored in the game by both teams.
Updated after the game ends to allow for resulting bets
AwayRotationNumber:
type:
- integer
- 'null'
description: 'Rotation number of away team for this event Note: if the betting
event is a future this field will be NULL'
HomeRotationNumber:
type:
- integer
- 'null'
description: 'The rotation number of the home team for this event Note:
If betting event is a future this field will be NULL'
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 that the game started (in US Eastern Time)
BettingMarket:
properties:
BettingMarketID:
type: integer
description: The unique ID associated with the betting market
BettingEventID:
type: integer
description: The unique ID associated with the betting event
BettingMarketTypeID:
type:
- integer
- 'null'
description: Unique ID that distinguishes the different types of Market
Types
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 Points,
Moneyline, Spread, etc.)
BettingPeriodTypeID:
type:
- integer
- 'null'
description: The BettingPeriodTypeID of this type of market which we can
result
BettingPeriodType:
type:
- string
- 'null'
description: The name of the period type of this market (e.g. Full Game;
1st Half; 2nd Quarter; Regular Season)
Name:
type:
- string
- 'null'
description: The generic name of this market
TeamID:
type:
- integer
- 'null'
description: The unique ID of the team tied to this market (if applicable)
TeamKey:
type:
- string
- 'null'
description: The abbreviation [Key] of the team associated with this market
(if applicable)
PlayerID:
type:
- integer
- 'null'
description: 'The player''s unique PlayerID as assigned by SportsDataIO.
Note: this ID will stay with the player throughout their entire career'
PlayerName:
type:
- string
- 'null'
description: The name of the player tied to this market (if applicable)
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 timestamp of the last time this betting market was updated
(in US Eastern Time)
AvailableSportsbooks:
type: array
items:
$ref: '#/components/schemas/Sportsbook'
description: A list of sportsbooks that have odds available in a given 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
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 empty string
Sportsbook:
properties:
SportsbookID:
type: integer
description: The unique identifier of the sportsbook
Name:
type:
- string
- 'null'
description: The name of the sportsbooks
BettingOutcome:
properties:
BettingOutcomeID:
type:
- integer
- 'null'
description: The unique ID associated with this specific outcome
BettingMarketID:
type:
- integer
- 'null'
description: The unique ID associated with the betting market
SportsBook:
$ref: '#/components/schemas/Sportsbook'
description: The sportsbook offering this outcome for betting
BettingOutcomeTypeID:
type:
- integer
- 'null'
description: The BettingOutcomeTypeID of this outcome
BettingOutcomeType:
type:
- string
- 'null'
description: The name of outcome type (e.g. Home; Away; Under; Over)
PayoutAmerican:
type:
- integer
- 'null'
description: 'The american odds payout '
PayoutDecimal:
type:
- number
- 'null'
description: The decimal odds payout
Value:
type:
- number
- 'null'
description: The number associated with the outcome of a market (e.g. the
spread, 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
IsAlternate:
type:
- boolean
- 'null'
description: Is this an alternate value or the core value
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 timestamp of the last time this betting outcome was updated
(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 unique ID of the team tied to this outcome (if applicable)
PlayerID:
type:
- integer
- 'null'
description: 'The player''s unique PlayerID as assigned by SportsDataIO
(where applicable). Note: this ID will stay with the player throughout
their entire career'
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team (where applicable). This
value is guaranteed to be unique across all sports/leagues.
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)
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 this specific outcome
BettingMarketID:
type:
- integer
- 'null'
description: The unique ID associated with the betting market
SportsBook:
$ref: '#/components/schemas/Sportsbook'
description: The sportsbook offering this outcome for betting
BettingOutcomeTypeID:
type:
- integer
- 'null'
description: The BettingOutcomeTypeID of this outcome
BettingOutcomeType:
type:
- string
- 'null'
description: The name of outcome type (e.g. Home; Away; Under; Over)
PayoutAmerican:
type:
- integer
- 'null'
description: 'The american odds payout '
PayoutDecimal:
type:
- number
- 'null'
description: The decimal odds payout
Value:
type:
- number
- 'null'
description: The number associated with the outcome of a market (e.g. the
spread, 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
IsAlternate:
type:
- boolean
- 'null'
description: Is this an alternate value or the core value
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 timestamp of the last time this betting outcome was updated
(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 unique ID of the team tied to this outcome (if applicable)
PlayerID:
type:
- integer
- 'null'
description: 'The player''s unique PlayerID as assigned by SportsDataIO
(where applicable). Note: this ID will stay with the player throughout
their entire career'
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team (where applicable). This
value is guaranteed to be unique across all sports/leagues.
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)
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)
TeamTrends:
properties:
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
TeamID:
type:
- integer
- 'null'
description: The unique ID of the team
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 unique ID of the team
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
OpponentID:
type:
- integer
- 'null'
description: The TeamID of the opponent team
Opponent:
type:
- string
- 'null'
description: Abbreviation [Key] of the opponent team (e.g. LAL; PHI; BOS;
CHI; etc.)
Wins:
type: integer
description: 'The total number of wins by the team relating to the scope.
Examples of scopes include: Last 3 Games, Last 5 Home Games, Last 10 Games
as Favorite, etc.'
Losses:
type: integer
description: 'The total number of losses by the team relating to the scope.
Examples of scopes include: Last 3 Games, Last 5 Home Games, Last 10 Games
as Favorite, etc..'
Ties:
type: integer
description: 'The total number of ties by the team relating to the scope.
Examples of scopes include: Last 3 Games, Last 5 Home Games, Last 10 Games
as Favorite, etc.'
WinsAgainstTheSpread:
type:
- integer
- 'null'
description: 'How many games the given team has covered the spread in relating
to the scope of the search. Examples of scopes include: Last 3 Games,
Last 5 Home Games, Last 10 Games as Favorite, etc.'
LossesAgainstTheSpread:
type:
- integer
- 'null'
description: 'The total number of losses against the point spread by the
team relating to the scope. Examples of scopes include: Last 3 Games,
Last 5 Home Games, Last 10 Games as Favorite, etc.'
PushesAgainstTheSpread:
type:
- integer
- 'null'
description: 'Pushes against the spread relating to the scope. Examples
of scopes include: Last 3 Games, Last 5 Home Games, Last 10 Games as Favorite,
etc.'
Overs:
type:
- integer
- 'null'
description: Amount of times the total score goes over the total points
line
Unders:
type:
- integer
- 'null'
description: Amount of times the total score goes under the total points
line
OverUnderPushes:
type:
- integer
- 'null'
description: Amount of times the total score pushes the total points line
AverageScore:
type:
- number
- 'null'
description: The average points per game scored by the given team over a
certain scope (Last 3 Games, Last 5 Games, Last 10 Games, etc.)
AverageOpponentScore:
type:
- number
- 'null'
description: The average points per game scored by the opposing teams of
a given team over a certain scope (Last 3 Games, Last 5 Games, Last 10
Games, etc.)
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 team
PreviousGames:
type: array
items:
$ref: '#/components/schemas/Game'
description: The collection of last 10 game scores between each team
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;
Regulation Time; 1st Half)
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: A text value for the record (e.g. Moneyline; Player Prop; 3rd
Quarter)
Active:
type:
- boolean
- 'null'
description: 'Whether or not this market is currently is use. Note: Active
= True & Inactive = False'
BettingResultingMetadata:
properties:
BettingMarketTypeId:
type: integer
description: The unique ID that distinguishes the different types of Market
Types
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 type of market which we can
result
BettingMarketResult:
properties:
BettingMarketID:
type: integer
description: The unique ID associated with the betting market
BettingMarketTypeID:
type: integer
description: The unique ID that distinguishes the different types of Market
Types
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 unique 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 Points,
Moneyline, Spread, etc.)
BettingPeriodTypeID:
type: integer
description: The BettingPeriodTypeID of this type of market which we can
result
BettingPeriodType:
type:
- string
- 'null'
description: The name of the period type of this market (e.g. Full Game;
1st Half; 2nd Quarter; Regular Season)
Name:
type:
- string
- 'null'
description: The generic name of this market
TeamID:
type:
- integer
- 'null'
description: The unique ID of the team tied to this market result (if applicable)
TeamKey:
type:
- string
- 'null'
description: The abbreviation [Key] of the team associated with this market
PlayerID:
type:
- integer
- 'null'
description: 'The player''s unique PlayerID as assigned by SportsDataIO.
Note: this ID will stay with the player throughout their entire career'
PlayerName:
type:
- string
- 'null'
description: The name of the player tied to this market (if applicable)
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
BettingOutcomeResult:
properties:
BettingOutcomeID:
type: integer
description: The unique ID associated with this specific outcome
BettingResultTypeID:
type:
- integer
- 'null'
description: The BettingResultType of this outcome
BettingResultType:
type:
- string
- 'null'
description: The string identifier of the BettingResultType of this outcome
(e.g. Won, Lost, Push, Not Resulted, Incomplete)
BettingOutcomeTypeID:
type:
- integer
- 'null'
description: The BettingOutcomeTypeID of this outcome
BettingOutcomeType:
type:
- string
- 'null'
description: The name of outcome type (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 5 and the spread was -6.5, the actual value would
be 5 and the bet value would be -6.5)
ActualValue:
type:
- number
- 'null'
description: The value of the actual result that occurred in game (i.e.
If a team won a game by 5 and the spread was -6.5, the actual value would
be 5 and the bet value would be -6.5)
BettingMarketSplit:
properties:
BettingMarketID:
type: integer
description: The unique ID associated with the betting market
BettingEventID:
type: integer
description: The unique ID of the betting event associated with this split
BettingMarketTypeID:
type: integer
description: The unique ID that distinguishes the different types of Market
Types
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 unique 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 Points,
Moneyline, Spread, etc.)
BettingPeriodTypeID:
type: integer
description: The BettingPeriodTypeID of this type of market which we can
result
BettingPeriodType:
type:
- string
- 'null'
description: The name of the period type of this market (e.g. Full Game;
1st Half; 2nd Quarter; Regular Season)
TeamID:
type:
- integer
- 'null'
description: The unique ID of the team tied to this market split (if applicable)
TeamKey:
type:
- string
- 'null'
description: The abbreviation [Key] of the team associated with this market
PlayerID:
type:
- integer
- 'null'
description: 'The player''s unique PlayerID as assigned by SportsDataIO.
Note: this ID will stay with the player throughout their entire career'
PlayerName:
type:
- string
- 'null'
description: The name of the player tied to this market (if applicable)
BettingSplits:
type: array
items:
$ref: '#/components/schemas/BettingSplit'
description: A list of betting splits for a given game
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 BettingOutcomeTypeID of this outcome
BettingOutcomeType:
type:
- string
- 'null'
description: The name of outcome type (e.g. Home; Away; Under; Over)
BetPercentage:
type:
- integer
- 'null'
description: Percentage of bets placed on a specific outcome
MoneyPercentage:
type:
- integer
- 'null'
description: Percent of Money on this Outcome
Created:
type:
- string
- 'null'
description: The date and time when this betting split was first seen (in
US Eastern Time)
LastSeen:
type:
- string
- 'null'
description: When this split was last updated
GameBettingSplit:
properties:
GameID:
type: integer
description: The unique ID of the game associated with this GameBettingSplit
SeasonType:
type: integer
description: The type of season that this record corresponds to (1=Regular
Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=AllStar; 6=Exhibition)
Season:
type: integer
description: The NBA season of the game
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 BettingMarketSplits included in a given game
GameInfoResult:
properties:
GameID:
type: integer
description: The unique ID of the game.
Season:
type: integer
description: The NBA 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; 6=Exhibition)
Day:
type:
- string
- 'null'
description: The day of the game
DateTime:
type:
- string
- 'null'
description: The date and time of the game
Status:
type:
- string
- 'null'
description: 'Indicates the game''s status. Possible values include: Scheduled,
InProgress, Final, F/OT, Suspended, Postponed, Delayed, Canceled, Forfeit'
AwayTeamID:
type:
- integer
- 'null'
description: The unique ID 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/GameOddResult'
description: List of Pregame GameOdds from different sportsbooks with results
HomeTeamScore:
type:
- integer
- 'null'
description: Total points scored by the home team in the game (updated after
the game ends to allow for resolving bets)
AwayTeamScore:
type:
- integer
- 'null'
description: Total number of points the away team scored in the game (updated
after game ends to allow for resolving bets)
TotalScore:
type:
- integer
- 'null'
description: The total amount of points scored in the game by both teams.
Updated after the game ends to allow for resulting bets
HomeRotationNumber:
type:
- integer
- 'null'
description: The rotation number of the home team for this game
AwayRotationNumber:
type:
- integer
- 'null'
description: The rotation number of the away team for this game
AlternateMarketPregameOdds:
type: array
items:
$ref: '#/components/schemas/GameOddResult'
description: A list of Alternate Market Pregame GameOdds from different
sportsbooks (such as 1st-half; 1st-qtr; etc)
Quarter:
type:
- string
- 'null'
description: 'The current quarter in the game. Possible values include:
1, 2, 3, 4, Half, OT, NULL'
TimeRemainingMinutes:
type:
- integer
- 'null'
description: The number of minutes remaining in the quarter
TimeRemainingSeconds:
type:
- integer
- 'null'
description: The number of seconds remaining in the quarter
Quarters:
type: array
items:
$ref: '#/components/schemas/Quarter'
description: The details of the quarters (including overtime periods) for
this game.
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'
LiveOdds:
type: array
items:
$ref: '#/components/schemas/GameOddResult'
description: List of Live Odds from different sportsbooks with results
GameOddResult:
properties:
GameOddID:
type: integer
description: The unique ID of this odd
Sportsbook:
type:
- string
- 'null'
description: Name of sportsbook
GameID:
type: integer
description: The unique ID of the game associated with this GameOdd
Created:
type:
- string
- 'null'
description: The timestamp of when these odds were first created (in US
Eastern Time)
Updated:
type:
- string
- 'null'
description: The timestamp of when these odds were last updated (US Eastern
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 money line for the home team
AwayMoneyLine:
type:
- integer
- 'null'
description: The sportsbook's money line for the away team
HomePointSpread:
type:
- number
- 'null'
description: The sportsbook's point spread for the home team
AwayPointSpread:
type:
- number
- 'null'
description: The sportsbook's point spread for the away team
HomePointSpreadPayout:
type:
- integer
- 'null'
description: The sportsbook's point spread payout for the home team
AwayPointSpreadPayout:
type:
- integer
- 'null'
description: The sportsbook's point spread payout for the away team
OverUnder:
type:
- number
- 'null'
description: The sportsbook's total points scored over under for the game
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
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-half, 2nd-quarter)'
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
description: The unique ID of this odd
GameOddResultTypeId:
type:
- integer
- 'null'
description: The GameOddResultType of this outcome as an integer
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; 2nd quarter;
etc)'
GameOddType:
type:
- string
- 'null'
description: The GameOddOutcomeType of this outcome as 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 5 and the spread was -6.5, the actual value would
be 5 and the bet value would be -6.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 5 and the spread was -6.5, the actual value would
be 5 and the bet value would be -6.5)
BoxScore:
properties:
Game:
$ref: '#/components/schemas/Game'
description: The details of the game associated with this box score
Quarters:
type: array
items:
$ref: '#/components/schemas/Quarter'
description: The details of the quarters associated with this 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
PlayerGame:
properties:
StatID:
type: integer
description: The unique ID of the stat
TeamID:
type:
- integer
- 'null'
description: The unique ID of the team
PlayerID:
type:
- integer
- 'null'
description: 'The player''s unique PlayerID as assigned by SportsDataIO.
Note: this ID will stay with the player throughout their entire 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; 6=Exhibition)
Season:
type:
- integer
- 'null'
description: The NBA season of the game
Name:
type:
- string
- 'null'
description: The name of the player
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the player's team
Position:
type:
- string
- 'null'
description: 'The player''s position associated with the given game or season.
Possible values: C, F, FC, G, GF, PF, PG, SF, SG'
Started:
type:
- integer
- 'null'
description: 'Indicates whether or not the player started the game Note:
this will be one or zero for single game feeds'
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: The body part that is injured (Knee, Groin, Calf, Hamstring,
etc.)
InjuryStartDate:
type:
- string
- 'null'
description: The day that the injury started or was 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's daily fantasy contests.
FantasyDraftPosition:
type:
- string
- 'null'
description: The player's eligible position in Fantasy Draft's 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
Minutes:
type:
- integer
- 'null'
description: Total number of minutes played
Seconds:
type:
- integer
- 'null'
description: Total number of seconds played
FieldGoalsMade:
type:
- number
- 'null'
description: Total number of field goals made
FieldGoalsAttempted:
type:
- number
- 'null'
description: Total number of field goals attempted
FieldGoalsPercentage:
type:
- number
- 'null'
description: Total field goal percentage
EffectiveFieldGoalsPercentage:
type:
- number
- 'null'
description: Total effective field goals percentage
TwoPointersMade:
type:
- number
- 'null'
description: Total two pointers made
TwoPointersAttempted:
type:
- number
- 'null'
description: Total two pointers attempted
TwoPointersPercentage:
type:
- number
- 'null'
description: Total two pointers percentage
ThreePointersMade:
type:
- number
- 'null'
description: Total three pointers made
ThreePointersAttempted:
type:
- number
- 'null'
description: Total three pointers attempted
ThreePointersPercentage:
type:
- number
- 'null'
description: Total three pointers percentage
FreeThrowsMade:
type:
- number
- 'null'
description: Total free throws made
FreeThrowsAttempted:
type:
- number
- 'null'
description: Total free throws attempted
FreeThrowsPercentage:
type:
- number
- 'null'
description: Total free throws percentage
OffensiveRebounds:
type:
- number
- 'null'
description: Total offensive rebounds
DefensiveRebounds:
type:
- number
- 'null'
description: Total defensive rebounds
Rebounds:
type:
- number
- 'null'
description: Total rebounds
OffensiveReboundsPercentage:
type:
- number
- 'null'
description: Total offensive rebounds percentage
DefensiveReboundsPercentage:
type:
- number
- 'null'
description: Total defensive rebounds percentage
TotalReboundsPercentage:
type:
- number
- 'null'
description: The player/team total rebounds percentage
Assists:
type:
- number
- 'null'
description: Total assists
Steals:
type:
- number
- 'null'
description: Total steals
BlockedShots:
type:
- number
- 'null'
description: Total blocked shots
Turnovers:
type:
- number
- 'null'
description: Total turnovers
PersonalFouls:
type:
- number
- 'null'
description: Total personal fouls
Points:
type:
- number
- 'null'
description: Total points scored
TrueShootingAttempts:
type:
- number
- 'null'
description: 'The player''s true shooting attempts as defined here: http://www.basketball-reference.com/about/glossary.html'
TrueShootingPercentage:
type:
- number
- 'null'
description: 'The player''s true shooting percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
PlayerEfficiencyRating:
type:
- number
- 'null'
description: 'The player''s linear weight efficiency rating as defined here:
http://bleacherreport.com/articles/113144-cracking-the-code-how-to-calculate-hollingers-per-without-all-the-mess'
AssistsPercentage:
type:
- number
- 'null'
description: 'The player''s assist percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
StealsPercentage:
type:
- number
- 'null'
description: 'The player''s steal percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
BlocksPercentage:
type:
- number
- 'null'
description: 'The player''s block percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
TurnOversPercentage:
type:
- number
- 'null'
description: 'The player''s turnover percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
UsageRatePercentage:
type:
- number
- 'null'
description: 'The player''s usage rate percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
FantasyPointsFanDuel:
type:
- number
- 'null'
description: Total FanDuel daily fantasy points scored
FantasyPointsDraftKings:
type:
- number
- 'null'
description: Total DraftKings daily fantasy points scored
FantasyPointsYahoo:
type:
- number
- 'null'
description: Total Yahoo daily fantasy points scored
PlusMinus:
type:
- number
- 'null'
description: Total plus minus
DoubleDoubles:
type:
- number
- 'null'
description: Total double-doubles scored
TripleDoubles:
type:
- number
- 'null'
description: Total triple-doubles scored
FantasyPointsFantasyDraft:
type:
- number
- 'null'
description: Total FantasyDraft daily fantasy points scored
IsClosed:
type: boolean
description: Indicates whether the game is over and the stats for this player
have been verified and closed out.
LineupConfirmed:
type:
- boolean
- 'null'
description: Indicates whether starting lineup is confirmed
LineupStatus:
type:
- string
- 'null'
description: Indicates whether player is starting, active, or inactive
PlayerSeason:
properties:
StatID:
type: integer
description: The unique ID of the stat
TeamID:
type:
- integer
- 'null'
description: The unique ID of the player's team
PlayerID:
type:
- integer
- 'null'
description: 'The player''s unique PlayerID as assigned by SportsDataIO.
Note: this ID will stay with the player throughout their entire 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; 6=Exhibition).
Season:
type:
- integer
- 'null'
description: The NBA season in which these totals apply
Name:
type:
- string
- 'null'
description: The name of the player
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the player's team
Position:
type:
- string
- 'null'
description: 'The player''s position associated with the given game or season.
Possible values: PG; SG; SF; PF; C'
Started:
type:
- integer
- 'null'
description: Indicates how many games the player has started in the season
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
Minutes:
type:
- integer
- 'null'
description: Total number of minutes played
Seconds:
type:
- integer
- 'null'
description: Total number of seconds played
FieldGoalsMade:
type:
- number
- 'null'
description: Total number of field goals made
FieldGoalsAttempted:
type:
- number
- 'null'
description: Total number of field goals attempted
FieldGoalsPercentage:
type:
- number
- 'null'
description: Total field goal percentage
EffectiveFieldGoalsPercentage:
type:
- number
- 'null'
description: Total effective field goals percentage
TwoPointersMade:
type:
- number
- 'null'
description: Total two pointers made
TwoPointersAttempted:
type:
- number
- 'null'
description: Total two pointers attempted
TwoPointersPercentage:
type:
- number
- 'null'
description: Total two pointers percentage
ThreePointersMade:
type:
- number
- 'null'
description: Total three pointers made
ThreePointersAttempted:
type:
- number
- 'null'
description: Total three pointers attempted
ThreePointersPercentage:
type:
- number
- 'null'
description: Total three pointers percentage
FreeThrowsMade:
type:
- number
- 'null'
description: Total free throws made
FreeThrowsAttempted:
type:
- number
- 'null'
description: Total free throws attempted
FreeThrowsPercentage:
type:
- number
- 'null'
description: Total free throws percentage
OffensiveRebounds:
type:
- number
- 'null'
description: Total offensive rebounds
DefensiveRebounds:
type:
- number
- 'null'
description: Total defensive rebounds
Rebounds:
type:
- number
- 'null'
description: Total rebounds
OffensiveReboundsPercentage:
type:
- number
- 'null'
description: Total offensive rebounds percentage
DefensiveReboundsPercentage:
type:
- number
- 'null'
description: Total defensive rebounds percentage
TotalReboundsPercentage:
type:
- number
- 'null'
description: The player/team total rebounds percentage
Assists:
type:
- number
- 'null'
description: Total assists
Steals:
type:
- number
- 'null'
description: Total steals
BlockedShots:
type:
- number
- 'null'
description: Total blocked shots
Turnovers:
type:
- number
- 'null'
description: Total turnovers
PersonalFouls:
type:
- number
- 'null'
description: Total personal fouls
Points:
type:
- number
- 'null'
description: Total points scored
TrueShootingAttempts:
type:
- number
- 'null'
description: 'The player''s true shooting attempts as defined here: http://www.basketball-reference.com/about/glossary.html'
TrueShootingPercentage:
type:
- number
- 'null'
description: 'The player''s true shooting percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
PlayerEfficiencyRating:
type:
- number
- 'null'
description: 'The player''s linear weight efficiency rating as defined here:
http://bleacherreport.com/articles/113144-cracking-the-code-how-to-calculate-hollingers-per-without-all-the-mess'
AssistsPercentage:
type:
- number
- 'null'
description: 'The player''s assist percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
StealsPercentage:
type:
- number
- 'null'
description: 'The player''s steal percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
BlocksPercentage:
type:
- number
- 'null'
description: 'The player''s block percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
TurnOversPercentage:
type:
- number
- 'null'
description: 'The player''s turnover percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
UsageRatePercentage:
type:
- number
- 'null'
description: 'The player''s usage rate percentage as defined here: http://www.basketball-reference.com/about/glossary.html'
FantasyPointsFanDuel:
type:
- number
- 'null'
description: Total FanDuel daily fantasy points scored
FantasyPointsDraftKings:
type:
- number
- 'null'
description: Total DraftKings daily fantasy points scored
FantasyPointsYahoo:
type:
- number
- 'null'
description: Total Yahoo daily fantasy points scored
PlusMinus:
type:
- number
- 'null'
description: Total plus minus
DoubleDoubles:
type:
- number
- 'null'
description: Total double-doubles scored
TripleDoubles:
type:
- number
- 'null'
description: Total triple-doubles scored
FantasyPointsFantasyDraft:
type:
- number
- 'null'
description: Total FantasyDraft daily fantasy points scored
IsClosed:
type: boolean
description: Indicates whether the game is over and the stats for this player
have been verified and closed out.
LineupConfirmed:
type:
- boolean
- 'null'
description: Indicates whether starting lineup is confirmed
LineupStatus:
type:
- string
- 'null'
description: Indicates whether player is starting, active, or inactive
PlayerInfo:
properties:
PlayerID:
type: integer
description: 'The player''s unique PlayerID as assigned by SportsDataIO.
Note: this ID will stay with the player throughout their entire career'
Name:
type:
- string
- 'null'
description: The player's full name
TeamID:
type:
- integer
- 'null'
description: The unique ID of the player's team
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the player's team
Position:
type:
- string
- 'null'
description: 'The player''s primary position. Possible values: C; PF; PG;
SF; SG'
FantasyGame:
properties:
GameID:
type:
- integer
- 'null'
description: The unique ID of this game
PlayerID:
type:
- integer
- 'null'
description: 'The player''s unique PlayerID as assigned by SportsDataIO.
Note: this ID will stay with the player throughout their entire 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; 6=Exhibition)
Season:
type:
- integer
- 'null'
description: The NBA season of the game
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)
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
Opponent:
type:
- string
- 'null'
description: Abbreviation [Key] of the opponent team (e.g. LAL; PHI; BOS;
CHI; etc.)
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: The player's full name
Position:
type:
- string
- 'null'
description: 'The player''s primary position. Possible values: PG; SG; SF;
PF; C'
PositionCategory:
type:
- string
- 'null'
description: 'The player''s position category. Possible values: C, F, G'
Games:
type:
- integer
- 'null'
description: 'The number of games played by the player in the game Note:
this will be one or zero for single game feeds'
Started:
type:
- integer
- 'null'
description: 'Indicates whether or not the player started the game Note:
this will be one or zero for single game feeds'
FantasyPoints:
type:
- number
- 'null'
description: Total fantasy points by the player in the game
IsGameOver:
type: boolean
description: Whether the game is over (true/false)
FantasyPointsFanDuel:
type:
- number
- 'null'
description: Total FanDuel daily fantasy points scored
FantasyPointsYahoo:
type:
- number
- 'null'
description: Total Yahoo daily fantasy points scored
FantasyPointsDraftKings:
type:
- number
- 'null'
description: Total DraftKings daily fantasy points scored
FandDuelPosition:
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.
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 timestamp of when this game was last updated (in US Eastern
Time)
PlayByPlay:
properties:
Game:
$ref: '#/components/schemas/Game'
description: The details of the game associated with this play-by-play
Quarters:
type: array
items:
$ref: '#/components/schemas/Quarter'
description: The details of the quarters 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 identifier of the play.
QuarterID:
type: integer
description: The unique identifier of the Quarter that this play occurred
in.
QuarterName:
type:
- string
- 'null'
description: The name of the quarter that this play occurred in
Sequence:
type: integer
description: The order in which this play happened over the course of the
game.
TimeRemainingMinutes:
type:
- integer
- 'null'
description: The number of minutes remaining in the quarter when this play
occurred
TimeRemainingSeconds:
type:
- integer
- 'null'
description: The number of seconds remaining in the quarter when the play
occurred
AwayTeamScore:
type:
- integer
- 'null'
description: Total number of points the away team scored after this play
completed
HomeTeamScore:
type:
- integer
- 'null'
description: Total points scored by the home team after the completion of
this play
PotentialPoints:
type:
- integer
- 'null'
description: The points that would have been potentially scored by the shot
attempt (if any).
Points:
type:
- integer
- 'null'
description: The points scores by the shot attempt (if any).
ShotMade:
type:
- boolean
- 'null'
description: Whether the shot was made (if any).
Category:
type:
- string
- 'null'
description: 'The category the play. Possible values: Period, Timeout, JumpBall,
Shot, Rebound, Foul, Substitution, Turnover, Challenge.'
Type:
type:
- string
- 'null'
description: 'The type of the play. Possible values: None, Period, Timeout,
JumpBall, FieldGoalMade, FieldGoalMissed, FreeThrowMade, FreeThrowMissed,
Rebound, Steal, Turnover, Foul, PersonalFoul, ShootingFoul, OffensiveFoul,
LooseBallFoul, TechnicalFoul, FlagrantFoul, Traveling, Palming, Goaltending,
KickedBall, LaneViolation, DelayOfGame, Substitution, Ejection, and Challenge.'
TeamID:
type:
- integer
- 'null'
description: The unique ID of the team associated with this play
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team associated with this play
OpponentID:
type:
- integer
- 'null'
description: The unique ID of the opponent team associated with this play
Opponent:
type:
- string
- 'null'
description: Abbreviation [Key] of the opponent team (e.g. LAL; PHI; BOS;
CHI; etc.)
ReceivingTeamID:
type:
- integer
- 'null'
description: The TeamID of the team that won the jump ball.
ReceivingTeam:
type:
- string
- 'null'
description: The team abbreviation [Key] of the team that won the jump ball
Description:
type:
- string
- 'null'
description: The description of the play.
PlayerID:
type:
- integer
- 'null'
description: 'The player''s unique PlayerID as assigned by SportsDataIO.
Note: this ID will stay with the player throughout their entire career'
AssistedByPlayerID:
type:
- integer
- 'null'
description: The PlayerID of the player who recorded an assist on a made
field goal by another player (if applicable)
BlockedByPlayerID:
type:
- integer
- 'null'
description: The PlayerID of the player who blocked the field goal attempt
on this play (if any).
FastBreak:
type:
- boolean
- 'null'
description: Indicates whether this play happened on a fast break.
SideOfBasket:
type:
- string
- 'null'
description: 'The side of the basket that the field goal was attempted from
(if any). Possible values: L, R'
Updated:
type:
- string
- 'null'
description: The timestamp of when this play was last updated (in US Eastern
Time)
Created:
type:
- string
- 'null'
description: The database generated timestamp of when this play was first
created (in US Eastern Time)
SubstituteInPlayerID:
type:
- integer
- 'null'
description: The PlayerID of the player who substituted into the game.
SubstituteOutPlayerID:
type:
- integer
- 'null'
description: The PlayerID of the player who substituted out of the game.
AwayPlayerID:
type:
- integer
- 'null'
description: The PlayerID of the player who is involved in the play from
the away team (if applicable)
HomePlayerID:
type:
- integer
- 'null'
description: The PlayerID of the player who is involved in the play from
the home team
ReceivingPlayerID:
type:
- integer
- 'null'
description: The PlayerID of the player who received the ball
BaselineOffsetPercentage:
type:
- number
- 'null'
description: The baseline offset percentage of where the ball was shot/passed
SidelineOffsetPercentage:
type:
- number
- 'null'
description: The sideline offset percentage of where the ball was shot/passed
Coordinates:
type:
- string
- 'null'
description: The x/y coordinates of where the ball was shot/passed
StolenByPlayerID:
type:
- integer
- 'null'
description: The PlayerID of the player who stole the ball (if applicable)
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 entire career'
Name:
type:
- string
- 'null'
description: The player's full name
TeamID:
type:
- integer
- 'null'
description: The unique ID of the team
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the player's team
Position:
type:
- string
- 'null'
description: 'The player''s primary position. Possible values: C; PF; PG;
SF; SG'
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 updated date of the player's hosted headshot.
HostedHeadshotNoBackgroundUrl:
type:
- string
- 'null'
description: The player's transparent background hosted headshot URL.
HostedHeadshotNoBackgroundUpdated:
type:
- string
- 'null'
description: The last updated date of the player's transparent background
hosted headshot.
securitySchemes:
apiKeyHeader:
type: apiKey
name: Ocp-Apim-Subscription-Key
in: header
apiKeyQuery:
type: apiKey
name: key
in: query
security:
- apiKeyHeader: []
- apiKeyQuery: []