openapi: 3.1.0
info:
title: NFL API
version: '1.0'
description: NFL API - OpenAPI 3.1 Specification
servers:
- url: https://api.sportsdata.io
description: Production server
paths:
/v3/nfl/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: nfl_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:
- NFL v3 Scores
/v3/nfl/scores/{format}/Teams:
get:
description: 'Full team information: team name and city, conference and division,
colors, coaching and scheme info. 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: nfl_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:
- NFL v3 Scores
/v3/nfl/scores/{format}/Byes/{season}:
get:
description: Get bye weeks for the teams during a specified NFL season.
operationId: nfl_v3_scores_bye_weeks
summary: Bye Weeks
parameters:
- name: format
in: path
description: Desired response format. Valid entries are JSON
or XML.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: season
in: path
description: "\n Year of the season and the season type. If no season\
\ type is provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Bye'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Scores
/v3/nfl/scores/{format}/CurrentSeason:
get:
description: Year of the current NFL season. This value changes at the start
of the new NFL league year. NFL seasons run across two calendar years; the
league year is the one in which it starts, not ends (that is, a season starting
in 2023 and ending in 2024 will have the league year of 2023.)
operationId: nfl_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:
type:
- integer
- 'null'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Scores
/v3/nfl/scores/{format}/CurrentWeek:
get:
description: Number of the current week of the NFL season. This value usually
changes on Tuesday nights or Wednesday mornings at midnight ET but in the
rare case of a rescheduled or overseas game with a non-standard gameday this
could change.
operationId: nfl_v3_scores_week___current
summary: Week - 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:
type:
- integer
- 'null'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Scores
/v3/nfl/scores/{format}/Scores/{season}:
get:
description: Full scores and gameday info delivered live and post-game. Live
data includes down and distance, as well as game clock. Gameday info includes
referee, weather, TV channel etc.
operationId: nfl_v3_scores_games___by_season__live___final
summary: Games - by Season [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: 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/Score'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Scores
/v3/nfl/scores/{format}/LastCompletedSeason:
get:
description: Year of the most recently completed NFL season. This value changes
immediately after the Super Bowl. NFL seasons run across two calendar years;
the league year is the one in which it starts, not ends (that is, a season
starting in 2023 and ending in 2024 will have the league year of 2023.)
operationId: nfl_v3_scores_season___last_completed
summary: Season - Last Completed
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:
- integer
- 'null'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Scores
/v3/nfl/scores/{format}/LastCompletedWeek:
get:
description: Number of the last completed week of the NFL season. This value
usually changes on Tuesday nights or Wednesday mornings at midnight ET but
in the rare case of a rescheduled or overseas game with a non-standard gameday
this could change.
operationId: nfl_v3_scores_week___last_completed
summary: Week - Last Completed
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:
- integer
- 'null'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Scores
/v3/nfl/scores/{format}/News:
get:
description: Basic RotoBaller news feed, with limited stories available - usually
0-1 stories per day. Ideal for test purposes.
operationId: nfl_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:
- NFL v3 Scores
/v3/nfl/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: nfl_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: Each NFL player has a unique ID assigned by FantasyData. Player
IDs can be determined by pulling player related data. Example:14257.
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:
- NFL v3 Scores
/v3/nfl/scores/{format}/NewsByTeam/{team}:
get:
description: Basic RotoBaller news feed, with limited stories available - usually
0-1 stories per day. Ideal for test purposes.
operationId: nfl_v3_scores_news___by_team
summary: News - 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: 'Abbreviation of the team. Example: WAS.'
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:
- NFL v3 Scores
/v3/nfl/scores/{format}/Schedules/{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: nfl_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/Schedule'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Scores
/v3/nfl/scores/{format}/ScoresByWeek/{season}/{week}:
get:
description: Full scores and gameday info delivered live and post-game. Live
data includes down and distance, as well as game clock. Gameday info includes
referee, weather, TV channel etc.
operationId: nfl_v3_scores_games___by_week__live___final
summary: Games - by Week [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: season
in: path
description: "\n Year of the season and the season type. If no season\
\ type is provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "\n Week of the season. Valid values are as follows:\
\ Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.\n \
\ Example: 1\n "
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Score'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Scores
/v3/nfl/scores/{format}/Stadiums:
get:
description: Returns all stadiums in the NFL with capacity, surface, latitude/longitude,
city and state (and, where applicable, country.)
operationId: nfl_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:
- NFL v3 Scores
/v3/nfl/scores/{format}/Standings/{season}:
get:
description: Includes regular season standings in division and conference, from
which postseason seeding can be derived.
operationId: nfl_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: "\n Year of the season and the season type. If no season\
\ type is provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
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:
- NFL v3 Scores
/v3/nfl/scores/{format}/Teams/{season}:
get:
description: 'Full team information: team name and city, conference and division,
colors, coaching and scheme info. 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: nfl_v3_scores_team_profiles___by_season
summary: Team Profiles - by Season
parameters:
- name: format
in: path
description: Desired response format. Valid entries are JSON
or XML.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: season
in: path
description: "\n Year of the season and the season type. If no season\
\ type is provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
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:
- NFL v3 Scores
/v3/nfl/scores/{format}/Timeframes/{type}:
get:
description: Timeframes for the NFL refer to current weeks, season status etc.
operationId: nfl_v3_scores_timeframes
summary: Timeframes
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: type
in: path
description: The type of timeframes to return. Valid entries are current
or upcoming or completed or recent
or all.
required: true
schema:
type: string
enum:
- current
- upcoming
- completed
- recent
- all
default: current
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Timeframe'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Scores
/v3/nfl/scores/{format}/UpcomingSeason:
get:
description: Year of the current NFL season, if we are in the mid-season. If
we are in the off-season, then year of the next upcoming season. This value
changes immediately after the Super Bowl. NFL seasons run across two calendar
years; the league year is the one in which it starts, not ends (that is, a
season starting in 2023 and ending in 2024 will have the league year of 2023.)
operationId: nfl_v3_scores_season___upcoming
summary: Season - Upcoming
parameters:
- name: format
in: path
description: Desired response format. Valid entries are JSON
or XML.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
responses:
'200':
description: Success
content:
application/json:
schema:
type:
- integer
- 'null'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Scores
/v3/nfl/scores/{format}/UpcomingWeek:
get:
description: Number of the next upcoming week of the NFL season. This value
usually changes on Tuesday nights or Wednesday mornings at midnight ET but
in the rare case of a rescheduled or overseas game with a non-standard gameday
this could change.
operationId: nfl_v3_scores_week___upcoming
summary: Week - Upcoming
parameters:
- name: format
in: path
description: Desired response format. Valid entries are JSON
or XML.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
responses:
'200':
description: Success
content:
application/json:
schema:
type:
- integer
- 'null'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Scores
/v3/nfl/scores/{format}/TeamGameStats/{season}/{week}:
get:
description: Returns the box score statistical record team-wide (aggregated
from all players) for a given team's game in a given week, during the game
and with final stats after it ends.
operationId: nfl_v3_scores_team_game_stats__live___final
summary: Team Game Stats [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: season
in: path
description: "\n Year of the season and the season type. If no season\
\ type is provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "\n Week of the season. Valid values are as follows:\
\ Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.\n \
\ Example: 1\n "
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:
- NFL v3 Scores
/v3/nfl/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: nfl_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: "\n Year of the season and the season type. If no season\
\ type is provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
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:
- NFL v3 Scores
/v3/nfl/scores/{format}/AllTeams:
get:
description: 'Full team information: team name and city, conference and division,
colors, coaching and scheme info. 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: nfl_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:
- NFL v3 Scores
/v3/nfl/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: nfl_v3_scores_news___by_date
summary: News - by Date
parameters:
- name: format
in: path
description: Desired response format. Valid entries are JSON
or XML.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: date
in: path
description: 'The date of the news.
Examples: 2017-JUL-31, 2017-SEP-01.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/News'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Scores
/v3/nfl/scores/{format}/SimulatedScores/{numberofplays}:
get:
description: Gets simulated live scores of NFL games, covering the Conference
Championship games on January 21, 2018.
operationId: nfl_v3_scores_scores_by_week_simulation
summary: Scores by Week Simulation
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: numberofplays
in: path
description: The number of plays to progress in this NFL live game simulation.
Example entries are 0, 1, 2, 3,
150, 200, etc.
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Score'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Scores
/v3/nfl/scores/{format}/Players:
get:
description: Full player bio and details, including injury notes, for all NFL
players in our database.
operationId: nfl_v3_scores_player_details___all
summary: Player Details - 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/Player'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Scores
/v3/nfl/scores/{format}/FreeAgents:
get:
description: Full player bio and details, including injury notes, for all available
NFL free agents unattached to a team.
operationId: nfl_v3_scores_player_details___by_free_agents
summary: Player Details - by Free Agents
parameters:
- name: format
in: path
description: Desired response format. Valid entries are JSON
or XML.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Player'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Scores
/v3/nfl/scores/{format}/Players/{team}:
get:
description: Full player bio and details, including injury notes, for all available
NFL players by team.
operationId: nfl_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: 'Abbreviation of the team. Example: WAS.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PlayerDetail'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Scores
/v3/nfl/scores/{format}/Rookies/{season}:
get:
description: Full player bio and details, including injury notes, for all available
NFL players by a specified draft year.
operationId: nfl_v3_scores_player_details___by_rookie_draft_year
summary: Player Details - by Rookie Draft Year
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: 2018, 2019,
etc.'
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:
- NFL v3 Scores
/v3/nfl/scores/{format}/Referees:
get:
description: Returns referees with name, numbers, position (e.g. FJ for Field
Judge), college, and years of experience.
operationId: nfl_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:
- NFL v3 Scores
/v3/nfl/scores/{format}/ScoresByDate/{date}:
get:
description: Full scores and gameday info delivered live and post-game. Live
data includes down and distance, as well as game clock. Gameday info includes
referee, weather, TV channel etc.
operationId: nfl_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 games.
Examples: 2021-SEP-12,
2021-NOV-28.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Score'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Scores
/v3/nfl/scores/{format}/TeamGameStatsBySeason/{season}/{teamid}/{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: nfl_v3_scores_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: 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:
- NFL v3 Scores
/v3/nfl/scores/{format}/DepthCharts:
get:
description: Depth charts for all active players NFL teams split by offensive,
defensive, and special teams position groupings.
operationId: nfl_v3_scores_depth_charts___by_active
summary: Depth Charts - 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/TeamDepthChart'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Scores
/v3/nfl/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: nfl_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:
- NFL v3 Scores
/v3/nfl/scores/{format}/ScoresBasic/{season}/{week}:
get:
description: This endpoint simply delivers the game clock and quarter and total
scores live; no down and distance and no gameday info such as weather.
operationId: nfl_v3_scores_games__basic____by_week__live___final
summary: Games (Basic) - by Week [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: season
in: path
description: "\n Year of the season and the season type. If no season\
\ type is provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "\n Week of the season. Valid values are as follows:\
\ Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.\n \
\ Example: 1\n "
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:
- NFL v3 Scores
/v3/nfl/scores/{format}/TeamsBasic:
get:
description: The most basic top-line team information, such as team name and
city, conference and division, stadium ID, coach info, and team colors. Returns
all teams regardless of current active status.
operationId: nfl_v3_scores_team_profiles__basic____all
summary: Team Profiles (Basic) - 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/TeamBasic'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Scores
/v3/nfl/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: nfl_v3_scores_player_profiles___by_team
summary: Player Profiles - by Team
parameters:
- name: format
in: path
description: Desired response format. Valid entries are JSON
or XML.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: team
in: path
description: 'Abbreviation of the team. Example: WAS.'
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:
- NFL v3 Scores
/v3/nfl/scores/{format}/PlayersByAvailable:
get:
description: Player profiles include basic biographical information, position,
college, and current team (if attached to a team.) This returns all players.
operationId: nfl_v3_scores_player_profiles___all
summary: Player 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/PlayerBasic'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Scores
/v3/nfl/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: nfl_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:
- NFL v3 Scores
/v3/nfl/scores/{format}/PlayersByRookieDraftYear/{season}:
get:
description: Player profiles include basic biographical information, position,
college, and current team (if attached to a team.) Specify a year parameter
to receive all player profiles from that rookie draft year.
operationId: nfl_v3_scores_player_profiles___by_rookie_draft_year
summary: Player Profiles - by Rookie Draft Year
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: 2018, 2019,
etc.'
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:
- NFL v3 Scores
/v3/nfl/scores/{format}/TransactionsByDate/{date}:
get:
description: Includes a list of transactions for a given date, with type (e.g.
trade, injury listing, assignment) and a brief note.
operationId: nfl_v3_scores_transactions___by_date
summary: Transactions - 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/Transaction'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Scores
/v3/nfl/scores/{format}/ScoresByWeekFinal/{season}/{week}:
get:
description: Full scores and gameday info, including weather, referee, infotainment
odds, as well as all of the quarter scores and full-time score.
operationId: nfl_v3_scores_games___by_week__final
summary: Games - by Week [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: season
in: path
description: "\n Year of the season and the season type. If no season\
\ type is provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "\n Week of the season. Valid values are as follows:\
\ Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.\n \
\ Example: 1\n "
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Score'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Scores
/v3/nfl/scores/{format}/ScoresByDateFinal/{date}:
get:
description: Full scores and gameday info, including weather, referee, infotainment
odds, as well as all of the quarter scores and full-time score.
operationId: nfl_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 games.
Examples: 2021-SEP-12,
2021-NOV-28.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Score'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Scores
/v3/nfl/scores/{format}/ScoresBasicFinal/{season}/{week}:
get:
description: A slimmed-down score endpoint, giving just the quarter scores and
final score, for simple applications.
operationId: nfl_v3_scores_games__basic____by_week__final
summary: Games (Basic) - by Week [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: season
in: path
description: "\n Year of the season and the season type. If no season\
\ type is provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "\n Week of the season. Valid values are as follows:\
\ Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.\n \
\ Example: 1\n "
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:
- NFL v3 Scores
/v3/nfl/scores/{format}/DepthChartsAll:
get:
description: Depth charts for all players in all NFL teams split by offensive,
defensive, and special teams position groupings.
operationId: nfl_v3_scores_depth_charts___all
summary: Depth Charts - 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/TeamDepthChart'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Scores
/v3/nfl/scores/{format}/DepthChartsByWeek/{season}/{week}:
get:
description: Depth charts for active players by week in all NFL teams split
by offensive, defensive, and special teams position groupings.
operationId: nfl_v3_scores_depth_charts___by_week
summary: Depth Charts - by Week
parameters:
- name: format
in: path
description: Desired response format. Valid entries are JSON
or XML.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: season
in: path
description: "\n Year of the season and the season type. If no season\
\ type is provided, then the default is regular season.
Examples:\
\ 2015REG, 2015PRE, 2015POST. \
\ \n"
required: true
schema:
type: string
- name: week
in: path
description: "\n Week of the season. Valid values are as follows:\
\ Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4. \
\ Example: 1 \n"
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/TeamDepthChartWeekly'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Scores
/v3/nfl/projections/{format}/FantasyDefenseProjectionsBySeason/{season}:
get:
description: SportsDataIO's proprietary projections, including average draft
position, for all fantasy defense teams for the season. Does not contain Individual
Defensive Players (IDP), which have their own endpoint.
operationId: nfl_v3_projections_projected_fantasy_defense_season_stats_with_adp
summary: Projected Fantasy Defense Season Stats With ADP
parameters:
- name: format
in: path
description: Desired response format. Valid entries are JSON
or XML.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: season
in: path
description: "Year of the season and the season type. If no season type is\
\ provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/FantasyDefenseSeasonProjection'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Projections
/v3/nfl/projections/{format}/FantasyDefenseProjectionsByGame/{season}/{week}:
get:
description: SportsDataIO's proprietary projections, including DFS salary information,
for all fantasy defense teams. Called by season and week. Does not contain
Individual Defensive Players (IDP), which have their own endpoint.
operationId: nfl_v3_projections_projected_fantasy_defense_game_stats_with_dfs_salaries
summary: Projected Fantasy Defense Game Stats With DFS Salaries
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.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "Week of the season. Valid values are as follows: Preseason 0\
\ to 4, Regular Season 1 to 17, Postseason 1 to 4.\n Example: 1\n\
\ "
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/FantasyDefenseGameProjection'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Projections
/v3/nfl/projections/{format}/PlayerGameProjectionStatsByTeam/{season}/{week}/{team}:
get:
description: SportsDataIO's proprietary projections, including DFS salary information
and injuries, for fantasy players, for a given game, called by team.
operationId: nfl_v3_projections_projected_player_game_stats___by_team
summary: Projected Player Game 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 and the season type. If no season type is\
\ provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "Week of the season. Valid values are as follows: Preseason 0\
\ to 4, Regular Season 1 to 17, Postseason 1 to 4.\n Example: 1\n\
\ "
required: true
schema:
type: string
- name: team
in: path
description: 'Abbreviation of the team. Example: WAS.'
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:
- NFL v3 Projections
/v3/nfl/projections/{format}/PlayerSeasonProjectionStats/{season}:
get:
description: SportsDataIO's proprietary projections on a season-long basis,
including Average Draft Position (ADP), for fantasy players, for a given season.
operationId: nfl_v3_projections_projected_player_season_stats_with_adp
summary: Projected Player Season Stats With ADP
parameters:
- name: format
in: path
description: Desired response format. Valid entries are JSON
or XML.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: season
in: path
description: "Year of the season and the season type. If no season type is\
\ provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
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:
- NFL v3 Projections
/v3/nfl/projections/{format}/PlayerSeasonProjectionStatsByTeam/{season}/{team}:
get:
description: SportsDataIO's proprietary projections on a season-long basis,
including ADP, for fantasy players, for a given season and team.
operationId: nfl_v3_projections_projected_player_season_stats_with_adp___by_team
summary: Projected Player Season Stats With ADP - 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 and the season type. If no season type is\
\ provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
required: true
schema:
type: string
- name: team
in: path
description: 'Abbreviation of the team. Example: WAS.'
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:
- NFL v3 Projections
/v3/nfl/projections/{format}/PlayerGameProjectionStatsByWeek/{season}/{week}:
get:
description: SportsDataIO's proprietary projections, including DFS salary information
and injuries, for fantasy players, called by week.
operationId: nfl_v3_projections_projected_player_game_stats___by_week
summary: Projected Player Game Stats - by Week
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.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "\n Week of the season. Valid values are as follows:\
\ Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.\n \
\ Example: 1\n "
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:
- NFL v3 Projections
/v3/nfl/projections/{format}/DfsSlatesByDate/{date}:
get:
description: Returns DFS slates, including eligible games, positions, captain
mode, players and salaries, for a given date.
operationId: nfl_v3_projections_dfs_slates___by_date
summary: DFS Slates - by Date
parameters:
- name: format
in: path
description: Desired response format. Valid entries are JSON
or XML.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: date
in: path
description: 'The date of the slates.
Examples: 2017-SEP-25, 2017-10-31.'
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:
- NFL v3 Projections
/v3/nfl/projections/{format}/DfsSlatesByWeek/{season}/{week}:
get:
description: Returns DFS slates, including eligible games, positions, captain
mode, players and salaries, for a given week.
operationId: nfl_v3_projections_dfs_slates___by_week
summary: DFS Slates - by Week
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
- name: week
in: path
description: "Week of the season. Valid values are as follows: Preseason 0\
\ to 4, Regular Season 1 to 17, Postseason 1 to 4.\n Example: 1"
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:
- NFL v3 Projections
/v3/nfl/projections/{format}/IdpPlayerGameProjectionStatsByWeek/{season}/{week}:
get:
description: Individual Defensive Player (IDP stats, including DFS salary information
and injuries, for fantasy players, called by week.
operationId: nfl_v3_projections_idp_projected_player_game_stats___by_week
summary: IDP Projected Player Game Stats - by Week
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.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "Week of the season. Valid values are as follows: Preseason 0\
\ to 4, Regular Season 1 to 17, Postseason 1 to 4.\n Example: 1\n\
\ "
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:
- NFL v3 Projections
/v3/nfl/projections/{format}/IdpPlayerGameProjectionStatsByTeam/{season}/{week}/{team}:
get:
description: Individual Defensive Player (IDP stats, including DFS salary information
and injuries, for fantasy players, called by team.
operationId: nfl_v3_projections_idp_projected_player_game_stats___by_team
summary: IDP Projected Player Game 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 and the season type. If no season type is\
\ provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "Week of the season. Valid values are as follows: Preseason 0\
\ to 4, Regular Season 1 to 17, Postseason 1 to 4.\n Example: 1\n\
\ "
required: true
schema:
type: string
- name: team
in: path
description: 'Abbreviation of the team. Example: WAS.'
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:
- NFL v3 Projections
/v3/nfl/projections/{format}/UpcomingDfsSlateOwnershipProjections:
get:
description: Returns DFS Slates which have not yet started for which we have
DFS Ownership projections.
operationId: nfl_v3_projections_dfs_slate_ownership_projections___upcoming
summary: DFS Slate Ownership Projections - Upcoming
parameters:
- name: format
in: path
description: Desired response format. Valid entries are JSON
or XML.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/DfsSlateWithOwnershipProjection'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Projections
/v3/nfl/projections/{format}/DfsSlateOwnershipProjectionsBySlateID/{slateId}:
get:
description: Slate Ownership Projections for a specific slate. Projections are
for Guaranteed Prize Pool (GPP) format ownership. Will return an empty list
if the slate is not yet projected or not a slate we have projections for.
operationId: nfl_v3_projections_dfs_slate_ownership_projections___by_slate
summary: DFS Slate Ownership Projections - by Slate
parameters:
- name: format
in: path
description: Desired response format. Valid entries are JSON
or XML.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: slateId
in: path
description: SlateID of the DFS Slate you wish to get ownership projections
for. Will have an empty SlateOwnershipProjections if this slate was not
projected
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/DfsSlateWithOwnershipProjection'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Projections
/v3/nfl/projections/{format}/InjuredPlayers:
get:
description: This endpoint provides all currently injured NFL players, along
with injury details.
operationId: nfl_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:
- NFL v3 Projections
/v3/nfl/news-rotoballer/{format}/RotoBallerPremiumNews:
get:
description: RotoBaller's Premium News feed, with the latest updated stories
in greater detail.
operationId: nfl_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:
- NFL v3 RotoBaller Premium News
/v3/nfl/news-rotoballer/{format}/RotoBallerPremiumNewsByDate/{date}:
get:
description: RotoBaller's Premium News feed, with the latest updated stories
in greater detail called by date.
operationId: nfl_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:
- NFL v3 RotoBaller Premium News
/v3/nfl/news-rotoballer/{format}/RotoBallerPremiumNewsByTeam/{team}:
get:
description: RotoBaller's Premium News feed, with the latest updated stories
in greater detail called by team.
operationId: nfl_v3_news_rotoballer_premium_news___by_team
summary: Premium News - 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: 'Abbreviation of the team. Example: WAS.'
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:
- NFL v3 RotoBaller Premium News
/v3/nfl/odds/{format}/GameOddsByWeek/{season}/{week}:
get:
description: Returns the full-game core odds for games in a given week & season.
This means moneyline, spread, and total. Only returns the most recently seen
odds, not-including line movement.
operationId: nfl_v3_odds_pre_game_odds___by_week
summary: Pre-Game Odds - by Week
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, 2018POST, etc.'
required: true
schema:
type: string
- name: week
in: path
description: 'The week of the scores (games).
Examples: 1,
2, etc.'
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:
- NFL v3 Odds
/v3/nfl/odds/{format}/GameOddsLineMovement/{scoreid}:
get:
description: Returns the full-game core odds for a given ScoreID. This means
moneyline, spread, and total. Only returns the most recently seen odds, not-including
line movement. 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: nfl_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: scoreid
in: path
description: The ScoreID of an NFL score (game). ScoreIDs can be found in
the Scores API. Valid entries are 16654 or 16667
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:
- NFL v3 Odds
/v3/nfl/odds/{format}/LiveGameOddsByWeek/{season}/{week}:
get:
description: Returns in-play 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. As this is in-game, it will only return results
while the game is in progress.
operationId: nfl_v3_odds_in_game_odds___by_week
summary: In-Game Odds - by Week
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, 2018POST, etc.'
required: true
schema:
type: string
- name: week
in: path
description: 'The week of the scores (games).
Examples: 1,
2, etc.'
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:
- NFL v3 Odds
/v3/nfl/odds/{format}/LiveGameOddsLineMovement/{scoreid}:
get:
description: Returns in-play game odds (spread, moneyline, total) for games
in a given week and season. Returns the full line movement for the given game.
This endpoint has a longer cache as it is meant for historical data/line movement
rather than the most up to the second line.
operationId: nfl_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: scoreid
in: path
description: The ScoreID of an NFL score (game). ScoreIDs can be found in
the Scores API. Valid entries are 16654 or 16667
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:
- NFL v3 Odds
/v3/nfl/odds/{format}/AlternateMarketGameOddsByWeek/{season}/{week}:
get:
description: Returns the non-full-game odds (spread, moneyline, total) for games
in a given week and season. Non-full-game means 1st-half or 1st-quarter, for
example, rather than full game. Only returns the most recently seen odds,
not inclusive of line movement.
operationId: nfl_v3_odds_period_game_odds___by_week
summary: Period Game Odds - by Week
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, 2018POST, etc.'
required: true
schema:
type: string
- name: week
in: path
description: 'The week of the scores (games).
Examples: 1,
2, etc.'
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:
- NFL v3 Odds
/v3/nfl/odds/{format}/AlternateMarketGameOddsLineMovement/{scoreid}:
get:
description: Returns the non-full-game odds (spread, moneyline, total) for games
in a given week and season. Non-full-game means 1st-half or 1st-quarter, for
example, rather than full game. Only returns the most recently seen odds,
not inclusive of line movement.
operationId: nfl_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: scoreid
in: path
description: The ScoreID of an NFL score (game). ScoreIDs can be found in
the Scores API. Valid entries are 16654 or 16667
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:
- NFL v3 Odds
/v3/nfl/odds/{format}/TeamTrends/{team}:
get:
description: Describes recent team trends and performance against betting data
in recent sets of games.
operationId: nfl_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: 'Abbreviation of a team. Example: PHI.'
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:
- NFL v3 Odds
/v3/nfl/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: nfl_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: 'Abbreviation of a team. Example: PHI.'
required: true
schema:
type: string
- name: opponent
in: path
description: 'Abbreviation of an opponent. Example: NE.'
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:
- NFL v3 Odds
/v3/nfl/odds/{format}/BettingEventsByDate/{date}:
get:
description: The list of current BettingEvents for the given date, from which
Betting Market data can be gathered via the Betting Markets by Event endpoint,
for all available Betting Market types (e.g. Player Props, Team Props.)
operationId: nfl_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-09-10,
2020-09-13.'
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:
- NFL v3 Odds
/v3/nfl/odds/{format}/BettingEvents/{season}:
get:
description: The list of current BettingEvents for the given season, from which
Betting Market data can be gathered via the Betting Markets by Event endpoint,
for all available Betting Market types (e.g. Player Props, Team Props.)
operationId: nfl_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
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:
- NFL v3 Odds
/v3/nfl/odds/{format}/BettingFuturesBySeason/{season}:
get:
description: Returns available Futures markets for the given season. Does not
include line movement.
operationId: nfl_v3_odds_betting_futures___by_season
summary: Betting Futures - by Season
parameters:
- name: format
in: path
description: Desired response format. Valid entries are JSON
or XML.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: season
in: path
description: 'Year of the season (with optional season type).
Examples:
2020REG, 2020PRE, 2020POST, 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:
- NFL v3 Odds
/v3/nfl/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: nfl_v3_odds_betting_markets___by_event
summary: Betting Markets - by Event
parameters:
- name: format
in: path
description: Desired response format. Valid entries are JSON
or XML.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: eventId
in: path
description: The EventId of the desired event/game for which to pull all betting
markets (includes outcomes/bets).
required: true
schema:
type: string
- name: include
in: query
description: 'This parameter indicates which BettingOutcome records
to return in the payload. By default, this endpoint only returns available
outcomes, excluding the unlisted bets.
Important Note: the
default parameter of available is much faster and provides
the best performance. Passing unlisted will return unlisted odds, but these
are cached for much longer and may be several minutes old. For best performance,
the default parameter is highly recommended.
Possible values include:
available - excludes any betting outcomes that have
been removed/unlisted by the respective sportsbook. This is more lightweight
and delivers odds much faster than using unlisted.
unlisted
- includes the most recently available betting outcome per sportsbook, for
each listed market, even those outcomes are expired/unlisted or otherwise
unavailable from the respective sportsbook. This is a far heavier payload,
and it''s cached for much longer than available.
'
schema:
type: string
enum:
- available
- unlisted
default: available
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BettingMarket'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Odds
/v3/nfl/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: nfl_v3_odds_betting_market
summary: Betting Market
parameters:
- name: format
in: path
description: Desired response format. Valid entries are JSON
or XML.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: marketId
in: path
description: The MarketId of the desired market for which to pull all outcomes/bets.
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/BettingMarket'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Odds
/v3/nfl/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: nfl_v3_odds_betting_markets___by_market_type
summary: Betting Markets - by Market Type
parameters:
- name: format
in: path
description: Desired response format. Valid entries are JSON
or XML.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: eventId
in: path
description: The EventId of the desired event/game for which to pull all betting
markets (includes outcomes/bets).
required: true
schema:
type: string
- name: marketTypeID
in: path
description: 'The Market Type ID of the desired MarketTypes to pull. Some
common types include: 1 for Game Lines, 2 for
Player Props, 3 for Team Props, 6 for Game Props'
required: true
schema:
type: string
- name: include
in: query
description: 'This parameter indicates which BettingOutcome records
to return in the payload. By default, this endpoint only returns available
outcomes, excluding the unlisted bets.
Important Note: the
default parameter of available is much faster and provides
the best performance. Passing unlisted will return unlisted odds, but these
are cached for much longer and may be several minutes old. For best performance,
the default parameter is highly recommended.
Possible values include:
available - excludes any betting outcomes that have
been removed/unlisted by the respective sportsbook. This is more lightweight
and delivers odds much faster than using unlisted.
unlisted
- includes the most recently available betting outcome per sportsbook, for
each listed market, even those outcomes are expired/unlisted or otherwise
unavailable from the respective sportsbook. This is a far heavier payload,
and it''s cached for much longer than available.
'
schema:
type: string
enum:
- available
- unlisted
default: available
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BettingMarket'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Odds
/v3/nfl/odds/{format}/BettingMarketsByScoreID/{scoreid}:
get:
description: Returns the markets of all available types (e.g. Player Props,
Team Props) and available outcomes for a given GameID.
operationId: nfl_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: scoreid
in: path
description: The ScoreID of the desired game/score for which to pull all betting
markets (includes outcomes/bets).
required: true
schema:
type: string
- name: include
in: query
description: 'This parameter indicates which BettingOutcome records
to return in the payload. By default, this endpoint only returns available
outcomes, excluding the unlisted bets.
Important Note: the
default parameter of available is much faster and provides
the best performance. Passing unlisted will return unlisted odds, but these
are cached for much longer and may be several minutes old. For best performance,
the default parameter is highly recommended.
Possible values include:
available - excludes any betting outcomes that have
been removed/unlisted by the respective sportsbook. This is more lightweight
and delivers odds much faster than using unlisted.
unlisted
- includes the most recently available betting outcome per sportsbook, for
each listed market, even those outcomes are expired/unlisted or otherwise
unavailable from the respective sportsbook. This is a far heavier payload,
and it''s cached for much longer than available.
'
schema:
type: string
enum:
- available
- unlisted
default: available
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BettingMarket'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Odds
/v3/nfl/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: nfl_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:
- NFL v3 Odds
/v3/nfl/odds/{format}/ActiveSportsbooks:
get:
description: Returns a list for mapping SportsbookID to the Sportsbook name.
operationId: nfl_v3_odds_sportsbooks___active
summary: Sportsbooks - 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:
- NFL v3 Odds
/v3/nfl/odds/{format}/BettingSplitsByScoreId/{scoreId}:
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: nfl_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: scoreId
in: path
description: The ScoreID of the desired game to get Betting Market Splits
for
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:
- NFL v3 Odds
/v3/nfl/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: nfl_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 BettingMarketID of the market you would like to get splits
for. Note that markets we do not have split information on will return an
empty response.
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:
- NFL v3 Odds
/v3/nfl/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: nfl_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. '
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:
- NFL v3 Odds
/v3/nfl/odds/{format}/BettingPlayerPropsByScoreID/{scoreid}:
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: nfl_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: scoreid
in: path
description: The unique ScoreID 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:
- NFL v3 Odds
/v3/nfl/odds/{format}/PreGameOddsByWeek/{season}/{week}/{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: nfl_v3_odds_pre_game_and_period_game_odds___by_week__sportsbook_group
summary: Pre-Game and Period Game Odds - by Week [Sportsbook Group]
parameters:
- name: format
in: path
description: Desired response format. Valid entries are JSON
or XML.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: season
in: path
description: 'Year of the season, with optional season type.
Examples:
2018, 2018POST, etc.'
required: true
schema:
type: string
- name: week
in: path
description: 'The week of the scores (games).
Examples: 1,
2, 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/GameInfo'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Odds
/v3/nfl/odds/{format}/PreGameOddsLineMovement/{scoreid}/{sportsbookgroup}:
get:
description: Returns the game odds (for games in a given week and season. In
this endpoint both full-game and partial-game odds are included. Returns the
full line movement for the given game. This endpoint has a longer cache as
it is meant for historical data/line movement rather than the most up to the
second line. A Sportsbook Group must be specified as a URL parameter.
operationId: nfl_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: scoreid
in: path
description: The ScoreID of an NFL score (game). ScoreIDs can be found in
the Scores API. Valid entries are 16654 or 16667
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:
- NFL v3 Odds
/v3/nfl/odds/{format}/InGameOddsByWeek/{season}/{week}/{sportsbookgroup}:
get:
description: Returns in-play 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. 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: nfl_v3_odds_in_game_odds_by_week__sportsbook_group
summary: In-Game Odds by Week [Sportsbook Group]
parameters:
- name: format
in: path
description: Desired response format. Valid entries are JSON
or XML.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: season
in: path
description: 'Year of the season, with optional season type.
Examples:
2018, 2018POST, etc.'
required: true
schema:
type: string
- name: week
in: path
description: 'The week of the scores (games).
Examples: 1,
2, 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/GameInfo'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Odds
/v3/nfl/odds/{format}/InGameLineMovement/{scoreid}/{sportsbookgroup}:
get:
description: Returns in-play game odds (spread, moneyline, total) for games
in a given week and season. Returns the full line movement for the given game.
This endpoint has a longer cache as it is meant for historical data/line movement
rather than the most up to the second line. A Sportsbook Group must be specified
as a URL parameter.
operationId: nfl_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: scoreid
in: path
description: The ScoreID of an NFL score (game). ScoreIDs can be found in
the Scores API. Valid entries are 16654 or 16667
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:
- NFL v3 Odds
/v3/nfl/odds/{format}/BettingPlayerPropsByScoreID/{scoreid}/{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: nfl_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: scoreid
in: path
description: The unique ScoreID 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:
- NFL v3 Odds
/v3/nfl/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: nfl_v3_odds_betting_markets___by_market_type__sportsbook_group
summary: Betting Markets - by Market Type [Sportsbook Group]
parameters:
- name: format
in: path
description: Desired response format. Valid entries are JSON
or XML.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: eventId
in: path
description: The EventId of the desired event/game for which to pull all betting
markets (includes outcomes/bets).
required: true
schema:
type: string
- name: marketTypeID
in: path
description: 'The Market Type ID of the desired MarketTypes to pull. Some
common types include: 1 for Game Lines, 2 for
Player Props, 3 for Team Props, 6 for Game Props'
required: true
schema:
type: string
- name: sportsbookgroup
in: path
description: 'The name of the Sportsbook 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:
- NFL v3 Odds
/v3/nfl/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: nfl_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/score for which to pull all betting
markets (includes outcomes/bets).
required: true
schema:
type: string
- name: sportsbookgroup
in: path
description: 'The name of the Sportsbook 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:
- NFL v3 Odds
/v3/nfl/odds/{format}/BettingMarketsByEvent/{eventId}/{sportsbookgroup}:
get:
description: Returns the markets and available outcomes for a given BettingEventID.
A Sportsbook Group must be specified as a URL parameter.
operationId: nfl_v3_odds_betting_markets___by_event__sportsbook_group
summary: Betting Markets - by Event [Sportsbook Group]
parameters:
- name: format
in: path
description: Desired response format. Valid entries are JSON
or XML.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: eventId
in: path
description: The EventId of the desired event/game for which to pull all betting
markets (includes outcomes/bets).
required: true
schema:
type: string
- name: sportsbookgroup
in: path
description: 'The name of the Sportsbook 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:
- NFL v3 Odds
/v3/nfl/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: nfl_v3_odds_betting_market__sportsbook_group
summary: Betting Market [Sportsbook Group]
parameters:
- name: format
in: path
description: Desired response format. Valid entries are JSON
or XML.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: marketId
in: path
description: The MarketId of the desired market for which to pull all outcomes/bets.
required: true
schema:
type: string
- name: sportsbookgroup
in: path
description: 'The name of the Sportsbook 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:
- NFL v3 Odds
/v3/nfl/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: nfl_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. '
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:
- NFL v3 Odds
/v3/nfl/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: nfl_v3_odds_betting_futures___by_season__sportsbook_group
summary: Betting Futures - by Season [Sportsbook Group]
parameters:
- name: format
in: path
description: Desired response format. Valid entries are JSON
or XML.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: season
in: path
description: 'Year of the season (with optional season type).
Examples:
2020REG, 2020PRE, 2020POST, 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:
- NFL v3 Odds
/v3/nfl/odds/{format}/PreGameOddsLineMovementWithResulting/{scoreid}/{sportsbookgroup}:
get:
description: 'Returns the game odds ( for games in a given week and season.
In this endpoint both full-game and partial-game odds are included.
This
also includes Resulting: for markets with a ResultType, each line will be
graded and it will be determined whether the bet would have won or lost.
Returns
the full line movement for the given game. This endpoint has a longer cache
as it is meant for historical data/line movement rather than the most up to
the second line.
A Sportsbook Group must be specified as a URL parameter.'
operationId: nfl_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: scoreid
in: path
description: The ScoreID of an NFL score (game). ScoreIDs can be found in
the Scores API. Valid entries are 16654 or 16667
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:
- NFL v3 Odds
/v3/nfl/odds/{format}/InGameLineMovementWithResulting/{scoreid}/{sportsbookgroup}:
get:
description: Provides in-play odds line movement data for a given game. This
means odds for games which are in-progress. Serves full line movement and
is intended for showing the trend over a game rather than the most up-to-the
second lines.
operationId: nfl_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: scoreid
in: path
description: The ScoreID of an NFL score (game). ScoreIDs can be found in
the Scores API. Valid entries are 16654 or 16667
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:
- NFL v3 Odds
/v3/nfl/stats/{format}/PlayerGameStatsDelta/{minutes}:
get:
description: This method returns all player game stats, 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: nfl_v3_stats_player_game_stats_delta
summary: Player Game Stats 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: minutes
in: path
description: "\n 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:\n 1 or 2.\n \
\ "
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:
- NFL v3 Stats
/v3/nfl/stats/{format}/FantasyDefenseByGame/{season}/{week}:
get:
description: Returns stats and fantasy points for a given game for the fantasy
defense team (not IDP.)
operationId: nfl_v3_stats_fantasy_defense_game_stats___all
summary: Fantasy Defense Game Stats - 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
- name: season
in: path
description: "\n Year of the season and the season type. If no season\
\ type is provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "\n Week of the season. Valid values are as follows:\
\ Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.\n \
\ Example: 1\n "
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/FantasyDefenseGame'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/FantasyDefenseBySeason/{season}:
get:
description: Returns stats and fantasy points for a given season for the fantasy
defense team (not IDP.)
operationId: nfl_v3_stats_fantasy_defense_season_stats___all
summary: Fantasy Defense Season Stats - 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
- name: season
in: path
description: "\n Year of the season and the season type. If no season\
\ type is provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/FantasyDefenseSeason'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/Injuries/{season}/{week}:
get:
description: A list of all injured players and a description of their injuries.
operationId: nfl_v3_stats_injuries___all
summary: Injuries - 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
- name: season
in: path
description: "\n Year of the season and the season type. If no season\
\ type is provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "\n Week of the season. Valid values are as follows:\
\ Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.\n \
\ Example: 1\n "
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Injury'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/Injuries/{season}/{week}/{team}:
get:
description: A list of all injured players on a specified team and a description
of their injuries.
operationId: nfl_v3_stats_injuries___by_team
summary: Injuries - 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: "\n Year of the season and the season type. If no season\
\ type is provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "\n Week of the season. Valid values are as follows:\
\ Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.\n \
\ Example: 1\n "
required: true
schema:
type: string
- name: team
in: path
description: 'Abbreviation of the team. Example: WAS.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Injury'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/PlayerGameStatsByTeam/{season}/{week}/{team}:
get:
description: Returns the box score statistical record for all involved players
across a given team's game in a given week, updated live as the game takes
place.
operationId: nfl_v3_stats_player_game_stats___by_team__live___final
summary: Player Game Stats - by Team [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: season
in: path
description: "\n Year of the season and the season type. If no season\
\ type is provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "\n Week of the season. Valid values are as follows:\
\ Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.\n \
\ Example: 1\n "
required: true
schema:
type: string
- name: team
in: path
description: 'Abbreviation of the team. Example: WAS.'
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:
- NFL v3 Stats
/v3/nfl/stats/{format}/PlayerGameStatsByWeekDelta/{season}/{week}/{minutes}:
get:
description: This method returns all player scores for a given season and week,
but only returns player stats that have changed in the last X minutes as specified
in your API call. Ideal for live applications.
operationId: nfl_v3_stats_player_game_stats_delta___by_week
summary: Player Game Stats Delta - by Week
parameters:
- name: format
in: path
description: Desired response format. Valid entries are JSON
or XML.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: season
in: path
description: "\n Year of the season and the season type. If no season\
\ type is provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "\n Week of the season. Valid values are as follows:\
\ Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.\n \
\ Example: 1\n "
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:
\n 1 or 2.\n "
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:
- NFL v3 Stats
/v3/nfl/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: nfl_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: "\n Year of the season and the season type. If no season\
\ type is provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
required: true
schema:
type: string
- name: team
in: path
description: 'Abbreviation of the team. Example: WAS.'
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:
- NFL v3 Stats
/v3/nfl/stats/{format}/PlayerGameStatsByWeek/{season}/{week}:
get:
description: Returns the box score statistical record for all involved players
across a given week, updated live as the game takes place.
operationId: nfl_v3_stats_player_game_stats___by_week__live___final
summary: Player Game Stats - by Week [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: season
in: path
description: "\n Year of the season and the season type. If no season\
\ type is provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "\n Week of the season. Valid values are as follows:\
\ Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.\n \
\ Example: 1\n "
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:
- NFL v3 Stats
/v3/nfl/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: nfl_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: "\n Year of the season and the season type. If no season\
\ type is provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
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:
- NFL v3 Stats
/v3/nfl/stats/{format}/FantasyDefenseByGameByTeam/{season}/{week}/{team}:
get:
description: Returns stats and fantasy points for a given team's game for the
fantasy defense team (not IDP.)
operationId: nfl_v3_stats_fantasy_defense_game_stats___by_team
summary: Fantasy Defense Game 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 and the season type. If no season type is\
\ provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "Week of the season. Valid values are as follows: Preseason 0\
\ to 4, Regular Season 1 to 17, Postseason 1 to 4.\n Example: 1\n\
\ "
required: true
schema:
type: string
- name: team
in: path
description: 'Abbreviation of the team. Example: WAS.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/FantasyDefenseGame'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/FantasyDefenseBySeasonByTeam/{season}/{team}:
get:
description: Returns stats and fantasy points for a given team and season for
the fantasy defense team (not IDP.)
operationId: nfl_v3_stats_fantasy_defense_season_stats___by_team
summary: Fantasy Defense 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 and the season type. If no season type is\
\ provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
required: true
schema:
type: string
- name: team
in: path
description: 'Abbreviation of the team. Example: WAS.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/FantasyDefenseSeason'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/PlayerSeasonRedZoneStats/{season}:
get:
description: Delivers all offensive stats within the red zone (within the 20-yard
line of the defensive team) for all players in a given season (i.e. the season
total, not each individual game record.)
operationId: nfl_v3_stats_player_season_red_zone_stats
summary: Player Season Red Zone 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 and the season type. If no season type is\
\ provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PlayerSeasonRedZone'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/PlayerSeasonThirdDownStats/{season}:
get:
description: Returns all season-long stats (i.e. the season total, not each
individual game record) for all players on the third down for a given season.
operationId: nfl_v3_stats_player_season_third_down_stats
summary: Player Season Third Down 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: "\n Year of the season and the season type. If no season\
\ type is provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PlayerSeasonThirdDown'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/BoxScoresDeltaV3/{season}/{week}/{playerstoinclude}/{minutes}:
get:
description: This method returns all box scores for a given season and week,
but only returns player stats that have changed in the last X minutes as specified
in your API call. You can also filter by type of player stats to include,
such as traditional fantasy players, IDP players or all players. by definition
this is a live endpoint, not final.
operationId: nfl_v3_stats_box_scores_delta___by_week
summary: Box Scores Delta - by Week
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.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "Week of the season. Valid values are as follows: Preseason 0\
\ to 4, Regular Season 1 to 17, Postseason 1 to 4.\n Example: 1\n\
\ "
required: true
schema:
type: string
- name: playerstoinclude
in: path
description: 'The subcategory of players to include in the returned PlayerGame
records. Possible values include:
all Returns all players
fantasy Returns traditional fantasy players (QB, RB, WR, TE,
K, DST)
idp Returns traditional fantasy players and IDP players.'
required: true
schema:
type: string
enum:
- all
- fantasy
- idp
default: all
- 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,\n 2, etc.\n "
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BoxScoreV3'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/BoxScoreV3/{season}/{week}/{hometeam}:
get:
description: Full statistical information for a specified game, down to the
team and player stat level, delivered live during the game, called for a given
team's game in a given week and season.
operationId: nfl_v3_stats_box_score___by_team__live___final
summary: Box Score - by Team [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: 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.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "Week of the season. Valid values are as follows: Preseason 0\
\ to 4, Regular Season 1 to 17, Postseason 1 to 4.\n Example: 1\n\
\ "
required: true
schema:
type: string
- name: hometeam
in: path
description: 'Abbreviation of a team playing in this game. Example: WAS.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/BoxScoreV3'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/BoxScoreByScoreIDV3/{scoreid}:
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: nfl_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: scoreid
in: path
description: 'The ScoreID of the game. Possible values include: 16247,
16245, etc.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/BoxScoreV3'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/PlayerOwnership/{season}/{week}:
get:
description: Projected fantasy ownership of all players for a given season.
operationId: nfl_v3_stats_fantasy_player_ownership_percentages__season_long____by_week
summary: Fantasy Player Ownership Percentages (Season-Long) - by Week
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.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "Week of the season. Valid values are as follows: Preseason 0\
\ to 4, Regular Season 1 to 17, Postseason 1 to 4.\n Example: 1\n\
\ "
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PlayerOwnership'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/PlayerGameRedZoneStats/{season}/{week}:
get:
description: Delivers all offensive stats within the red zone (within the 20-yard
line of the defensive team) for all players in a given season or week.
operationId: nfl_v3_stats_player_game_red_zone_stats
summary: Player Game Red Zone 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 and the season type. If no season type is\
\ provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "Week of the season. Valid values are as follows: Preseason 0\
\ to 4, Regular Season 1 to 17, Postseason 1 to 4.\n Example: 1\n\
\ "
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PlayerGameRedZone'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/ProBowlers/{season}:
get:
description: A list of players involved in the Pro Bowl, by season.
operationId: nfl_v3_stats_pro_bowlers
summary: Pro Bowlers
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: 2016, 2017'
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:
- NFL v3 Stats
/v3/nfl/stats/{format}/SimulatedBoxScoresV3/{numberofplays}:
get:
description: Gets simulated live box scores of NFL games, covering the Conference
Championship games on January 21, 2018.
operationId: nfl_v3_stats_box_scores_simulation
summary: Box Scores Simulation
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: numberofplays
in: path
description: The number of plays to progress in this NFL live game simulation.
Example entries are 0, 1, 2, 3,
150, 200, etc.
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BoxScoreV3'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/PlayerGameRedZoneInsideTenStats/{season}/{week}:
get:
description: Delivers all offensive stats within the 10-yard line of the defensive
team for all players in a given season or week.
operationId: nfl_v3_stats_player_game_red_zone_stats__inside_ten
summary: Player Game Red Zone Stats (Inside Ten)
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.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "Week of the season. Valid values are as follows: Preseason 0\
\ to 4, Regular Season 1 to 17, Postseason 1 to 4.\n Example: 1\n\
\ "
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PlayerGameRedZone'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/PlayerSeasonRedZoneInsideTenStats/{season}:
get:
description: Delivers all offensive stats within the 10-yard line of the defensive
team for all players in a given season (i.e. the season total, not each individual
game record.)
operationId: nfl_v3_stats_player_season_red_zone_stats__inside_ten
summary: Player Season Red Zone Stats (Inside Ten)
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.\n \
\ "
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PlayerSeasonRedZone'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/PlayerGameRedZoneInsideFiveStats/{season}/{week}:
get:
description: Delivers all offensive stats within the 5-yard line of the defensive
team for all players in a given season or week.
operationId: nfl_v3_stats_player_game_red_zone_stats__inside_five
summary: Player Game Red Zone Stats (Inside Five)
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.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "Week of the season. Valid values are as follows: Preseason 0\
\ to 4, Regular Season 1 to 17, Postseason 1 to 4.\n Example: 1\n\
\ "
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PlayerGameRedZone'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/PlayerSeasonRedZoneInsideFiveStats/{season}:
get:
description: Delivers all offensive stats within the 5-yard line of the defensive
team for all players in a given season (i.e. the season total, not each individual
game record.)
operationId: nfl_v3_stats_player_season_red_zone_stats__inside_five
summary: Player Season Red Zone Stats (Inside Five)
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.\n \
\ "
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PlayerSeasonRedZone'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/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: nfl_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:17920.
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:
- NFL v3 Stats
/v3/nfl/stats/{format}/BoxScoreFinal/{scoreid}:
get:
description: Full statistical information for a specified game, down to the
team and player stat level, delivered after the game is complete.
operationId: nfl_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: scoreid
in: path
description: 'The ScoreID of the game. Possible values include: 16247,
16245, etc.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/BoxScoreV3'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/BoxScoresFinal/{season}/{week}:
get:
description: Full statistical information for a specified game week for each
game that took place, down to the team and player stat level, delivered after
the game is complete.
operationId: nfl_v3_stats_box_scores___by_week__final
summary: Box Scores - by Week [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: 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.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "Week of the season. Valid values are as follows: Preseason 0\
\ to 4, Regular Season 1 to 17, Postseason 1 to 4.\n Example: 1\n\
\ "
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BoxScoreV3'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/TeamGameStatsFinal/{season}/{week}:
get:
description: Returns the box score statistical record team-wide (aggregated
from all players) for a given team's game in a given week after the game has
concluded.
operationId: nfl_v3_stats_team_game_stats___by_game__final
summary: Team Game Stats - by Game [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: season
in: path
description: "\n Year of the season and the season type. If no season\
\ type is provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "\n Week of the season. Valid values are as follows:\
\ Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.\n \
\ Example: 1\n "
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:
- NFL v3 Stats
/v3/nfl/stats/{format}/PlayerGameStatsByWeekFinal/{season}/{week}:
get:
description: Returns the box score statistical record for all involved players
across all teams' games in a given week after the game has concluded.
operationId: nfl_v3_stats_player_game_stats___by_week__final
summary: Player Game Stats - by Week [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: season
in: path
description: "\n Year of the season and the season type. If no season\
\ type is provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "\n Week of the season. Valid values are as follows:\
\ Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.\n \
\ Example: 1\n "
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:
- NFL v3 Stats
/v3/nfl/stats/{format}/ScoresFinal/{season}:
get:
description: Full scores and gameday info, including weather, referee, infotainment
odds, as well as all of the quarter scores and full-time score.
operationId: nfl_v3_stats_games___by_season__final
summary: Games - by Season [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: 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/Score'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/PlayerGameStatsByTeamFinal/{season}/{week}/{team}:
get:
description: Returns the box score statistical record for all involved players
in a given team's game in a given week after the game has concluded.
operationId: nfl_v3_stats_player_game_stats___by_team__final
summary: Player Game Stats - by Team [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: season
in: path
description: "\n Year of the season and the season type. If no season\
\ type is provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "\n Week of the season. Valid values are as follows:\
\ Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.\n \
\ Example: 1\n "
required: true
schema:
type: string
- name: team
in: path
description: 'Abbreviation of the team. Example: WAS.'
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:
- NFL v3 Stats
/v3/nfl/stats/{format}/BoxScoreByTeamFinal/{season}/{week}/{hometeam}:
get:
description: Full statistical information for a given team's game in a specified
season and week, down to the team and player stat level, delivered after the
game is complete.
operationId: nfl_v3_stats_box_score___by_team__final
summary: Box Score - by Team [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: 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.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "Week of the season. Valid values are as follows: Preseason 0\
\ to 4, Regular Season 1 to 17, Postseason 1 to 4.\n Example: 1\n\
\ "
required: true
schema:
type: string
- name: hometeam
in: path
description: 'Abbreviation of a team playing in this game. Example: WAS.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/BoxScoreV3'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/FantasyGameStatsByWeek/{season}/{week}:
get:
description: Returns a simple list of fantasy points and stats for each player
for a given week.
operationId: nfl_v3_stats_fantasy_points___by_week
summary: Fantasy Points - by Week
parameters:
- name: format
in: path
description: Desired response format. Valid entries are JSON
or XML.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: season
in: path
description: "\n Year of the season and the season type. If no season\
\ type is provided, then the default is regular season.\n
Examples:\
\ 2015REG, 2015PRE, 2015POST.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "\n Week of the season. Valid values are as follows:\
\ Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.\n \
\ Example: 1\n "
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:
- NFL v3 Stats
/v3/nfl/pbp/{format}/PlayByPlay/{season}/{week}/{hometeam}:
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 team.
operationId: nfl_v3_pbp_play_by_play___by_team__live___final
summary: Play By Play - by Team [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: 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.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "Week of the season. Valid values are as follows: Preseason 0\
\ to 4, Regular Season 1 to 17, Postseason 1 to 4.\n Example: 1\n\
\ "
required: true
schema:
type: string
- name: hometeam
in: path
description: 'Abbreviation of the home team. Example: WAS.'
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:
- NFL v3 Play-by-Play
/v3/nfl/pbp/{format}/SimulatedPlayByPlay/{numberofplays}:
get:
description: Gets simulated live play-by-play of NFL games, covering the Conference
Championship games on January 21, 2018.
operationId: nfl_v3_pbp_play_by_play_simulation
summary: Play By Play Simulation
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: numberofplays
in: path
description: The number of plays to progress in this NFL live game simulation.
Example entries are 0, 1, 2, 3,
150, 200, etc.
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:
- NFL v3 Play-by-Play
/v3/nfl/pbp/{format}/PlayByPlayDelta/{season}/{week}/{minutes}:
get:
description: This method returns all play-by-plays for a given season and week,
but only returnsplays that have changed in the last X minutes as specified
in your API call. by definition this is a live endpoint, not final.
operationId: nfl_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: 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.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "Week of the season. Valid values are as follows: Preseason 0\
\ to 4, Regular Season 1 to 17, Postseason 1 to 4.\n Example: 1\n\
\ "
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:
\n 1 or 2.\n "
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:
- NFL v3 Play-by-Play
/v3/nfl/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 team.
operationId: nfl_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 a NFL game. GameIDs can be found in the Games
API. Valid entries are 14620 or 16905
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/PlayByPlay'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Play-by-Play
/v3/nfl/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: nfl_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 a NFL game. GameIDs can be found in the Games
API. Valid entries are 14620 or 16905
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/PlayByPlay'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Play-by-Play
/v3/nfl/pbp/{format}/PlayByPlayFinal/{season}/{week}/{hometeam}:
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 team.
operationId: nfl_v3_pbp_play_by_play___by_team__final
summary: Play By Play - by Team [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: 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.\n \
\ "
required: true
schema:
type: string
- name: week
in: path
description: "Week of the season. Valid values are as follows: Preseason 0\
\ to 4, Regular Season 1 to 17, Postseason 1 to 4.\n Example: 1\n\
\ "
required: true
schema:
type: string
- name: hometeam
in: path
description: 'Abbreviation of the home team. Example: WAS.'
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:
- NFL v3 Play-by-Play
/v3/nfl/headshots/{format}/Headshots:
get:
description: USA Today/IMAGN cropped action headshots for all active NFL players,
delivered shortly after the season starts.
operationId: nfl_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:
- NFL v3 Headshots
components:
schemas:
Unauthorized:
properties:
HttpStatusCode:
type: integer
Code:
type: integer
Description:
type: string
Help:
type: string
Team:
properties:
Key:
type:
- string
- 'null'
description: Abbreviation [Key] of the team (e.g. PHI; NE; IND; etc.)
TeamID:
type: integer
description: The unique ID of the team
PlayerID:
type: integer
description: The auto-generated unique ID of the Team; that avoids collisions
with PlayerIDs. This is useful when combining players and fantasy defenses
to create fantasy teams
City:
type:
- string
- 'null'
description: The city/location of the team (e.g. Minnesota; Philadelphia;
New England; Indianapolis; etc.)
Name:
type:
- string
- 'null'
description: The mascot of the team (e.g. Eagles; Patriots; Colts; etc.)
Conference:
type:
- string
- 'null'
description: The conference of the team (e.g. AFC or NFC)
Division:
type:
- string
- 'null'
description: The division of the team (e.g. East, North, South, West)
FullName:
type:
- string
- 'null'
description: The full name of the team (e.g. New England Patriots)
StadiumID:
type:
- integer
- 'null'
description: The unique ID of the team's current home stadium
ByeWeek:
type:
- integer
- 'null'
description: The bye week of the team in the upcoming or current regular
season
AverageDraftPosition:
type:
- number
- 'null'
description: The average draft position of the team's fantasy defense (DST)
in re-draft leagues
AverageDraftPositionPPR:
type:
- number
- 'null'
description: The average draft position of the team (DST) in Points Per
Reception (PPR) leagues
HeadCoach:
type:
- string
- 'null'
description: The current head coach of the team
OffensiveCoordinator:
type:
- string
- 'null'
description: 'The current offensive coordinator of the team. Note: field
will be NULL if team doesn''t have an OFF coordinator'
DefensiveCoordinator:
type:
- string
- 'null'
description: 'The current offensive coordinator of the team. Note: field
will be NULL if team doesn''t have an DEF coordinator'
SpecialTeamsCoach:
type:
- string
- 'null'
description: 'The current special teams coordinator of the team. Note: field
will be NULL if team doesn''t have an ST coordinator'
OffensiveScheme:
type:
- string
- 'null'
description: The offensive scheme this team runs (PRO, 2TE, 3WR). This
is decided at our discretion.
DefensiveScheme:
type:
- string
- 'null'
description: The current defensive scheme this team runs (3-4, 4-3)
UpcomingSalary:
type:
- integer
- 'null'
description: The team's DEF/ST salary for the upcoming week in accordance
with a $50,000 salary cap. This is used for daily fantasy sports salary
cap contests. Salaries represent those published by DraftKings. When DraftKings
doesn't publish a salary for a given game; the most recent DraftKings
salary is used
UpcomingOpponent:
type:
- string
- 'null'
description: The opponent team the team is playing against in the upcoming
week
UpcomingOpponentRank:
type:
- integer
- 'null'
description: The team's upcoming opponent's rank in DEF/ST fantasy points
allowed.
UpcomingOpponentPositionRank:
type:
- integer
- 'null'
description: The team's upcoming opponent's rank in DEF/ST fantasy points
allowed.
UpcomingFanDuelSalary:
type:
- integer
- 'null'
description: 'The team''s DEF/ST DraftKings salary for the upcoming week.
Note: We recommend using our new DFS endpoints instead.'
UpcomingDraftKingsSalary:
type:
- integer
- 'null'
description: 'The team''s DEF/ST DraftKings salary for the upcoming week.
Note: We recommend using our new DFS endpoints instead'
UpcomingYahooSalary:
type:
- integer
- 'null'
description: The team's DEF/ST Yahoo salary for the upcoming week
PrimaryColor:
type:
- string
- 'null'
description: The team's primary color. (This is not licensed for public
or commercial use)
SecondaryColor:
type:
- string
- 'null'
description: The team's secondary color. (This is not licensed for public
or commercial use)
TertiaryColor:
type:
- string
- 'null'
description: The team's tertiary color. (This is not licensed for public
or commercial use)
QuaternaryColor:
type:
- string
- 'null'
description: The team's quaternary color. (This is not licensed for public
or commercial use)
WikipediaLogoUrl:
type:
- string
- 'null'
description: The link to the team's logo hosted on Wikipedia (This is not
licensed for public or commercial use)
WikipediaWordMarkUrl:
type:
- string
- 'null'
description: The link to the team's wordmark logo hosted on Wikipedia (This
is not licensed for public or commercial use)
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team. This value is guaranteed
to be unique across all sports/leagues
DraftKingsName:
type:
- string
- 'null'
description: Team's D/ST name on DraftKings daily fantasy contests
DraftKingsPlayerID:
type:
- integer
- 'null'
description: Team's D/ST player ID on DraftKings daily fantasy contests
FanDuelName:
type:
- string
- 'null'
description: Team's D/ST name on FanDuel daily fantasy contests
FanDuelPlayerID:
type:
- integer
- 'null'
description: Team's DST player ID on FanDuel daily fantasy contests
FantasyDraftName:
type:
- string
- 'null'
description: Team's D/ST name on daily FantasyDraft daily fantasy contests
FantasyDraftPlayerID:
type:
- integer
- 'null'
description: Team's D/ST player ID on daily FantasyDraft daily fantasy contests
YahooName:
type:
- string
- 'null'
description: Team's D/ST name on Yahoo daily fantasy contests
YahooPlayerID:
type:
- integer
- 'null'
description: Team's D/ST player ID on Yahoo daily fantasy contests
StadiumDetails:
$ref: '#/components/schemas/Stadium'
description: The details of this team's home stadium
AverageDraftPosition2QB:
type:
- number
- 'null'
description: The average draft position of the team (DST) in 2 Quarterback
leagues
AverageDraftPositionDynasty:
type:
- number
- 'null'
description: The average draft position of this team (DST) in dynasty leagues
Stadium:
properties:
StadiumID:
type: integer
description: The unique ID of the stadium
Name:
type:
- string
- 'null'
description: The full name of the stadium
City:
type:
- string
- 'null'
description: The city where the stadium is located
State:
type:
- string
- 'null'
description: The city where the venue is located
Country:
type:
- string
- 'null'
description: The 3-digit country code where the stadium is located
Capacity:
type:
- integer
- 'null'
description: The estimated seating capacity of the stadium
PlayingSurface:
type:
- string
- 'null'
description: The playing surface of the stadium (Grass, Artificial or Dome)
GeoLat:
type:
- number
- 'null'
description: The geographic latitude coordinate of this venue
GeoLong:
type:
- number
- 'null'
description: The geographic longitude coordinate of this venue.
Type:
type:
- string
- 'null'
description: 'The type of the stadium (possible values: Outdoor, Dome, RetractableDome)'
Bye:
properties:
Season:
type: integer
description: The NFL season during which this bye week occurs.
Week:
type: integer
description: 'The NFL week during this bye week (regular season: 1 to 18;
preseason: 0 to 4; postseason: 1 to 4). Note: seasons after 2021 will
have only 3 preseason weeks'
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team who is on a bye
Score:
properties:
GameKey:
type:
- string
- 'null'
description: 'A 9 digit unique code identifying the game that this record
corresponds to. The GameID is composed of Season; SeasonType; Week and
HomeTeam. Note: This value will be NULL for bye weeks'
SeasonType:
type: integer
description: The type of season that this game corresponds to (1=Regular
Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=All-Star).
Season:
type: integer
description: The NFL season of the game
Week:
type: integer
description: 'The NFL week of the game (regular season: 1 to 18; preseason:
0 to 4; postseason: 1 to 4). Note: seasons after 2021 will have only 3
preseason weeks'
Date:
type:
- string
- 'null'
description: The date and time of the game (in US Eastern Time)
AwayTeam:
type:
- string
- 'null'
description: The abbreviation [Key} of the away team
HomeTeam:
type:
- string
- 'null'
description: The abbreviation [Key] of the home team
AwayScore:
type:
- integer
- 'null'
description: The final score of the Away Team
HomeScore:
type:
- integer
- 'null'
description: The final score of the Home Team
Channel:
type:
- string
- 'null'
description: The television station broadcasting the game
PointSpread:
type:
- number
- 'null'
description: The oddsmaker point spread at game start from the perspective
of the team (negative numbers indicate the HomeTeam is favored; positive
numbers indicate the AwayTeam is favored)
OverUnder:
type:
- number
- 'null'
description: The total points line (over/under) at game start
Quarter:
type:
- string
- 'null'
description: The current quarter of the game (1, 2, 3, 4, HALF, OT, F, F/OT
or NULL if game has not yet started)
TimeRemaining:
type:
- string
- 'null'
description: The amount of time remaining in the current quarter (e.g. 11:23;
5:34; NULL if game is not in progress or at halftime)
Possession:
type:
- string
- 'null'
description: The team that currently has possession of the ball (Ex. PHI;
NE; NULL if game is not in progress or at halftime)
Down:
type:
- integer
- 'null'
description: The current down in the game (1, 2, 3, 4 or NULL)
Distance:
type:
- string
- 'null'
description: The yards to go for a first down (this can be any positive
number or "Goal")
YardLine:
type:
- integer
- 'null'
description: the yard line of the ball's current position on the field as
of the most recently completed play
YardLineTerritory:
type:
- string
- 'null'
description: The team's side of the field that the ball is on when the play
occurred
RedZone:
type:
- string
- 'null'
description: 'The team abbreviation [Key] that currently has the ball in
the opponent''s red zone (Ex: "SF"; "BAL" or NULL)'
AwayScoreQuarter1:
type:
- integer
- 'null'
description: Points scored by the away team in Quarter 1
AwayScoreQuarter2:
type:
- integer
- 'null'
description: Points scored by the away team in Quarter 2
AwayScoreQuarter3:
type:
- integer
- 'null'
description: Points scored by the away team in Quarter 3
AwayScoreQuarter4:
type:
- integer
- 'null'
description: Points scored by the away team in Quarter 4
AwayScoreOvertime:
type:
- integer
- 'null'
description: Points scored by the away team in overtime
HomeScoreQuarter1:
type:
- integer
- 'null'
description: Points scored by the home team in Quarter 1
HomeScoreQuarter2:
type:
- integer
- 'null'
description: Points scored by the home team in Quarter 2
HomeScoreQuarter3:
type:
- integer
- 'null'
description: Points scored by the home team in Quarter 3
HomeScoreQuarter4:
type:
- integer
- 'null'
description: Points scored by the home team in Quarter 4
HomeScoreOvertime:
type:
- integer
- 'null'
description: Points scored by the home team in overtime
HasStarted:
type: boolean
description: Whether the game has started (true/false)
IsInProgress:
type: boolean
description: Whether the game is currently in progress (true/false)
IsOver:
type: boolean
description: Whether the game is over (true/false)
Has1stQuarterStarted:
type: boolean
description: Whether the 1st quarter has started
Has2ndQuarterStarted:
type: boolean
description: Whether the 2nd quarter has started
Has3rdQuarterStarted:
type: boolean
description: Whether the 3rd quarter has started
Has4thQuarterStarted:
type: boolean
description: Whether the 4th quarter has started
IsOvertime:
type: boolean
description: Whether this game went into overtime
DownAndDistance:
type:
- string
- 'null'
description: The description of the down and distance for display purposes
QuarterDescription:
type:
- string
- 'null'
description: Description of the current quarter for display purposes
StadiumID:
type:
- integer
- 'null'
description: The unique ID of the team's current home stadium
LastUpdated:
type:
- string
- 'null'
description: The date and time that this game was last updated (in US Eastern
Time)
GeoLat:
type:
- number
- 'null'
description: The geographic latitude coordinate of the venue where the game
is taking place
GeoLong:
type:
- number
- 'null'
description: The geographic longitude coordinate of the venue where the
game is taking place
ForecastTempLow:
type:
- integer
- 'null'
description: The forecasted low temperature on game day at this venue (Fahrenheit)
ForecastTempHigh:
type:
- integer
- 'null'
description: The forecasted high temperature on game day at this venue (Fahrenheit)
ForecastDescription:
type:
- string
- 'null'
description: The forecast description on game day at this venue.
ForecastWindChill:
type:
- integer
- 'null'
description: The forecasted wind chill on game day at this venue.
ForecastWindSpeed:
type:
- integer
- 'null'
description: The forecasted wind speed on game day at this venue.
AwayTeamMoneyLine:
type:
- integer
- 'null'
description: The sportsbook's moneyline for the away team
HomeTeamMoneyLine:
type:
- integer
- 'null'
description: The sportsbook's moneyline for the home team
Canceled:
type:
- boolean
- 'null'
description: Indicates whether the game was canceled
Closed:
type:
- boolean
- 'null'
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'
LastPlay:
type:
- string
- 'null'
description: 'The description of the most recent play/event of the game.
Note: This is for display purposes and does not include corresponding
data points'
Day:
type:
- string
- 'null'
description: The date of the game (in US Eastern Time)
DateTime:
type:
- string
- 'null'
description: The date and time of the game (in US Eastern Time)
AwayTeamID:
type:
- integer
- 'null'
description: The unique ID of the away team
HomeTeamID:
type:
- integer
- 'null'
description: The unique ID of the home team
GlobalGameID:
type:
- integer
- 'null'
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
PointSpreadAwayTeamMoneyLine:
type:
- integer
- 'null'
description: The payout on the away team's spread
PointSpreadHomeTeamMoneyLine:
type:
- integer
- 'null'
description: The payout on the home team's spread
ScoreID:
type: integer
description: Unique ID of the Score/Game
StadiumDetails:
$ref: '#/components/schemas/Stadium'
description: The details of the stadium where this game is played
Status:
type:
- string
- 'null'
description: The status of the game. For a description of possible values,
see here. For how suspended and postponed games are handled
specifically, see here.
GameEndDateTime:
type:
- string
- 'null'
description: 'The date and time of when the game officially ended. Note:
This field is populated after the game and score are finalized'
HomeRotationNumber:
type:
- integer
- 'null'
description: Rotation number of home team in this game
AwayRotationNumber:
type:
- integer
- 'null'
description: Rotation number of away team in this game
NeutralVenue:
type:
- boolean
- 'null'
description: Indicates whether this game is played in a neutral venue
RefereeID:
type:
- integer
- 'null'
description: The unique ID of the head referee
OverPayout:
type:
- integer
- 'null'
description: The sportsbook's payout for over the total points line
UnderPayout:
type:
- integer
- 'null'
description: The sportsbook's payout for the under
HomeTimeouts:
type:
- integer
- 'null'
description: The number of timeouts remaining for the Home Team
AwayTimeouts:
type:
- integer
- 'null'
description: The number of timeouts remaining for the Away Team
DateTimeUTC:
type:
- string
- 'null'
description: The date and time of the game (in UTC)
Attendance:
type: integer
description: The total attendance for the game
IsClosed:
type:
- boolean
- 'null'
description: Indicates whether the game is over and the final score has
been verified and closed out.
News:
properties:
NewsID:
type: integer
description: 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 date/time that the content was published (in US Eastern
time)
TimeAgo:
type:
- string
- 'null'
description: A description of how long ago this content was published
Title:
type:
- string
- 'null'
description: The brief title of the news (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 story
TermsOfUse:
type:
- string
- 'null'
description: The terms of use with using this news item, credit must be
given to the originator of the story when specified in the terms of use
Author:
type:
- string
- 'null'
description: The author of the content
Categories:
type:
- string
- 'null'
description: 'Comma delimited meta tags describing the categories of this
content. Possible tags include: Top Headlines, Breaking News, Injury,
Sit/Start, Waiver Wire, Risers, Fallers, Lineups, Transactions, Free Agents,
Prospects/Rookies, Game Recap, Matchup Outlook, NFL Draft'
PlayerID:
type:
- integer
- 'null'
description: 'The unique PlayerID as assigned by SportsDataIO of the player
tied to this news story. 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 the story
PlayerID2:
type:
- integer
- 'null'
description: 'The unique PlayerID as assigned by SportsDataIO of the second
player tied to this news story. Note: this ID will stay with the player
throughout their entire career'
TeamID2:
type:
- integer
- 'null'
description: The unique ID of the second team that relates to this story
Team2:
type:
- string
- 'null'
description: The abbreviation [Key] of the second team that relates to the
story
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
Schedule:
properties:
GameKey:
type:
- string
- 'null'
description: 'A 9 digit unique code identifying the game that this record
corresponds to. The GameID is composed of Season; SeasonType; Week and
HomeTeam. Note: This value will be NULL for bye weeks'
SeasonType:
type: integer
description: The type of season that this game corresponds to (1=Regular
Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star)
Season:
type: integer
description: The NFL season of the game
Week:
type: integer
description: 'The NFL week of the game (regular season: 1 to 18; preseason:
0 to 4; postseason: 1 to 4). Note: seasons after 2021 will have only 3
preseason weeks'
Date:
type:
- string
- 'null'
description: The date and time of the game (in US Eastern Time)
AwayTeam:
type:
- string
- 'null'
description: The abbreviation [Key] of the away team
HomeTeam:
type:
- string
- 'null'
description: The abbreviation [Key] of the home team
Channel:
type:
- string
- 'null'
description: The television station broadcasting the game
PointSpread:
type:
- number
- 'null'
description: The oddsmaker point spread at game start from the perspective
of the team (negative numbers indicate the HomeTeam is favored; positive
numbers indicate the AwayTeam is favored)
OverUnder:
type:
- number
- 'null'
description: The total points line (over/under) at game start
StadiumID:
type:
- integer
- 'null'
description: The unique ID of the team's current home stadium
Canceled:
type:
- boolean
- 'null'
description: Indicates whether the game was canceled
GeoLat:
type:
- number
- 'null'
description: The geographic latitude coordinate of the venue where the game
is taking place
GeoLong:
type:
- number
- 'null'
description: The geographic longitude coordinate of the venue where the
game is taking place
ForecastTempLow:
type:
- integer
- 'null'
description: The forecasted low temperature on game day at this venue (Fahrenheit).
ForecastTempHigh:
type:
- integer
- 'null'
description: The forecasted high temperature on game day at this venue (Fahrenheit).
ForecastDescription:
type:
- string
- 'null'
description: The forecast description on game day at this venue.
ForecastWindChill:
type:
- integer
- 'null'
description: The forecasted wind chill on game day at this venue.
ForecastWindSpeed:
type:
- integer
- 'null'
description: The forecasted wind speed on game day at this venue.
AwayTeamMoneyLine:
type:
- integer
- 'null'
description: The sportsbook's moneyline for the away team
HomeTeamMoneyLine:
type:
- integer
- 'null'
description: The sportsbook's moneyline for the home team
Day:
type:
- string
- 'null'
description: The date of the game (in US Eastern Time)
DateTime:
type:
- string
- 'null'
description: The date and time of the game (in US Eastern Time)
GlobalGameID:
type:
- integer
- 'null'
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
ScoreID:
type: integer
description: Unique ID of the score/game
StadiumDetails:
$ref: '#/components/schemas/Stadium'
description: The details of the stadium where this game is played
Status:
type:
- string
- 'null'
description: The status of the game. For a description of possible values,
see here. For how suspended and postponed games are handled
specifically, see here.
IsClosed:
type:
- boolean
- 'null'
description: Indicates whether the game is over and the final score has
been verified and closed out.
DateTimeUTC:
type:
- string
- 'null'
description: The date and time of the game (in UTC)
Standing:
properties:
SeasonType:
type: integer
description: The type of season that this game corresponds to (1=Regular
Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star).
Season:
type: integer
description: The NFL season for which these totals apply
Conference:
type:
- string
- 'null'
description: The conference of the team (e.g. AFC or NFC)
Division:
type:
- string
- 'null'
description: The division of the team (e.g. East; North; South; West)
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
Name:
type:
- string
- 'null'
description: The full name of the team
Wins:
type: integer
description: Total number of wins by the team in the season
Losses:
type: integer
description: Regular season losses by the team
Ties:
type: integer
description: Total ties by the team
Percentage:
type: number
description: The winning percentage of the team in the season
PointsFor:
type: integer
description: Total points scored by the team in the season
PointsAgainst:
type: integer
description: Total points allowed by the team during the season
NetPoints:
type: integer
description: Difference between PointsFor and PointsAgainst for the team
Touchdowns:
type:
- integer
- 'null'
description: Total touchdowns scored by the team
DivisionWins:
type: integer
description: Regular season wins within the division by the team
DivisionLosses:
type: integer
description: Regular season losses within the division by the team
ConferenceWins:
type: integer
description: Regular season wins within the conference by the team
ConferenceLosses:
type: integer
description: Regular season losses within the conference by the team
TeamID:
type: integer
description: The unique ID of the team
DivisionTies:
type: integer
description: Regular season ties within the division by the team
ConferenceTies:
type: integer
description: Regular season ties within the conference by the team
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team. This value is guaranteed
to be unique across all sports/leagues.
DivisionRank:
type: integer
description: Team's rank within the division
ConferenceRank:
type: integer
description: Team's rank within the conference
HomeWins:
type:
- integer
- 'null'
description: Home wins for the team
HomeLosses:
type:
- integer
- 'null'
description: Home losses for the team
HomeTies:
type:
- integer
- 'null'
description: Home ties for the team
AwayWins:
type:
- integer
- 'null'
description: Away wins for the team
AwayLosses:
type:
- integer
- 'null'
description: Away losses for the team
AwayTies:
type:
- integer
- 'null'
description: Away ties for the team
Streak:
type:
- integer
- 'null'
description: The current winning or losing streak for this team (negative
numbers represent losing streaks).
ClinchedDivision:
type:
- boolean
- 'null'
description: Returns TRUE if team has clinched their division; FALSE if
not
ClinchedWildCard:
type:
- boolean
- 'null'
description: Returns TRUE if team has clinched a Wild Card spot; FALSE if
not
ClinchedBye:
type:
- boolean
- 'null'
description: Returns TRUE if team has clinched a first-round bye in the
playoffs; FALSE if not
EliminatedFromPlayoffContention:
type:
- boolean
- 'null'
description: Returns TRUE if team has been eliminated from playoff contention;
FALSE if not
Timeframe:
properties:
SeasonType:
type: integer
description: The season type of the timeframe (1=Regular Season, 2=Preseason,
3=Postseason, 4=Offseason, 5=All-Star)
Season:
type: integer
description: The league year of the timeframe (this gets incremented on
the first day of the league year during free agency)
Week:
type:
- integer
- 'null'
description: 'The week of the timeframe (regular season: 1 to 18; preseason:
0 to 4; postseason: 1 to4; offseason=NULL). Note: seasons after 2021 will
have only 3 preseason weeks'
Name:
type:
- string
- 'null'
description: The friendly name of the Timeframe
ShortName:
type:
- string
- 'null'
description: The shorter name of the Timeframe
StartDate:
type:
- string
- 'null'
description: The start date/time of this Timeframe
EndDate:
type:
- string
- 'null'
description: The end date and time of the timeframe
FirstGameStart:
type:
- string
- 'null'
description: The start date/time of the first game of the Timeframe (if
no games then returns the StartDate)
FirstGameEnd:
type:
- string
- 'null'
description: The end date/time of the first game of the Timeframe (if no
games then returns the EndDate)
LastGameEnd:
type:
- string
- 'null'
description: The end date/time of the last game of the Timeframe (if no
games then returns the EndDate)
HasGames:
type: boolean
description: Whether there are any games in this Timeframe
HasStarted:
type: boolean
description: Whether this Timeframe has started
HasEnded:
type: boolean
description: Whether this Timeframe has ended
HasFirstGameStarted:
type: boolean
description: Whether the first game has started
HasFirstGameEnded:
type: boolean
description: Whether the first game has ended
HasLastGameEnded:
type: boolean
description: Whether the last game has ended
ApiSeason:
type:
- string
- 'null'
description: The value of the Season parameter used to pass into the API
ApiWeek:
type:
- string
- 'null'
description: The value of the Week parameter used to pass into the API
TeamGame:
properties:
GameKey:
type:
- string
- 'null'
description: 'A 9 digit unique code identifying the game that this record
corresponds to. The GameID is composed of Season; SeasonType; Week and
HomeTeam. Note: This value will be NULL for bye weeks'
Date:
type:
- string
- 'null'
description: The date and time of the game (in US Eastern Time)
SeasonType:
type: integer
description: The type of season that this team corresponds to (1=Regular
Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star)
Season:
type: integer
description: The NFL season of the game
Week:
type:
- integer
- 'null'
description: 'The NFL week of the game (regular season: 1 to 18; preseason:
0 to 4; postseason: 1 to 4). For seasons prior to 2021 there will be 3
preseason weeks'
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
Opponent:
type:
- string
- 'null'
description: The abbreviation [Key] of the opponent team
HomeOrAway:
type:
- string
- 'null'
description: Whether the team is home or away
Score:
type: integer
description: The final score of the team in the game
OpponentScore:
type: integer
description: The final score of the opponent team in the game
TotalScore:
type: integer
description: The total points scored by both teams in the game
Stadium:
type:
- string
- 'null'
description: Stadium of the event
PlayingSurface:
type:
- string
- 'null'
description: The playing surface of the stadium
Temperature:
type:
- integer
- 'null'
description: Temperature at game start (Fahrenheit)
Humidity:
type:
- integer
- 'null'
description: The humidity percentage at the start of the game
WindSpeed:
type:
- integer
- 'null'
description: The wind speed at the start of the game (in MPH)
OverUnder:
type:
- number
- 'null'
description: The total points line (over/under) for the team in the game
PointSpread:
type:
- number
- 'null'
description: The oddsmaker point spread at game start from the perspective
of the team (negative numbers indicate the HomeTeam is favored; positive
numbers indicate the AwayTeam is favored)
ScoreQuarter1:
type:
- integer
- 'null'
description: Points scored during Quarter 1 for the team in the game
ScoreQuarter2:
type:
- integer
- 'null'
description: Points scored during Quarter 2 for the team in the game
ScoreQuarter3:
type:
- integer
- 'null'
description: Points scored during Quarter 3 for the team in the game
ScoreQuarter4:
type:
- integer
- 'null'
description: Points scored during Quarter 4 for the team in the game
ScoreOvertime:
type: integer
description: Points scored during overtime for the team in the game
TimeOfPossessionMinutes:
type:
- integer
- 'null'
description: Total time of possession (minutes) by the team in the game
TimeOfPossessionSeconds:
type:
- integer
- 'null'
description: Total time of possession (seconds) by the team in the game
TimeOfPossession:
type:
- string
- 'null'
description: Total time of possession by the team in the game
FirstDowns:
type:
- integer
- 'null'
description: Total first downs by the team in the game
FirstDownsByRushing:
type:
- integer
- 'null'
description: Total rushing first downs by the team in the game
FirstDownsByPassing:
type:
- integer
- 'null'
description: Total passing first downs by the team in the game
FirstDownsByPenalty:
type:
- integer
- 'null'
description: Total first downs by opponent's penalty by the team in the
game
OffensivePlays:
type: integer
description: Number of offensive plays run by the team in the game
OffensiveYards:
type: integer
description: Total offensive yards gained by the team in the game
OffensiveYardsPerPlay:
type: number
description: Average yards gained per offensive play by the team in the
game
Touchdowns:
type:
- integer
- 'null'
description: Total touchdowns scored by the team in the game
RushingAttempts:
type:
- integer
- 'null'
description: Total rushing attempts by the team in the game
RushingYards:
type:
- integer
- 'null'
description: Total rushing yards by the team in the game
RushingYardsPerAttempt:
type: number
description: Total rushing yards per attempt by the team in the game
RushingTouchdowns:
type:
- integer
- 'null'
description: Total rushing touchdowns by the team in the game
PassingAttempts:
type:
- integer
- 'null'
description: Total passes thrown by the team in the game
PassingCompletions:
type:
- integer
- 'null'
description: Total passes completed by the team in the game
PassingYards:
type:
- integer
- 'null'
description: Total passing yards by the team in the game
PassingTouchdowns:
type:
- integer
- 'null'
description: Total passing touchdowns by the team in the game
PassingInterceptions:
type:
- integer
- 'null'
description: Total interceptions thrown by the team in the game
PassingYardsPerAttempt:
type: number
description: Total average passing yards per attempt by the team in the
game
PassingYardsPerCompletion:
type: number
description: Total average passing yards per completion by the team in the
game
CompletionPercentage:
type: number
description: The date and time of the game (in US Eastern Time)
PasserRating:
type:
- number
- 'null'
description: The team's passer rating in the game
ThirdDownAttempts:
type:
- integer
- 'null'
description: Total third down attempts by the team in the game
ThirdDownConversions:
type:
- integer
- 'null'
description: Total percentage of third downs converted by the team in the
game
ThirdDownPercentage:
type:
- number
- 'null'
description: Percentage of third downs converted
FourthDownAttempts:
type:
- integer
- 'null'
description: Total fourth down attempts by the team in the game
FourthDownConversions:
type:
- integer
- 'null'
description: Total fourth down conversions by the team in the game
FourthDownPercentage:
type:
- number
- 'null'
description: Percentage of fourth downs converted by the team in the game
RedZoneAttempts:
type:
- integer
- 'null'
description: Total red zone opportunities by the team in the game
RedZoneConversions:
type:
- integer
- 'null'
description: Total red zone opportunities converted into touchdowns by the
team in the game
GoalToGoAttempts:
type:
- integer
- 'null'
description: This field is deprecated
GoalToGoConversions:
type:
- integer
- 'null'
description: This field is deprecated
ReturnYards:
type:
- integer
- 'null'
description: Total punt and defensive return yards by the team in the game
Penalties:
type:
- integer
- 'null'
description: Total penalties committed by the team in the game
PenaltyYards:
type:
- integer
- 'null'
description: Total penalty yards enforced against the team
Fumbles:
type:
- integer
- 'null'
description: Total fumbles by the team in the game
FumblesLost:
type:
- integer
- 'null'
description: Total fumbles lost by the team in the game
TimesSacked:
type:
- integer
- 'null'
description: Total number of sacks allowed by the team in the game
TimesSackedYards:
type:
- integer
- 'null'
description: Total sack yards allowed by the team in the game
QuarterbackHits:
type:
- integer
- 'null'
description: 'Total quarterback hits by the team in the game. Note: This
is a defensive stat that includes sacks'
TacklesForLoss:
type:
- integer
- 'null'
description: 'Total tackles for loss by the team in the game. Note: These
are tackles behind the line of scrimmage for loss of yards (including
sacks)'
Safeties:
type:
- integer
- 'null'
description: Total defensive safeties scored by the team in the game
Punts:
type:
- integer
- 'null'
description: Total number of punts by the team in the game
PuntYards:
type:
- integer
- 'null'
description: Total punt yards by the team in the game
PuntAverage:
type: number
description: The average number of yards per punt by the team in the game
Giveaways:
type: integer
description: Total number of giveaways by the team in the game
Takeaways:
type: integer
description: Total takeaways by the team in the game
TurnoverDifferential:
type: integer
description: Total turnover differential (takeaways minus giveaways) by
the team in the game
OpponentScoreQuarter1:
type:
- integer
- 'null'
description: Points scored during Quarter 1 for the opponent team in the
game
OpponentScoreQuarter2:
type:
- integer
- 'null'
description: Points scored during Quarter 2 for the opponent team in the
game
OpponentScoreQuarter3:
type:
- integer
- 'null'
description: Points scored during Quarter 3 for the opponent team in the
game
OpponentScoreQuarter4:
type:
- integer
- 'null'
description: Points scored during Quarter 4 for the opponent team in the
game
OpponentScoreOvertime:
type: integer
description: Points scored during overtime for the opponent team in the
game
OpponentTimeOfPossessionMinutes:
type:
- integer
- 'null'
description: Total time of possession minutes for the opponent team in the
game
OpponentTimeOfPossessionSeconds:
type:
- integer
- 'null'
description: Total time of possession seconds for the opponent team in the
game
OpponentTimeOfPossession:
type:
- string
- 'null'
description: Total time of possession for the opponent team in the game
OpponentFirstDowns:
type:
- integer
- 'null'
description: Total first downs converted by the opponent team in the game
OpponentFirstDownsByRushing:
type:
- integer
- 'null'
description: Total rushing first downs by the opponent team in the game
OpponentFirstDownsByPassing:
type:
- integer
- 'null'
description: Total passing first downs converted by the opponent team in
the game
OpponentFirstDownsByPenalty:
type:
- integer
- 'null'
description: Total first downs by penalty for the opponent team in the game
OpponentOffensivePlays:
type: integer
description: Total offensive plays by the opponent team in the game
OpponentOffensiveYards:
type: integer
description: Total offensive yards gained by the opponent team in the game
OpponentOffensiveYardsPerPlay:
type: number
description: Average yards gained per offensive play by the opponent team
in the game
OpponentTouchdowns:
type:
- integer
- 'null'
description: Total touchdowns scored by the opponent team in the game
OpponentRushingAttempts:
type:
- integer
- 'null'
description: Total rushing attempts by the opponent team in the game
OpponentRushingYards:
type:
- integer
- 'null'
description: Total rushing yards by the opponent team in the game
OpponentRushingYardsPerAttempt:
type: number
description: Average rushing yards gained per attempt by the opponent team
in the game
OpponentRushingTouchdowns:
type:
- integer
- 'null'
description: Total rushing touchdowns by the opponent team in the game
OpponentPassingAttempts:
type:
- integer
- 'null'
description: Total passes thrown by the opponent team in the game
OpponentPassingCompletions:
type:
- integer
- 'null'
description: Total passing completions by the opponent team in the game
OpponentPassingYards:
type:
- integer
- 'null'
description: Total passing yards by the opponent team in the game
OpponentPassingTouchdowns:
type:
- integer
- 'null'
description: Total passing touchdowns by the opponent team in the game
OpponentPassingInterceptions:
type:
- integer
- 'null'
description: Total interceptions thrown by the opponent team in the game
OpponentPassingYardsPerAttempt:
type: number
description: Average passing yards gained per attempt by the opponent team
in the game
OpponentPassingYardsPerCompletion:
type: number
description: Average passing yards gained per completion by the opponent
team in the game
OpponentCompletionPercentage:
type: number
description: Total completion percentage of the opponent team in the game
OpponentPasserRating:
type:
- number
- 'null'
description: Total passer rating by the opponent team in the game
OpponentThirdDownAttempts:
type:
- integer
- 'null'
description: Total third down attempts by the opponent team in the game
OpponentThirdDownConversions:
type:
- integer
- 'null'
description: Total third down conversions by the opponent team in the game
OpponentThirdDownPercentage:
type:
- number
- 'null'
description: Total third down percentage by the opponent team in the game
OpponentFourthDownAttempts:
type:
- integer
- 'null'
description: Total fourth downs attempted by the opponent team in the game
OpponentFourthDownConversions:
type:
- integer
- 'null'
description: Total fourth downs converted by the opponent team in the game
OpponentFourthDownPercentage:
type:
- number
- 'null'
description: Total fourth down conversion percentage by the opponent team
in the game
OpponentRedZoneAttempts:
type:
- integer
- 'null'
description: Total red zone opportunities by the opponent team in the game
OpponentRedZoneConversions:
type:
- integer
- 'null'
description: Total red zone opportunities converted to touchdowns by the
opponent team in the game
OpponentGoalToGoAttempts:
type:
- integer
- 'null'
description: This field is deprecated
OpponentGoalToGoConversions:
type:
- integer
- 'null'
description: This field is deprecated
OpponentReturnYards:
type:
- integer
- 'null'
description: Total punt and defensive return yards by the opponent team
in the game
OpponentPenalties:
type:
- integer
- 'null'
description: Total penalties enforced against the opponent team in the game
OpponentPenaltyYards:
type:
- integer
- 'null'
description: Total penalty yards enforced against the opponent team in the
game
OpponentFumbles:
type:
- integer
- 'null'
description: Total offensive fumbles by the opponent team in the game
OpponentFumblesLost:
type:
- integer
- 'null'
description: Total fumbles lost by the opponent team in the game
OpponentTimesSacked:
type:
- integer
- 'null'
description: Total sacks allowed by the opponent team in the game
OpponentTimesSackedYards:
type:
- integer
- 'null'
description: Total yards as a result of a sack allowed by the opponent team
in the game
OpponentQuarterbackHits:
type:
- integer
- 'null'
description: Total quarterback hits by the opponent team in the game
OpponentTacklesForLoss:
type:
- integer
- 'null'
description: Total tackles for loss by the opponent team in the game
OpponentSafeties:
type:
- integer
- 'null'
description: Total safeties recorded by the opponent team in the game
OpponentPunts:
type:
- integer
- 'null'
description: Total punts by the opponent team in the game
OpponentPuntYards:
type:
- integer
- 'null'
description: Total punt yards by the opponent team in the game
OpponentPuntAverage:
type: number
description: Average number of yards per punt
OpponentGiveaways:
type: integer
description: Total giveaways by the opponent team in the game
OpponentTakeaways:
type: integer
description: Total takeaways by the opponent team in the game
OpponentTurnoverDifferential:
type: integer
description: Total turnover differential by the opponent team in the game
(takeaways minus giveaways)
RedZonePercentage:
type:
- number
- 'null'
description: Total percentage of red zone opportunities converted into touchdowns
by the team in the game
GoalToGoPercentage:
type:
- number
- 'null'
description: This field is deprecated
QuarterbackHitsDifferential:
type:
- integer
- 'null'
description: 'The quarterback hits differential of the team in the game.
Note: Determined by hits on opposing quarterback minus hits on own quarterback'
TacklesForLossDifferential:
type:
- integer
- 'null'
description: Total tackles for loss differential by the team in the game
QuarterbackSacksDifferential:
type: integer
description: Total sack differential of the team in the game
TacklesForLossPercentage:
type:
- number
- 'null'
description: Total percentage of plays defended that resulted in a tackle
for loss by the team in the game
QuarterbackHitsPercentage:
type:
- number
- 'null'
description: Total percentage of opposing quarterback dropbacks that resulted
in a quarterback hit by the team in the game
TimesSackedPercentage:
type: number
description: Total percentage of drop backs that resulted in a sack by the
team in the game
OpponentRedZonePercentage:
type:
- number
- 'null'
description: Percentage of opponent's red zone opportunities converted into
touchdowns in the game
OpponentGoalToGoPercentage:
type:
- number
- 'null'
description: This field is deprecated
OpponentQuarterbackHitsDifferential:
type:
- integer
- 'null'
description: Total quarterback hits differential by the opponent team in
the game
OpponentTacklesForLossDifferential:
type:
- integer
- 'null'
description: Total tackles for loss differential by the opponent team in
the game
OpponentQuarterbackSacksDifferential:
type:
- integer
- 'null'
description: Total quarterback sacks differential by the opponent team in
the game
OpponentTacklesForLossPercentage:
type:
- number
- 'null'
description: Total percentage of tackles for loss by the opponent team in
the game
OpponentQuarterbackHitsPercentage:
type:
- number
- 'null'
description: Total quarterback hits percentage by the opponent team in the
game
OpponentTimesSackedPercentage:
type: number
description: Total percentage of dropbacks that resulted in a sack allowed
by the opponent team in the game
Kickoffs:
type:
- integer
- 'null'
description: Total number of kickoffs by the team in the game
KickoffsInEndZone:
type:
- integer
- 'null'
description: Total kickoffs that went into the end zone by the team in the
game
KickoffTouchbacks:
type:
- integer
- 'null'
description: Total kickoffs that resulted in touchbacks by the team in the
game
PuntsHadBlocked:
type:
- integer
- 'null'
description: Total punts by the team that were blocked in the game
PuntNetAverage:
type:
- number
- 'null'
description: The average net yards per punt by the team in the game
ExtraPointKickingAttempts:
type:
- integer
- 'null'
description: Total extra point kick attempts by the team in the game
ExtraPointKickingConversions:
type:
- integer
- 'null'
description: Total extra point kicks made by the team in the game
ExtraPointsHadBlocked:
type:
- integer
- 'null'
description: Total extra point kick attempts by the team that were blocked
in the game
ExtraPointPassingAttempts:
type:
- integer
- 'null'
description: Total two point conversions passing conversions by the team
in the game
ExtraPointPassingConversions:
type:
- integer
- 'null'
description: Total two point conversions passing conversions by the team
in the game
ExtraPointRushingAttempts:
type:
- integer
- 'null'
description: Total two point conversion rushing attempts by the team in
the game
ExtraPointRushingConversions:
type:
- integer
- 'null'
description: Total two point conversion rushing conversions in the game
FieldGoalAttempts:
type:
- integer
- 'null'
description: Total field goal attempts by the team in the game
FieldGoalsMade:
type:
- integer
- 'null'
description: Total field goals made by the team in game
FieldGoalsHadBlocked:
type:
- integer
- 'null'
description: Total field goals by the team that were blocked in the game
PuntReturns:
type:
- integer
- 'null'
description: Total punt returns by the team in the game
PuntReturnYards:
type:
- integer
- 'null'
description: Total punt return yards by the team in the game
KickReturns:
type:
- integer
- 'null'
description: Total kickoff returns by the team in the game
KickReturnYards:
type:
- integer
- 'null'
description: Total kickoff return yards by the team in the game
InterceptionReturns:
type:
- integer
- 'null'
description: Total defensive interception returns by the team in the game
InterceptionReturnYards:
type:
- integer
- 'null'
description: Total defensive interception return yards by the team in the
game
OpponentKickoffs:
type:
- integer
- 'null'
description: Total kickoffs by the opponent team in the game
OpponentKickoffsInEndZone:
type:
- integer
- 'null'
description: Total kickoffs that went into the end zone by the opponent
team in the game
OpponentKickoffTouchbacks:
type:
- integer
- 'null'
description: Total kickoffs that resulted in touchbacks by the opponent
team in the game
OpponentPuntsHadBlocked:
type:
- integer
- 'null'
description: Total punt yard that were blocked for the opponent team in
the game
OpponentPuntNetAverage:
type:
- number
- 'null'
description: This field is deprecated
OpponentExtraPointKickingAttempts:
type:
- integer
- 'null'
description: Total extra point kick attempts by the opponent team in the
game
OpponentExtraPointKickingConversions:
type:
- integer
- 'null'
description: Total extra point kicks made by the opponent team in the game
OpponentExtraPointsHadBlocked:
type:
- integer
- 'null'
description: Total extra point kick attempts that were blocked against the
opponent team in the game
OpponentExtraPointPassingAttempts:
type:
- integer
- 'null'
description: Total two point conversion passing attempts by the opponent
team in the game
OpponentExtraPointPassingConversions:
type:
- integer
- 'null'
description: Total two point conversion passing conversions by the opponent
team in the game
OpponentExtraPointRushingAttempts:
type:
- integer
- 'null'
description: Total two point conversion rushing attempts by the opponent
team in the game
OpponentExtraPointRushingConversions:
type:
- integer
- 'null'
description: Total two point conversion rushing conversions by the opponent
team in the game
OpponentFieldGoalAttempts:
type:
- integer
- 'null'
description: Total field goal attempts by the opponent team in the game
OpponentFieldGoalsMade:
type:
- integer
- 'null'
description: Total field goals made by the opponent team in the game
OpponentFieldGoalsHadBlocked:
type:
- integer
- 'null'
description: Total blocked field goals against the opponent team in the
game
OpponentPuntReturns:
type:
- integer
- 'null'
description: Total punt returns by the opponent team in the game
OpponentPuntReturnYards:
type:
- integer
- 'null'
description: Total punt return yards by the opponent team in the game
OpponentKickReturns:
type:
- integer
- 'null'
description: Total kickoff returns by the opponent team in the game
OpponentKickReturnYards:
type:
- integer
- 'null'
description: Total kickoff return yards by the opponent team in the game
OpponentInterceptionReturns:
type:
- integer
- 'null'
description: Total defensive interceptions by the opponent team in the game
OpponentInterceptionReturnYards:
type:
- integer
- 'null'
description: Total defensive interception return yards by the opponent team
in the game
SoloTackles:
type:
- integer
- 'null'
description: Total defensive solo (unassisted) tackles by the team in the
game
AssistedTackles:
type:
- integer
- 'null'
description: Total defensive assisted tackles by the team in the game
Sacks:
type:
- integer
- 'null'
description: Total defensive sacks by the team in the game
SackYards:
type:
- integer
- 'null'
description: Total defensive sack yards by the team in the game
PassesDefended:
type:
- integer
- 'null'
description: Total passes defended by the team's defense in the game
FumblesForced:
type:
- integer
- 'null'
description: Total fumbles forced on defense by the team in the game
FumblesRecovered:
type:
- integer
- 'null'
description: Total defensive fumble recoveries by the team in the game
FumbleReturnYards:
type:
- integer
- 'null'
description: Total fumble return yards by the team in the game
FumbleReturnTouchdowns:
type:
- integer
- 'null'
description: Total fumble return touchdowns by the team in the game
InterceptionReturnTouchdowns:
type:
- integer
- 'null'
description: Total defensive interception return touchdowns by the team
in the game
BlockedKicks:
type:
- integer
- 'null'
description: 'Total blocked kicks by the team in the game. Note: BlockedKicks
include Field Goals and Punts but NOT Extra Points'
PuntReturnTouchdowns:
type:
- integer
- 'null'
description: Total punt return touchdowns by the team in the game
PuntReturnLong:
type:
- integer
- 'null'
description: The longest punt return by the team in the game
KickReturnTouchdowns:
type:
- integer
- 'null'
description: Total kickoff return touchdowns by the team in the game
KickReturnLong:
type:
- integer
- 'null'
description: Longest kick return by the team in the game
BlockedKickReturnYards:
type:
- integer
- 'null'
description: Total blocked kick recovery return yards for the team in the
game
BlockedKickReturnTouchdowns:
type:
- integer
- 'null'
description: Total blocked kick recovery return touchdowns for the team
in the game
FieldGoalReturnYards:
type:
- integer
- 'null'
description: 'Total field goal return yards by the team in the game. Note:
This field excludes blocked field goals'
FieldGoalReturnTouchdowns:
type:
- integer
- 'null'
description: 'Total field goal return touchdowns by the team in the game.
Note: This field excludes blocked field goals'
PuntNetYards:
type:
- integer
- 'null'
description: The net yards of the punts by the team in the game
OpponentSoloTackles:
type:
- integer
- 'null'
description: Total defensive solo tackles by the opponent team in the game
OpponentAssistedTackles:
type:
- integer
- 'null'
description: Total defensive assisted tackles by the opponent team in the
game
OpponentSacks:
type:
- integer
- 'null'
description: Total defensive sacks by the opponent team in the game
OpponentSackYards:
type:
- integer
- 'null'
description: Total defensive sack yards by the opponent team in the game
OpponentPassesDefended:
type:
- integer
- 'null'
description: Total passes defended by the opponent team in the game
OpponentFumblesForced:
type:
- integer
- 'null'
description: Total defensive fumbles forced by the opponent team in the
game
OpponentFumblesRecovered:
type:
- integer
- 'null'
description: Total defensive fumble recoveries by the opponent team in the
game
OpponentFumbleReturnYards:
type:
- integer
- 'null'
description: Total defensive fumbles return yards by the opponent team in
the game
OpponentFumbleReturnTouchdowns:
type:
- integer
- 'null'
description: Total defensive fumbles return touchdowns by the opponent team
in the game
OpponentInterceptionReturnTouchdowns:
type:
- integer
- 'null'
description: Total defensive interception touchdowns by the opponent team
in the game
OpponentBlockedKicks:
type:
- integer
- 'null'
description: Total blocked kicks against the opponent team in the game
OpponentPuntReturnTouchdowns:
type:
- integer
- 'null'
description: Total punt return touchdowns by the opponent team in the game
OpponentPuntReturnLong:
type:
- integer
- 'null'
description: Longest punt return by the opponent team in the game
OpponentKickReturnTouchdowns:
type:
- integer
- 'null'
description: Total kickoff return touchdowns by the opponent team in the
game
OpponentKickReturnLong:
type:
- integer
- 'null'
description: Longest kick return by the opponent team in the game
OpponentBlockedKickReturnYards:
type:
- integer
- 'null'
description: Total blocked kick return yards by the opponent team in the
game
OpponentBlockedKickReturnTouchdowns:
type:
- integer
- 'null'
description: Total blocked kick return touchdowns by the opponent team in
the game
OpponentFieldGoalReturnYards:
type:
- integer
- 'null'
description: 'Total field goal return yards by the opponent team in the
game. Note: Excludes blocked field goals (only for straight misses that
are returned)'
OpponentFieldGoalReturnTouchdowns:
type:
- integer
- 'null'
description: 'Total field goal return touchdowns by the opponent team in
the game. Note: Excludes blocked field goals (only for straight misses
that are returned)'
OpponentPuntNetYards:
type:
- integer
- 'null'
description: This field is deprecated
IsGameOver:
type:
- boolean
- 'null'
description: Whether the game is over (true/false)
TeamName:
type:
- string
- 'null'
description: The full name of the team (e.g. New England Patriots; Los Angeles
Chargers)
DayOfWeek:
type:
- string
- 'null'
description: The day of the week this game was played on (e.g. Sunday; Monday;
Thursday)
PassingDropbacks:
type:
- integer
- 'null'
description: Total number of times the team dropped back to pass in the
game
OpponentPassingDropbacks:
type:
- integer
- 'null'
description: Total passing dropbacks by the opponent team in the game
TeamGameID:
type: integer
description: Unique ID of this TeamGame record (subject to change; although
it very rarely does). For a guaranteed static ID; use a combination of
GameKey and Team.
PointDifferential:
type:
- integer
- 'null'
description: The team's total point differential in the game
PassingInterceptionPercentage:
type:
- number
- 'null'
description: 'The team''s percentage of passes that were intercepted by
the defense in the game. Note: This refers to the offensive team''s passes
that were intercepted'
PuntReturnAverage:
type:
- number
- 'null'
description: The average punt return yardage for the team in the game
KickReturnAverage:
type:
- number
- 'null'
description: Average kick return yards by the team in the game
ExtraPointPercentage:
type:
- number
- 'null'
description: Team's percentage of extra points made in the game
FieldGoalPercentage:
type:
- number
- 'null'
description: Team's percentage of field goals made in the game
OpponentPassingInterceptionPercentage:
type:
- number
- 'null'
description: Percentage of passes that were intercepted against the opponent
team in the game
OpponentPuntReturnAverage:
type:
- number
- 'null'
description: Punt return average of the opponent team in the game
OpponentKickReturnAverage:
type:
- number
- 'null'
description: Kick return average of the opponent team in the game
OpponentExtraPointPercentage:
type:
- number
- 'null'
description: Total extra point percentage by the opponent team in the game
OpponentFieldGoalPercentage:
type:
- number
- 'null'
description: Total field goal percentage by the opponent team in the game
PenaltyYardDifferential:
type:
- integer
- 'null'
description: The team's penalty yard differential in the game
PuntReturnYardDifferential:
type:
- integer
- 'null'
description: Punt return yard differential for the team in the game
KickReturnYardDifferential:
type:
- integer
- 'null'
description: Total kick return yard differential by the team in the game
TwoPointConversionReturns:
type:
- integer
- 'null'
description: Total successful two point conversion returns by the team in
the game
OpponentTwoPointConversionReturns:
type:
- integer
- 'null'
description: Total two point attempt returns converted by the defense for
the opponent team in the game
TeamID:
type:
- integer
- 'null'
description: The unique ID of this team
OpponentID:
type:
- integer
- 'null'
description: Total defensive interceptions by the opponent team in the game
Day:
type:
- string
- 'null'
description: The date of the game (in US Eastern Time)
DateTime:
type:
- string
- 'null'
description: The date of the game (in US Eastern Time)
GlobalGameID:
type:
- integer
- 'null'
description: A globally unique ID for this game. This value is guaranteed
to be unique across all sports/leagues
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team. This value is guaranteed
to be unique across all sports/leagues
GlobalOpponentID:
type:
- integer
- 'null'
description: A globally unique ID for this team's opponent. This value is
guaranteed to be unique across all sports/leagues
ScoreID:
type: integer
description: Unique ID of the score/game
TeamSeason:
properties:
SeasonType:
type: integer
description: The type of season that this team corresponds to (1=Regular
Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star)
Season:
type: integer
description: The NFL regular season for which these totals apply
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
Score:
type: integer
description: Total points scored by the team in the season
OpponentScore:
type: integer
description: Total points scored by opponent teams in the season
TotalScore:
type: integer
description: The total points scored and allowed by the team in the season
Temperature:
type:
- integer
- 'null'
description: Temperature at game start (Fahrenheit)
Humidity:
type:
- integer
- 'null'
description: The humidity percentage at the start of the game
WindSpeed:
type:
- integer
- 'null'
description: The wind speed at the start of the game (in MPH)
OverUnder:
type:
- number
- 'null'
description: The average total points line (over/under) for the team in
the season
PointSpread:
type:
- number
- 'null'
description: The average point spread from the perspecive of the team for
the season (negative numbers indicate the HomeTeam is favored; positive
numbers indicate the AwayTeam is favored)
ScoreQuarter1:
type:
- integer
- 'null'
description: Points scored during Quarter 1 for the team in the season
ScoreQuarter2:
type:
- integer
- 'null'
description: Points scored during Quarter 2 for the team in the season
ScoreQuarter3:
type:
- integer
- 'null'
description: Points scored during Quarter 3 for the team in the season
ScoreQuarter4:
type:
- integer
- 'null'
description: Points scored during Quarter 4 for the team in the season
ScoreOvertime:
type: integer
description: Points scored during overtime for the team in the season
TimeOfPossession:
type:
- string
- 'null'
description: Total average time of possession by the team in the season
FirstDowns:
type:
- integer
- 'null'
description: Total first downs by the team in the season
FirstDownsByRushing:
type:
- integer
- 'null'
description: Total rushing first downs by the team in the season
FirstDownsByPassing:
type:
- integer
- 'null'
description: Total passing first downs team in the season
FirstDownsByPenalty:
type:
- integer
- 'null'
description: Total first downs by opponent's penalty by the team in the
season
OffensivePlays:
type: integer
description: Number of offensive plays run by the season in the game
OffensiveYards:
type: integer
description: Total offensive yards gained by the team in the season
OffensiveYardsPerPlay:
type: number
description: Average yards gained per offensive play by the team in the
season
Touchdowns:
type:
- integer
- 'null'
description: Total touchdowns scored by the team in the season
RushingAttempts:
type:
- integer
- 'null'
description: Total rushing attempts by the team in the season
RushingYards:
type:
- integer
- 'null'
description: Total rushing yards by the team in the season
RushingYardsPerAttempt:
type: number
description: Total rushing yards per attempt by the team in the season
RushingTouchdowns:
type:
- integer
- 'null'
description: Total rushing touchdowns by the team in the season
PassingAttempts:
type:
- integer
- 'null'
description: Total passes thrown by the team in the season
PassingCompletions:
type:
- integer
- 'null'
description: Total passes completed by the team in the season
PassingYards:
type:
- integer
- 'null'
description: Total passing yards by the team in the season
PassingTouchdowns:
type:
- integer
- 'null'
description: Total passing touchdowns by the team in the season
PassingInterceptions:
type:
- integer
- 'null'
description: Total interceptions thrown by the team in the season
PassingYardsPerAttempt:
type: number
description: Total average passing yards per attempt by the team in the
season
PassingYardsPerCompletion:
type: number
description: Total average passing yards per completion by the team in the
season
CompletionPercentage:
type: number
description: Percentage of passes that were completed by the team in the
season
PasserRating:
type:
- number
- 'null'
description: The team's passer rating in the season
ThirdDownAttempts:
type:
- integer
- 'null'
description: Total third down attempts by the team in the season
ThirdDownConversions:
type:
- integer
- 'null'
description: Total third down conversions by the team in the season
ThirdDownPercentage:
type:
- number
- 'null'
description: Total percentage of third downs converted by the team in the
season
FourthDownAttempts:
type:
- integer
- 'null'
description: Total fourth down attempts by the team in the season
FourthDownConversions:
type:
- integer
- 'null'
description: Total fourth down conversions by the team in the season
FourthDownPercentage:
type:
- number
- 'null'
description: Percentage of fourth downs converted by the team in the season
RedZoneAttempts:
type:
- integer
- 'null'
description: Total red zone opportunities by the team in the season
RedZoneConversions:
type:
- integer
- 'null'
description: Total red zone opportunities converted into touchdowns by the
team in the season
GoalToGoAttempts:
type:
- integer
- 'null'
description: This field is deprecated
GoalToGoConversions:
type:
- integer
- 'null'
description: This field is deprecated
ReturnYards:
type:
- integer
- 'null'
description: Total punt and defensive return yards by the team in the season
Penalties:
type:
- integer
- 'null'
description: Total penalties committed by the team in the season
PenaltyYards:
type:
- integer
- 'null'
description: Total penalty yards enforced against the team
Fumbles:
type:
- integer
- 'null'
description: Total fumbles by the team in the season
FumblesLost:
type:
- integer
- 'null'
description: Total fumbles lost by the team in the season
TimesSacked:
type:
- integer
- 'null'
description: Total number of sacks allowed by the team in the season
TimesSackedYards:
type:
- integer
- 'null'
description: Total sack yards allowed by the team in the season
QuarterbackHits:
type:
- integer
- 'null'
description: 'Total quarterback hits by the team in the season. Note: This
is a defensive stat that includes sacks'
TacklesForLoss:
type:
- integer
- 'null'
description: 'Total tackles for loss by the team in the season. Note: These
are tackles behind the line of scrimmage for loss of yards (including
sacks)'
Safeties:
type:
- integer
- 'null'
description: Total defensive safeties scored by the team in the season
Punts:
type:
- integer
- 'null'
description: Total number of punts by the team in the game
PuntYards:
type:
- integer
- 'null'
description: Total punt yards by the team in the season
PuntAverage:
type: number
description: The average number of yards per punt by the team in the season
Giveaways:
type: integer
description: Total number of giveaways by the team in the season
Takeaways:
type: integer
description: Total takeaways by the team in the season
TurnoverDifferential:
type: integer
description: Total turnover differential (takeaways minus giveaways) by
the team in the season
OpponentScoreQuarter1:
type:
- integer
- 'null'
description: Points scored during Quarter 1 for the opponent teams in the
season
OpponentScoreQuarter2:
type:
- integer
- 'null'
description: Points scored during Quarter 2 for the opponent teams in the
season
OpponentScoreQuarter3:
type:
- integer
- 'null'
description: Points scored during Quarter 3 for the opponent teams in the
season
OpponentScoreQuarter4:
type:
- integer
- 'null'
description: Points scored during Quarter 4 for the opponent teams in the
season
OpponentScoreOvertime:
type: integer
description: Points scored during overtime for the opponent teams in the
season
OpponentTimeOfPossession:
type:
- string
- 'null'
description: Total average time of possession for the opponent teams in
the season
OpponentFirstDowns:
type:
- integer
- 'null'
description: Total first downs converted the opponent teams in the season
OpponentFirstDownsByRushing:
type:
- integer
- 'null'
description: Total rushing first downs by the opponent teams in the season
OpponentFirstDownsByPassing:
type:
- integer
- 'null'
description: Total passing first downs converted the opponent teams in the
season
OpponentFirstDownsByPenalty:
type:
- integer
- 'null'
description: Total first downs by penalty for the opponent teams in the
season
OpponentOffensivePlays:
type: integer
description: Total offensive plays by the opponent teams in the season
OpponentOffensiveYards:
type: integer
description: Total offensive yards gained by the opponent teams in the season
OpponentOffensiveYardsPerPlay:
type: number
description: Average yards gained per offensive play by the opponent teams
in the season
OpponentTouchdowns:
type:
- integer
- 'null'
description: Total touchdowns scored by the opponent teams in the season
OpponentRushingAttempts:
type:
- integer
- 'null'
description: Total rushing attempts by the opponent teams in the season
OpponentRushingYards:
type:
- integer
- 'null'
description: Total rushing yards by the opponent teams in the season
OpponentRushingYardsPerAttempt:
type: number
description: Average rushing yards gained per attempt by the opponent teams
in the season
OpponentRushingTouchdowns:
type:
- integer
- 'null'
description: Total rushing touchdowns by the opponent teams in the season
OpponentPassingAttempts:
type:
- integer
- 'null'
description: Total passes thrown by the opponent teams in the season
OpponentPassingCompletions:
type:
- integer
- 'null'
description: Total passing completions by the opponent teams in the season
OpponentPassingYards:
type:
- integer
- 'null'
description: Total passing yards by the opponent teams in the season
OpponentPassingTouchdowns:
type:
- integer
- 'null'
description: Total passing touchdowns by the opponent teams in the season
OpponentPassingInterceptions:
type:
- integer
- 'null'
description: Total interception thrown by the opponent teams in the season
OpponentPassingYardsPerAttempt:
type: number
description: Average passing yards gained per attempt by the opponent teams
in the season
OpponentPassingYardsPerCompletion:
type: number
description: Average passing yards gained per completion by the opponent
teams in the season
OpponentCompletionPercentage:
type: number
description: Total completion percentage of the opponent teams in the season
OpponentPasserRating:
type:
- number
- 'null'
description: Total passer rating by the opponent teams in the season
OpponentThirdDownAttempts:
type:
- integer
- 'null'
description: Total third down attempts by the opponent teams in the season
OpponentThirdDownConversions:
type:
- integer
- 'null'
description: Total third down conversions by the opponent teams in the season
OpponentThirdDownPercentage:
type:
- number
- 'null'
description: Total third down percentage by the opponent teams in the season
OpponentFourthDownAttempts:
type:
- integer
- 'null'
description: Total fourth downs attempted by the opponent teams in the season
OpponentFourthDownConversions:
type:
- integer
- 'null'
description: Total fourth downs converted by the opponent teams in the season
OpponentFourthDownPercentage:
type:
- number
- 'null'
description: Total fourth down conversion percentage by the opponent teams
in the season
OpponentRedZoneAttempts:
type:
- integer
- 'null'
description: Total red zone opportunities by the opponents in the season
OpponentRedZoneConversions:
type:
- integer
- 'null'
description: Total red zone opportunities converted to touchdowns by the
opponents in the season
OpponentGoalToGoAttempts:
type:
- integer
- 'null'
description: This field is deprecated
OpponentGoalToGoConversions:
type:
- integer
- 'null'
description: This field is deprecated
OpponentReturnYards:
type:
- integer
- 'null'
description: Total punt and defensive return yards by the opponent teams
in the season
OpponentPenalties:
type:
- integer
- 'null'
description: Total penalty yards enforced against the opponent teams in
the season
OpponentPenaltyYards:
type:
- integer
- 'null'
description: Total penalty yards enforced against the opponent teams in
the season
OpponentFumbles:
type:
- integer
- 'null'
description: Total offensive fumbles by the opponent teams in the season
OpponentFumblesLost:
type:
- integer
- 'null'
description: Total fumbles lost by the opponent teams in the season
OpponentTimesSacked:
type:
- integer
- 'null'
description: Total sacks allowed by the opponent teams in the season
OpponentTimesSackedYards:
type:
- integer
- 'null'
description: Total yards as a result of a sack allowed by the opponent teams
in the season
OpponentQuarterbackHits:
type:
- integer
- 'null'
description: Total quarterback hits by the opponent teams in the season
OpponentTacklesForLoss:
type:
- integer
- 'null'
description: Total tackles for loss by the opponent teams in the season
OpponentSafeties:
type:
- integer
- 'null'
description: Total safeties recorded by the opponent teams in the season
OpponentPunts:
type:
- integer
- 'null'
description: Total punts by the opponent teams in the season
OpponentPuntYards:
type:
- integer
- 'null'
description: Total punt yards by the opponent teams in the season
OpponentPuntAverage:
type: number
description: Average number of yards per punt by the opponent team in the
season
OpponentGiveaways:
type: integer
description: Total giveaways by the opponent teams in the season
OpponentTakeaways:
type: integer
description: Total takeaways by the opponent teams in the season
OpponentTurnoverDifferential:
type: integer
description: Total turnover differential by the opponent teams in the season
(takeaways minus giveaways)
RedZonePercentage:
type:
- number
- 'null'
description: Total percentage of red zone opportunities converted into touchdowns
by the team in the season
GoalToGoPercentage:
type:
- number
- 'null'
description: This field is deprecated
QuarterbackHitsDifferential:
type:
- integer
- 'null'
description: 'The quarterback hits differential of the team in the season.
Note: Determined by hits on opposing quarterback minus hits on own quarterback'
TacklesForLossDifferential:
type:
- integer
- 'null'
description: Total tackles for loss differential by the team in the season
QuarterbackSacksDifferential:
type: integer
description: Total sack differential of the team in the season
TacklesForLossPercentage:
type:
- number
- 'null'
description: Total percentage of plays defended that resulted in a tackle
for loss by the team in the season
QuarterbackHitsPercentage:
type:
- number
- 'null'
description: Total percentage of opposing quarterback dropbacks that resulted
in a quarterback hit by the team in the season
TimesSackedPercentage:
type: number
description: Total percentage of drop backs that resulted in a sack by the
team in the season
OpponentRedZonePercentage:
type:
- number
- 'null'
description: Percentage of opponent's red zone opportunities converted into
touchdowns in the season
OpponentGoalToGoPercentage:
type:
- number
- 'null'
description: This field is deprecated
OpponentQuarterbackHitsDifferential:
type:
- integer
- 'null'
description: Total quarterback hits differential by the opponent teams in
the season
OpponentTacklesForLossDifferential:
type:
- integer
- 'null'
description: Total tackles for loss differential by the opponent teams in
the season
OpponentQuarterbackSacksDifferential:
type:
- integer
- 'null'
description: Total quarterback sacks differential by the opponent teams
in the season
OpponentTacklesForLossPercentage:
type:
- number
- 'null'
description: Total percentage of tackles for loss by the opponent teams
in the season
OpponentQuarterbackHitsPercentage:
type:
- number
- 'null'
description: Percentage of own team's quarterback drop backs that resulted
in our quarterback getting hit
OpponentTimesSackedPercentage:
type: number
description: Total percentage of dropbacks that resulted in a sack allowed
by the opponent teams in the season
Kickoffs:
type:
- integer
- 'null'
description: Total number of kickoffs by the team in the season
KickoffsInEndZone:
type:
- integer
- 'null'
description: Total kickoffs that went into the end zone by the team in the
season
KickoffTouchbacks:
type:
- integer
- 'null'
description: Total kickoffs that resulted in touchbacks by the team in the
season
PuntsHadBlocked:
type:
- integer
- 'null'
description: Total punts by the team that were blocked in the season
PuntNetAverage:
type:
- number
- 'null'
description: The average net yards per punt by the team in the season
ExtraPointKickingAttempts:
type:
- integer
- 'null'
description: Total extra point kick attempts by the team in the season
ExtraPointKickingConversions:
type:
- integer
- 'null'
description: Total extra point kicks made by the team in the season
ExtraPointsHadBlocked:
type:
- integer
- 'null'
description: Total extra point kick attempts by the team that were blocked
in the season
ExtraPointPassingAttempts:
type:
- integer
- 'null'
description: Total two point conversion passing attempts by the team in
the season
ExtraPointPassingConversions:
type:
- integer
- 'null'
description: Total two point conversion passing conversions by the team
in the season
ExtraPointRushingAttempts:
type:
- integer
- 'null'
description: Total two point conversion rushing attempts by the team in
the season
ExtraPointRushingConversions:
type:
- integer
- 'null'
description: Total two point conversion rushing conversions in the season
FieldGoalAttempts:
type:
- integer
- 'null'
description: Total field goal attempts by the team in the season
FieldGoalsMade:
type:
- integer
- 'null'
description: Total field goals made by the team in season
FieldGoalsHadBlocked:
type:
- integer
- 'null'
description: Total field goals by the team that were blocked in the season
PuntReturns:
type:
- integer
- 'null'
description: Total punt returns by the team in the season
PuntReturnYards:
type:
- integer
- 'null'
description: Total punt return yards by the team in the season
KickReturns:
type:
- integer
- 'null'
description: Total kickoff returns by the team in the season
KickReturnYards:
type:
- integer
- 'null'
description: Total kickoff return yards by the team in the season
InterceptionReturns:
type:
- integer
- 'null'
description: Total defensive interception returns by the team in the season
InterceptionReturnYards:
type:
- integer
- 'null'
description: Total defensive interception return yards by the team in the
season
OpponentKickoffs:
type:
- integer
- 'null'
description: Total kickoffs by the opponent teams in the season
OpponentKickoffsInEndZone:
type:
- integer
- 'null'
description: Total kickoffs that went into the end zone by the opponent
teams in the season
OpponentKickoffTouchbacks:
type:
- integer
- 'null'
description: Total kickoffs that resulted in touchbacks by the opponent
teams in the season
OpponentPuntsHadBlocked:
type:
- integer
- 'null'
description: Total punt yard that were blocked for the opponent teams in
the season
OpponentPuntNetAverage:
type:
- number
- 'null'
description: Average net punt yards by the opponent team in the season
OpponentExtraPointKickingAttempts:
type:
- integer
- 'null'
description: Total extra point kick attempts by the opponent teams in the
season
OpponentExtraPointKickingConversions:
type:
- integer
- 'null'
description: Total extra point kicks made by the opponent teams in the season
OpponentExtraPointsHadBlocked:
type:
- integer
- 'null'
description: Total extra point kick attempts that were blocked against the
opponent teams in the season
OpponentExtraPointPassingAttempts:
type:
- integer
- 'null'
description: Total two point conversion passing attempts by the opponent
teams in the season
OpponentExtraPointPassingConversions:
type:
- integer
- 'null'
description: Total two point conversion passing conversions by the opponent
teams in the season
OpponentExtraPointRushingAttempts:
type:
- integer
- 'null'
description: Total two point conversion rushing attempts by the opponent
teams in the season
OpponentExtraPointRushingConversions:
type:
- integer
- 'null'
description: Total two point conversion rushing conversions by the opponent
teams in the season
OpponentFieldGoalAttempts:
type:
- integer
- 'null'
description: Total field goal attempts by the opponent teams in the season
OpponentFieldGoalsMade:
type:
- integer
- 'null'
description: Total field goals made the opponent teams in the season
OpponentFieldGoalsHadBlocked:
type:
- integer
- 'null'
description: Total blocked field goals against the opponent teams in the
season
OpponentPuntReturns:
type:
- integer
- 'null'
description: Total punt returns by the opponent teams in the season
OpponentPuntReturnYards:
type:
- integer
- 'null'
description: Total punt return yards the opponent teams in the season
OpponentKickReturns:
type:
- integer
- 'null'
description: Total kickoff returns by the opponent teams in the season
OpponentKickReturnYards:
type:
- integer
- 'null'
description: Total kickoff return yards by the opponent teams in the season
OpponentInterceptionReturns:
type:
- integer
- 'null'
description: Total defensive interceptions by the opponent teams in the
seasons
OpponentInterceptionReturnYards:
type:
- integer
- 'null'
description: Total defensive interception return yards by the opponent teams
in the seasons
SoloTackles:
type:
- integer
- 'null'
description: Total defensive solo (unassisted) tackles by the team in the
season
AssistedTackles:
type:
- integer
- 'null'
description: Total defensive assisted tackles by the team in the season
Sacks:
type:
- integer
- 'null'
description: Total defensive sacks by the team in the season
SackYards:
type:
- integer
- 'null'
description: Total defensive sack yards by the team in the season
PassesDefended:
type:
- integer
- 'null'
description: Total passes defended by the team's defense in the season
FumblesForced:
type:
- integer
- 'null'
description: Total fumbles forced on defense by the team in the season
FumblesRecovered:
type:
- integer
- 'null'
description: Total defensive fumble recoveries by the team in the season
FumbleReturnYards:
type:
- integer
- 'null'
description: Total fumble return yards by the team in the season
FumbleReturnTouchdowns:
type:
- integer
- 'null'
description: Total fumble return touchdowns by the team in the season
InterceptionReturnTouchdowns:
type:
- integer
- 'null'
description: Total defensive interception return touchdowns by the team
in the season
BlockedKicks:
type:
- integer
- 'null'
description: 'Total blocked kicks by the team in the season. Note: BlockedKicks
include Field Goals and Punts but NOT Extra Points'
PuntReturnTouchdowns:
type:
- integer
- 'null'
description: Total punt return touchdowns by the team in the season
PuntReturnLong:
type:
- integer
- 'null'
description: The longest punt return by the team in the season
KickReturnTouchdowns:
type:
- integer
- 'null'
description: Total kickoff return touchdowns by the team in the season
KickReturnLong:
type:
- integer
- 'null'
description: Longest kick return by the team in the season
BlockedKickReturnYards:
type:
- integer
- 'null'
description: Total blocked kick recovery return yards for the team in the
season
BlockedKickReturnTouchdowns:
type:
- integer
- 'null'
description: Total blocked kick recovery return touchdowns for the team
in the season
FieldGoalReturnYards:
type:
- integer
- 'null'
description: 'Total field goal return yards by the team in the season. Note:
This field excludes blocked field goals'
FieldGoalReturnTouchdowns:
type:
- integer
- 'null'
description: 'Total field goal return touchdowns by the team in the season.
Note: This field excludes blocked field goals'
PuntNetYards:
type:
- integer
- 'null'
description: The net yards of the punts by the team in the season
OpponentSoloTackles:
type:
- integer
- 'null'
description: Total defensive solo tackles by the opponent teams in the season
OpponentAssistedTackles:
type:
- integer
- 'null'
description: Total defensive assisted tackles by the opponent teams in the
season
OpponentSacks:
type:
- integer
- 'null'
description: Total defensive sacks by the opponent teams in the season
OpponentSackYards:
type:
- integer
- 'null'
description: Total defensive sack yards by the opponent teams in the season
OpponentPassesDefended:
type:
- integer
- 'null'
description: Total passes defended by the opponent teams in the season
OpponentFumblesForced:
type:
- integer
- 'null'
description: Total defensive fumbles forced by the opponent teams in the
season
OpponentFumblesRecovered:
type:
- integer
- 'null'
description: Total defensive fumble recoveries by the opponent teams in
the season
OpponentFumbleReturnYards:
type:
- integer
- 'null'
description: Total defensive fumbles return yards by the opponent teams
in the season
OpponentFumbleReturnTouchdowns:
type:
- integer
- 'null'
description: Total defensive fumbles return touchdowns by the opponent teams
in the season
OpponentInterceptionReturnTouchdowns:
type:
- integer
- 'null'
description: Total defensive interception touchdowns by the opponent teams
in the seasons
OpponentBlockedKicks:
type:
- integer
- 'null'
description: Total blocked kicks against the opponent teams in the season
OpponentPuntReturnTouchdowns:
type:
- integer
- 'null'
description: Total punt return touchdowns the opponent teams in the season
OpponentPuntReturnLong:
type:
- integer
- 'null'
description: Longest punt return by the opponent teams in the season
OpponentKickReturnTouchdowns:
type:
- integer
- 'null'
description: Total kickoff return touchdowns by the opponent teams in the
season
OpponentKickReturnLong:
type:
- integer
- 'null'
description: Longest kick return by the opponent teams in the season
OpponentBlockedKickReturnYards:
type:
- integer
- 'null'
description: Total blocked kick return yards by the opponent teams in the
season
OpponentBlockedKickReturnTouchdowns:
type:
- integer
- 'null'
description: Total blocked kick return touchdowns by the opponent teams
in the season
OpponentFieldGoalReturnYards:
type:
- integer
- 'null'
description: 'Total field goal return yards by the opponent teams in the
season. Note: Excludes blocked field goals (only for straight misses that
are returned)'
OpponentFieldGoalReturnTouchdowns:
type:
- integer
- 'null'
description: 'Total field goal return touchdowns by the opponent teams in
the season. Note: Excludes blocked field goals (only for straight misses
that are returned)'
OpponentPuntNetYards:
type:
- integer
- 'null'
description: Total net punt yards by the opponent team in the season
TeamName:
type:
- string
- 'null'
description: The full name of the team (e.g. New England Patriots; Los Angeles
Chargers)
Games:
type:
- integer
- 'null'
description: The total number of games played by the team in the season
PassingDropbacks:
type:
- integer
- 'null'
description: Total number of times the team dropped back to pass in the
season
OpponentPassingDropbacks:
type:
- integer
- 'null'
description: Total passing dropbacks by the opponent teams in the season
TeamSeasonID:
type: integer
description: The unique identifier for this TeamSeason record (subject to
change; although it very rarely does). For a static ID; use a combination
of SeasonType; Season and Team.
PointDifferential:
type:
- integer
- 'null'
description: The team's total point differential in the season
PassingInterceptionPercentage:
type:
- number
- 'null'
description: 'The team''s percentage of passes that were intercepted by
the defense in the season. Note: This refers to the offensive team''s
passes that were intercepted'
PuntReturnAverage:
type:
- number
- 'null'
description: The average punt return yardage for the team in the season
KickReturnAverage:
type:
- number
- 'null'
description: Average kick return yard by the team in the season
ExtraPointPercentage:
type:
- number
- 'null'
description: Team's percentage of extra points made in the season
FieldGoalPercentage:
type:
- number
- 'null'
description: Team's percentage of field goals made in the season
OpponentPassingInterceptionPercentage:
type:
- number
- 'null'
description: Percentage of passes that were intercepted against the opponent
teams in the season
OpponentPuntReturnAverage:
type:
- number
- 'null'
description: Punt return average of the opponent team in the seasons
OpponentKickReturnAverage:
type:
- number
- 'null'
description: Kick return average of the opponent teams in the season
OpponentExtraPointPercentage:
type:
- number
- 'null'
description: Total extra point percentage by the opponent teams in the season
OpponentFieldGoalPercentage:
type:
- number
- 'null'
description: Total field goal percentage by the opponent teams in the season
PenaltyYardDifferential:
type:
- integer
- 'null'
description: The team's penalty yard differential in the season
PuntReturnYardDifferential:
type:
- integer
- 'null'
description: Punt return yard differential for the team in the season
KickReturnYardDifferential:
type:
- integer
- 'null'
description: Total kick return yard differential by the team in the season
TwoPointConversionReturns:
type:
- integer
- 'null'
description: Total successful two point conversion returns by the team in
the season
OpponentTwoPointConversionReturns:
type:
- integer
- 'null'
description: Total two point attempt returns converted by the defense for
the opponent teams in the season
TeamID:
type:
- integer
- 'null'
description: The unique ID of the team
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team. This value is guaranteed
to be unique across all sports/leagues
TeamStatID:
type: integer
description: Unique ID of this TeamStatID record.
Player:
properties:
PlayerID:
type: integer
description: 'The unique PlayerID of the player as assigned by SportsDataIO.
Note: this ID will stay with the player throughout their entire career.'
Team:
type:
- string
- 'null'
description: 'The abbreviation [Key] of the team that the player is on.
Note: If this player is a free agent; this field is NULL.'
Number:
type:
- integer
- 'null'
description: Player's jersey number
FirstName:
type:
- string
- 'null'
description: Player's first name
LastName:
type:
- string
- 'null'
description: Player's last name
Position:
type:
- string
- 'null'
description: 'The primary position of the player. Possible Values: C; CB;
DB; DE; DL; DT; FB; FS; G; ILB; K; KR; LB; LS; NT; OL; OLB; OT; P; QB;
RB; S; SS; T; TE; WR.'
Status:
type:
- string
- 'null'
description: The player's current status. Possible values include Active,
Inactive, Injured Reserve, Physically Unable to Perform, Practice Squad,
Suspended, Non Football Injury, Non-Football Illness, Commissioner Exempt
List, Exempt/Left Team, Paternity, Bereavement, Reserve/COVID-19, and
Voluntary Opt Out. Inactive indicates that this player is a free agent. Active
indicates that this player is on his team's active roster.
Height:
type:
- string
- 'null'
description: Height in feet, inches
Weight:
type:
- integer
- 'null'
description: Player's weight in pounds
BirthDate:
type:
- string
- 'null'
description: Player's date of birth
College:
type:
- string
- 'null'
description: College team the player played for prior to turning professional
Experience:
type:
- integer
- 'null'
description: 'Number of years experience. Note: This number is incremented
every year; in the Spring; when we load the rookies following the NFL
Draft. Rookies will have Experience = 0; while second year players will
have Experience = 2.'
FantasyPosition:
type:
- string
- 'null'
description: 'The player''s fantasy football position. Possible values:
QB; RB; WR; TE; DL; LB; DB; K; P; OL.'
Active:
type:
- boolean
- 'null'
description: Whether or not the player is on the active roster of the NFL
team (True/False)
PositionCategory:
type:
- string
- 'null'
description: The category of the player's position (OFF; DEF; ST)
Name:
type:
- string
- 'null'
description: Player's full name
Age:
type:
- integer
- 'null'
description: The player's current age
ExperienceString:
type:
- string
- 'null'
description: The player's experience converted to a string
BirthDateString:
type:
- string
- 'null'
description: The player's date of birth converted to a string
PhotoUrl:
type:
- string
- 'null'
description: 'This field is deprecated. Note: Headshots are now delivered
through IMAGN. Please see our Headshots products for further information.'
ByeWeek:
type:
- integer
- 'null'
description: The week the player is on bye for the upcoming or current season
UpcomingGameOpponent:
type:
- string
- 'null'
description: The opposing team the player is playing against in the upcoming
week
UpcomingGameWeek:
type: integer
description: The week of the player's upcoming game (this will be the upcoming
week unless the player is on Bye that week, which would bump it to the
next week)
ShortName:
type:
- string
- 'null'
description: The first initial and last name of the player (J. Doe)
AverageDraftPosition:
type:
- number
- 'null'
description: The average draft position of the player in re-draft leagues
DepthPositionCategory:
type:
- string
- 'null'
description: The category (Offense, Defense or Special Teams) of the players
DepthPositionCategory (OFF, DEF, ST)
DepthPosition:
type:
- string
- 'null'
description: The position this player is listed at on his team's depth chart
(e.g. QB; LWR; RDE; LILB, K)
DepthOrder:
type:
- integer
- 'null'
description: The order this player is at his position (1 = Starter; 2 =
Backup; 3 = 3rd String; 4 = 4th String; 5 = 5th String)
DepthDisplayOrder:
type:
- integer
- 'null'
description: The display order of the positions (for display purposes)
CurrentTeam:
type:
- string
- 'null'
description: The team who currently employs this player. This value is null
when this player is unemployed (for example a free agent or retired player).
CollegeDraftTeam:
type:
- string
- 'null'
description: 'The team who drafted this player. Note: If this player was
an Undrafted Free Agent; then it''s the team who first signed him as a
rookie.'
CollegeDraftYear:
type:
- integer
- 'null'
description: The year this player entered the NFL as a rookie
CollegeDraftRound:
type:
- integer
- 'null'
description: The round this player was drafted in
CollegeDraftPick:
type:
- integer
- 'null'
description: The overall pick in the draft this player was selected
IsUndraftedFreeAgent:
type: boolean
description: Whether this player was an undrafted free agent. This value
is True if the player was not drafted.
HeightFeet:
type:
- integer
- 'null'
description: The feet component of a player's height (if player is 6'3",
then this value would be 6)
HeightInches:
type:
- integer
- 'null'
description: The inches component of a player's height (if player is 6'3",
then this value would be 3)
UpcomingOpponentRank:
type:
- integer
- 'null'
description: The player's upcoming opponent's rank in fantasy points allowed
UpcomingOpponentPositionRank:
type:
- integer
- 'null'
description: The player's upcoming opponent's rank in fantasy points allowed
to his fantasy position
CurrentStatus:
type:
- string
- 'null'
description: The player's current status. Possible values include Active,
Inactive, Injured Reserve, Physically Unable to Perform, Practice Squad,
Suspended, Non Football Injury, Non-Football Illness, Commissioner Exempt
List, Exempt/Left Team, Paternity, Bereavement, Reserve/COVID-19, and
Voluntary Opt Out. Inactive indicates that this player is a free agent. Active
indicates that this player is on his team's active roster. Can also include
injury status.
UpcomingSalary:
type:
- integer
- 'null'
description: The player's salary for the upcoming week in accordance with
a $50,000 salary cap. This is used for daily fantasy sports salary cap
contests. Salaries represent those published by DraftKings. When DraftKings
doesn't publish a salary for a given game; the most recent DraftKings
salary is used. We recommend using our new DFS endpoints instead.
FantasyAlarmPlayerID:
type:
- integer
- 'null'
description: The player's cross reference PlayerID to the FantasyAlarm news
feed
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
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 unique PlayerID for cross reference use with XML
Team data feeds
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 unique PlayerID for cross reference use with Yahoo
InjuryStatus:
type:
- string
- 'null'
description: The player's current injury status, in the form of likelihood
that player plays (Probable, Questionable, Doubtful, Out)
InjuryBodyPart:
type:
- string
- 'null'
description: The body part that is injured for the player (Knee; Groin;
Calf; Hamstring; etc.)
InjuryStartDate:
type:
- string
- 'null'
description: The day that the player's injury started or was first discovered
InjuryNotes:
type:
- string
- 'null'
description: A brief description of the player's injury and expected availability
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 name in Yahoo's daily fantasy sports platform
FantasyPositionDepthOrder:
type:
- integer
- 'null'
description: The order this player is at his team's FantasyPosition
InjuryPractice:
type:
- string
- 'null'
description: This field is deprecated
InjuryPracticeDescription:
type:
- string
- 'null'
description: This field is deprecated
DeclaredInactive:
type: boolean
description: 'Whether the player has been declared inactive. This value
is updated in the hours leading up to game start time; as teams announce
their inactive players. Note: This is only updated for offensive skill
position players (QB; RB; WR; TE).'
UpcomingFanDuelSalary:
type:
- integer
- 'null'
description: 'The player''s FanDuel salary for the upcoming week. Note:
We recommend using our new DFS endpoints instead.'
UpcomingDraftKingsSalary:
type:
- integer
- 'null'
description: 'The player''s DraftKings salary for the upcoming week. Note:
We recommend using our new DFS endpoints instead.'
UpcomingYahooSalary:
type:
- integer
- 'null'
description: The player's Yahoo salary for the upcoming week. We recommend
using our new DFS endpoints instead.
TeamID:
type:
- integer
- 'null'
description: 'The unique ID of the team that the player is on. Note: If
the player is a free agent; this field is NULL'
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team. This value is guaranteed
to be unique across all sports/leagues.
FantasyDraftPlayerID:
type:
- integer
- 'null'
description: The player's cross reference PlayerID to FantasyDraft
FantasyDraftName:
type:
- string
- 'null'
description: The player's full name in FantasyDraft's daily fantasy sports
platform
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.
PlayerDetail:
properties:
PlayerSeason:
$ref: '#/components/schemas/PlayerSeason'
description: This field is expected to be NULL
LatestNews:
type: array
items:
$ref: '#/components/schemas/News'
description: The latest news associated with this player
PlayerID:
type: integer
description: 'The unique PlayerID of the player as assigned by SportsDataIO.
Note: this ID will stay with the player throughout their entire career.'
Team:
type:
- string
- 'null'
description: 'The abbreviation [Key] of the team that the player is on.
Note: If this player is a free agent; this field is NULL.'
Number:
type:
- integer
- 'null'
description: Player's jersey number
FirstName:
type:
- string
- 'null'
description: Player's first name
LastName:
type:
- string
- 'null'
description: Player's last name
Position:
type:
- string
- 'null'
description: 'The primary position of the player. Possible Values: C; CB;
DB; DE; DL; DT; FB; FS; G; ILB; K; KR; LB; LS; NT; OL; OLB; OT; P; QB;
RB; S; SS; T; TE; WR.'
Status:
type:
- string
- 'null'
description: The player's current status. Possible values include Active,
Inactive, Injured Reserve, Physically Unable to Perform, Practice Squad,
Suspended, Non Football Injury, Non-Football Illness, Commissioner Exempt
List, Exempt/Left Team, Paternity, Bereavement, Reserve/COVID-19, and
Voluntary Opt Out. Inactive indicates that this player is a free agent. Active
indicates that this player is on his team's active roster.
Height:
type:
- string
- 'null'
description: Height in feet, inches
Weight:
type:
- integer
- 'null'
description: Player's weight in pounds
BirthDate:
type:
- string
- 'null'
description: Player's date of birth
College:
type:
- string
- 'null'
description: College team the player played for prior to turning professional
Experience:
type:
- integer
- 'null'
description: 'Number of years experience. Note: This number is incremented
every year; in the Spring; when we load the rookies following the NFL
Draft. Rookies will have Experience = 0; while second year players will
have Experience = 2.'
FantasyPosition:
type:
- string
- 'null'
description: 'The player''s fantasy football position. Possible values:
QB; RB; WR; TE; DL; LB; DB; K; P; OL.'
Active:
type:
- boolean
- 'null'
description: Whether or not the player is on the active roster of the NFL
team (True/False)
PositionCategory:
type:
- string
- 'null'
description: The category of the player's position (OFF; DEF; ST)
Name:
type:
- string
- 'null'
description: Player's full name
Age:
type:
- integer
- 'null'
description: The player's current age
ExperienceString:
type:
- string
- 'null'
description: The player's experience converted to a string
BirthDateString:
type:
- string
- 'null'
description: The player's date of birth converted to a string
PhotoUrl:
type:
- string
- 'null'
description: 'This field is deprecated. Note: Headshots are now delivered
through IMAGN. Please see our Headshots products for further information.'
ByeWeek:
type:
- integer
- 'null'
description: The week the player is on bye for the upcoming or current season
UpcomingGameOpponent:
type:
- string
- 'null'
description: The opposing team the player is playing against in the upcoming
week
UpcomingGameWeek:
type: integer
description: The week of the player's upcoming game (this will be the upcoming
week unless the player is on Bye that week, which would bump it to the
next week)
ShortName:
type:
- string
- 'null'
description: The first initial and last name of the player (J. Doe)
AverageDraftPosition:
type:
- number
- 'null'
description: The average draft position of the player in re-draft leagues
DepthPositionCategory:
type:
- string
- 'null'
description: The category (Offense, Defense or Special Teams) of the players
DepthPositionCategory (OFF, DEF, ST)
DepthPosition:
type:
- string
- 'null'
description: The position this player is listed at on his team's depth chart
(e.g. QB; LWR; RDE; LILB, K)
DepthOrder:
type:
- integer
- 'null'
description: The order this player is at his position (1 = Starter; 2 =
Backup; 3 = 3rd String; 4 = 4th String; 5 = 5th String)
DepthDisplayOrder:
type:
- integer
- 'null'
description: The display order of the positions (for display purposes)
CurrentTeam:
type:
- string
- 'null'
description: The team who currently employs this player. This value is null
when this player is unemployed (for example a free agent or retired player).
CollegeDraftTeam:
type:
- string
- 'null'
description: 'The team who drafted this player. Note: If this player was
an Undrafted Free Agent; then it''s the team who first signed him as a
rookie.'
CollegeDraftYear:
type:
- integer
- 'null'
description: The year this player entered the NFL as a rookie
CollegeDraftRound:
type:
- integer
- 'null'
description: The round this player was drafted in
CollegeDraftPick:
type:
- integer
- 'null'
description: The overall pick in the draft this player was selected
IsUndraftedFreeAgent:
type: boolean
description: Whether this player was an undrafted free agent. This value
is True if the player was not drafted.
HeightFeet:
type:
- integer
- 'null'
description: The feet component of a player's height (if player is 6'3",
then this value would be 6)
HeightInches:
type:
- integer
- 'null'
description: The inches component of a player's height (if player is 6'3",
then this value would be 3)
UpcomingOpponentRank:
type:
- integer
- 'null'
description: The player's upcoming opponent's rank in fantasy points allowed
UpcomingOpponentPositionRank:
type:
- integer
- 'null'
description: The player's upcoming opponent's rank in fantasy points allowed
to his fantasy position
CurrentStatus:
type:
- string
- 'null'
description: The player's current status. Possible values include Active,
Inactive, Injured Reserve, Physically Unable to Perform, Practice Squad,
Suspended, Non Football Injury, Non-Football Illness, Commissioner Exempt
List, Exempt/Left Team, Paternity, Bereavement, Reserve/COVID-19, and
Voluntary Opt Out. Inactive indicates that this player is a free agent. Active
indicates that this player is on his team's active roster. Can also include
injury status.
UpcomingSalary:
type:
- integer
- 'null'
description: The player's salary for the upcoming week in accordance with
a $50,000 salary cap. This is used for daily fantasy sports salary cap
contests. Salaries represent those published by DraftKings. When DraftKings
doesn't publish a salary for a given game; the most recent DraftKings
salary is used. We recommend using our new DFS endpoints instead.
FantasyAlarmPlayerID:
type:
- integer
- 'null'
description: The player's cross reference PlayerID to the FantasyAlarm news
feed
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
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 unique PlayerID for cross reference use with XML
Team data feeds
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 unique PlayerID for cross reference use with Yahoo
InjuryStatus:
type:
- string
- 'null'
description: The player's current injury status, in the form of likelihood
that player plays (Probable, Questionable, Doubtful, Out)
InjuryBodyPart:
type:
- string
- 'null'
description: The body part that is injured for the player (Knee; Groin;
Calf; Hamstring; etc.)
InjuryStartDate:
type:
- string
- 'null'
description: The day that the player's injury started or was first discovered
InjuryNotes:
type:
- string
- 'null'
description: A brief description of the player's injury and expected availability
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 name in Yahoo's daily fantasy sports platform
FantasyPositionDepthOrder:
type:
- integer
- 'null'
description: The order this player is at his team's FantasyPosition
InjuryPractice:
type:
- string
- 'null'
description: This field is deprecated
InjuryPracticeDescription:
type:
- string
- 'null'
description: This field is deprecated
DeclaredInactive:
type: boolean
description: 'Whether the player has been declared inactive. This value
is updated in the hours leading up to game start time; as teams announce
their inactive players. Note: This is only updated for offensive skill
position players (QB; RB; WR; TE).'
UpcomingFanDuelSalary:
type:
- integer
- 'null'
description: 'The player''s FanDuel salary for the upcoming week. Note:
We recommend using our new DFS endpoints instead.'
UpcomingDraftKingsSalary:
type:
- integer
- 'null'
description: 'The player''s DraftKings salary for the upcoming week. Note:
We recommend using our new DFS endpoints instead.'
UpcomingYahooSalary:
type:
- integer
- 'null'
description: The player's Yahoo salary for the upcoming week. We recommend
using our new DFS endpoints instead.
TeamID:
type:
- integer
- 'null'
description: 'The unique ID of the team that the player is on. Note: If
the player is a free agent; this field is NULL'
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team. This value is guaranteed
to be unique across all sports/leagues.
FantasyDraftPlayerID:
type:
- integer
- 'null'
description: The player's cross reference PlayerID to FantasyDraft
FantasyDraftName:
type:
- string
- 'null'
description: The player's full name in FantasyDraft's daily fantasy sports
platform
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.
PlayerSeason:
properties:
PlayerID:
type:
- integer
- 'null'
description: 'The unique PlayerID of the player as assigned by SportsDataIO.
Note: this ID will stay with the player throughout their entire career'
SeasonType:
type: integer
description: The type of season that this player corresponds to (1=Regular
Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star)
Season:
type: integer
description: The NFL season for which these totals apply
Team:
type:
- string
- 'null'
description: 'The abbreviation [Key] of the team that the player is on.
Note: If this player is a free agent; this field is NULL'
Number:
type: integer
description: Player's jersey number
Name:
type:
- string
- 'null'
description: Player's full name
Position:
type:
- string
- 'null'
description: 'The primary position of the player. Possible Values: C; CB;
DB; DE; DL; DT; FB; FS; G; ILB; K; KR; LB; LS; NT; OL; OLB; OT; P; QB;
RB; S; SS; T; TE; WR'
PositionCategory:
type:
- string
- 'null'
description: The category of the player's position (OFF; DEF; ST)
Activated:
type: integer
description: The total number of games that the player was active for in
the season
Played:
type: integer
description: The total number of games played by the the player in the season
Started:
type: integer
description: Total games started (on offense or defense) by the player in
the season
PassingAttempts:
type: number
description: Total passes thrown by the player in the season
PassingCompletions:
type: number
description: Total passes completed by the player in the season
PassingYards:
type: number
description: Total passing yards by the player in the season
PassingCompletionPercentage:
type: number
description: The percentage of passes completed by the player in the season
PassingYardsPerAttempt:
type: number
description: Total average passing yards per attempt by the player in the
season
PassingYardsPerCompletion:
type: number
description: Total average passing yards per completion by the player in
the season
PassingTouchdowns:
type: number
description: Total passing touchdowns by the player in the season
PassingInterceptions:
type: number
description: Total interceptions thrown by the player in the season
PassingRating:
type: number
description: The passer rating of the player in the season
PassingLong:
type: number
description: Total yards of longest completion by the player in the season
PassingSacks:
type: number
description: The total number of times the player was sacked in the season
PassingSackYards:
type: number
description: Total yards lost by the player in the season as a result of
being sacked
RushingAttempts:
type: number
description: Total rushing attempts by the player in the season
RushingYards:
type: number
description: Total rushing yards by the player in the season
RushingYardsPerAttempt:
type: number
description: Total rushing yards per attempt by the player in the season
RushingTouchdowns:
type: number
description: Total rushing touchdowns by the player in the season
RushingLong:
type: number
description: The longest rush by the player in the season
ReceivingTargets:
type:
- number
- 'null'
description: Total receiving targets by the player in the season
Receptions:
type: number
description: Total receptions by the player in the season
ReceivingYards:
type: number
description: Total receiving yards by the player in the season
ReceivingYardsPerReception:
type: number
description: Average receiving yards per reception by the player in the
season
ReceivingTouchdowns:
type: number
description: Total receiving touchdowns by the player in the season
ReceivingLong:
type: number
description: The longest reception by the player in the season
Fumbles:
type: number
description: Total fumbles by the player in the season
FumblesLost:
type:
- number
- 'null'
description: Total fumbles lost by the player in the season
PuntReturns:
type: number
description: Total punt returns by the player in the season
PuntReturnYards:
type: number
description: Total punt return yards by the player in the season
PuntReturnYardsPerAttempt:
type: number
description: Total average yards gained per punt return by the player in
the season
PuntReturnTouchdowns:
type: number
description: Total punt return touchdowns by the player in the season
PuntReturnLong:
type: number
description: The longest punt return by the player in the season
KickReturns:
type: number
description: Total kickoff returns by the player in the season
KickReturnYards:
type: number
description: Total kickoff return yards by the player in the season
KickReturnYardsPerAttempt:
type: number
description: Average yards gained per kick return by the player in the season
KickReturnTouchdowns:
type: number
description: Total kickoff return touchdowns by the player in the season
KickReturnLong:
type: number
description: Longest kick return by the player in the season
SoloTackles:
type: number
description: Total defensive solo (unassisted) tackles by the player in
the season
AssistedTackles:
type: number
description: Total defensive assisted tackles by the player in the season
TacklesForLoss:
type:
- number
- 'null'
description: 'Total tackles for loss by the player in the season. Note:
these are tackles behind the line of scrimmage for loss of yards (including
sacks)'
Sacks:
type: number
description: Total defensive sacks by the player in the season
SackYards:
type: number
description: Total defensive safeties scored by the player in the season
QuarterbackHits:
type:
- number
- 'null'
description: 'Total quarterback hits by the player in the season. Note:
This is a defensive stat that includes sacks'
PassesDefended:
type: number
description: Total passes defended by the player in the season
FumblesForced:
type: number
description: Total fumbles forced on defense by the player in the season
FumblesRecovered:
type: number
description: Total defensive fumble recoveries by the player in the season
FumbleReturnYards:
type: number
description: Total fumble return yards by the player in the season
FumbleReturnTouchdowns:
type: number
description: Total fumble return touchdowns by the player in the season
Interceptions:
type: number
description: Total defensive interceptions by the player in the season
InterceptionReturnYards:
type: number
description: Total defensive interception return yards by the player in
the season
InterceptionReturnTouchdowns:
type: number
description: Total defensive interception return touchdowns by the player
in the season
BlockedKicks:
type: number
description: 'Total blocked kicks by the player in the season. Note: BlockedKicks
include Field Goals and Punts but NOT Extra Points'
SpecialTeamsSoloTackles:
type: number
description: This field is deprecated
SpecialTeamsAssistedTackles:
type: number
description: This field is deprecated
MiscSoloTackles:
type: number
description: This field is deprecated
MiscAssistedTackles:
type: number
description: This field is deprecated
Punts:
type: number
description: Total number of punts by the player in the season
PuntYards:
type: number
description: Total punt yards by the player in the season
PuntAverage:
type: number
description: The average number of yards per punt by the player in the season
FieldGoalsAttempted:
type: number
description: Total field goals attempted by the player in the season
FieldGoalsMade:
type: number
description: Total field goals made by the player in season
FieldGoalsLongestMade:
type: number
description: Longest field goal made by the player in the season
ExtraPointsMade:
type: number
description: Total extra points made by the player in the season
TwoPointConversionPasses:
type: number
description: Total successful two point conversion passes by the player
in the season
TwoPointConversionRuns:
type: number
description: Total successful two point conversion rushes by the player
in the season
TwoPointConversionReceptions:
type: number
description: Total successful two point conversion receptions by the player
in the season
FantasyPoints:
type: number
description: Fantasy points scored based on basic fantasy scoring system
by the player in the season
FantasyPointsPPR:
type: number
description: Fantasy points scored based on basic PPR fantasy scoring system
by the player in the season
ReceptionPercentage:
type: number
description: Total percentage of receiving targets that were receptions
by the player in the season
ReceivingYardsPerTarget:
type: number
description: Average receiving yards per target by the player in the season
Tackles:
type: number
description: Total tackles (solo & assisted) by the player in the season
OffensiveTouchdowns:
type: number
description: Total offensive touchdowns scored by the player in the season
DefensiveTouchdowns:
type: number
description: Total defensive touchdowns scored by the player in the season
SpecialTeamsTouchdowns:
type: number
description: Total special teams touchdowns scored by the player in the
season
Touchdowns:
type: number
description: Total touchdowns scored by the player in the season
FantasyPosition:
type:
- string
- 'null'
description: 'The player''s fantasy football position. Possible values:
QB, RB, WR, TE, DL, LB, DB, K, P, OL'
FieldGoalPercentage:
type: number
description: Total field goal attempts made by the player in the season
PlayerSeasonID:
type: integer
description: Unique ID of PlayerSeason record (subject to change, although
it very rarely does). For a static ID, use a combination of SeasonType,
Season and PlayerID.
FumblesOwnRecoveries:
type:
- number
- 'null'
description: 'Total own fumble recoveries by the player in the season. Note:
this fumble doesn''t result in a turnover - the fumbling team recovers
the fumble'
FumblesOutOfBounds:
type:
- number
- 'null'
description: This field is deprecated
KickReturnFairCatches:
type:
- number
- 'null'
description: This field is deprecated
PuntReturnFairCatches:
type:
- number
- 'null'
description: This field is deprecated.
PuntTouchbacks:
type:
- number
- 'null'
description: Total punts that resulted in touchbacks by the player in the
season
PuntInside20:
type:
- number
- 'null'
description: Total punts downed inside the 20 yard line by the player in
the season
PuntNetAverage:
type:
- number
- 'null'
description: The average net yards per punt by the player in the season
ExtraPointsAttempted:
type:
- number
- 'null'
description: Total extra point kicks attempted by the player in the season
BlockedKickReturnTouchdowns:
type:
- number
- 'null'
description: Total blocked kick recovery return touchdowns for the player
in the season
FieldGoalReturnTouchdowns:
type:
- number
- 'null'
description: 'Total field goal return touchdowns by the player in the season.
Note: This field excludes blocked field goals'
Safeties:
type:
- number
- 'null'
description: Defensive safeties (sacks in end zone, solo tackles in end
zone, blocked kicks that went out of bounds in the end zone)
FieldGoalsHadBlocked:
type:
- number
- 'null'
description: Total field goals by the player that were blocked in the season
PuntsHadBlocked:
type:
- number
- 'null'
description: Total punts by the player that were blocked in the season
ExtraPointsHadBlocked:
type:
- number
- 'null'
description: Total extra point kick attempts by the player that were blocked
in the season
PuntLong:
type:
- number
- 'null'
description: The longest punt by the player in the season
BlockedKickReturnYards:
type:
- number
- 'null'
description: Total blocked kick recovery return yards for the player in
the season
FieldGoalReturnYards:
type:
- number
- 'null'
description: 'Total field goal return yards by the player in the season.
Note: This field excludes blocked field goals'
PuntNetYards:
type:
- number
- 'null'
description: The net yards of the punts by the player in the season
SpecialTeamsFumblesForced:
type:
- number
- 'null'
description: This field is deprecated
SpecialTeamsFumblesRecovered:
type:
- number
- 'null'
description: This field is deprecated
MiscFumblesForced:
type:
- number
- 'null'
description: This field is deprecated
MiscFumblesRecovered:
type:
- number
- 'null'
description: This field is deprecated
ShortName:
type:
- string
- 'null'
description: The first initial and last name of the player (J. Doe)
SafetiesAllowed:
type:
- number
- 'null'
description: This field is deprecated
Temperature:
type:
- integer
- 'null'
description: Temperature at game start (Fahrenheit)
Humidity:
type:
- integer
- 'null'
description: The humidity percentage at the start of the game
WindSpeed:
type:
- integer
- 'null'
description: The wind speed at the start of the game (in MPH)
OffensiveSnapsPlayed:
type:
- integer
- 'null'
description: 'Total snaps this player played on offensive in the season.
Note: Snap counts are available the morning after the game.'
DefensiveSnapsPlayed:
type:
- integer
- 'null'
description: 'Total snaps this player played on defense in the season. Note:
Snap counts are available the morning after the game.'
SpecialTeamsSnapsPlayed:
type:
- integer
- 'null'
description: 'Total snaps this player played on special teams in the season.
Note: Snap counts are available the morning after the game.'
OffensiveTeamSnaps:
type:
- integer
- 'null'
description: 'Total offensive snaps this player''s team played in the season.
Note: Snap counts are available the morning after the game.'
DefensiveTeamSnaps:
type:
- integer
- 'null'
description: 'Total defensive snaps this player''s team played in the season.
Note: Snap counts are available the morning after the game.'
SpecialTeamsTeamSnaps:
type:
- integer
- 'null'
description: 'Total special teams snaps this player''s team played in the
season. Note: Snap counts are available the morning after the game.'
AuctionValue:
type:
- number
- 'null'
description: Player's dollar value in a $200 salary cap auction draft.
AuctionValuePPR:
type:
- number
- 'null'
description: Player's dollar value in a $200 salary cap PPR auction draft.
TwoPointConversionReturns:
type:
- number
- 'null'
description: Total successful two point conversion returns by the player
in the season
FantasyPointsFanDuel:
type:
- number
- 'null'
description: Fantasy points based on FanDuel's scoring system by the player
in the season
FieldGoalsMade0to19:
type:
- number
- 'null'
description: Total field goals of 0 to 19 yards made by the player in season
FieldGoalsMade20to29:
type:
- number
- 'null'
description: Total field goals of 20 to 29 yards made by the player in season
FieldGoalsMade30to39:
type:
- number
- 'null'
description: Total field goals of 30 to 39 yards made by the player in season
FieldGoalsMade40to49:
type:
- number
- 'null'
description: Total field goals of 40 to 49 yards made by the player in season
FieldGoalsMade50Plus:
type:
- number
- 'null'
description: Total field goals of 50+ yards made by the player in season
FantasyPointsDraftKings:
type:
- number
- 'null'
description: Fantasy points based on DraftKings' scoring system by the player
in the season
FantasyPointsYahoo:
type:
- number
- 'null'
description: Fantasy points based on Yahoo's daily fantasy scoring system
by the player in the season
AverageDraftPosition:
type:
- number
- 'null'
description: The average draft position of the player in re-draft leagues
AverageDraftPositionPPR:
type:
- number
- 'null'
description: The average draft position of this player in Points Per Reception
(PPR) leagues.
TeamID:
type:
- integer
- 'null'
description: 'The unique ID of the team that the player is on. Note: If
the player is a free agent; this field is NULL'
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team. This value is guaranteed
to be unique across all sports/leagues
FantasyPointsFantasyDraft:
type:
- number
- 'null'
description: Fantasy points based on FantasyDraft's scoring system by the
player in the season
ScoringDetails:
type: array
items:
$ref: '#/components/schemas/ScoringDetail'
description: The details of the scoring plays this player recorded in the
season
AverageDraftPositionRookie:
type:
- number
- 'null'
description: The average draft position of this rookie in Points Per Reception
(PPR) leagues.
AverageDraftPositionDynasty:
type:
- number
- 'null'
description: The average draft position of this player in dynasty drafts
leagues
AverageDraftPosition2QB:
type:
- number
- 'null'
description: The average draft position of this player in 2 Quarterback
leagues
OffensiveFumbleRecoveryTouchdowns:
type:
- integer
- 'null'
description: This field is deprecated
ScoringDetail:
properties:
GameKey:
type:
- string
- 'null'
description: 'A 9 digit unique code identifying the game that this record
corresponds to. The GameID is composed of Season; SeasonType; Week and
HomeTeam. Note: This value will be NULL for bye weeks'
SeasonType:
type: integer
description: The type of season that this game corresponds to (1=Regular
Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star)
PlayerID:
type:
- integer
- 'null'
description: 'The unique PlayerID of the player as assigned by SportsDataIO
tied to this scoring detail. Note: this ID will stay with the player throughout
their entire career'
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
Season:
type: integer
description: The season during which the score happened
Week:
type: integer
description: 'The NFL week of the game (regular season: 1 to 18; preseason:
0 to 4; postseason: 1 to 4). Note: seasons after 2021 will have only 3
preseason weeks'
ScoringType:
type:
- string
- 'null'
description: The type of scoring play (e.g. BlockedFieldGoalReturnTouchdown,
BlockedPuntReturnTouchdown, FieldGoalMade, FieldGoalReturnTouchdown, FumbleReturnTouchdown,
InterceptionReturnTouchdown, KickoffReturnTouchdown, PassingTouchdown,
PuntReturnTouchdown, ReceivingTouchdown, RushingTouchdown, Safety)
Length:
type: integer
description: The length in yards of the score
ScoringDetailID:
type: integer
description: Unique ID of this scoring detail
PlayerGameID:
type: integer
description: Unique ID of the PlayerGame record tied to this scoring detail
ScoreID:
type:
- integer
- 'null'
description: Unique ID of the score/game
ScoringPlayID:
type:
- integer
- 'null'
description: Unique ID of the scoring play
Referee:
properties:
RefereeID:
type: integer
description: The unique ID of the referee
Name:
type:
- string
- 'null'
description: The name of the referee
Number:
type: integer
description: The referee's number
Position:
type:
- string
- 'null'
description: The referee's position
College:
type:
- string
- 'null'
description: The referee's college
Experience:
type: integer
description: The referee's years of experience
TeamDepthChart:
properties:
TeamID:
type: integer
description: Unique ID of Team
Offense:
type: array
items:
$ref: '#/components/schemas/DepthChart'
description: List of Offensive Depth Charts for Team
Defense:
type: array
items:
$ref: '#/components/schemas/DepthChart'
description: List of Defensive Depth Charts for Team
SpecialTeams:
type: array
items:
$ref: '#/components/schemas/DepthChart'
description: List of Special Teams Depth Charts for Team
DepthChart:
properties:
DepthChartID:
type: integer
description: Unique ID of Depth Chart Record
TeamID:
type: integer
description: Unique ID of Team
PlayerID:
type:
- integer
- 'null'
description: Unique ID of Player
Name:
type:
- string
- 'null'
description: Player's full name
PositionCategory:
type:
- string
- 'null'
description: The category of the player's depth chart position (OFF; DEF;
ST)
Position:
type:
- string
- 'null'
description: The player's depth chart position
DepthOrder:
type:
- integer
- 'null'
description: The order this player is at his position (1 = Starter; 2 =
Backup; 3 = 3rd String; 4 = 4th String; 5 = 5th String)
Updated:
type:
- string
- 'null'
description: Date and time last updated (in US Eastern Time)
ScheduleBasic:
properties:
GameID:
type:
- integer
- 'null'
description: The unique ID of the game
GlobalGameID:
type:
- integer
- 'null'
description: A globally unique ID for this game. This value is guaranteed
to be unique across all sports/leagues.
ScoreID:
type:
- integer
- 'null'
description: Unique ID of the score/game
GameKey:
type:
- string
- 'null'
description: 'A 9 digit unique code identifying the game that this record
corresponds to. The GameKey is composed of Season; SeasonType; Week and
HomeTeam. Note: This value will be NULL for bye weeks'
Season:
type: integer
description: The NFL season of the game
SeasonType:
type: integer
description: The type of season that this record corresponds to (1=Regular
Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar).
Status:
type:
- string
- 'null'
description: The status of the game. For a description of possible values,
see here. For how suspended and postponed games are handled
specifically, see here.
Canceled:
type:
- boolean
- 'null'
description: Indicates whether the game was canceled.
Date:
type:
- string
- 'null'
description: The date and time of the game (in US Eastern Time)
Day:
type:
- string
- 'null'
description: The date of the game (in US Eastern Time)
DateTime:
type:
- string
- 'null'
description: The date and time of the game (in US Eastern Time)
DateTimeUTC:
type:
- string
- 'null'
description: The date and time of the game (in UTC)
AwayTeam:
type:
- string
- 'null'
description: The abbreviation [Key] of the away team
HomeTeam:
type:
- string
- 'null'
description: The abbreviation [Key] of the home team
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.
AwayTeamID:
type:
- integer
- 'null'
description: The unique ID of the away team
HomeTeamID:
type:
- integer
- 'null'
description: The unique ID of the home team
StadiumID:
type:
- integer
- 'null'
description: The unique ID of the team's current home stadium
Closed:
type:
- boolean
- 'null'
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'
LastUpdated:
type:
- string
- 'null'
description: The date and time that this game was last updated (in US Eastern
Time)
IsClosed:
type:
- boolean
- 'null'
description: Indicates whether the game is over and the final score has
been verified and closed out.
Week:
type: integer
description: 'The NFL week of the game (regular season: 1 to 18; preseason:
0 to 4; postseason: 1 to 4). Note: seasons after 2021 will have only 3
preseason weeks'
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:
Quarter:
type:
- string
- 'null'
description: The current quarter of the game (1, 2, 3, 4, HALF, OT, F, F/OT
or NULL if game has not yet started)
TimeRemaining:
type:
- string
- 'null'
description: The amount of time remaining in the current quarter (e.g. 11:23;
5:34; NULL if game is not in progress or at halftime)
QuarterDescription:
type:
- string
- 'null'
description: Description of the current quarter for display purposes
GameEndDateTime:
type:
- string
- 'null'
description: 'The date and time of when the game officially ended. Note:
This field is populated after the game and score are finalized'
AwayScore:
type:
- integer
- 'null'
description: The final score of the away team
HomeScore:
type:
- integer
- 'null'
description: The final score of the Home Team
GameID:
type:
- integer
- 'null'
description: The unique ID of the game
GlobalGameID:
type:
- integer
- 'null'
description: A globally unique ID for this game. This value is guaranteed
to be unique across all sports/leagues.
ScoreID:
type:
- integer
- 'null'
description: Unique ID of the score/game
GameKey:
type:
- string
- 'null'
description: 'A 9 digit unique code identifying the game that this record
corresponds to. The GameKey is composed of Season; SeasonType; Week and
HomeTeam. Note: This value will be NULL for bye weeks'
Season:
type: integer
description: The NFL season of the game
SeasonType:
type: integer
description: The type of season that this record corresponds to (1=Regular
Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar).
Status:
type:
- string
- 'null'
description: The status of the game. For a description of possible values,
see here. For how suspended and postponed games are handled
specifically, see here.
Canceled:
type:
- boolean
- 'null'
description: Indicates whether the game was canceled.
Date:
type:
- string
- 'null'
description: The date and time of the game (in US Eastern Time)
Day:
type:
- string
- 'null'
description: The date of the game (in US Eastern Time)
DateTime:
type:
- string
- 'null'
description: The date and time of the game (in US Eastern Time)
DateTimeUTC:
type:
- string
- 'null'
description: The date and time of the game (in UTC)
AwayTeam:
type:
- string
- 'null'
description: The abbreviation [Key] of the away team
HomeTeam:
type:
- string
- 'null'
description: The abbreviation [Key] of the home team
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.
AwayTeamID:
type:
- integer
- 'null'
description: The unique ID of the away team
HomeTeamID:
type:
- integer
- 'null'
description: The unique ID of the home team
StadiumID:
type:
- integer
- 'null'
description: The unique ID of the team's current home stadium
Closed:
type:
- boolean
- 'null'
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'
LastUpdated:
type:
- string
- 'null'
description: The date and time that this game was last updated (in US Eastern
Time)
IsClosed:
type:
- boolean
- 'null'
description: Indicates whether the game is over and the final score has
been verified and closed out.
Week:
type: integer
description: 'The NFL week of the game (regular season: 1 to 18; preseason:
0 to 4; postseason: 1 to 4). Note: seasons after 2021 will have only 3
preseason weeks'
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.
TeamBasic:
properties:
Key:
type:
- string
- 'null'
description: Abbreviation [Key] of the team (e.g. LAC; PHI; NE; IND; etc.)
TeamID:
type: integer
description: The unique ID of the team
PlayerID:
type: integer
description: The auto-generated unique ID of the Team, that avoids collisions
with PlayerIDs. This is useful when combining players and fantasy defenses
to create fantasy teams.
City:
type:
- string
- 'null'
description: The city/location of the team (e.g. Minnesota; Philadelphia;
New England; Indianapolis; etc.)
Name:
type:
- string
- 'null'
description: The mascot of the team (e.g. Chargers, Eagles, Patriots, Colts,
etc.)
Conference:
type:
- string
- 'null'
description: The conference of the team (e.g. AFC or NFC)
Division:
type:
- string
- 'null'
description: The division of the team (e.g. East, North, South, West)
FullName:
type:
- string
- 'null'
description: The full name of the team (e.g. New England Patriots)
StadiumID:
type:
- integer
- 'null'
description: The unique ID of the team's current home stadium
ByeWeek:
type:
- integer
- 'null'
description: The bye week of the team in the upcoming or current regular
season
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team. This value is guaranteed
to be unique across all sports/leagues
HeadCoach:
type:
- string
- 'null'
description: The current head coach of the team
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)
OffensiveCoordinator:
type:
- string
- 'null'
description: 'The current offensive coordinator of the team. Note: field
will be NULL if team doesn''t have an OFF coordinator'
DefensiveCoordinator:
type:
- string
- 'null'
description: 'The current defensive coordinator of the team. Note: field
will be NULL if team doesn''t have an DEFF coordinator'
SpecialTeamsCoach:
type:
- string
- 'null'
description: 'The current special teams coordinator of the team. Note: field
will be NULL if team doesn''t have an ST coordinator'
OffensiveScheme:
type:
- string
- 'null'
description: The offensive scheme this team runs (PRO, 2TE, 3WR). This
is decided at our discretion.
DefensiveScheme:
type:
- string
- 'null'
description: The current defensive scheme this team runs (3-4, 4-3)
PlayerBasic:
properties:
PlayerID:
type: integer
description: 'The unique PlayerID of the player as assigned by SportsDataIO.
Note: this ID will stay with the player throughout their entire career'
Team:
type:
- string
- 'null'
description: 'The abbreviation [Key] of the team that the player is on.
Note: If this player is a free agent; this field is NULL'
Number:
type:
- integer
- 'null'
description: Player's jersey number
FirstName:
type:
- string
- 'null'
description: Player's first name
LastName:
type:
- string
- 'null'
description: Player's last name
Position:
type:
- string
- 'null'
description: 'The primary position of the player. Possible Values: C; CB;
DB; DE; DL; DT; FB; FS; G; ILB; K; KR; LB; LS; NT; OL; OLB; OT; P; QB;
RB; S; SS; T; TE; WR'
Status:
type:
- string
- 'null'
description: The player's current status. Possible values include Active,
Inactive, Injured Reserve, Physically Unable to Perform, Practice Squad,
Suspended, Non Football Injury, Non-Football Illness, Commissioner Exempt
List, Exempt/Left Team, Paternity, Bereavement, Reserve/COVID-19, and
Voluntary Opt Out. Inactive indicates that this player is a free agent. Active
indicates that this player is on his team's active roster.
Height:
type:
- string
- 'null'
description: Height in feet, inches
Weight:
type:
- integer
- 'null'
description: Weight in pounds
BirthDate:
type:
- string
- 'null'
description: The player's date of birth
College:
type:
- string
- 'null'
description: College team the player played for prior to turning professional
Experience:
type:
- integer
- 'null'
description: 'Number of years experience. Note: This number is incremented
every year; in the Spring; when we load the rookies following the NFL
Draft. Rookies will have Experience = Zero; while second year players
will have Experience = 2.'
FantasyPosition:
type:
- string
- 'null'
description: 'The player''s fantasy football position. Possible values:
QB; RB; WR; TE; DL; LB; DB; K; P; OL'
Active:
type:
- boolean
- 'null'
description: Whether or not the player is on the active roster of the NFL
team
PositionCategory:
type:
- string
- 'null'
description: The category of the player's position (OFF; DEF; ST)
Name:
type:
- string
- 'null'
description: The player's full name
Age:
type:
- integer
- 'null'
description: The player's current age
ShortName:
type:
- string
- 'null'
description: The first initial and last name of the player (J. Doe)
HeightFeet:
type:
- integer
- 'null'
description: The feet component of a player's height (if player is 6'3",
then this value would be 6)
HeightInches:
type:
- integer
- 'null'
description: The inches component of a player's height (if player is 6'3",
then this value would be 3)
TeamID:
type:
- integer
- 'null'
description: 'The unique ID of the team that the player is on. Note: If
the player is a free agent; this field is NULL'
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team. This value is guaranteed
to be unique across all sports/leagues.
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.
Transaction:
properties:
PlayerID:
type: integer
description: 'The unique PlayerID of the player as assigned by SportsDataIO
tied to this transaction. Note: this ID will stay with the player throughout
their entire career'
Name:
type:
- string
- 'null'
description: Player's full name
FormerTeamID:
type:
- integer
- 'null'
description: ID of Player's former team
FormerTeam:
type:
- string
- 'null'
description: Player's former team abbreviation [Key] (e.g. LAC; PHI; NE;
IND etc.)
TeamID:
type:
- integer
- 'null'
description: The unique ID of the team
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
Type:
type:
- string
- 'null'
description: Type of Transaction. Released, Waived, Signed, Promoted, Elevated,
Demoted, and Traded.
Date:
type:
- string
- 'null'
description: Date & time that the transaction took place (in US Eastern
Time)
Note:
type:
- string
- 'null'
description: Transaction Summary (e.g. "Harris has signed with the Commanders.")
Created:
type:
- string
- 'null'
description: Date and time of the transaction creation (in US Eastern Time)
Updated:
type:
- string
- 'null'
description: Date and time last updated (in US Eastern Time)
TeamDepthChartWeekly:
properties:
TeamID:
type: integer
description: Unique ID of Team
Offense:
type: array
items:
$ref: '#/components/schemas/DepthChartWeekly'
description: List of Offensive Depth Charts for Team
Defense:
type: array
items:
$ref: '#/components/schemas/DepthChartWeekly'
description: List of Defensive Depth Charts for Team
SpecialTeams:
type: array
items:
$ref: '#/components/schemas/DepthChartWeekly'
description: List of Special Teams Depth Charts for Team
DepthChartWeekly:
properties:
DepthChartWeeklyID:
type: integer
description: Unique ID of Depth Chart Weekly Record
TeamID:
type: integer
description: Unique ID of Team
PlayerID:
type:
- integer
- 'null'
description: Unique ID of Player
Name:
type:
- string
- 'null'
description: Player Name
PositionCategory:
type:
- string
- 'null'
description: Player Position Category (OFF, DEF, ST)
Position:
type:
- string
- 'null'
description: Player Position
DepthOrder:
type:
- integer
- 'null'
description: Depth Chart Order
Updated:
type:
- string
- 'null'
description: Date and Time Last Updated
FantasyDefenseSeasonProjection:
properties:
SeasonType:
type: integer
description: The type of season that this team corresponds to (1=Regular
Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star)
Season:
type: integer
description: The NFL regular season for which these totals apply
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
PointsAllowed:
type: number
description: Total points allowed by the team during the season
TouchdownsScored:
type: number
description: Total defensive and special teams touchdowns scored by the
team in the season
SoloTackles:
type: number
description: Total defensive solo (unassisted) tackles by the team in the
season
AssistedTackles:
type: number
description: Total defensive assisted tackles by the team in the season
Sacks:
type: number
description: Total defensive sacks by the team in the season
SackYards:
type: number
description: Total defensive sack yards by the team in the season
PassesDefended:
type: number
description: Total passes defended by the team in the season
FumblesForced:
type: number
description: Total fumbles forced on defense by the team in the season
FumblesRecovered:
type: number
description: Total defensive fumble recoveries by the team in the season
FumbleReturnYards:
type: number
description: Total fumble return yards by the team in the season
FumbleReturnTouchdowns:
type: number
description: Total fumble return touchdowns by the team in the season
Interceptions:
type: number
description: Total defensive interceptions by the team in the season
InterceptionReturnYards:
type: number
description: Total defensive interception return yards by the team in the
season
InterceptionReturnTouchdowns:
type: number
description: Total defensive interception return touchdowns by the team
in the season
BlockedKicks:
type: number
description: 'Total blocked kicks by the team in the season. Note: BlockedKicks
include Field Goals and Punts but NOT Extra Points'
Safeties:
type: number
description: Total defensive safeties scored by the team in the season
PuntReturns:
type: number
description: Total punt returns by the team in the season
PuntReturnYards:
type: number
description: Total punt return yards by the team in the season
PuntReturnTouchdowns:
type: number
description: Total punt return touchdowns by the team in the season
PuntReturnLong:
type: number
description: The longest punt return by the team in the season
KickReturns:
type: number
description: Total kickoff returns by the team in the season
KickReturnYards:
type: number
description: Total kickoff return yards by the team in the season
KickReturnTouchdowns:
type: number
description: Total kickoff return touchdowns by the team in the season
KickReturnLong:
type: number
description: Longest kick return by the team in the season
BlockedKickReturnTouchdowns:
type:
- number
- 'null'
description: Total blocked kick recovery return touchdowns for the team
in the season
FieldGoalReturnTouchdowns:
type:
- number
- 'null'
description: 'Total field goal return touchdowns by the team in the season.
Note: This field excludes blocked field goals'
FantasyPointsAllowed:
type:
- number
- 'null'
description: 'Fantasy points allowed to opposing offensive players in the
season. Note: positions include: QB; RB; WR; TE'
QuarterbackFantasyPointsAllowed:
type:
- number
- 'null'
description: Fantasy points allowed to opposing quarterbacks by the team
in the season
RunningbackFantasyPointsAllowed:
type:
- number
- 'null'
description: Total fantasy points allowed to opposing running backs by the
team in the season
WideReceiverFantasyPointsAllowed:
type:
- number
- 'null'
description: Fantasy points allowed to opposing wide receivers
TightEndFantasyPointsAllowed:
type:
- number
- 'null'
description: Fantasy points allowed to opposing tight ends by the team in
the season
KickerFantasyPointsAllowed:
type:
- number
- 'null'
description: Fantasy points allowed to opponent kickers by the team in the
season
Games:
type:
- integer
- 'null'
description: The total number of games played by the team in the season
BlockedKickReturnYards:
type:
- number
- 'null'
description: Total blocked kick recovery return yards for the team in the
season
FieldGoalReturnYards:
type:
- number
- 'null'
description: 'Total field goal return yards by the team in the season. Note:
This field excludes blocked field goals'
QuarterbackHits:
type:
- number
- 'null'
description: 'Total quarterback hits by the team in the season. Note: This
is a defensive stat that includes sacks'
TacklesForLoss:
type:
- number
- 'null'
description: 'Total tackles for loss by the team in the season. Note: these
are tackles behind the line of scrimmage for loss of yards (including
sacks)'
DefensiveTouchdowns:
type:
- number
- 'null'
description: Total defensive touchdowns scored by the team in the season
SpecialTeamsTouchdowns:
type:
- number
- 'null'
description: Total special teams touchdowns scored by the team in the season
FantasyPoints:
type:
- number
- 'null'
description: Fantasy points scored based on basic fantasy scoring system
by the team in the season
Temperature:
type:
- integer
- 'null'
description: Temperature at game start (Fahrenheit)
Humidity:
type:
- integer
- 'null'
description: The humidity percentage at the start of the game
WindSpeed:
type:
- integer
- 'null'
description: The wind speed at the start of the game (in MPH)
ThirdDownAttempts:
type:
- number
- 'null'
description: Total third down attempts against the team in the season
ThirdDownConversions:
type:
- number
- 'null'
description: Total third down conversions against the team in the season
FourthDownAttempts:
type:
- number
- 'null'
description: Opponent's fourth down attempts against the team in the season
FourthDownConversions:
type:
- number
- 'null'
description: Opponent's fourth down conversions against the team in the
season
PointsAllowedByDefenseSpecialTeams:
type:
- number
- 'null'
description: 'Total number of points allowed by the team in the season to
the opposing offense and special teams. Note: This field excludes points
scored by the opponent''s defense'
AuctionValue:
type:
- number
- 'null'
description: Player's dollar value in a $200 salary cap auction draft.
AuctionValuePPR:
type:
- number
- 'null'
description: Player's dollar value in a $200 salary cap PPR auction draft.
TwoPointConversionReturns:
type:
- number
- 'null'
description: Total successful two point conversion returns by the team in
the season
FantasyPointsFanDuel:
type:
- number
- 'null'
description: Fantasy points based on FanDuel's scoring system by the team
in the season
FantasyPointsDraftKings:
type:
- number
- 'null'
description: Fantasy points based on DraftKings' scoring system by the team
in the season
OffensiveYardsAllowed:
type:
- number
- 'null'
description: Offensive yards allowed by the team's defense in the season
PlayerID:
type:
- integer
- 'null'
description: 'The unique PlayerID of the player as assigned by SportsDataIO
for use when combining with player feeds. Note: this ID will stay with
the player throughout their entire career'
FantasyPointsYahoo:
type:
- number
- 'null'
description: Fantasy points based on Yahoo's daily fantasy scoring system
by the team in the season
AverageDraftPosition:
type:
- number
- 'null'
description: The average draft position of the team's fantasy defense (DST)
in re-draft leagues
AverageDraftPositionPPR:
type:
- number
- 'null'
description: The average draft position of the team (DST) in Points Per
Reception (PPR) leagues
TeamID:
type:
- integer
- 'null'
description: The unique ID of the team
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team. This value is guaranteed
to be unique across all sports/leagues
FanDuelFantasyPointsAllowed:
type:
- number
- 'null'
description: 'FanDuel fantasy points allowed to opposing offensive players
in the season. Note: positions include: QB; RB; WR; TE'
FanDuelQuarterbackFantasyPointsAllowed:
type:
- number
- 'null'
description: FanDuel fantasy points allowed by the team to opposing quarterbacks
in the season
FanDuelRunningbackFantasyPointsAllowed:
type:
- number
- 'null'
description: FanDuel fantasy points allowed by the team to opposing running
backs in the season
FanDuelWideReceiverFantasyPointsAllowed:
type:
- number
- 'null'
description: FanDuel fantasy points allowed by the team to opposing wide
receivers in the season
FanDuelTightEndFantasyPointsAllowed:
type:
- number
- 'null'
description: FanDuel fantasy points allowed by the team to opposing tight
ends in the season
FanDuelKickerFantasyPointsAllowed:
type:
- number
- 'null'
description: FanDuel fantasy points allowed by the team to opposing kickers
in the season
DraftKingsFantasyPointsAllowed:
type:
- number
- 'null'
description: 'DraftKings fantasy points allowed to opposing offensive players
in the season. Note: positions include: QB; RB; WR; TE'
DraftKingsQuarterbackFantasyPointsAllowed:
type:
- number
- 'null'
description: DraftKings fantasy points allowed by the team to opponent quarterbacks
in the season
DraftKingsRunningbackFantasyPointsAllowed:
type:
- number
- 'null'
description: DraftKings fantasy points allowed by the team to opponent running
backs in the season
DraftKingsWideReceiverFantasyPointsAllowed:
type:
- number
- 'null'
description: DraftKings fantasy points allowed by the team to opponent wide
receivers in the season
DraftKingsTightEndFantasyPointsAllowed:
type:
- number
- 'null'
description: DraftKings fantasy points allowed by the team to opponent tight
ends in the season
DraftKingsKickerFantasyPointsAllowed:
type:
- number
- 'null'
description: DraftKings fantasy points allowed by the team to opponent kickers
in the season
YahooFantasyPointsAllowed:
type:
- number
- 'null'
description: 'Total Yahoo fantasy points allowed to opposing offensive players
by the team in the season. Note: Offensive players include: QB, RB, WR,
& TE'
YahooQuarterbackFantasyPointsAllowed:
type:
- number
- 'null'
description: Total Yahoo fantasy points allowed to opposing quarterbacks
by the team in the season
YahooRunningbackFantasyPointsAllowed:
type:
- number
- 'null'
description: Total Yahoo fantasy points allowed to opposing running backs
by the team in the season
YahooWideReceiverFantasyPointsAllowed:
type:
- number
- 'null'
description: Total Yahoo fantasy points allowed to opposing wide receivers
by the team in the season
YahooTightEndFantasyPointsAllowed:
type:
- number
- 'null'
description: Total Yahoo fantasy points allowed to opposing tight ends by
the team in the season
YahooKickerFantasyPointsAllowed:
type:
- number
- 'null'
description: Total Yahoo fantasy points allowed to opposing kickers by the
team in the season
FantasyPointsFantasyDraft:
type:
- number
- 'null'
description: Fantasy points based on FanDraft's scoring system by the team
in the season
FantasyDraftFantasyPointsAllowed:
type:
- number
- 'null'
description: 'FantasyDraft fantasy points allowed to opposing offensive
players in the season. Note: positions include: QB; RB; WR; TE'
FantasyDraftQuarterbackFantasyPointsAllowed:
type:
- number
- 'null'
description: FantasyDraft fantasy points allowed by the team to opposing
quarterbacks in the season
FantasyDraftRunningbackFantasyPointsAllowed:
type:
- number
- 'null'
description: FantasyDraft fantasy points allowed by the team to opposing
running backs in the season
FantasyDraftWideReceiverFantasyPointsAllowed:
type:
- number
- 'null'
description: FantasyDraft fantasy points allowed by the team to opposing
wide receivers in the season
FantasyDraftTightEndFantasyPointsAllowed:
type:
- number
- 'null'
description: FantasyDraft fantasy points allowed by the team to opposing
tight ends in the season
FantasyDraftKickerFantasyPointsAllowed:
type:
- number
- 'null'
description: FantasyDraft fantasy points allowed by the team to opposing
kickers in the season
ScoringDetails:
type: array
items:
$ref: '#/components/schemas/ScoringDetail'
description: The details of the scoring plays this team DST recorded in
the season
AverageDraftPositionDynasty:
type:
- number
- 'null'
description: The average draft position of this team (DST) in dynasty drafts
leagues
AverageDraftPosition2QB:
type:
- number
- 'null'
description: The average draft position of the team (DST) in 2 Quarterback
leagues
FantasyDefenseGameProjection:
properties:
GameKey:
type:
- string
- 'null'
description: 'A 9 digit unique code identifying the game that this record
corresponds to. The GameID is composed of Season; SeasonType; Week and
HomeTeam. Note: This value will be NULL for bye weeks'
SeasonType:
type: integer
description: The type of season that this player corresponds to (1=Regular
Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star)
Season:
type: integer
description: The NFL season of the game
Week:
type:
- integer
- 'null'
description: 'The NFL week of the game (regular season: 1 to 18; preseason:
0 to 4; postseason: 1 to 4). Note: seasons after 2021 will have only 3
preseason weeks'
Date:
type:
- string
- 'null'
description: The date and time of the game (in US Eastern Time)
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
Opponent:
type:
- string
- 'null'
description: The abbreviation [Key] of the opponent team
PointsAllowed:
type: number
description: Total points allowed by the team during the game
TouchdownsScored:
type: number
description: Total defensive and special teams touchdowns scored by the
team in the game
SoloTackles:
type: number
description: Total defensive solo (unassisted) tackles by the team in the
game
AssistedTackles:
type: number
description: Total defensive assisted tackles by the team in the game
Sacks:
type: number
description: Total defensive sacks by the team in the game
SackYards:
type: number
description: Total defensive sack yards by the team in the game
PassesDefended:
type: number
description: Total passes defended by the team in the game
FumblesForced:
type: number
description: Total fumbles forced on defense by the team in the game
FumblesRecovered:
type: number
description: Total defensive fumble recoveries by the team in the game
FumbleReturnYards:
type: number
description: Total fumble return yards by the team in the game
FumbleReturnTouchdowns:
type: number
description: Total fumble return touchdowns by the team in the game
Interceptions:
type: number
description: Total defensive interceptions by the team in the game
InterceptionReturnYards:
type: number
description: Total defensive interception return yards by the team in the
game
InterceptionReturnTouchdowns:
type: number
description: Total defensive interception return touchdowns by the team
in the game
BlockedKicks:
type: number
description: 'Total blocked kicks by team in the game. Note: BlockedKicks
include Field Goals and Punts but NOT Extra Points'
Safeties:
type: number
description: Total defensive safeties scored by the team in the game
PuntReturns:
type: number
description: Total punt returns by the team in the game
PuntReturnYards:
type: number
description: Total punt return yards by the team in the game
PuntReturnTouchdowns:
type: number
description: Total punt return touchdowns by the team in the game
PuntReturnLong:
type: number
description: The longest punt return by the team in the game
KickReturns:
type: number
description: Total kickoff returns by the team in the game
KickReturnYards:
type: number
description: Total kickoff return yards by the team in the game
KickReturnTouchdowns:
type: number
description: Total kickoff return touchdowns by the team in the game
KickReturnLong:
type: number
description: Longest kick return by the team in the game
BlockedKickReturnTouchdowns:
type:
- number
- 'null'
description: Total blocked kick recovery return touchdowns for the team
in the game
FieldGoalReturnTouchdowns:
type:
- number
- 'null'
description: 'Total field goal return touchdowns by the team in the game.
Note: This field excludes blocked field goals'
FantasyPointsAllowed:
type:
- number
- 'null'
description: 'Fantasy points allowed to opposing offensive players in the
season. Note: positions include: QB; RB; WR; TE'
QuarterbackFantasyPointsAllowed:
type:
- number
- 'null'
description: Fantasy points allowed to opposing quarterbacks by the team
in the game
RunningbackFantasyPointsAllowed:
type:
- number
- 'null'
description: Total fantasy points allowed to opposing running backs by the
team in the game
WideReceiverFantasyPointsAllowed:
type:
- number
- 'null'
description: Fantasy points allowed to opposing wide receivers
TightEndFantasyPointsAllowed:
type:
- number
- 'null'
description: Fantasy points allowed to opposing tight ends by the team in
the game
KickerFantasyPointsAllowed:
type:
- number
- 'null'
description: Fantasy points allowed to opponent kickers by the team in the
game
BlockedKickReturnYards:
type:
- number
- 'null'
description: Total blocked kick recovery return yards for the team in the
game
FieldGoalReturnYards:
type:
- number
- 'null'
description: 'Total field goal return yards by the team in the game. Note:
This field excludes blocked field goals'
QuarterbackHits:
type:
- number
- 'null'
description: 'Total quarterback hits by the team in the game. Note: This
is a defensive stat that includes sacks'
TacklesForLoss:
type:
- number
- 'null'
description: 'Total tackles for loss by the team in the game. Note: These
are tackles behind the line of scrimmage for loss of yards (including
sacks)'
DefensiveTouchdowns:
type:
- number
- 'null'
description: Total touchdowns scored by the defense
SpecialTeamsTouchdowns:
type:
- number
- 'null'
description: Total special teams touchdowns scored by the team in the game
IsGameOver:
type:
- boolean
- 'null'
description: Whether the game is over (true/false)
FantasyPoints:
type:
- number
- 'null'
description: Fantasy points scored based on basic fantasy scoring system
by the team's D/ST in the game
Stadium:
type:
- string
- 'null'
description: Stadium of the event
Temperature:
type:
- integer
- 'null'
description: Temperature at game start (Fahrenheit)
Humidity:
type:
- integer
- 'null'
description: The humidity percentage at the start of the game
WindSpeed:
type:
- integer
- 'null'
description: The wind speed at the start of the game (in MPH)
ThirdDownAttempts:
type:
- number
- 'null'
description: Total third down attempts against the team in the game
ThirdDownConversions:
type:
- number
- 'null'
description: Total third down conversions against the team in the game
FourthDownAttempts:
type:
- number
- 'null'
description: Opponent's fourth down attempts against the team in the game
FourthDownConversions:
type:
- number
- 'null'
description: Opponent's fourth down conversions against the team in the
game
PointsAllowedByDefenseSpecialTeams:
type:
- number
- 'null'
description: 'Total number of points allowed by the team in the game to
the opposing offense and special teams. Note: This field excludes points
scored by the opponent''s defense'
FanDuelSalary:
type:
- integer
- 'null'
description: The team's D/ST salary for FanDuel daily fantasy contests
DraftKingsSalary:
type:
- integer
- 'null'
description: The team's D/ST salary for DraftKings daily fantasy contests.
FantasyDataSalary:
type:
- integer
- 'null'
description: The team's D/ST salary as calculated by SportsDataIO (formerly
known as FantasyData). Based on the same salary cap as DraftKings contests
($50,000)
VictivSalary:
type:
- integer
- 'null'
description: The player's salary for Victiv daily fantasy contests.
TwoPointConversionReturns:
type:
- number
- 'null'
description: Total successful two point conversion returns by the team in
the game
FantasyPointsFanDuel:
type:
- number
- 'null'
description: Fantasy points based on FanDuel's scoring system by the team
in the game
FantasyPointsDraftKings:
type:
- number
- 'null'
description: Fantasy points based on DraftKings' scoring system by the team
in the game
OffensiveYardsAllowed:
type:
- number
- 'null'
description: Offensive yards allowed by the team's defense in the game
YahooSalary:
type:
- integer
- 'null'
description: The player's salary for Yahoo daily fantasy contests
PlayerID:
type:
- integer
- 'null'
description: 'The unique PlayerID of the player as assigned by SportsDataIO
for use when combining with player feeds. Note: this ID will stay with
the player throughout their entire career'
FantasyPointsYahoo:
type:
- number
- 'null'
description: Fantasy points based on Yahoo's daily fantasy scoring system
by the team in the game
HomeOrAway:
type:
- string
- 'null'
description: Whether the team is home or away
OpponentRank:
type:
- integer
- 'null'
description: The ranking of the opposing team's offense with regards to
fantasy points allowed to fantasy DST
OpponentPositionRank:
type:
- integer
- 'null'
description: The ranking of the opposing team's offense with regards to
fantasy points allowed to fantasy DST
FantasyDraftSalary:
type:
- integer
- 'null'
description: The team's D/ST salary for FantasyDraft daily fantasy contests.
TeamID:
type:
- integer
- 'null'
description: The unique ID of the team
OpponentID:
type:
- integer
- 'null'
description: The unique ID of this opponent team
Day:
type:
- string
- 'null'
description: The date of the game (in US Eastern Time)
DateTime:
type:
- string
- 'null'
description: The date and time of the game (in US Eastern Time)
GlobalGameID:
type:
- integer
- 'null'
description: A globally unique ID for this game. This value is guaranteed
to be unique across all sports/leagues
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team. This value is guaranteed
to be unique across all sports/leagues
GlobalOpponentID:
type:
- integer
- 'null'
description: A globally unique ID for this team's opponent. This value is
guaranteed to be unique across all sports/leagues
DraftKingsPosition:
type:
- string
- 'null'
description: The position of this team's D/ST; as listed by DraftKings.
FanDuelPosition:
type:
- string
- 'null'
description: The position of this team's D/ST; as listed by FanDuel.
FantasyDraftPosition:
type:
- string
- 'null'
description: The position of this team's D/ST; as listed by FantasyDraft
YahooPosition:
type:
- string
- 'null'
description: The position of the team's defense/special teams unit, as listed
on Yahoo's daily fantasy sports platform
FantasyDefenseID:
type:
- integer
- 'null'
description: '"Unique ID of FantasyDefense record (subject to change; although
it very rarely does). Note: For a guaranteed static ID; use a combination
of GameKey and Team"'
ScoreID:
type: integer
description: Unique ID of the score/game
FanDuelFantasyPointsAllowed:
type:
- number
- 'null'
description: 'FanDuel fantasy points allowed to opposing offensive players
in the game. Note: positions include: QB; RB; WR; TE'
FanDuelQuarterbackFantasyPointsAllowed:
type:
- number
- 'null'
description: FanDuel fantasy points allowed by the team to opposing quarterbacks
in the game
FanDuelRunningbackFantasyPointsAllowed:
type:
- number
- 'null'
description: FanDuel fantasy points allowed by the team to opposing running
backs in the game
FanDuelWideReceiverFantasyPointsAllowed:
type:
- number
- 'null'
description: FanDuel fantasy points allowed by the team to opposing wide
receivers in the game
FanDuelTightEndFantasyPointsAllowed:
type:
- number
- 'null'
description: FanDuel fantasy points allowed by the team to opposing tight
ends in the game
FanDuelKickerFantasyPointsAllowed:
type:
- number
- 'null'
description: FanDuel fantasy points allowed by the team to opposing kickers
in the game
DraftKingsFantasyPointsAllowed:
type:
- number
- 'null'
description: 'DraftKings fantasy points allowed to opposing offensive players
in the game. Note: positions include: QB; RB; WR; TE'
DraftKingsQuarterbackFantasyPointsAllowed:
type:
- number
- 'null'
description: DraftKings fantasy points allowed by the team to opponent quarterbacks
in the game
DraftKingsRunningbackFantasyPointsAllowed:
type:
- number
- 'null'
description: DraftKings fantasy points allowed by the team to opponent running
backs in the game
DraftKingsWideReceiverFantasyPointsAllowed:
type:
- number
- 'null'
description: DraftKings fantasy points allowed by the team to opponent wide
receivers in the game
DraftKingsTightEndFantasyPointsAllowed:
type:
- number
- 'null'
description: DraftKings fantasy points allowed by the team to opponent tight
ends in the game
DraftKingsKickerFantasyPointsAllowed:
type:
- number
- 'null'
description: DraftKings fantasy points allowed to opposing kickers
YahooFantasyPointsAllowed:
type:
- number
- 'null'
description: 'Total Yahoo fantasy points allowed to opposing offensive players
by the team in the game. Note: Offensive players include: QB, RB, WR,
& TE'
YahooQuarterbackFantasyPointsAllowed:
type:
- number
- 'null'
description: Total Yahoo fantasy points allowed to opposing quarterbacks
by the team in the game
YahooRunningbackFantasyPointsAllowed:
type:
- number
- 'null'
description: Total Yahoo fantasy points allowed to opposing running backs
by the team in the game
YahooWideReceiverFantasyPointsAllowed:
type:
- number
- 'null'
description: Total Yahoo fantasy points allowed to opposing wide receivers
by the team in the game
YahooTightEndFantasyPointsAllowed:
type:
- number
- 'null'
description: Total Yahoo fantasy points allowed to opposing tight ends by
the team in the game
YahooKickerFantasyPointsAllowed:
type:
- number
- 'null'
description: Total Yahoo fantasy points allowed to opposing kickers by the
team in the game
FantasyPointsFantasyDraft:
type:
- number
- 'null'
description: Fantasy points based on FantasyDraft's scoring system by the
team in the game
FantasyDraftFantasyPointsAllowed:
type:
- number
- 'null'
description: 'FantasyDraft fantasy points allowed to opposing offensive
players in the game. Note: positions include: QB; RB; WR; TE'
FantasyDraftQuarterbackFantasyPointsAllowed:
type:
- number
- 'null'
description: FantasyDraft fantasy points allowed by the team to opposing
quarterbacks in the game
FantasyDraftRunningbackFantasyPointsAllowed:
type:
- number
- 'null'
description: FantasyDraft fantasy points allowed by the team to opposing
running backs in the game
FantasyDraftWideReceiverFantasyPointsAllowed:
type:
- number
- 'null'
description: FantasyDraft fantasy points allowed by the team to opposing
wide receivers in the game
FantasyDraftTightEndFantasyPointsAllowed:
type:
- number
- 'null'
description: FantasyDraft fantasy points allowed by the team to opposing
tight ends in the game
FantasyDraftKickerFantasyPointsAllowed:
type:
- number
- 'null'
description: FantasyDraft fantasy points allowed by the team to opposing
kickers in the game
ScoringDetails:
type: array
items:
$ref: '#/components/schemas/ScoringDetail'
description: The details of the scoring plays this team DST recorded in
the game
PlayerGameProjection:
properties:
GameKey:
type:
- string
- 'null'
description: 'A 9 digit unique code identifying the game that this record
corresponds to. The GameID is composed of Season; SeasonType; Week and
HomeTeam.. Note: This value will be NULL for bye weeks'
PlayerID:
type:
- integer
- 'null'
description: 'The unique PlayerID of the player as assigned by SportsDataIO.
Note: this ID will stay with the player throughout their entire career'
SeasonType:
type: integer
description: The type of season that this player corresponds to (1=Regular
Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star)
Season:
type: integer
description: The NFL season of the game
GameDate:
type:
- string
- 'null'
description: The date and time the game is scheduled to start
Week:
type: integer
description: 'The NFL week of the game (regular season: 1 to 18; preseason:
0 to 4; postseason: 1 to 4). Note: seasons after 2021 will have only 3
preseason weeks'
Team:
type:
- string
- 'null'
description: 'The abbreviation [Key] of the team that the player is on.
Note: if this player is a free agent; this field is NULL'
Opponent:
type:
- string
- 'null'
description: The abbreviation [Key] of the opponent team
HomeOrAway:
type:
- string
- 'null'
description: Whether the team is home or away
Number:
type: integer
description: Player's jersey number
Name:
type:
- string
- 'null'
description: Player's full name
Position:
type:
- string
- 'null'
description: 'The primary position of the player. Possible Values: C; CB;
DB; DE; DL; DT; FB; FS; G; ILB; K; KR; LB; LS; NT; OL; OLB; OT; P; QB;
RB; S; SS; T; TE; WR'
PositionCategory:
type:
- string
- 'null'
description: The category of the player's position (OFF; DEF; ST)
Activated:
type: integer
description: Whether or not the player was active for the game
Played:
type: integer
description: 'Whether the player played at least one snap in the game Note:
Will return "1" if player played at least one snap and "0" if they did
not'
Started:
type: integer
description: 'Whether the player started the game (on offensive or defense).
Note: Started = 1 / Did Not Start = 0'
PassingAttempts:
type: number
description: Total passes thrown by the player in the game
PassingCompletions:
type: number
description: Total passes completed by the player in the game
PassingYards:
type: number
description: Total passing yards by the player in the game
PassingCompletionPercentage:
type: number
description: The percentage of passes completed by the player in the game
PassingYardsPerAttempt:
type: number
description: Total average passing yards per attempt by the player in the
game
PassingYardsPerCompletion:
type: number
description: Total average passing yards per completion by the player in
the game
PassingTouchdowns:
type: number
description: Total passing touchdowns by the player in the game
PassingInterceptions:
type: number
description: Total interceptions thrown by the player in the game
PassingRating:
type: number
description: The passer rating of the player in the game
PassingLong:
type: number
description: Total yards of longest completion by the player in the game
PassingSacks:
type: number
description: The total number of times the player was sacked in the game
PassingSackYards:
type: number
description: Total yards lost by the player in the game as a result of being
sacked
RushingAttempts:
type: number
description: Total rushing attempts by the player in the game
RushingYards:
type: number
description: Total rushing yards by the player in the game
RushingYardsPerAttempt:
type: number
description: Total rushing yards per attempt by the player in the game
RushingTouchdowns:
type: number
description: Total rushing touchdowns by the player in the game
RushingLong:
type: number
description: The longest rush by the player in the game
ReceivingTargets:
type:
- number
- 'null'
description: Total receiving targets by the player in the game
Receptions:
type: number
description: Total receptions by the player in the game
ReceivingYards:
type: number
description: Total receiving yards by the player in the game
ReceivingYardsPerReception:
type: number
description: Average receiving yards per reception by the player in the
game
ReceivingTouchdowns:
type: number
description: Total receiving touchdowns by the player in the game
ReceivingLong:
type: number
description: The longest reception by the player in the game
Fumbles:
type: number
description: Total fumbles by the player in the game
FumblesLost:
type:
- number
- 'null'
description: Total fumbles lost by the player in the game
PuntReturns:
type: number
description: Total punt returns by the player in the game
PuntReturnYards:
type: number
description: Total punt return yards by the player in the game
PuntReturnYardsPerAttempt:
type: number
description: Total average yards gained per punt return by the player in
the game
PuntReturnTouchdowns:
type: number
description: Total punt return touchdowns by the player in the game
PuntReturnLong:
type: number
description: The longest punt return by the player in the game
KickReturns:
type: number
description: Total kickoff returns by the player in the game
KickReturnYards:
type: number
description: Total kickoff return yards by the player in the game
KickReturnYardsPerAttempt:
type: number
description: Average yards gained per kick return by the player in the game
KickReturnTouchdowns:
type: number
description: Total kickoff return touchdowns by the player in the game
KickReturnLong:
type: number
description: Longest kick return by the player in the game
SoloTackles:
type: number
description: Total defensive solo (unassisted) tackles by the player in
the game
AssistedTackles:
type: number
description: Total defensive assisted tackles by the player in the game
TacklesForLoss:
type:
- number
- 'null'
description: 'Total tackles for loss by the player in the game. Note: these
are tackles behind the line of scrimmage for loss of yards (including
sacks)'
Sacks:
type: number
description: Total defensive sacks by the player in the game
SackYards:
type: number
description: Total defensive sacks yards by the player in the game
QuarterbackHits:
type:
- number
- 'null'
description: 'Total quarterback hits by the player in the game. Note: This
is a defensive stat that includes sacks'
PassesDefended:
type: number
description: Total passes defended by the player in the game
FumblesForced:
type: number
description: Total fumbles forced on defense by the player in the game
FumblesRecovered:
type: number
description: Total defensive fumble recoveries by the player in the game
FumbleReturnYards:
type: number
description: Total fumble return yards by the player in the game
FumbleReturnTouchdowns:
type: number
description: Total fumble return touchdowns by the player in the game
Interceptions:
type: number
description: Total defensive interceptions by the player in the game
InterceptionReturnYards:
type: number
description: Total defensive interception return yards by the player in
the game
InterceptionReturnTouchdowns:
type: number
description: Total defensive interception return touchdowns by the player
in the game
BlockedKicks:
type: number
description: 'Total blocked kicks by the player in the game. Note: BlockedKicks
include Field Goals and Punts but NOT Extra Points'
SpecialTeamsSoloTackles:
type: number
description: This field is deprecated
SpecialTeamsAssistedTackles:
type: number
description: This field is deprecated
MiscSoloTackles:
type: number
description: This field is deprecated
MiscAssistedTackles:
type: number
description: This field is deprecated
Punts:
type: number
description: Total number of punts by the player in the game
PuntYards:
type: number
description: Total punt yards by the player in the game
PuntAverage:
type: number
description: The average number of yards per punt by the player in the game
FieldGoalsAttempted:
type: number
description: Total field goals attempted by the player in the game
FieldGoalsMade:
type: number
description: Total field goals made by the player in game
FieldGoalsLongestMade:
type: number
description: Longest field goal made by the player in the game
ExtraPointsMade:
type: number
description: Total extra points made by the player in the game
TwoPointConversionPasses:
type: number
description: Total successful two point conversion passes by the player
in the game
TwoPointConversionRuns:
type: number
description: Total successful two point conversion rushes by the player
in the game
TwoPointConversionReceptions:
type: number
description: Total successful two point conversion receptions by the player
in the game
FantasyPoints:
type: number
description: Fantasy points scored based on basic fantasy scoring system
by the player in the game
FantasyPointsPPR:
type: number
description: This field is expected to be NULL
ReceptionPercentage:
type: number
description: Total percentage of receiving targets that were receptions
by the player in the game
ReceivingYardsPerTarget:
type: number
description: Average receiving yards per target by the player in the game
Tackles:
type: number
description: Total tackles (solo & assisted) by the player in the game
OffensiveTouchdowns:
type: number
description: Total offensive touchdowns scored by the player in the game
DefensiveTouchdowns:
type: number
description: Total defensive touchdowns scored by the player in the game
SpecialTeamsTouchdowns:
type: number
description: Total special teams touchdowns scored by the player in the
game
Touchdowns:
type: number
description: Total touchdowns scored by the player in the game (excludes
passing touchdowns)
FantasyPosition:
type:
- string
- 'null'
description: 'The player''s fantasy football position. Possible values:
QB; RB; WR; TE; DL; LB; DB; K; P; OL'
FieldGoalPercentage:
type: number
description: Total field goal attempts made by the player in the game
PlayerGameID:
type: integer
description: Unique ID of PlayerGame record (subject to change, although
it very rarely does). For a static ID, use a combination of GameKey and
PlayerID.
FumblesOwnRecoveries:
type:
- number
- 'null'
description: 'Total own fumble recoveries by the player in the game. Note:
this fumble doesn''t result in a turnover - the fumbling team recovers
the fumble'
FumblesOutOfBounds:
type:
- number
- 'null'
description: This field is deprecated
KickReturnFairCatches:
type:
- number
- 'null'
description: This field is deprecated
PuntReturnFairCatches:
type:
- number
- 'null'
description: This field is deprecated
PuntTouchbacks:
type:
- number
- 'null'
description: Total punts that resulted in touchbacks by the player in the
game
PuntInside20:
type:
- number
- 'null'
description: Total punts downed inside the 20 yard line by the player in
the game
PuntNetAverage:
type:
- number
- 'null'
description: The average net yards per punt by the player in the game
ExtraPointsAttempted:
type:
- number
- 'null'
description: Total extra point kicks attempted by the player in the game
BlockedKickReturnTouchdowns:
type:
- number
- 'null'
description: Total blocked kick recovery return touchdowns for the player
in the game
FieldGoalReturnTouchdowns:
type:
- number
- 'null'
description: 'Total field goal return touchdowns by the player in the game.
Note: This field excludes blocked field goals'
Safeties:
type:
- number
- 'null'
description: Total defensive safeties scored by the player in the game
FieldGoalsHadBlocked:
type:
- number
- 'null'
description: Total field goals by the player that were blocked in the game
PuntsHadBlocked:
type:
- number
- 'null'
description: Total punts by the player that were blocked in the game
ExtraPointsHadBlocked:
type:
- number
- 'null'
description: Total extra point kick attempts by the player that were blocked
in the game
PuntLong:
type:
- number
- 'null'
description: The longest punt by the player in the game
BlockedKickReturnYards:
type:
- number
- 'null'
description: Total blocked kick recovery return yards for the player in
the game
FieldGoalReturnYards:
type:
- number
- 'null'
description: 'Total field goal return yards by the player in the game. Note:
This field excludes blocked field goals'
PuntNetYards:
type:
- number
- 'null'
description: The net yards of the punts by the player in the game
SpecialTeamsFumblesForced:
type:
- number
- 'null'
description: This field is deprecated
SpecialTeamsFumblesRecovered:
type:
- number
- 'null'
description: This field is deprecated
MiscFumblesForced:
type:
- number
- 'null'
description: This field is deprecated
MiscFumblesRecovered:
type:
- number
- 'null'
description: This field is deprecated
ShortName:
type:
- string
- 'null'
description: The first initial and last name of the player (J. Doe)
PlayingSurface:
type:
- string
- 'null'
description: The playing surface of the stadium
IsGameOver:
type:
- boolean
- 'null'
description: Whether the game is over (true/false)
SafetiesAllowed:
type:
- number
- 'null'
description: This field is deprecated
Stadium:
type:
- string
- 'null'
description: Stadium of the event
Temperature:
type:
- integer
- 'null'
description: Temperature at game start (Fahrenheit)
Humidity:
type:
- integer
- 'null'
description: The humidity percentage at the start of the game
WindSpeed:
type:
- integer
- 'null'
description: The wind speed at the start of the game (in MPH)
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).
OffensiveSnapsPlayed:
type:
- integer
- 'null'
description: 'Total snaps this player played on offense in the game. Note:
Snap counts are available the morning after the game.'
DefensiveSnapsPlayed:
type:
- integer
- 'null'
description: 'Total snaps this player played on defense in the game. Note:
Snap counts are available the morning after the game.'
SpecialTeamsSnapsPlayed:
type:
- integer
- 'null'
description: 'Total snaps this player played on special teams in the game.
Note: Snap counts are available the morning after the game.'
OffensiveTeamSnaps:
type:
- integer
- 'null'
description: 'Total offensive snaps this player''s team played in the game.
Note: Snap counts are available the morning after the game.'
DefensiveTeamSnaps:
type:
- integer
- 'null'
description: 'Total defensive snaps this player''s team played in the game.
Note: Snap counts are available the morning after the game.'
SpecialTeamsTeamSnaps:
type:
- integer
- 'null'
description: 'Total special teams snaps this player''s team played in the
game. Note: Snap counts are available the morning after the game.'
VictivSalary:
type:
- integer
- 'null'
description: The player's salary for Victiv daily fantasy contests.
TwoPointConversionReturns:
type:
- number
- 'null'
description: Total successful two point conversion returns by the player
in the game
FantasyPointsFanDuel:
type:
- number
- 'null'
description: Fantasy points based on FanDuel's scoring system by the player
in the game
FieldGoalsMade0to19:
type:
- number
- 'null'
description: Total field goals of 0 to 19 yards made by the player in game
FieldGoalsMade20to29:
type:
- number
- 'null'
description: Total field goals of 20 to 29 yards made by the player in game
FieldGoalsMade30to39:
type:
- number
- 'null'
description: Total field goals of 30 to 39 yards made by the player in game
FieldGoalsMade40to49:
type:
- number
- 'null'
description: Total field goals of 40 to 49 yards made by the player in game
FieldGoalsMade50Plus:
type:
- number
- 'null'
description: Total field goals of 50+ yards made by the player in game
FantasyPointsDraftKings:
type:
- number
- 'null'
description: Fantasy points based on DraftKings' scoring system by the player
in the game
YahooSalary:
type:
- integer
- 'null'
description: The player's salary for Yahoo daily fantasy contests
FantasyPointsYahoo:
type:
- number
- 'null'
description: Fantasy points based on Yahoo's daily fantasy scoring system
by the player in the game
InjuryStatus:
type:
- string
- 'null'
description: The player's current injury status; in the form of likelihood
that player plays (Probable; Questionable; Doubtful; Out)
InjuryBodyPart:
type:
- string
- 'null'
description: The body part that is injured for the player (Knee; Groin;
Calf; Hamstring; etc.)
InjuryStartDate:
type:
- string
- 'null'
description: The day that the player's injury started or was first discovered
InjuryNotes:
type:
- string
- 'null'
description: A 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.
InjuryPractice:
type:
- string
- 'null'
description: This field is deprecated
InjuryPracticeDescription:
type:
- string
- 'null'
description: This field is deprecated
DeclaredInactive:
type: boolean
description: 'Whether the player has been declared inactive. This value
is updated in the hours leading up to game start time; as teams announce
their inactive players. Note: This is only updated for offensive skill
position players (QB; RB; WR; TE)'
FantasyDraftSalary:
type:
- integer
- 'null'
description: The player's salary for FantasyDraft daily fantasy contests.
FantasyDraftPosition:
type:
- string
- 'null'
description: The player's eligible position in FantasyDraft's daily fantasy
sports platform.
TeamID:
type:
- integer
- 'null'
description: 'The unique ID of the team that the player is on. Note: if
the player is a free agent; this field is NULL'
OpponentID:
type:
- integer
- 'null'
description: The unique ID of this opponent team
Day:
type:
- string
- 'null'
description: The date of the game (in US Eastern Time)
DateTime:
type:
- string
- 'null'
description: The date and time of the game (in US Eastern Time)
GlobalGameID:
type:
- integer
- 'null'
description: A globally unique ID for this game. This value is guaranteed
to be unique across all sports/leagues
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team. This value is guaranteed
to be unique across all sports/leagues
GlobalOpponentID:
type:
- integer
- 'null'
description: A globally unique ID for this opposing team. This value is
guaranteed to be unique across all sports/leagues.
ScoreID:
type: integer
description: Unique ID of the score/game
FantasyPointsFantasyDraft:
type:
- number
- 'null'
description: This field is no longer in use and will return null.
ScoringDetails:
type: array
items:
$ref: '#/components/schemas/ScoringDetail'
description: The details of the scoring plays this player recorded in the
game
OffensiveFumbleRecoveryTouchdowns:
type:
- number
- 'null'
description: This field is deprecated
SnapCountsConfirmed:
type:
- boolean
- 'null'
description: 'Whether snap count fields are confirmed (true/false). Note:
This takes place the morning after the game.'
Updated:
type:
- string
- 'null'
description: 'Time of last update (in US Eastern time). Note: this does
not indicate that stats changed.'
PlayerSeasonProjection:
properties:
PlayerID:
type:
- integer
- 'null'
description: 'The unique PlayerID of the player as assigned by SportsDataIO.
Note: this ID will stay with the player throughout their entire career'
SeasonType:
type: integer
description: The type of season that this player corresponds to (1=Regular
Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star)
Season:
type: integer
description: The NFL season for which these totals apply
Team:
type:
- string
- 'null'
description: 'The abbreviation [Key] of the team that the player is on.
Note: If this player is a free agent; this field is NULL'
Number:
type: integer
description: Player's jersey number
Name:
type:
- string
- 'null'
description: Player's full name
Position:
type:
- string
- 'null'
description: 'The primary position of the player. Possible Values: C; CB;
DB; DE; DL; DT; FB; FS; G; ILB; K; KR; LB; LS; NT; OL; OLB; OT; P; QB;
RB; S; SS; T; TE; WR'
PositionCategory:
type:
- string
- 'null'
description: The category of the player's position (OFF; DEF; ST)
Activated:
type: integer
description: The total number of games that the player was active for in
the season
Played:
type: integer
description: The total number of games played by the the player in the season
Started:
type: integer
description: Total games started (on offense or defense) by the player in
the season
PassingAttempts:
type: number
description: Total passes thrown by the player in the season
PassingCompletions:
type: number
description: Total passes completed by the player in the season
PassingYards:
type: number
description: Total passing yards by the player in the season
PassingCompletionPercentage:
type: number
description: The percentage of passes completed by the player in the season
PassingYardsPerAttempt:
type: number
description: Total average passing yards per attempt by the player in the
season
PassingYardsPerCompletion:
type: number
description: Total average passing yards per completion by the player in
the season
PassingTouchdowns:
type: number
description: Total passing touchdowns by the player in the season
PassingInterceptions:
type: number
description: Total interceptions thrown by the player in the season
PassingRating:
type: number
description: The passer rating of the player in the season
PassingLong:
type: number
description: Total yards of longest completion by the player in the season
PassingSacks:
type: number
description: The total number of times the player was sacked in the season
PassingSackYards:
type: number
description: Total yards lost by the player in the season as a result of
being sacked
RushingAttempts:
type: number
description: Total rushing attempts by the player in the season
RushingYards:
type: number
description: Total rushing yards by the player in the season
RushingYardsPerAttempt:
type: number
description: Total rushing yards per attempt by the player in the season
RushingTouchdowns:
type: number
description: Total rushing touchdowns by the player in the season
RushingLong:
type: number
description: The longest rush by the player in the season
ReceivingTargets:
type:
- number
- 'null'
description: Total receiving targets by the player in the season
Receptions:
type: number
description: Total receptions by the player in the season
ReceivingYards:
type: number
description: Total receiving yards by the player in the season
ReceivingYardsPerReception:
type: number
description: Average receiving yards per reception by the player in the
season
ReceivingTouchdowns:
type: number
description: Total receiving touchdowns by the player in the season
ReceivingLong:
type: number
description: The longest reception by the player in the season
Fumbles:
type: number
description: Total fumbles by the player in the season
FumblesLost:
type:
- number
- 'null'
description: Total fumbles lost by the player in the season
PuntReturns:
type: number
description: Total punt returns by the player in the season
PuntReturnYards:
type: number
description: Total punt return yards by the player in the season
PuntReturnYardsPerAttempt:
type: number
description: Total average yards gained per punt return by the player in
the season
PuntReturnTouchdowns:
type: number
description: Total punt return touchdowns by the player in the season
PuntReturnLong:
type: number
description: The longest punt return by the player in the season
KickReturns:
type: number
description: Total kickoff returns by the player in the season
KickReturnYards:
type: number
description: Total kickoff return yards by the player in the season
KickReturnYardsPerAttempt:
type: number
description: Average yards gained per kick return by the player in the season
KickReturnTouchdowns:
type: number
description: Total kickoff return touchdowns by the player in the season
KickReturnLong:
type: number
description: Longest kick return by the player in the season
SoloTackles:
type: number
description: Total defensive solo (unassisted) tackles by the player in
the season
AssistedTackles:
type: number
description: Total defensive assisted tackles by the player in the season
TacklesForLoss:
type:
- number
- 'null'
description: 'Total tackles for loss by the player in the season. Note:
these are tackles behind the line of scrimmage for loss of yards (including
sacks)'
Sacks:
type: number
description: Total defensive sacks by the player in the season
SackYards:
type: number
description: Total defensive safeties scored by the player in the season
QuarterbackHits:
type:
- number
- 'null'
description: 'Total quarterback hits by the player in the season. Note:
This is a defensive stat that includes sacks'
PassesDefended:
type: number
description: Total passes defended by the player in the season
FumblesForced:
type: number
description: Total fumbles forced on defense by the player in the season
FumblesRecovered:
type: number
description: Total defensive fumble recoveries by the player in the season
FumbleReturnYards:
type: number
description: Total fumble return yards by the player in the season
FumbleReturnTouchdowns:
type: number
description: Total fumble return touchdowns by the player in the season
Interceptions:
type: number
description: Total defensive interceptions by the player in the season
InterceptionReturnYards:
type: number
description: Total defensive interception return yards by the player in
the season
InterceptionReturnTouchdowns:
type: number
description: Total defensive interception return touchdowns by the player
in the season
BlockedKicks:
type: number
description: 'Total blocked kicks by the player in the season. Note: BlockedKicks
include Field Goals and Punts but NOT Extra Points'
SpecialTeamsSoloTackles:
type: number
description: This field is deprecated
SpecialTeamsAssistedTackles:
type: number
description: This field is deprecated
MiscSoloTackles:
type: number
description: This field is deprecated
MiscAssistedTackles:
type: number
description: This field is deprecated
Punts:
type: number
description: Total number of punts by the player in the season
PuntYards:
type: number
description: Total punt yards by the player in the season
PuntAverage:
type: number
description: The average number of yards per punt by the player in the season
FieldGoalsAttempted:
type: number
description: Total field goals attempted by the player in the season
FieldGoalsMade:
type: number
description: Total field goals made by the player in season
FieldGoalsLongestMade:
type: number
description: Longest field goal made by the player in the season
ExtraPointsMade:
type: number
description: Total extra points made by the player in the season
TwoPointConversionPasses:
type: number
description: Total successful two point conversion passes by the player
in the season
TwoPointConversionRuns:
type: number
description: Total successful two point conversion rushes by the player
in the season
TwoPointConversionReceptions:
type: number
description: Total successful two point conversion receptions by the player
in the season
FantasyPoints:
type: number
description: Fantasy points scored based on basic fantasy scoring system
by the player in the season
FantasyPointsPPR:
type: number
description: Fantasy points scored based on basic PPR fantasy scoring system
by the player in the season
ReceptionPercentage:
type: number
description: Total percentage of receiving targets that were receptions
by the player in the season
ReceivingYardsPerTarget:
type: number
description: Average receiving yards per target by the player in the season
Tackles:
type: number
description: Total tackles (solo & assisted) by the player in the season
OffensiveTouchdowns:
type: number
description: Total offensive touchdowns scored by the player in the season
DefensiveTouchdowns:
type: number
description: Total defensive touchdowns scored by the player in the season
SpecialTeamsTouchdowns:
type: number
description: Total special teams touchdowns scored by the player in the
season
Touchdowns:
type: number
description: Total touchdowns scored by the player in the season
FantasyPosition:
type:
- string
- 'null'
description: 'The player''s fantasy football position. Possible values:
QB, RB, WR, TE, DL, LB, DB, K, P, OL'
FieldGoalPercentage:
type: number
description: Total field goal attempts made by the player in the season
PlayerSeasonID:
type: integer
description: Unique ID of PlayerSeason record (subject to change, although
it very rarely does). For a static ID, use a combination of SeasonType,
Season and PlayerID.
FumblesOwnRecoveries:
type:
- number
- 'null'
description: 'Total own fumble recoveries by the player in the season. Note:
this fumble doesn''t result in a turnover - the fumbling team recovers
the fumble'
FumblesOutOfBounds:
type:
- number
- 'null'
description: This field is deprecated
KickReturnFairCatches:
type:
- number
- 'null'
description: This field is deprecated
PuntReturnFairCatches:
type:
- number
- 'null'
description: This field is deprecated.
PuntTouchbacks:
type:
- number
- 'null'
description: Total punts that resulted in touchbacks by the player in the
season
PuntInside20:
type:
- number
- 'null'
description: Total punts downed inside the 20 yard line by the player in
the season
PuntNetAverage:
type:
- number
- 'null'
description: The average net yards per punt by the player in the season
ExtraPointsAttempted:
type:
- number
- 'null'
description: Total extra point kicks attempted by the player in the season
BlockedKickReturnTouchdowns:
type:
- number
- 'null'
description: Total blocked kick recovery return touchdowns for the player
in the season
FieldGoalReturnTouchdowns:
type:
- number
- 'null'
description: 'Total field goal return touchdowns by the player in the season.
Note: This field excludes blocked field goals'
Safeties:
type:
- number
- 'null'
description: Defensive safeties (sacks in end zone, solo tackles in end
zone, blocked kicks that went out of bounds in the end zone)
FieldGoalsHadBlocked:
type:
- number
- 'null'
description: Total field goals by the player that were blocked in the season
PuntsHadBlocked:
type:
- number
- 'null'
description: Total punts by the player that were blocked in the season
ExtraPointsHadBlocked:
type:
- number
- 'null'
description: Total extra point kick attempts by the player that were blocked
in the season
PuntLong:
type:
- number
- 'null'
description: The longest punt by the player in the season
BlockedKickReturnYards:
type:
- number
- 'null'
description: Total blocked kick recovery return yards for the player in
the season
FieldGoalReturnYards:
type:
- number
- 'null'
description: 'Total field goal return yards by the player in the season.
Note: This field excludes blocked field goals'
PuntNetYards:
type:
- number
- 'null'
description: The net yards of the punts by the player in the season
SpecialTeamsFumblesForced:
type:
- number
- 'null'
description: This field is deprecated
SpecialTeamsFumblesRecovered:
type:
- number
- 'null'
description: This field is deprecated
MiscFumblesForced:
type:
- number
- 'null'
description: This field is deprecated
MiscFumblesRecovered:
type:
- number
- 'null'
description: This field is deprecated
ShortName:
type:
- string
- 'null'
description: The first initial and last name of the player (J. Doe)
SafetiesAllowed:
type:
- number
- 'null'
description: This field is deprecated
Temperature:
type:
- integer
- 'null'
description: Temperature at game start (Fahrenheit)
Humidity:
type:
- integer
- 'null'
description: The humidity percentage at the start of the game
WindSpeed:
type:
- integer
- 'null'
description: The wind speed at the start of the game (in MPH)
OffensiveSnapsPlayed:
type:
- integer
- 'null'
description: 'Total snaps this player played on offensive in the season.
Note: Snap counts are available the morning after the game.'
DefensiveSnapsPlayed:
type:
- integer
- 'null'
description: 'Total snaps this player played on defense in the season. Note:
Snap counts are available the morning after the game.'
SpecialTeamsSnapsPlayed:
type:
- integer
- 'null'
description: 'Total snaps this player played on special teams in the season.
Note: Snap counts are available the morning after the game.'
OffensiveTeamSnaps:
type:
- integer
- 'null'
description: 'Total offensive snaps this player''s team played in the season.
Note: Snap counts are available the morning after the game.'
DefensiveTeamSnaps:
type:
- integer
- 'null'
description: 'Total defensive snaps this player''s team played in the season.
Note: Snap counts are available the morning after the game.'
SpecialTeamsTeamSnaps:
type:
- integer
- 'null'
description: 'Total special teams snaps this player''s team played in the
season. Note: Snap counts are available the morning after the game.'
AuctionValue:
type:
- number
- 'null'
description: Player's dollar value in a $200 salary cap auction draft.
AuctionValuePPR:
type:
- number
- 'null'
description: Player's dollar value in a $200 salary cap PPR auction draft.
TwoPointConversionReturns:
type:
- number
- 'null'
description: Total successful two point conversion returns by the player
in the season
FantasyPointsFanDuel:
type:
- number
- 'null'
description: Fantasy points based on FanDuel's scoring system by the player
in the season
FieldGoalsMade0to19:
type:
- number
- 'null'
description: Total field goals of 0 to 19 yards made by the player in season
FieldGoalsMade20to29:
type:
- number
- 'null'
description: Total field goals of 20 to 29 yards made by the player in season
FieldGoalsMade30to39:
type:
- number
- 'null'
description: Total field goals of 30 to 39 yards made by the player in season
FieldGoalsMade40to49:
type:
- number
- 'null'
description: Total field goals of 40 to 49 yards made by the player in season
FieldGoalsMade50Plus:
type:
- number
- 'null'
description: Total field goals of 50+ yards made by the player in season
FantasyPointsDraftKings:
type:
- number
- 'null'
description: Fantasy points based on DraftKings' scoring system by the player
in the season
FantasyPointsYahoo:
type:
- number
- 'null'
description: Fantasy points based on Yahoo's daily fantasy scoring system
by the player in the season
AverageDraftPosition:
type:
- number
- 'null'
description: The average draft position of the player in re-draft leagues
AverageDraftPositionPPR:
type:
- number
- 'null'
description: The average draft position of this player in Points Per Reception
(PPR) leagues.
TeamID:
type:
- integer
- 'null'
description: 'The unique ID of the team that the player is on. Note: If
the player is a free agent; this field is NULL'
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team. This value is guaranteed
to be unique across all sports/leagues
FantasyPointsFantasyDraft:
type:
- number
- 'null'
description: Fantasy points based on FantasyDraft's scoring system by the
player in the season
ScoringDetails:
type: array
items:
$ref: '#/components/schemas/ScoringDetail'
description: The details of the scoring plays this player recorded in the
season
AverageDraftPositionRookie:
type:
- number
- 'null'
description: The average draft position of this rookie in Points Per Reception
(PPR) leagues.
AverageDraftPositionDynasty:
type:
- number
- 'null'
description: The average draft position of this player in dynasty drafts
leagues
AverageDraftPosition2QB:
type:
- number
- 'null'
description: The average draft position of this player in 2 Quarterback
leagues
OffensiveFumbleRecoveryTouchdowns:
type:
- integer
- 'null'
description: This field is deprecated
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 and time that the slate begins; assigned by the operator
(in US Eastern Time)
NumberOfGames:
type:
- integer
- 'null'
description: The day that the slate begins; assigned by the operator (in
US Eastern Time)
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: Unique ID of a Slate (assigned by SportsDataIO).
GameID:
type:
- integer
- 'null'
description: The unique ID of this game tied to this SlateGame
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.
ScoreID:
type:
- integer
- 'null'
description: Unique ID of the Score/Game
Game:
$ref: '#/components/schemas/Schedule'
description: The details of the Score/Game that this SlateGame refers to
DfsSlatePlayer:
properties:
SlatePlayerID:
type: integer
description: Unique ID of a SlatePlayer (assigned by SportsDataIO)
SlateID:
type: integer
description: Unique ID of a Slate (assigned by SportsDataIO)
SlateGameID:
type:
- integer
- 'null'
description: Unique ID of a SlateGame (assigned by SportsDataIO)
PlayerID:
type:
- integer
- 'null'
description: 'The unique PlayerID of the player as assigned by SportsDataIO
tied to this SlatePlayer. This points to data in the respective sports''
player feeds 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.
This field is only filled for Players. For the NFL feeds; this is the
PlayerGameProjection.PlayerGameID
FantasyDefenseProjectionStatID:
type:
- integer
- 'null'
description: The SportsDataIO StatID that this SlatePlayer refers to. This
field is only filled for Defense/Special Teams. For the NFL feeds, this
is the FantasyDefenseGameProjection.FantasyDefenseID.
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 (assigned by the operator)
OperatorRosterSlots:
type: array
items:
type:
- string
- 'null'
description: 'The player''s eligible positions to be played in the contest
(assigned by the operator). Note: This would include FLEX; etc plays
for those that are eligible'
OperatorSalary:
type:
- integer
- 'null'
description: The player's salary for the contest (assigned by the operator).
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
TeamID:
type:
- integer
- 'null'
description: 'The unique ID of the team that the player is on. Note: If
the player is a free agent; this field is NULL'
RemovedByOperator:
type:
- boolean
- 'null'
description: Indicates whether this player was removed/deleted by the operator.
DfsSlateWithOwnershipProjection:
properties:
SlateID:
type: integer
description: Unique ID of a Slate (assigned by SportsDataIO).
Operator:
type:
- string
- 'null'
description: 'The name of the operator who is running contests for this
slate. Possible values: FanDuel, DraftKings, Yahoo, FantasyDraft, etc.'
OperatorSlateID:
type:
- integer
- 'null'
description: Unique ID of a slate (assigned by the operator).
OperatorName:
type:
- string
- 'null'
description: 'The name of the slate (assigned by the operator). Possible
values: Main, Express, Arcade, Late Night, etc.'
OperatorDay:
type:
- string
- 'null'
description: The day that the slate begins; assigned by the operator (in
US Eastern Time)
OperatorStartTime:
type:
- string
- 'null'
description: The date/time (in EST/EDT) that the slate begins (assigned
by the operator).
SlateOwnershipProjections:
type: array
items:
$ref: '#/components/schemas/DfsSlatePlayerOwnershipProjection'
description: The list of projected ownership
DfsSlatePlayerOwnershipProjection:
properties:
SlateID:
type: integer
description: Unique ID of a Slate (assigned by SportsDataIO).
PlayerID:
type:
- integer
- 'null'
description: Unique ID of the Associated Player (can be null when it is
a Team Defense)
FantasyDefensePlayerID:
type:
- integer
- 'null'
description: Unique ID of the Team Defense (only set for Team Defenses)
ProjectedOwnershipPercentage:
type: number
description: Projected Ownership Percentage (0-100)
IsCaptain:
type: boolean
description: Indicates if this is the MVP/Captain slot for single game slates
GameInfo:
properties:
ScoreId:
type: integer
description: Unique ID of the score/game
Season:
type: integer
description: The year of the season during which this game occurs.
SeasonType:
type: integer
description: The type of season that this game corresponds to (1=Regular
Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star).
Week:
type:
- integer
- 'null'
description: 'The NFL week of the game (regular season: 1 to 18; preseason:
0 to 4; postseason: 1 to 4). Note: seasons after 2021 will have only 3
preseason weeks'
Day:
type:
- string
- 'null'
description: The date of the game (in US Eastern Time)
DateTime:
type:
- string
- 'null'
description: The date and time of the game (in US Eastern Time)
Status:
type:
- string
- 'null'
description: The status of the game. For a description of possible values,
see here. For how suspended and postponed games are handled
specifically, see here.
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 name of the away team
HomeTeamName:
type:
- string
- 'null'
description: The name of the home team.
GlobalGameId:
type: integer
description: A globally unique ID for this game. This value is guaranteed
to be unique across all sports/leagues
GlobalAwayTeamId:
type:
- integer
- 'null'
description: A globally unique ID for the away team. This value is guaranteed
to be unique across all sports/leagues
GlobalHomeTeamId:
type:
- integer
- 'null'
description: A globally unique ID for the home team. This value is guaranteed
to be unique across all sports/leagues
PregameOdds:
type: array
items:
$ref: '#/components/schemas/GameOdd'
description: List of Pregame Odds from different sportsbooks
LiveOdds:
type: array
items:
$ref: '#/components/schemas/GameOdd'
description: List of Live Odds from different sportsbooks
HomeTeamScore:
type:
- integer
- 'null'
description: Score of the home team (updated after game ends to allow for
resolving bets)
AwayTeamScore:
type:
- integer
- 'null'
description: Score of the away team (updated after game ends to allow for
resolving bets)
TotalScore:
type:
- integer
- 'null'
description: The total points scored by both teams in the game tied to this
event (updated after game ends to allow for resulting bets)
HomeRotationNumber:
type:
- integer
- 'null'
description: Rotation Number of home team in this game
AwayRotationNumber:
type:
- integer
- 'null'
description: Rotation Number of away team in this game
AlternateMarketPregameOdds:
type: array
items:
$ref: '#/components/schemas/GameOdd'
description: List of Alternate Market Pregame Odds from different sportsbooks
GameId:
type: integer
description: The unique ID of this game
GameOdd:
properties:
GameOddId:
type: integer
description: The unique ID of this odd
Sportsbook:
type:
- string
- 'null'
description: Name of sportsbook
ScoreId:
type: integer
description: Unique ID of the score/game
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, based on
US Eatern Time (EST/EDT). If these are the latest odds for this game,
and they have not been updated within the last few minutes, then it indicates
that there were problems connecting to the sportsbook.
HomeMoneyLine:
type:
- integer
- 'null'
description: The sportsbook's moneyline for the home team
AwayMoneyLine:
type:
- integer
- 'null'
description: The sportsbook's moneyline for the away team
DrawMoneyLine:
type:
- integer
- 'null'
description: The sportsbook's moneyline for a draw
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 over the total points line
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 this odd (ex: live, pregame, 1st-half,
1st-qtr, etc)'
SportsbookUrl:
type:
- string
- 'null'
description: The URL for sportsbook event
GameId:
type: integer
description: The unique ID of this game
Unlisted:
type:
- string
- 'null'
description: The datetime the outcome was unlisted (no longer available
for bets) in US eastern time
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/Score'
description: Upcoming game for this 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 unique ID of the opponent team
Opponent:
type:
- string
- 'null'
description: The abbreviation [Key] of the opponent team
Wins:
type: integer
description: 'Total number of wins 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: 'Losses 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: 'Total 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: 'Total number of wins against the spread relating to the scope.
Examples of scopes include: Last 3 Games, Last 5 Home Games, Last 10 Games
as Favorite, etc.'
LossesAgainstTheSpread:
type:
- integer
- 'null'
description: 'Losses against the spread 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 (over/under)
Unders:
type:
- integer
- 'null'
description: Amount of times the total score goes under the total points
line (over/under)
OverUnderPushes:
type:
- integer
- 'null'
description: Amount of times the total score pushes the total point line
(over/under)
AverageScore:
type:
- number
- 'null'
description: Average score of team
AverageOpponentScore:
type:
- number
- 'null'
description: Average score of opponent
MatchupTrends:
properties:
UpcomingGame:
$ref: '#/components/schemas/Score'
description: Upcoming game between the team and the opponent
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/Score'
description: The collection of last 10 game scores between each team
BettingEvent:
properties:
BettingEventID:
type: integer
description: The unique ID assocated with the betting event
Name:
type:
- string
- 'null'
description: The name of the betting event
Season:
type:
- integer
- 'null'
description: The NFL season of the betting event
BettingEventTypeID:
type: integer
description: The ID associated with the type of betting event
BettingEventType:
type:
- string
- 'null'
description: Indicates the type of betting event - Game or Future
StartDate:
type:
- string
- 'null'
description: The furthest forward time any book has a market set to close
for this betting event
Created:
type:
- string
- 'null'
description: The date and time when this betting event was created in US
Eastern Time
Updated:
type:
- string
- 'null'
description: The date and time of the last update made to this betting event
(in US Eastern Time)
ScoreID:
type:
- integer
- 'null'
description: ScoreID has been superseded by GameID and should not be used
in any new integrations. Existing integrations can be updated to use GameID
instead, so that they are consistent with all other sports.
GlobalScoreID:
type:
- integer
- 'null'
description: A globally unique ID for the game tied to this betting event.
This value is guaranteed to be unique across all sports/leagues
GameStatus:
type:
- string
- 'null'
description: The status of the game tied to this betting event
Quarter:
type:
- string
- 'null'
description: The quarter of the game tied to this event
AwayTeam:
type:
- string
- 'null'
description: The abbreviation [Key] of the away team
HomeTeam:
type:
- string
- 'null'
description: The abbreviation [Key] of the Home Team
AwayTeamID:
type:
- integer
- 'null'
description: The unique TeamID of the away team tied to this BettingEvent
HomeTeamID:
type:
- integer
- 'null'
description: The unique TeamID of the home team tied to this BettingEvent
GlobalAwayTeamID:
type:
- integer
- 'null'
description: A globally unique ID for the away team tied to this BettingEvent
This value is guaranteed to be unique across all sports/leagues
GlobalHomeTeamID:
type:
- integer
- 'null'
description: A globally unique ID for the home team tied to this BettingEvent.
This value is guaranteed to be unique across all sports/leagues.
AwayTeamScore:
type:
- integer
- 'null'
description: Score of the away team tied to this betting event (updated
after game ends to allow for resolving bets)
HomeTeamScore:
type:
- integer
- 'null'
description: Score of the home team tied to this betting event (updated
after game ends to allow for resolving bets)
TotalScore:
type:
- integer
- 'null'
description: The total points scored by both teams in the game tied to this
event (updated after game ends to allow for resulting bets)
AwayRotationNumber:
type:
- integer
- 'null'
description: Rotation number of away team for this game
HomeRotationNumber:
type:
- integer
- 'null'
description: Rotation number of home team for this game
BettingMarkets:
type: array
items:
$ref: '#/components/schemas/BettingMarket'
description: The list of betting markets for this event
GameStartTime:
type:
- string
- 'null'
description: The date and time the game starts
BettingMarket:
properties:
BettingMarketID:
type: integer
description: The unique ID associated with the betting market
BettingEventID:
type: integer
description: The unique ID assocated with the betting event
BettingMarketTypeID:
type:
- integer
- 'null'
description: The unique ID associated with the market type of the betting
market
BettingMarketType:
type:
- string
- 'null'
description: The name of the market type within a market (e.g. Player Prop,
Team Prop, Game Prop, etc.)
BettingBetTypeID:
type:
- integer
- 'null'
description: The ID associated with the name of the bet type within a market
BettingBetType:
type:
- string
- 'null'
description: The name of the bet type within a market (e.g. Total 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 BettingPeriodType of this market (e.g. Full Game; 1st Period;
Overtime; Regular Season)
Name:
type:
- string
- 'null'
description: The name of the betting market
TeamID:
type:
- integer
- 'null'
description: The team's unique TeamID as assigned by SportsDataIO tied this
market (if applicable)
TeamKey:
type:
- string
- 'null'
description: The abbreviation [Key] of the team tied to this market (if
applicable)
PlayerID:
type:
- integer
- 'null'
description: 'The unique PlayerID of the player as assigned by SportsDataIO
tied to this betting market. Note: this ID will stay with the player throughout
their entire career'
PlayerName:
type:
- string
- 'null'
description: The full name of the player associated with this market
Created:
type:
- string
- 'null'
description: The date and time when this betting market was created in US
Eastern Time
Updated:
type:
- string
- 'null'
description: The date and time of the last update made to this betting market
(in US Eastern Time)
AvailableSportsbooks:
type: array
items:
$ref: '#/components/schemas/Sportsbook'
description: The sportsbooks that have had odds in this market
AnyBetsAvailable:
type:
- boolean
- 'null'
description: A field that returns "True" if there are any available bets
to make within the market in question. If there are no bets available
to make, the field returns "False"
BettingOutcomes:
type: array
items:
$ref: '#/components/schemas/BettingOutcome'
description: The list of betting outcomes from each sportsbook in this market
ConsensusOutcomes:
type: array
items:
$ref: '#/components/schemas/ConsensusOutcome'
description: The single set of consensus outcomes of this market
IsArchived:
type: boolean
description: Indicates whether a BettingOutcome has been archived or not
(true/false)
ArchiveLocation:
type:
- string
- 'null'
description: If IsArchived is true, this returns the URL that can be used
to retrieve the archived BettingOutcomes. An API Key and Sportsbook Grouping
will be required to retrieve this information. If IsArchived is false,
this returns an emtpy string
Sportsbook:
properties:
SportsbookID:
type: integer
description: Unique ID of the sportsbook
Name:
type:
- string
- 'null'
description: The name of the sportsbook(s)
BettingOutcome:
properties:
BettingOutcomeID:
type:
- integer
- 'null'
description: The unique ID associated with the betting outcome
BettingMarketID:
type:
- integer
- 'null'
description: The unique ID associated with the betting market
SportsBook:
$ref: '#/components/schemas/Sportsbook'
description: Name of sportsbook
BettingOutcomeTypeID:
type:
- integer
- 'null'
description: The unique ID associated with this BettingOutcomeType
BettingOutcomeType:
type:
- string
- 'null'
description: The name of BettingOutcomeType (e.g. Home; Away; Under; Over)
PayoutAmerican:
type:
- integer
- 'null'
description: The payout of the bet, shown in American odds format
PayoutDecimal:
type:
- number
- 'null'
description: The payout of the bet, shown in decimal odds format
Value:
type:
- number
- 'null'
description: The number associated with the outcome (spread, total, etc)
Participant:
type:
- string
- 'null'
description: 'This field is sourced from the related sportsbook and is shown
as is; consider it as free-text that can take any form. If a BettingOutcome
has the PlayerId or TeamId field set; you should use the respective Player
or Team record to perform actions like displaying a player''s name. Note:
if a BettingMarket has PlayerId or TeamId set; all the child BettingOutcomes
will have the field set as well'
IsAvailable:
type:
- boolean
- 'null'
description: Indicates whether a BettingOutcome is available for betting
or not (true/false)
IsAlternate:
type:
- boolean
- 'null'
description: Indicates whether this is an alternate value or the core value
(true/false)
Created:
type:
- string
- 'null'
description: The date and time when this betting outcome was created in
US Eastern Time.
Updated:
type:
- string
- 'null'
description: The date and time of the last update made to this betting outcome
(in US Eastern Time)
Unlisted:
type:
- string
- 'null'
description: The timestamp of when these odds were first made unavailable
to be bet on any further (In US Eastern Time)
TeamID:
type:
- integer
- 'null'
description: The team's unique TeamID as assigned by SportsDataIO tied this
outcome (if applicable)
PlayerID:
type:
- integer
- 'null'
description: 'The unique PlayerID of the player as assigned by SportsDataIO
tied to this betting outcome. Note: this ID will stay with the player
throughout their entire career'
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team tied to this outcome. This
value is guaranteed to be unique across all sports/leagues (where applicable)
SportsbookUrl:
type:
- string
- 'null'
description: The URL for sportsbook event
IsInPlay:
type:
- boolean
- 'null'
description: Was this outcome created after the start time of the game (only
applies when the betting event is of type game; true/false)
SportsbookMarketID:
type:
- string
- 'null'
description: The market id on the given sportsbook when available for deep
links
SportsbookOutcomeID:
type:
- string
- 'null'
description: The outcome id on the given sportsbook when available for deep
links
ConsensusOutcome:
properties:
NumberOfSportsbooks:
type: integer
description: The number of sportsbooks odds that went into creating this
consensus outcome
BettingOutcomeID:
type:
- integer
- 'null'
description: The unique ID associated with the betting outcome
BettingMarketID:
type:
- integer
- 'null'
description: The unique ID associated with the betting market
SportsBook:
$ref: '#/components/schemas/Sportsbook'
description: Name of sportsbook
BettingOutcomeTypeID:
type:
- integer
- 'null'
description: The unique ID associated with this BettingOutcomeType
BettingOutcomeType:
type:
- string
- 'null'
description: The name of BettingOutcomeType (e.g. Home; Away; Under; Over)
PayoutAmerican:
type:
- integer
- 'null'
description: The payout of the bet, shown in American odds format
PayoutDecimal:
type:
- number
- 'null'
description: The payout of the bet, shown in decimal odds format
Value:
type:
- number
- 'null'
description: The number associated with the outcome (spread, total, etc)
Participant:
type:
- string
- 'null'
description: 'This field is sourced from the related sportsbook and is shown
as is; consider it as free-text that can take any form. If a BettingOutcome
has the PlayerId or TeamId field set; you should use the respective Player
or Team record to perform actions like displaying a player''s name. Note:
if a BettingMarket has PlayerId or TeamId set; all the child BettingOutcomes
will have the field set as well'
IsAvailable:
type:
- boolean
- 'null'
description: Indicates whether a BettingOutcome is available for betting
or not (true/false)
IsAlternate:
type:
- boolean
- 'null'
description: Indicates whether this is an alternate value or the core value
(true/false)
Created:
type:
- string
- 'null'
description: The date and time when this betting outcome was created in
US Eastern Time.
Updated:
type:
- string
- 'null'
description: The date and time of the last update made to this betting outcome
(in US Eastern Time)
Unlisted:
type:
- string
- 'null'
description: The timestamp of when these odds were first made unavailable
to be bet on any further (In US Eastern Time)
TeamID:
type:
- integer
- 'null'
description: The team's unique TeamID as assigned by SportsDataIO tied this
outcome (if applicable)
PlayerID:
type:
- integer
- 'null'
description: 'The unique PlayerID of the player as assigned by SportsDataIO
tied to this betting outcome. Note: this ID will stay with the player
throughout their entire career'
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team tied to this outcome. This
value is guaranteed to be unique across all sports/leagues (where applicable)
SportsbookUrl:
type:
- string
- 'null'
description: The URL for sportsbook event
IsInPlay:
type:
- boolean
- 'null'
description: Was this outcome created after the start time of the game (only
applies when the betting event is of type game; true/false)
SportsbookMarketID:
type:
- string
- 'null'
description: The market id on the given sportsbook when available for deep
links
SportsbookOutcomeID:
type:
- string
- 'null'
description: The outcome id on the given sportsbook when available for deep
links
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 ; 1st Quarter)
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: The string identifier of the BettingResultType of this outcome
(e.g. Won; Lost; 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)
BettingResultingMetadata:
properties:
BettingMarketTypeId:
type: integer
description: The unique ID associated with the market type of the betting
market
BettingBetTypeId:
type: integer
description: The ID associated with the name of the bet type within a market
BettingPeriodTypeId:
type: integer
description: The BettingPeriodTypeID of this market
GameBettingSplit:
properties:
ScoreId:
type: integer
description: Unique ID of the score/game
GameKey:
type:
- string
- 'null'
description: 'A 9 digit unique code identifying the game that this record
corresponds to. The GameID is composed of Season; SeasonType; Week and
HomeTeam. Note: This value will be NULL for bye weeks'
SeasonType:
type: integer
description: The type of season that this game corresponds to (1=Regular
Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star).
Season:
type: integer
description: The season of the score
Week:
type: integer
description: 'The NFL week associated with this betting split (regular season:
1 to 18; preseason: 0 to 4; postseason: 1 to 4). Note: seasons after 2021
will have 3 preseason weeks'
Date:
type:
- string
- 'null'
description: The date and time of the game (in US Eastern Time)
AwayTeam:
type:
- string
- 'null'
description: The abbreviation [Key} of the away team
HomeTeam:
type:
- string
- 'null'
description: The abbreviation [Key] of the home team
BettingMarketSplits:
type: array
items:
$ref: '#/components/schemas/BettingMarketSplit'
description: Shows the Market Types that have splits included for them in
a given game
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 associated with the market type of the betting
market
BettingMarketType:
type:
- string
- 'null'
description: The name of the market type within a market (e.g. Player Prop,
Team Prop, Game Prop, etc.)
BettingBetTypeID:
type: integer
description: The ID associated with the name of the bet type within a market
BettingBetType:
type:
- string
- 'null'
description: The name of the bet type within a market (e.g. Total Points,
Moneyline, Spread, etc.)
BettingPeriodTypeID:
type: integer
description: The BettingPeriodTypeID of this market
BettingPeriodType:
type:
- string
- 'null'
description: The BettingPeriodType of this market (e.g. Full Game; 1st Period;
Overtime; Regular Season)
TeamID:
type:
- integer
- 'null'
description: The team's unique TeamID as assigned by SportsDataIO tied this
market (if applicable)
TeamKey:
type:
- string
- 'null'
description: The abbreviation [Key] of the team tied to this market (if
applicable)
PlayerID:
type:
- integer
- 'null'
description: 'The unique PlayerID of the player as assigned by SportsDataIO
tied to this betting market split. Note: this ID will stay with the player
throughout their entire career'
PlayerName:
type:
- string
- 'null'
description: The full name of the player associated with this market
BettingSplits:
type: array
items:
$ref: '#/components/schemas/BettingSplit'
description: A list of betting splits for the BettingMarket
BettingSplit:
properties:
BettingMarketSplitID:
type: integer
description: The unique ID associated with the betting split
BettingMarketID:
type: integer
description: The unique ID associated with the betting market
BettingOutcomeTypeID:
type:
- integer
- 'null'
description: The unique ID associated with this BettingOutcomeType
BettingOutcomeType:
type:
- string
- 'null'
description: The name of BettingOutcomeType (e.g. Home; Away; Under; Over)
BetPercentage:
type:
- integer
- 'null'
description: Percentage of bets placed on a specific outcome
MoneyPercentage:
type:
- integer
- 'null'
description: The percentage of the money placed in wagers on this market
taken by this type of bet
Created:
type:
- string
- 'null'
description: The date and time this betting split was created in US Eastern
Time
LastSeen:
type:
- string
- 'null'
description: The date and time this set of values was last seen
BettingMarketResult:
properties:
BettingMarketID:
type: integer
description: The unique ID associated with the betting market
BettingMarketTypeID:
type: integer
description: The unique ID associated with the market type of the betting
market
BettingMarketType:
type:
- string
- 'null'
description: The name of the market type within a market (e.g. Player Prop,
Team Prop, Game Prop, etc.)
BettingBetTypeID:
type: integer
description: The ID associated with the name of the bet type within a market
BettingBetType:
type:
- string
- 'null'
description: The name of the bet type within a market (e.g. Total 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 BettingPeriodType of this market (e.g. Full Game; 1st Period;
Overtime; Regular Season)
Name:
type:
- string
- 'null'
description: The name of the betting market
TeamID:
type:
- integer
- 'null'
description: The team's unique TeamID as assigned by SportsDataIO tied this
market (if applicable)
TeamKey:
type:
- string
- 'null'
description: The abbreviation [Key] of the team tied to this market (if
applicable)
PlayerID:
type:
- integer
- 'null'
description: 'The unique PlayerID of the player as assigned by SportsDataIO
tied to this betting market result. Note: this ID will stay with the player
throughout their entire career'
PlayerName:
type:
- string
- 'null'
description: The full name of the player associated with this market
BettingOutcomeResults:
type: array
items:
$ref: '#/components/schemas/BettingOutcomeResult'
description: The list of outcomes under this market with results
IsMarketResultingSupported:
type: boolean
description: Indicates whether resulting is supported for this kind of BettingMarket (true/false)
BettingOutcomeResult:
properties:
BettingOutcomeID:
type: integer
description: The unique ID associated with the betting outcome
BettingResultTypeID:
type:
- integer
- 'null'
description: The BettingResultTypeID of this outcome
BettingResultType:
type:
- string
- 'null'
description: The string identifier of the BettingResultType of this outcome
(e.g. Win; Loss; Push; Not Resulted; Incomplete)
BettingOutcomeTypeID:
type:
- integer
- 'null'
description: The unique ID associated with this BettingOutcomeType
BettingOutcomeType:
type:
- string
- 'null'
description: The name of BettingOutcomeType (e.g. Home; Away; Under; Over)
BetValue:
type:
- number
- 'null'
description: The offered betting line from a sportsbook for a game (i.e.
If a team won a game by 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)
GameInfoResult:
properties:
ScoreID:
type: integer
description: Unique ID of the score/game
Season:
type: integer
description: The year of the season during which this game occurs.
SeasonType:
type: integer
description: The type of season that this game corresponds to (1=Regular
Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star).
Week:
type:
- integer
- 'null'
description: 'The NFL week of the game (regular season: 1 to 18; preseason:
0 to 4; postseason: 1 to 4). Note: seasons after 2021 will have only 3
preseason weeks'
Day:
type:
- string
- 'null'
description: The date of the game (in US Eastern Time)
DateTime:
type:
- string
- 'null'
description: The date and time of the game (in US Eastern Time)
Status:
type:
- string
- 'null'
description: The status of the game. For a description of possible values,
see here. For how suspended and postponed games are handled
specifically, see here.
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 name of the away team
HomeTeamName:
type:
- string
- 'null'
description: The name 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
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 Odds from different sportsbooks with results
HomeTeamScore:
type:
- integer
- 'null'
description: Score of the home team (updated after game ends to allow for
resolving bets)
AwayTeamScore:
type:
- integer
- 'null'
description: Score of the away team (updated after game ends to allow for
resolving bets)
TotalScore:
type:
- integer
- 'null'
description: The total points scored by both teams in the game tied to this
event (updated after game ends to allow for resulting bets)
HomeRotationNumber:
type:
- integer
- 'null'
description: Rotation Number of home team in this game
AwayRotationNumber:
type:
- integer
- 'null'
description: Rotation Number of away team in this game
AlternateMarketPregameOdds:
type: array
items:
$ref: '#/components/schemas/GameOddResult'
description: List of Alternate Market Pregame Odds from different sportsbooks
with results
GameID:
type: integer
description: The unique ID of this game
Quarter:
type:
- string
- 'null'
description: The current quarter of the game (1, 2, 3, 4, Half, OT, F, F/OT
or NULL if game has not yet started)
TimeRemaining:
type:
- string
- 'null'
description: The amount of time remaining in the current quarter (e.g. 11:23;
5:34; NULL if game is not in progress or at halftime)
AwayScoreQuarter1:
type:
- integer
- 'null'
description: Points scored by the away team in Quarter 1
AwayScoreQuarter2:
type:
- integer
- 'null'
description: Points scored by the away team in Quarter 2
AwayScoreQuarter3:
type:
- integer
- 'null'
description: Points scored by the away team in Quarter 3
AwayScoreQuarter4:
type:
- integer
- 'null'
description: Points scored by the away team in Quarter 4
AwayScoreOvertime:
type:
- integer
- 'null'
description: Points scored by the away team in overtime
HomeScoreQuarter1:
type:
- integer
- 'null'
description: Points scored by the home team in Quarter 1
HomeScoreQuarter2:
type:
- integer
- 'null'
description: Points scored by the home team in Quarter 2
HomeScoreQuarter3:
type:
- integer
- 'null'
description: Points scored by the home team in Quarter 3
HomeScoreQuarter4:
type:
- integer
- 'null'
description: Points scored by the home team in Quarter 4
HomeScoreOvertime:
type:
- integer
- 'null'
description: Points scored by the home team in overtime
IsClosed:
type:
- boolean
- 'null'
description: Indicates whether the game is over and the final score has
been verified and closed out.
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
ScoreID:
type: integer
description: Unique ID of the score/game
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, based on
US Eatern Time (EST/EDT). If these are the latest odds for this game,
and they have not been updated within the last few minutes, then it indicates
that there were problems connecting to the sportsbook.
HomeMoneyLine:
type:
- integer
- 'null'
description: The sportsbook's moneyline for the home team
AwayMoneyLine:
type:
- integer
- 'null'
description: The sportsbook's moneyline for the away team
DrawMoneyLine:
type:
- integer
- 'null'
description: The sportsbook's moneyline for a draw
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 over the total points line
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 this odd (ex: live, pregame, 1st-half,
1st-qtr, etc)'
SportsbookUrl:
type:
- string
- 'null'
description: The URL for sportsbook event
GameID:
type: integer
description: The unique ID of this game
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 unique ID of this GameOddResultType
GameOddResultType:
type:
- string
- 'null'
description: The result/outcome of a bet (e.g. Won; Lost; Push; Not Resulted;
Incomplete)
OddType:
type:
- string
- 'null'
description: The market type of the odd (ex. live, pregame, 1st-5th ining,
etc)
GameOddType:
type:
- string
- 'null'
description: The GameOddOutcomeType of this outcome as a string
BetValue:
type:
- number
- 'null'
description: The value that was bet in this outcome (if applicable)
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)
PlayerGame:
properties:
GameKey:
type:
- string
- 'null'
description: 'A 9 digit unique code identifying the game that this record
corresponds to. The GameID is composed of Season; SeasonType; Week and
HomeTeam.. Note: This value will be NULL for bye weeks'
PlayerID:
type:
- integer
- 'null'
description: 'The unique PlayerID of the player as assigned by SportsDataIO.
Note: this ID will stay with the player throughout their entire career'
SeasonType:
type: integer
description: The type of season that this player corresponds to (1=Regular
Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star)
Season:
type: integer
description: The NFL season of the game
GameDate:
type:
- string
- 'null'
description: The date and time the game is scheduled to start
Week:
type: integer
description: 'The NFL week of the game (regular season: 1 to 18; preseason:
0 to 4; postseason: 1 to 4). Note: seasons after 2021 will have only 3
preseason weeks'
Team:
type:
- string
- 'null'
description: 'The abbreviation [Key] of the team that the player is on.
Note: if this player is a free agent; this field is NULL'
Opponent:
type:
- string
- 'null'
description: The abbreviation [Key] of the opponent team
HomeOrAway:
type:
- string
- 'null'
description: Whether the team is home or away
Number:
type: integer
description: Player's jersey number
Name:
type:
- string
- 'null'
description: Player's full name
Position:
type:
- string
- 'null'
description: 'The primary position of the player. Possible Values: C; CB;
DB; DE; DL; DT; FB; FS; G; ILB; K; KR; LB; LS; NT; OL; OLB; OT; P; QB;
RB; S; SS; T; TE; WR'
PositionCategory:
type:
- string
- 'null'
description: The category of the player's position (OFF; DEF; ST)
Activated:
type: integer
description: Whether or not the player was active for the game
Played:
type: integer
description: 'Whether the player played at least one snap in the game Note:
Will return "1" if player played at least one snap and "0" if they did
not'
Started:
type: integer
description: 'Whether the player started the game (on offensive or defense).
Note: Started = 1 / Did Not Start = 0'
PassingAttempts:
type: number
description: Total passes thrown by the player in the game
PassingCompletions:
type: number
description: Total passes completed by the player in the game
PassingYards:
type: number
description: Total passing yards by the player in the game
PassingCompletionPercentage:
type: number
description: The percentage of passes completed by the player in the game
PassingYardsPerAttempt:
type: number
description: Total average passing yards per attempt by the player in the
game
PassingYardsPerCompletion:
type: number
description: Total average passing yards per completion by the player in
the game
PassingTouchdowns:
type: number
description: Total passing touchdowns by the player in the game
PassingInterceptions:
type: number
description: Total interceptions thrown by the player in the game
PassingRating:
type: number
description: The passer rating of the player in the game
PassingLong:
type: number
description: Total yards of longest completion by the player in the game
PassingSacks:
type: number
description: The total number of times the player was sacked in the game
PassingSackYards:
type: number
description: Total yards lost by the player in the game as a result of being
sacked
RushingAttempts:
type: number
description: Total rushing attempts by the player in the game
RushingYards:
type: number
description: Total rushing yards by the player in the game
RushingYardsPerAttempt:
type: number
description: Total rushing yards per attempt by the player in the game
RushingTouchdowns:
type: number
description: Total rushing touchdowns by the player in the game
RushingLong:
type: number
description: The longest rush by the player in the game
ReceivingTargets:
type:
- number
- 'null'
description: Total receiving targets by the player in the game
Receptions:
type: number
description: Total receptions by the player in the game
ReceivingYards:
type: number
description: Total receiving yards by the player in the game
ReceivingYardsPerReception:
type: number
description: Average receiving yards per reception by the player in the
game
ReceivingTouchdowns:
type: number
description: Total receiving touchdowns by the player in the game
ReceivingLong:
type: number
description: The longest reception by the player in the game
Fumbles:
type: number
description: Total fumbles by the player in the game
FumblesLost:
type:
- number
- 'null'
description: Total fumbles lost by the player in the game
PuntReturns:
type: number
description: Total punt returns by the player in the game
PuntReturnYards:
type: number
description: Total punt return yards by the player in the game
PuntReturnYardsPerAttempt:
type: number
description: Total average yards gained per punt return by the player in
the game
PuntReturnTouchdowns:
type: number
description: Total punt return touchdowns by the player in the game
PuntReturnLong:
type: number
description: The longest punt return by the player in the game
KickReturns:
type: number
description: Total kickoff returns by the player in the game
KickReturnYards:
type: number
description: Total kickoff return yards by the player in the game
KickReturnYardsPerAttempt:
type: number
description: Average yards gained per kick return by the player in the game
KickReturnTouchdowns:
type: number
description: Total kickoff return touchdowns by the player in the game
KickReturnLong:
type: number
description: Longest kick return by the player in the game
SoloTackles:
type: number
description: Total defensive solo (unassisted) tackles by the player in
the game
AssistedTackles:
type: number
description: Total defensive assisted tackles by the player in the game
TacklesForLoss:
type:
- number
- 'null'
description: 'Total tackles for loss by the player in the game. Note: these
are tackles behind the line of scrimmage for loss of yards (including
sacks)'
Sacks:
type: number
description: Total defensive sacks by the player in the game
SackYards:
type: number
description: Total defensive sacks yards by the player in the game
QuarterbackHits:
type:
- number
- 'null'
description: 'Total quarterback hits by the player in the game. Note: This
is a defensive stat that includes sacks'
PassesDefended:
type: number
description: Total passes defended by the player in the game
FumblesForced:
type: number
description: Total fumbles forced on defense by the player in the game
FumblesRecovered:
type: number
description: Total defensive fumble recoveries by the player in the game
FumbleReturnYards:
type: number
description: Total fumble return yards by the player in the game
FumbleReturnTouchdowns:
type: number
description: Total fumble return touchdowns by the player in the game
Interceptions:
type: number
description: Total defensive interceptions by the player in the game
InterceptionReturnYards:
type: number
description: Total defensive interception return yards by the player in
the game
InterceptionReturnTouchdowns:
type: number
description: Total defensive interception return touchdowns by the player
in the game
BlockedKicks:
type: number
description: 'Total blocked kicks by the player in the game. Note: BlockedKicks
include Field Goals and Punts but NOT Extra Points'
SpecialTeamsSoloTackles:
type: number
description: This field is deprecated
SpecialTeamsAssistedTackles:
type: number
description: This field is deprecated
MiscSoloTackles:
type: number
description: This field is deprecated
MiscAssistedTackles:
type: number
description: This field is deprecated
Punts:
type: number
description: Total number of punts by the player in the game
PuntYards:
type: number
description: Total punt yards by the player in the game
PuntAverage:
type: number
description: The average number of yards per punt by the player in the game
FieldGoalsAttempted:
type: number
description: Total field goals attempted by the player in the game
FieldGoalsMade:
type: number
description: Total field goals made by the player in game
FieldGoalsLongestMade:
type: number
description: Longest field goal made by the player in the game
ExtraPointsMade:
type: number
description: Total extra points made by the player in the game
TwoPointConversionPasses:
type: number
description: Total successful two point conversion passes by the player
in the game
TwoPointConversionRuns:
type: number
description: Total successful two point conversion rushes by the player
in the game
TwoPointConversionReceptions:
type: number
description: Total successful two point conversion receptions by the player
in the game
FantasyPoints:
type: number
description: Fantasy points scored based on basic fantasy scoring system
by the player in the game
FantasyPointsPPR:
type: number
description: This field is expected to be NULL
ReceptionPercentage:
type: number
description: Total percentage of receiving targets that were receptions
by the player in the game
ReceivingYardsPerTarget:
type: number
description: Average receiving yards per target by the player in the game
Tackles:
type: number
description: Total tackles (solo & assisted) by the player in the game
OffensiveTouchdowns:
type: number
description: Total offensive touchdowns scored by the player in the game
DefensiveTouchdowns:
type: number
description: Total defensive touchdowns scored by the player in the game
SpecialTeamsTouchdowns:
type: number
description: Total special teams touchdowns scored by the player in the
game
Touchdowns:
type: number
description: Total touchdowns scored by the player in the game (excludes
passing touchdowns)
FantasyPosition:
type:
- string
- 'null'
description: 'The player''s fantasy football position. Possible values:
QB; RB; WR; TE; DL; LB; DB; K; P; OL'
FieldGoalPercentage:
type: number
description: Total field goal attempts made by the player in the game
PlayerGameID:
type: integer
description: Unique ID of PlayerGame record (subject to change, although
it very rarely does). For a static ID, use a combination of GameKey and
PlayerID.
FumblesOwnRecoveries:
type:
- number
- 'null'
description: 'Total own fumble recoveries by the player in the game. Note:
this fumble doesn''t result in a turnover - the fumbling team recovers
the fumble'
FumblesOutOfBounds:
type:
- number
- 'null'
description: This field is deprecated
KickReturnFairCatches:
type:
- number
- 'null'
description: This field is deprecated
PuntReturnFairCatches:
type:
- number
- 'null'
description: This field is deprecated
PuntTouchbacks:
type:
- number
- 'null'
description: Total punts that resulted in touchbacks by the player in the
game
PuntInside20:
type:
- number
- 'null'
description: Total punts downed inside the 20 yard line by the player in
the game
PuntNetAverage:
type:
- number
- 'null'
description: The average net yards per punt by the player in the game
ExtraPointsAttempted:
type:
- number
- 'null'
description: Total extra point kicks attempted by the player in the game
BlockedKickReturnTouchdowns:
type:
- number
- 'null'
description: Total blocked kick recovery return touchdowns for the player
in the game
FieldGoalReturnTouchdowns:
type:
- number
- 'null'
description: 'Total field goal return touchdowns by the player in the game.
Note: This field excludes blocked field goals'
Safeties:
type:
- number
- 'null'
description: Total defensive safeties scored by the player in the game
FieldGoalsHadBlocked:
type:
- number
- 'null'
description: Total field goals by the player that were blocked in the game
PuntsHadBlocked:
type:
- number
- 'null'
description: Total punts by the player that were blocked in the game
ExtraPointsHadBlocked:
type:
- number
- 'null'
description: Total extra point kick attempts by the player that were blocked
in the game
PuntLong:
type:
- number
- 'null'
description: The longest punt by the player in the game
BlockedKickReturnYards:
type:
- number
- 'null'
description: Total blocked kick recovery return yards for the player in
the game
FieldGoalReturnYards:
type:
- number
- 'null'
description: 'Total field goal return yards by the player in the game. Note:
This field excludes blocked field goals'
PuntNetYards:
type:
- number
- 'null'
description: The net yards of the punts by the player in the game
SpecialTeamsFumblesForced:
type:
- number
- 'null'
description: This field is deprecated
SpecialTeamsFumblesRecovered:
type:
- number
- 'null'
description: This field is deprecated
MiscFumblesForced:
type:
- number
- 'null'
description: This field is deprecated
MiscFumblesRecovered:
type:
- number
- 'null'
description: This field is deprecated
ShortName:
type:
- string
- 'null'
description: The first initial and last name of the player (J. Doe)
PlayingSurface:
type:
- string
- 'null'
description: The playing surface of the stadium
IsGameOver:
type:
- boolean
- 'null'
description: Whether the game is over (true/false)
SafetiesAllowed:
type:
- number
- 'null'
description: This field is deprecated
Stadium:
type:
- string
- 'null'
description: Stadium of the event
Temperature:
type:
- integer
- 'null'
description: Temperature at game start (Fahrenheit)
Humidity:
type:
- integer
- 'null'
description: The humidity percentage at the start of the game
WindSpeed:
type:
- integer
- 'null'
description: The wind speed at the start of the game (in MPH)
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).
OffensiveSnapsPlayed:
type:
- integer
- 'null'
description: 'Total snaps this player played on offense in the game. Note:
Snap counts are available the morning after the game.'
DefensiveSnapsPlayed:
type:
- integer
- 'null'
description: 'Total snaps this player played on defense in the game. Note:
Snap counts are available the morning after the game.'
SpecialTeamsSnapsPlayed:
type:
- integer
- 'null'
description: 'Total snaps this player played on special teams in the game.
Note: Snap counts are available the morning after the game.'
OffensiveTeamSnaps:
type:
- integer
- 'null'
description: 'Total offensive snaps this player''s team played in the game.
Note: Snap counts are available the morning after the game.'
DefensiveTeamSnaps:
type:
- integer
- 'null'
description: 'Total defensive snaps this player''s team played in the game.
Note: Snap counts are available the morning after the game.'
SpecialTeamsTeamSnaps:
type:
- integer
- 'null'
description: 'Total special teams snaps this player''s team played in the
game. Note: Snap counts are available the morning after the game.'
VictivSalary:
type:
- integer
- 'null'
description: The player's salary for Victiv daily fantasy contests.
TwoPointConversionReturns:
type:
- number
- 'null'
description: Total successful two point conversion returns by the player
in the game
FantasyPointsFanDuel:
type:
- number
- 'null'
description: Fantasy points based on FanDuel's scoring system by the player
in the game
FieldGoalsMade0to19:
type:
- number
- 'null'
description: Total field goals of 0 to 19 yards made by the player in game
FieldGoalsMade20to29:
type:
- number
- 'null'
description: Total field goals of 20 to 29 yards made by the player in game
FieldGoalsMade30to39:
type:
- number
- 'null'
description: Total field goals of 30 to 39 yards made by the player in game
FieldGoalsMade40to49:
type:
- number
- 'null'
description: Total field goals of 40 to 49 yards made by the player in game
FieldGoalsMade50Plus:
type:
- number
- 'null'
description: Total field goals of 50+ yards made by the player in game
FantasyPointsDraftKings:
type:
- number
- 'null'
description: Fantasy points based on DraftKings' scoring system by the player
in the game
YahooSalary:
type:
- integer
- 'null'
description: The player's salary for Yahoo daily fantasy contests
FantasyPointsYahoo:
type:
- number
- 'null'
description: Fantasy points based on Yahoo's daily fantasy scoring system
by the player in the game
InjuryStatus:
type:
- string
- 'null'
description: The player's current injury status; in the form of likelihood
that player plays (Probable; Questionable; Doubtful; Out)
InjuryBodyPart:
type:
- string
- 'null'
description: The body part that is injured for the player (Knee; Groin;
Calf; Hamstring; etc.)
InjuryStartDate:
type:
- string
- 'null'
description: The day that the player's injury started or was first discovered
InjuryNotes:
type:
- string
- 'null'
description: A 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.
InjuryPractice:
type:
- string
- 'null'
description: This field is deprecated
InjuryPracticeDescription:
type:
- string
- 'null'
description: This field is deprecated
DeclaredInactive:
type: boolean
description: 'Whether the player has been declared inactive. This value
is updated in the hours leading up to game start time; as teams announce
their inactive players. Note: This is only updated for offensive skill
position players (QB; RB; WR; TE)'
FantasyDraftSalary:
type:
- integer
- 'null'
description: The player's salary for FantasyDraft daily fantasy contests.
FantasyDraftPosition:
type:
- string
- 'null'
description: The player's eligible position in FantasyDraft's daily fantasy
sports platform.
TeamID:
type:
- integer
- 'null'
description: 'The unique ID of the team that the player is on. Note: if
the player is a free agent; this field is NULL'
OpponentID:
type:
- integer
- 'null'
description: The unique ID of this opponent team
Day:
type:
- string
- 'null'
description: The date of the game (in US Eastern Time)
DateTime:
type:
- string
- 'null'
description: The date and time of the game (in US Eastern Time)
GlobalGameID:
type:
- integer
- 'null'
description: A globally unique ID for this game. This value is guaranteed
to be unique across all sports/leagues
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team. This value is guaranteed
to be unique across all sports/leagues
GlobalOpponentID:
type:
- integer
- 'null'
description: A globally unique ID for this opposing team. This value is
guaranteed to be unique across all sports/leagues.
ScoreID:
type: integer
description: Unique ID of the score/game
FantasyPointsFantasyDraft:
type:
- number
- 'null'
description: This field is no longer in use and will return null.
ScoringDetails:
type: array
items:
$ref: '#/components/schemas/ScoringDetail'
description: The details of the scoring plays this player recorded in the
game
OffensiveFumbleRecoveryTouchdowns:
type:
- number
- 'null'
description: This field is deprecated
SnapCountsConfirmed:
type:
- boolean
- 'null'
description: 'Whether snap count fields are confirmed (true/false). Note:
This takes place the morning after the game.'
Updated:
type:
- string
- 'null'
description: 'Time of last update (in US Eastern time). Note: this does
not indicate that stats changed.'
FantasyDefenseGame:
properties:
GameKey:
type:
- string
- 'null'
description: 'A 9 digit unique code identifying the game that this record
corresponds to. The GameID is composed of Season; SeasonType; Week and
HomeTeam. Note: This value will be NULL for bye weeks'
SeasonType:
type: integer
description: The type of season that this player corresponds to (1=Regular
Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star)
Season:
type: integer
description: The NFL season of the game
Week:
type:
- integer
- 'null'
description: 'The NFL week of the game (regular season: 1 to 18; preseason:
0 to 4; postseason: 1 to 4). Note: seasons after 2021 will have only 3
preseason weeks'
Date:
type:
- string
- 'null'
description: The date and time of the game (in US Eastern Time)
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
Opponent:
type:
- string
- 'null'
description: The abbreviation [Key] of the opponent team
PointsAllowed:
type: number
description: Total points allowed by the team during the game
TouchdownsScored:
type: number
description: Total defensive and special teams touchdowns scored by the
team in the game
SoloTackles:
type: number
description: Total defensive solo (unassisted) tackles by the team in the
game
AssistedTackles:
type: number
description: Total defensive assisted tackles by the team in the game
Sacks:
type: number
description: Total defensive sacks by the team in the game
SackYards:
type: number
description: Total defensive sack yards by the team in the game
PassesDefended:
type: number
description: Total passes defended by the team in the game
FumblesForced:
type: number
description: Total fumbles forced on defense by the team in the game
FumblesRecovered:
type: number
description: Total defensive fumble recoveries by the team in the game
FumbleReturnYards:
type: number
description: Total fumble return yards by the team in the game
FumbleReturnTouchdowns:
type: number
description: Total fumble return touchdowns by the team in the game
Interceptions:
type: number
description: Total defensive interceptions by the team in the game
InterceptionReturnYards:
type: number
description: Total defensive interception return yards by the team in the
game
InterceptionReturnTouchdowns:
type: number
description: Total defensive interception return touchdowns by the team
in the game
BlockedKicks:
type: number
description: 'Total blocked kicks by team in the game. Note: BlockedKicks
include Field Goals and Punts but NOT Extra Points'
Safeties:
type: number
description: Total defensive safeties scored by the team in the game
PuntReturns:
type: number
description: Total punt returns by the team in the game
PuntReturnYards:
type: number
description: Total punt return yards by the team in the game
PuntReturnTouchdowns:
type: number
description: Total punt return touchdowns by the team in the game
PuntReturnLong:
type: number
description: The longest punt return by the team in the game
KickReturns:
type: number
description: Total kickoff returns by the team in the game
KickReturnYards:
type: number
description: Total kickoff return yards by the team in the game
KickReturnTouchdowns:
type: number
description: Total kickoff return touchdowns by the team in the game
KickReturnLong:
type: number
description: Longest kick return by the team in the game
BlockedKickReturnTouchdowns:
type:
- number
- 'null'
description: Total blocked kick recovery return touchdowns for the team
in the game
FieldGoalReturnTouchdowns:
type:
- number
- 'null'
description: 'Total field goal return touchdowns by the team in the game.
Note: This field excludes blocked field goals'
FantasyPointsAllowed:
type:
- number
- 'null'
description: 'Fantasy points allowed to opposing offensive players in the
season. Note: positions include: QB; RB; WR; TE'
QuarterbackFantasyPointsAllowed:
type:
- number
- 'null'
description: Fantasy points allowed to opposing quarterbacks by the team
in the game
RunningbackFantasyPointsAllowed:
type:
- number
- 'null'
description: Total fantasy points allowed to opposing running backs by the
team in the game
WideReceiverFantasyPointsAllowed:
type:
- number
- 'null'
description: Fantasy points allowed to opposing wide receivers
TightEndFantasyPointsAllowed:
type:
- number
- 'null'
description: Fantasy points allowed to opposing tight ends by the team in
the game
KickerFantasyPointsAllowed:
type:
- number
- 'null'
description: Fantasy points allowed to opponent kickers by the team in the
game
BlockedKickReturnYards:
type:
- number
- 'null'
description: Total blocked kick recovery return yards for the team in the
game
FieldGoalReturnYards:
type:
- number
- 'null'
description: 'Total field goal return yards by the team in the game. Note:
This field excludes blocked field goals'
QuarterbackHits:
type:
- number
- 'null'
description: 'Total quarterback hits by the team in the game. Note: This
is a defensive stat that includes sacks'
TacklesForLoss:
type:
- number
- 'null'
description: 'Total tackles for loss by the team in the game. Note: These
are tackles behind the line of scrimmage for loss of yards (including
sacks)'
DefensiveTouchdowns:
type:
- number
- 'null'
description: Total touchdowns scored by the defense
SpecialTeamsTouchdowns:
type:
- number
- 'null'
description: Total special teams touchdowns scored by the team in the game
IsGameOver:
type:
- boolean
- 'null'
description: Whether the game is over (true/false)
FantasyPoints:
type:
- number
- 'null'
description: Fantasy points scored based on basic fantasy scoring system
by the team's D/ST in the game
Stadium:
type:
- string
- 'null'
description: Stadium of the event
Temperature:
type:
- integer
- 'null'
description: Temperature at game start (Fahrenheit)
Humidity:
type:
- integer
- 'null'
description: The humidity percentage at the start of the game
WindSpeed:
type:
- integer
- 'null'
description: The wind speed at the start of the game (in MPH)
ThirdDownAttempts:
type:
- number
- 'null'
description: Total third down attempts against the team in the game
ThirdDownConversions:
type:
- number
- 'null'
description: Total third down conversions against the team in the game
FourthDownAttempts:
type:
- number
- 'null'
description: Opponent's fourth down attempts against the team in the game
FourthDownConversions:
type:
- number
- 'null'
description: Opponent's fourth down conversions against the team in the
game
PointsAllowedByDefenseSpecialTeams:
type:
- number
- 'null'
description: 'Total number of points allowed by the team in the game to
the opposing offense and special teams. Note: This field excludes points
scored by the opponent''s defense'
FanDuelSalary:
type:
- integer
- 'null'
description: The team's D/ST salary for FanDuel daily fantasy contests
DraftKingsSalary:
type:
- integer
- 'null'
description: The team's D/ST salary for DraftKings daily fantasy contests.
FantasyDataSalary:
type:
- integer
- 'null'
description: The team's D/ST salary as calculated by SportsDataIO (formerly
known as FantasyData). Based on the same salary cap as DraftKings contests
($50,000)
VictivSalary:
type:
- integer
- 'null'
description: The player's salary for Victiv daily fantasy contests.
TwoPointConversionReturns:
type:
- number
- 'null'
description: Total successful two point conversion returns by the team in
the game
FantasyPointsFanDuel:
type:
- number
- 'null'
description: Fantasy points based on FanDuel's scoring system by the team
in the game
FantasyPointsDraftKings:
type:
- number
- 'null'
description: Fantasy points based on DraftKings' scoring system by the team
in the game
OffensiveYardsAllowed:
type:
- number
- 'null'
description: Offensive yards allowed by the team's defense in the game
YahooSalary:
type:
- integer
- 'null'
description: The player's salary for Yahoo daily fantasy contests
PlayerID:
type:
- integer
- 'null'
description: 'The unique PlayerID of the player as assigned by SportsDataIO
for use when combining with player feeds. Note: this ID will stay with
the player throughout their entire career'
FantasyPointsYahoo:
type:
- number
- 'null'
description: Fantasy points based on Yahoo's daily fantasy scoring system
by the team in the game
HomeOrAway:
type:
- string
- 'null'
description: Whether the team is home or away
OpponentRank:
type:
- integer
- 'null'
description: The ranking of the opposing team's offense with regards to
fantasy points allowed to fantasy DST
OpponentPositionRank:
type:
- integer
- 'null'
description: The ranking of the opposing team's offense with regards to
fantasy points allowed to fantasy DST
FantasyDraftSalary:
type:
- integer
- 'null'
description: The team's D/ST salary for FantasyDraft daily fantasy contests.
TeamID:
type:
- integer
- 'null'
description: The unique ID of the team
OpponentID:
type:
- integer
- 'null'
description: The unique ID of this opponent team
Day:
type:
- string
- 'null'
description: The date of the game (in US Eastern Time)
DateTime:
type:
- string
- 'null'
description: The date and time of the game (in US Eastern Time)
GlobalGameID:
type:
- integer
- 'null'
description: A globally unique ID for this game. This value is guaranteed
to be unique across all sports/leagues
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team. This value is guaranteed
to be unique across all sports/leagues
GlobalOpponentID:
type:
- integer
- 'null'
description: A globally unique ID for this team's opponent. This value is
guaranteed to be unique across all sports/leagues
DraftKingsPosition:
type:
- string
- 'null'
description: The position of this team's D/ST; as listed by DraftKings.
FanDuelPosition:
type:
- string
- 'null'
description: The position of this team's D/ST; as listed by FanDuel.
FantasyDraftPosition:
type:
- string
- 'null'
description: The position of this team's D/ST; as listed by FantasyDraft
YahooPosition:
type:
- string
- 'null'
description: The position of the team's defense/special teams unit, as listed
on Yahoo's daily fantasy sports platform
FantasyDefenseID:
type:
- integer
- 'null'
description: '"Unique ID of FantasyDefense record (subject to change; although
it very rarely does). Note: For a guaranteed static ID; use a combination
of GameKey and Team"'
ScoreID:
type: integer
description: Unique ID of the score/game
FanDuelFantasyPointsAllowed:
type:
- number
- 'null'
description: 'FanDuel fantasy points allowed to opposing offensive players
in the game. Note: positions include: QB; RB; WR; TE'
FanDuelQuarterbackFantasyPointsAllowed:
type:
- number
- 'null'
description: FanDuel fantasy points allowed by the team to opposing quarterbacks
in the game
FanDuelRunningbackFantasyPointsAllowed:
type:
- number
- 'null'
description: FanDuel fantasy points allowed by the team to opposing running
backs in the game
FanDuelWideReceiverFantasyPointsAllowed:
type:
- number
- 'null'
description: FanDuel fantasy points allowed by the team to opposing wide
receivers in the game
FanDuelTightEndFantasyPointsAllowed:
type:
- number
- 'null'
description: FanDuel fantasy points allowed by the team to opposing tight
ends in the game
FanDuelKickerFantasyPointsAllowed:
type:
- number
- 'null'
description: FanDuel fantasy points allowed by the team to opposing kickers
in the game
DraftKingsFantasyPointsAllowed:
type:
- number
- 'null'
description: 'DraftKings fantasy points allowed to opposing offensive players
in the game. Note: positions include: QB; RB; WR; TE'
DraftKingsQuarterbackFantasyPointsAllowed:
type:
- number
- 'null'
description: DraftKings fantasy points allowed by the team to opponent quarterbacks
in the game
DraftKingsRunningbackFantasyPointsAllowed:
type:
- number
- 'null'
description: DraftKings fantasy points allowed by the team to opponent running
backs in the game
DraftKingsWideReceiverFantasyPointsAllowed:
type:
- number
- 'null'
description: DraftKings fantasy points allowed by the team to opponent wide
receivers in the game
DraftKingsTightEndFantasyPointsAllowed:
type:
- number
- 'null'
description: DraftKings fantasy points allowed by the team to opponent tight
ends in the game
DraftKingsKickerFantasyPointsAllowed:
type:
- number
- 'null'
description: DraftKings fantasy points allowed to opposing kickers
YahooFantasyPointsAllowed:
type:
- number
- 'null'
description: 'Total Yahoo fantasy points allowed to opposing offensive players
by the team in the game. Note: Offensive players include: QB, RB, WR,
& TE'
YahooQuarterbackFantasyPointsAllowed:
type:
- number
- 'null'
description: Total Yahoo fantasy points allowed to opposing quarterbacks
by the team in the game
YahooRunningbackFantasyPointsAllowed:
type:
- number
- 'null'
description: Total Yahoo fantasy points allowed to opposing running backs
by the team in the game
YahooWideReceiverFantasyPointsAllowed:
type:
- number
- 'null'
description: Total Yahoo fantasy points allowed to opposing wide receivers
by the team in the game
YahooTightEndFantasyPointsAllowed:
type:
- number
- 'null'
description: Total Yahoo fantasy points allowed to opposing tight ends by
the team in the game
YahooKickerFantasyPointsAllowed:
type:
- number
- 'null'
description: Total Yahoo fantasy points allowed to opposing kickers by the
team in the game
FantasyPointsFantasyDraft:
type:
- number
- 'null'
description: Fantasy points based on FantasyDraft's scoring system by the
team in the game
FantasyDraftFantasyPointsAllowed:
type:
- number
- 'null'
description: 'FantasyDraft fantasy points allowed to opposing offensive
players in the game. Note: positions include: QB; RB; WR; TE'
FantasyDraftQuarterbackFantasyPointsAllowed:
type:
- number
- 'null'
description: FantasyDraft fantasy points allowed by the team to opposing
quarterbacks in the game
FantasyDraftRunningbackFantasyPointsAllowed:
type:
- number
- 'null'
description: FantasyDraft fantasy points allowed by the team to opposing
running backs in the game
FantasyDraftWideReceiverFantasyPointsAllowed:
type:
- number
- 'null'
description: FantasyDraft fantasy points allowed by the team to opposing
wide receivers in the game
FantasyDraftTightEndFantasyPointsAllowed:
type:
- number
- 'null'
description: FantasyDraft fantasy points allowed by the team to opposing
tight ends in the game
FantasyDraftKickerFantasyPointsAllowed:
type:
- number
- 'null'
description: FantasyDraft fantasy points allowed by the team to opposing
kickers in the game
ScoringDetails:
type: array
items:
$ref: '#/components/schemas/ScoringDetail'
description: The details of the scoring plays this team DST recorded in
the game
FantasyDefenseSeason:
properties:
SeasonType:
type: integer
description: The type of season that this team corresponds to (1=Regular
Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star)
Season:
type: integer
description: The NFL regular season for which these totals apply
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
PointsAllowed:
type: number
description: Total points allowed by the team during the season
TouchdownsScored:
type: number
description: Total defensive and special teams touchdowns scored by the
team in the season
SoloTackles:
type: number
description: Total defensive solo (unassisted) tackles by the team in the
season
AssistedTackles:
type: number
description: Total defensive assisted tackles by the team in the season
Sacks:
type: number
description: Total defensive sacks by the team in the season
SackYards:
type: number
description: Total defensive sack yards by the team in the season
PassesDefended:
type: number
description: Total passes defended by the team in the season
FumblesForced:
type: number
description: Total fumbles forced on defense by the team in the season
FumblesRecovered:
type: number
description: Total defensive fumble recoveries by the team in the season
FumbleReturnYards:
type: number
description: Total fumble return yards by the team in the season
FumbleReturnTouchdowns:
type: number
description: Total fumble return touchdowns by the team in the season
Interceptions:
type: number
description: Total defensive interceptions by the team in the season
InterceptionReturnYards:
type: number
description: Total defensive interception return yards by the team in the
season
InterceptionReturnTouchdowns:
type: number
description: Total defensive interception return touchdowns by the team
in the season
BlockedKicks:
type: number
description: 'Total blocked kicks by the team in the season. Note: BlockedKicks
include Field Goals and Punts but NOT Extra Points'
Safeties:
type: number
description: Total defensive safeties scored by the team in the season
PuntReturns:
type: number
description: Total punt returns by the team in the season
PuntReturnYards:
type: number
description: Total punt return yards by the team in the season
PuntReturnTouchdowns:
type: number
description: Total punt return touchdowns by the team in the season
PuntReturnLong:
type: number
description: The longest punt return by the team in the season
KickReturns:
type: number
description: Total kickoff returns by the team in the season
KickReturnYards:
type: number
description: Total kickoff return yards by the team in the season
KickReturnTouchdowns:
type: number
description: Total kickoff return touchdowns by the team in the season
KickReturnLong:
type: number
description: Longest kick return by the team in the season
BlockedKickReturnTouchdowns:
type:
- number
- 'null'
description: Total blocked kick recovery return touchdowns for the team
in the season
FieldGoalReturnTouchdowns:
type:
- number
- 'null'
description: 'Total field goal return touchdowns by the team in the season.
Note: This field excludes blocked field goals'
FantasyPointsAllowed:
type:
- number
- 'null'
description: 'Fantasy points allowed to opposing offensive players in the
season. Note: positions include: QB; RB; WR; TE'
QuarterbackFantasyPointsAllowed:
type:
- number
- 'null'
description: Fantasy points allowed to opposing quarterbacks by the team
in the season
RunningbackFantasyPointsAllowed:
type:
- number
- 'null'
description: Total fantasy points allowed to opposing running backs by the
team in the season
WideReceiverFantasyPointsAllowed:
type:
- number
- 'null'
description: Fantasy points allowed to opposing wide receivers
TightEndFantasyPointsAllowed:
type:
- number
- 'null'
description: Fantasy points allowed to opposing tight ends by the team in
the season
KickerFantasyPointsAllowed:
type:
- number
- 'null'
description: Fantasy points allowed to opponent kickers by the team in the
season
Games:
type:
- integer
- 'null'
description: The total number of games played by the team in the season
BlockedKickReturnYards:
type:
- number
- 'null'
description: Total blocked kick recovery return yards for the team in the
season
FieldGoalReturnYards:
type:
- number
- 'null'
description: 'Total field goal return yards by the team in the season. Note:
This field excludes blocked field goals'
QuarterbackHits:
type:
- number
- 'null'
description: 'Total quarterback hits by the team in the season. Note: This
is a defensive stat that includes sacks'
TacklesForLoss:
type:
- number
- 'null'
description: 'Total tackles for loss by the team in the season. Note: these
are tackles behind the line of scrimmage for loss of yards (including
sacks)'
DefensiveTouchdowns:
type:
- number
- 'null'
description: Total defensive touchdowns scored by the team in the season
SpecialTeamsTouchdowns:
type:
- number
- 'null'
description: Total special teams touchdowns scored by the team in the season
FantasyPoints:
type:
- number
- 'null'
description: Fantasy points scored based on basic fantasy scoring system
by the team in the season
Temperature:
type:
- integer
- 'null'
description: Temperature at game start (Fahrenheit)
Humidity:
type:
- integer
- 'null'
description: The humidity percentage at the start of the game
WindSpeed:
type:
- integer
- 'null'
description: The wind speed at the start of the game (in MPH)
ThirdDownAttempts:
type:
- number
- 'null'
description: Total third down attempts against the team in the season
ThirdDownConversions:
type:
- number
- 'null'
description: Total third down conversions against the team in the season
FourthDownAttempts:
type:
- number
- 'null'
description: Opponent's fourth down attempts against the team in the season
FourthDownConversions:
type:
- number
- 'null'
description: Opponent's fourth down conversions against the team in the
season
PointsAllowedByDefenseSpecialTeams:
type:
- number
- 'null'
description: 'Total number of points allowed by the team in the season to
the opposing offense and special teams. Note: This field excludes points
scored by the opponent''s defense'
AuctionValue:
type:
- number
- 'null'
description: Player's dollar value in a $200 salary cap auction draft.
AuctionValuePPR:
type:
- number
- 'null'
description: Player's dollar value in a $200 salary cap PPR auction draft.
TwoPointConversionReturns:
type:
- number
- 'null'
description: Total successful two point conversion returns by the team in
the season
FantasyPointsFanDuel:
type:
- number
- 'null'
description: Fantasy points based on FanDuel's scoring system by the team
in the season
FantasyPointsDraftKings:
type:
- number
- 'null'
description: Fantasy points based on DraftKings' scoring system by the team
in the season
OffensiveYardsAllowed:
type:
- number
- 'null'
description: Offensive yards allowed by the team's defense in the season
PlayerID:
type:
- integer
- 'null'
description: 'The unique PlayerID of the player as assigned by SportsDataIO
for use when combining with player feeds. Note: this ID will stay with
the player throughout their entire career'
FantasyPointsYahoo:
type:
- number
- 'null'
description: Fantasy points based on Yahoo's daily fantasy scoring system
by the team in the season
AverageDraftPosition:
type:
- number
- 'null'
description: The average draft position of the team's fantasy defense (DST)
in re-draft leagues
AverageDraftPositionPPR:
type:
- number
- 'null'
description: The average draft position of the team (DST) in Points Per
Reception (PPR) leagues
TeamID:
type:
- integer
- 'null'
description: The unique ID of the team
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team. This value is guaranteed
to be unique across all sports/leagues
FanDuelFantasyPointsAllowed:
type:
- number
- 'null'
description: 'FanDuel fantasy points allowed to opposing offensive players
in the season. Note: positions include: QB; RB; WR; TE'
FanDuelQuarterbackFantasyPointsAllowed:
type:
- number
- 'null'
description: FanDuel fantasy points allowed by the team to opposing quarterbacks
in the season
FanDuelRunningbackFantasyPointsAllowed:
type:
- number
- 'null'
description: FanDuel fantasy points allowed by the team to opposing running
backs in the season
FanDuelWideReceiverFantasyPointsAllowed:
type:
- number
- 'null'
description: FanDuel fantasy points allowed by the team to opposing wide
receivers in the season
FanDuelTightEndFantasyPointsAllowed:
type:
- number
- 'null'
description: FanDuel fantasy points allowed by the team to opposing tight
ends in the season
FanDuelKickerFantasyPointsAllowed:
type:
- number
- 'null'
description: FanDuel fantasy points allowed by the team to opposing kickers
in the season
DraftKingsFantasyPointsAllowed:
type:
- number
- 'null'
description: 'DraftKings fantasy points allowed to opposing offensive players
in the season. Note: positions include: QB; RB; WR; TE'
DraftKingsQuarterbackFantasyPointsAllowed:
type:
- number
- 'null'
description: DraftKings fantasy points allowed by the team to opponent quarterbacks
in the season
DraftKingsRunningbackFantasyPointsAllowed:
type:
- number
- 'null'
description: DraftKings fantasy points allowed by the team to opponent running
backs in the season
DraftKingsWideReceiverFantasyPointsAllowed:
type:
- number
- 'null'
description: DraftKings fantasy points allowed by the team to opponent wide
receivers in the season
DraftKingsTightEndFantasyPointsAllowed:
type:
- number
- 'null'
description: DraftKings fantasy points allowed by the team to opponent tight
ends in the season
DraftKingsKickerFantasyPointsAllowed:
type:
- number
- 'null'
description: DraftKings fantasy points allowed by the team to opponent kickers
in the season
YahooFantasyPointsAllowed:
type:
- number
- 'null'
description: 'Total Yahoo fantasy points allowed to opposing offensive players
by the team in the season. Note: Offensive players include: QB, RB, WR,
& TE'
YahooQuarterbackFantasyPointsAllowed:
type:
- number
- 'null'
description: Total Yahoo fantasy points allowed to opposing quarterbacks
by the team in the season
YahooRunningbackFantasyPointsAllowed:
type:
- number
- 'null'
description: Total Yahoo fantasy points allowed to opposing running backs
by the team in the season
YahooWideReceiverFantasyPointsAllowed:
type:
- number
- 'null'
description: Total Yahoo fantasy points allowed to opposing wide receivers
by the team in the season
YahooTightEndFantasyPointsAllowed:
type:
- number
- 'null'
description: Total Yahoo fantasy points allowed to opposing tight ends by
the team in the season
YahooKickerFantasyPointsAllowed:
type:
- number
- 'null'
description: Total Yahoo fantasy points allowed to opposing kickers by the
team in the season
FantasyPointsFantasyDraft:
type:
- number
- 'null'
description: Fantasy points based on FanDraft's scoring system by the team
in the season
FantasyDraftFantasyPointsAllowed:
type:
- number
- 'null'
description: 'FantasyDraft fantasy points allowed to opposing offensive
players in the season. Note: positions include: QB; RB; WR; TE'
FantasyDraftQuarterbackFantasyPointsAllowed:
type:
- number
- 'null'
description: FantasyDraft fantasy points allowed by the team to opposing
quarterbacks in the season
FantasyDraftRunningbackFantasyPointsAllowed:
type:
- number
- 'null'
description: FantasyDraft fantasy points allowed by the team to opposing
running backs in the season
FantasyDraftWideReceiverFantasyPointsAllowed:
type:
- number
- 'null'
description: FantasyDraft fantasy points allowed by the team to opposing
wide receivers in the season
FantasyDraftTightEndFantasyPointsAllowed:
type:
- number
- 'null'
description: FantasyDraft fantasy points allowed by the team to opposing
tight ends in the season
FantasyDraftKickerFantasyPointsAllowed:
type:
- number
- 'null'
description: FantasyDraft fantasy points allowed by the team to opposing
kickers in the season
ScoringDetails:
type: array
items:
$ref: '#/components/schemas/ScoringDetail'
description: The details of the scoring plays this team DST recorded in
the season
AverageDraftPositionDynasty:
type:
- number
- 'null'
description: The average draft position of this team (DST) in dynasty drafts
leagues
AverageDraftPosition2QB:
type:
- number
- 'null'
description: The average draft position of the team (DST) in 2 Quarterback
leagues
Injury:
properties:
InjuryID:
type: integer
description: The unique ID of the injury record for the player
SeasonType:
type: integer
description: The type of season that this player corresponds to (1=Regular
Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star)
Season:
type: integer
description: The season of the game that this injury leads up to
Week:
type: integer
description: 'The NFL week of the game that this injury leads up to (regular
season: 1 to 18; preseason: 0 to 4; postseason: 1 to 4). Note: seasons
prior to 2021 will have 3 preseason weeks.'
PlayerID:
type: integer
description: 'The unique PlayerID of the player as assigned by SportsDataIO.
Note: this ID will stay with the player throughout their entire career.'
Name:
type:
- string
- 'null'
description: Player's full name
Position:
type:
- string
- 'null'
description: 'The primary position of the player. Possible Values: C; CB;
DB; DE; DL; DT; FB; FS; G; ILB; K; KR; LB; LS; NT; OL; OLB; OT; P; QB;
RB; S; SS; T; TE; WR.'
Number:
type: integer
description: Player's jersey number
Team:
type:
- string
- 'null'
description: 'The abbreviation [Key] of the team that the player is on.
Note: If this player is a free agent; this field is NULL.'
Opponent:
type:
- string
- 'null'
description: The abbreviation [Key] of the opponent team of the injured
player
BodyPart:
type:
- string
- 'null'
description: The body part that is injured (Knee; Groin; Calf; Hamstring;
etc.)
Status:
type:
- string
- 'null'
description: The injury designation assigned to the player (Probable; Questionable;
Doubtful; Out)
Practice:
type:
- string
- 'null'
description: This field is deprecated
PracticeDescription:
type:
- string
- 'null'
description: This field is deprecated
Updated:
type:
- string
- 'null'
description: The date/time the injury status was updated (in US Eastern
time)
DeclaredInactive:
type:
- boolean
- 'null'
description: 'Whether the player has been declared inactive. This value
is updated in the hours leading up to game start time; as teams announce
their inactive players. Note: This is only updated for offensive skill
position players (QB; RB; WR; TE).'
TeamID:
type:
- integer
- 'null'
description: 'The unique ID of the team that the player is on. Note: If
the player is a free agent; this field is NULL.'
OpponentID:
type:
- integer
- 'null'
description: The unique ID of the opponent this player played on during
this game
PlayerSeasonRedZone:
properties:
PlayerID:
type:
- integer
- 'null'
description: 'The unique PlayerID of the player as assigned by SportsDataIO.
Note: this ID will stay with the player throughout their entire career'
SeasonType:
type: integer
description: The type of season that this player corresponds to (1=Regular
Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star)
Season:
type: integer
description: The NFL season for which these totals apply
Team:
type:
- string
- 'null'
description: 'The abbreviation [Key] of the team that the player is on.
Note: If this player is a free agent; this field is NULL'
Number:
type: integer
description: Player's jersey number
Name:
type:
- string
- 'null'
description: Player's full name
Position:
type:
- string
- 'null'
description: 'The primary position of the player. Possible Values: C; CB;
DB; DE; DL; DT; FB; FS; G; ILB; K; KR; LB; LS; NT; OL; OLB; OT; P; QB;
RB; S; SS; T; TE; WR'
PositionCategory:
type:
- string
- 'null'
description: The category of the player's position (OFF; DEF; ST)
Activated:
type: integer
description: The total number of games that the player was active for in
the season
Played:
type: integer
description: The total number of games played by the the player in the season
Started:
type: integer
description: Total games started (on offense or defense) by the player in
the season
PassingAttempts:
type: number
description: Total passes thrown by the player in the season
PassingCompletions:
type: number
description: Total passes completed by the player in the season
PassingYards:
type: number
description: Total passing yards by the player in the season
PassingCompletionPercentage:
type: number
description: The percentage of passes completed by the player in the season
PassingYardsPerAttempt:
type: number
description: Total average passing yards per attempt by the player in the
season
PassingYardsPerCompletion:
type: number
description: Total average passing yards per completion by the player in
the season
PassingTouchdowns:
type: number
description: Total passing touchdowns by the player in the season
PassingInterceptions:
type: number
description: Total interceptions thrown by the player in the season
PassingRating:
type: number
description: The passer rating of the player in the season
PassingLong:
type: number
description: Total yards of longest completion by the player in the season
PassingSacks:
type: number
description: The total number of times the player was sacked in the season
PassingSackYards:
type: number
description: Total yards lost by the player in the season as a result of
being sacked
RushingAttempts:
type: number
description: Total rushing attempts by the player in the season
RushingYards:
type: number
description: Total rushing yards by the player in the season
RushingYardsPerAttempt:
type: number
description: Total rushing yards per attempt by the player in the season
RushingTouchdowns:
type: number
description: Total rushing touchdowns by the player in the season
RushingLong:
type: number
description: The longest rush by the player in the season
ReceivingTargets:
type:
- number
- 'null'
description: Total receiving targets by the player in the season
Receptions:
type: number
description: Total receptions by the player in the season
ReceivingYards:
type: number
description: Total receiving yards by the player in the season
ReceivingYardsPerReception:
type: number
description: Average receiving yards per reception by the player in the
season
ReceivingTouchdowns:
type: number
description: Total receiving touchdowns by the player in the season
ReceivingLong:
type: number
description: The longest reception by the player in the season
Fumbles:
type: number
description: Total fumbles by the player in the season
FumblesLost:
type:
- number
- 'null'
description: Total fumbles lost by the player in the season
PuntReturns:
type: number
description: Total punt returns by the player in the season
PuntReturnYards:
type: number
description: Total punt return yards by the player in the season
PuntReturnYardsPerAttempt:
type: number
description: Total average yards gained per punt return by the player in
the season
PuntReturnTouchdowns:
type: number
description: Total punt return touchdowns by the player in the season
PuntReturnLong:
type: number
description: The longest punt return by the player in the season
KickReturns:
type: number
description: Total kickoff returns by the player in the season
KickReturnYards:
type: number
description: Total kickoff return yards by the player in the season
KickReturnYardsPerAttempt:
type: number
description: Average yards gained per kick return by the player in the season
KickReturnTouchdowns:
type: number
description: Total kickoff return touchdowns by the player in the season
KickReturnLong:
type: number
description: Longest kick return by the player in the season
SoloTackles:
type: number
description: Total defensive solo (unassisted) tackles by the player in
the season
AssistedTackles:
type: number
description: Total defensive assisted tackles by the player in the season
TacklesForLoss:
type:
- number
- 'null'
description: 'Total tackles for loss by the player in the season. Note:
these are tackles behind the line of scrimmage for loss of yards (including
sacks)'
Sacks:
type: number
description: Total defensive sacks by the player in the season
SackYards:
type: number
description: Total defensive safeties scored by the player in the season
QuarterbackHits:
type:
- number
- 'null'
description: 'Total quarterback hits by the player in the season. Note:
This is a defensive stat that includes sacks'
PassesDefended:
type: number
description: Total passes defended by the player in the season
FumblesForced:
type: number
description: Total fumbles forced on defense by the player in the season
FumblesRecovered:
type: number
description: Total defensive fumble recoveries by the player in the season
FumbleReturnYards:
type: number
description: Total fumble return yards by the player in the season
FumbleReturnTouchdowns:
type: number
description: Total fumble return touchdowns by the player in the season
Interceptions:
type: number
description: Total defensive interceptions by the player in the season
InterceptionReturnYards:
type: number
description: Total defensive interception return yards by the player in
the season
InterceptionReturnTouchdowns:
type: number
description: Total defensive interception return touchdowns by the player
in the season
BlockedKicks:
type: number
description: 'Total blocked kicks by the player in the season. Note: BlockedKicks
include Field Goals and Punts but NOT Extra Points'
SpecialTeamsSoloTackles:
type: number
description: This field is deprecated
SpecialTeamsAssistedTackles:
type: number
description: This field is deprecated
MiscSoloTackles:
type: number
description: This field is deprecated
MiscAssistedTackles:
type: number
description: This field is deprecated
Punts:
type: number
description: Total number of punts by the player in the season
PuntYards:
type: number
description: Total punt yards by the player in the season
PuntAverage:
type: number
description: The average number of yards per punt by the player in the season
FieldGoalsAttempted:
type: number
description: Total field goals attempted by the player in the season
FieldGoalsMade:
type: number
description: Total field goals made by the player in season
FieldGoalsLongestMade:
type: number
description: Longest field goal made by the player in the season
ExtraPointsMade:
type: number
description: Total extra points made by the player in the season
TwoPointConversionPasses:
type: number
description: Total successful two point conversion passes by the player
in the season
TwoPointConversionRuns:
type: number
description: Total successful two point conversion rushes by the player
in the season
TwoPointConversionReceptions:
type: number
description: Total successful two point conversion receptions by the player
in the season
FantasyPoints:
type: number
description: Fantasy points scored based on basic fantasy scoring system
by the player in the season
FantasyPointsPPR:
type: number
description: Fantasy points scored based on basic PPR fantasy scoring system
by the player in the season
ReceptionPercentage:
type: number
description: Total percentage of receiving targets that were receptions
by the player in the season
ReceivingYardsPerTarget:
type: number
description: Average receiving yards per target by the player in the season
Tackles:
type: number
description: Total tackles (solo & assisted) by the player in the season
OffensiveTouchdowns:
type: number
description: Total offensive touchdowns scored by the player in the season
DefensiveTouchdowns:
type: number
description: Total defensive touchdowns scored by the player in the season
SpecialTeamsTouchdowns:
type: number
description: Total special teams touchdowns scored by the player in the
season
Touchdowns:
type: number
description: Total touchdowns scored by the player in the season
FantasyPosition:
type:
- string
- 'null'
description: 'The player''s fantasy football position. Possible values:
QB, RB, WR, TE, DL, LB, DB, K, P, OL'
FieldGoalPercentage:
type: number
description: Total field goal attempts made by the player in the season
PlayerSeasonID:
type: integer
description: Unique ID of PlayerSeason record (subject to change, although
it very rarely does). For a static ID, use a combination of SeasonType,
Season and PlayerID.
FumblesOwnRecoveries:
type:
- number
- 'null'
description: 'Total own fumble recoveries by the player in the season. Note:
this fumble doesn''t result in a turnover - the fumbling team recovers
the fumble'
FumblesOutOfBounds:
type:
- number
- 'null'
description: This field is deprecated
KickReturnFairCatches:
type:
- number
- 'null'
description: This field is deprecated
PuntReturnFairCatches:
type:
- number
- 'null'
description: This field is deprecated.
PuntTouchbacks:
type:
- number
- 'null'
description: Total punts that resulted in touchbacks by the player in the
season
PuntInside20:
type:
- number
- 'null'
description: Total punts downed inside the 20 yard line by the player in
the season
PuntNetAverage:
type:
- number
- 'null'
description: The average net yards per punt by the player in the season
ExtraPointsAttempted:
type:
- number
- 'null'
description: Total extra point kicks attempted by the player in the season
BlockedKickReturnTouchdowns:
type:
- number
- 'null'
description: Total blocked kick recovery return touchdowns for the player
in the season
FieldGoalReturnTouchdowns:
type:
- number
- 'null'
description: 'Total field goal return touchdowns by the player in the season.
Note: This field excludes blocked field goals'
Safeties:
type:
- number
- 'null'
description: Defensive safeties (sacks in end zone, solo tackles in end
zone, blocked kicks that went out of bounds in the end zone)
FieldGoalsHadBlocked:
type:
- number
- 'null'
description: Total field goals by the player that were blocked in the season
PuntsHadBlocked:
type:
- number
- 'null'
description: Total punts by the player that were blocked in the season
ExtraPointsHadBlocked:
type:
- number
- 'null'
description: Total extra point kick attempts by the player that were blocked
in the season
PuntLong:
type:
- number
- 'null'
description: The longest punt by the player in the season
BlockedKickReturnYards:
type:
- number
- 'null'
description: Total blocked kick recovery return yards for the player in
the season
FieldGoalReturnYards:
type:
- number
- 'null'
description: 'Total field goal return yards by the player in the season.
Note: This field excludes blocked field goals'
PuntNetYards:
type:
- number
- 'null'
description: The net yards of the punts by the player in the season
SpecialTeamsFumblesForced:
type:
- number
- 'null'
description: This field is deprecated
SpecialTeamsFumblesRecovered:
type:
- number
- 'null'
description: This field is deprecated
MiscFumblesForced:
type:
- number
- 'null'
description: This field is deprecated
MiscFumblesRecovered:
type:
- number
- 'null'
description: This field is deprecated
ShortName:
type:
- string
- 'null'
description: The first initial and last name of the player (J. Doe)
SafetiesAllowed:
type:
- number
- 'null'
description: This field is deprecated
Temperature:
type:
- integer
- 'null'
description: Temperature at game start (Fahrenheit)
Humidity:
type:
- integer
- 'null'
description: The humidity percentage at the start of the game
WindSpeed:
type:
- integer
- 'null'
description: The wind speed at the start of the game (in MPH)
OffensiveSnapsPlayed:
type:
- integer
- 'null'
description: 'Total snaps this player played on offensive in the season.
Note: Snap counts are available the morning after the game.'
DefensiveSnapsPlayed:
type:
- integer
- 'null'
description: 'Total snaps this player played on defense in the season. Note:
Snap counts are available the morning after the game.'
SpecialTeamsSnapsPlayed:
type:
- integer
- 'null'
description: 'Total snaps this player played on special teams in the season.
Note: Snap counts are available the morning after the game.'
OffensiveTeamSnaps:
type:
- integer
- 'null'
description: 'Total offensive snaps this player''s team played in the season.
Note: Snap counts are available the morning after the game.'
DefensiveTeamSnaps:
type:
- integer
- 'null'
description: 'Total defensive snaps this player''s team played in the season.
Note: Snap counts are available the morning after the game.'
SpecialTeamsTeamSnaps:
type:
- integer
- 'null'
description: 'Total special teams snaps this player''s team played in the
season. Note: Snap counts are available the morning after the game.'
AuctionValue:
type:
- number
- 'null'
description: Player's dollar value in a $200 salary cap auction draft.
AuctionValuePPR:
type:
- number
- 'null'
description: Player's dollar value in a $200 salary cap PPR auction draft.
TwoPointConversionReturns:
type:
- number
- 'null'
description: Total successful two point conversion returns by the player
in the season
FantasyPointsFanDuel:
type:
- number
- 'null'
description: Fantasy points based on FanDuel's scoring system by the player
in the season
FieldGoalsMade0to19:
type:
- number
- 'null'
description: Total field goals of 0 to 19 yards made by the player in season
FieldGoalsMade20to29:
type:
- number
- 'null'
description: Total field goals of 20 to 29 yards made by the player in season
FieldGoalsMade30to39:
type:
- number
- 'null'
description: Total field goals of 30 to 39 yards made by the player in season
FieldGoalsMade40to49:
type:
- number
- 'null'
description: Total field goals of 40 to 49 yards made by the player in season
FieldGoalsMade50Plus:
type:
- number
- 'null'
description: Total field goals of 50+ yards made by the player in season
FantasyPointsDraftKings:
type:
- number
- 'null'
description: Fantasy points based on DraftKings' scoring system by the player
in the season
FantasyPointsYahoo:
type:
- number
- 'null'
description: Fantasy points based on Yahoo's daily fantasy scoring system
by the player in the season
AverageDraftPosition:
type:
- number
- 'null'
description: The average draft position of the player in re-draft leagues
AverageDraftPositionPPR:
type:
- number
- 'null'
description: The average draft position of this player in Points Per Reception
(PPR) leagues.
TeamID:
type:
- integer
- 'null'
description: 'The unique ID of the team that the player is on. Note: If
the player is a free agent; this field is NULL'
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team. This value is guaranteed
to be unique across all sports/leagues
FantasyPointsFantasyDraft:
type:
- number
- 'null'
description: Fantasy points based on FantasyDraft's scoring system by the
player in the season
ScoringDetails:
type: array
items:
$ref: '#/components/schemas/ScoringDetail'
description: The details of the scoring plays this player recorded in the
season
AverageDraftPositionRookie:
type:
- number
- 'null'
description: The average draft position of this rookie in Points Per Reception
(PPR) leagues.
AverageDraftPositionDynasty:
type:
- number
- 'null'
description: The average draft position of this player in dynasty drafts
leagues
AverageDraftPosition2QB:
type:
- number
- 'null'
description: The average draft position of this player in 2 Quarterback
leagues
OffensiveFumbleRecoveryTouchdowns:
type:
- integer
- 'null'
description: This field is deprecated
PlayerSeasonThirdDown:
properties:
PlayerID:
type:
- integer
- 'null'
description: 'The unique PlayerID of the player as assigned by SportsDataIO.
Note: this ID will stay with the player throughout their entire career'
SeasonType:
type: integer
description: The type of season that this player corresponds to (1=Regular
Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star)
Season:
type: integer
description: The NFL season for which these totals apply
Team:
type:
- string
- 'null'
description: 'The abbreviation [Key] of the team that the player is on.
Note: If this player is a free agent; this field is NULL'
Number:
type: integer
description: Player's jersey number
Name:
type:
- string
- 'null'
description: Player's full name
Position:
type:
- string
- 'null'
description: 'The primary position of the player. Possible Values: C; CB;
DB; DE; DL; DT; FB; FS; G; ILB; K; KR; LB; LS; NT; OL; OLB; OT; P; QB;
RB; S; SS; T; TE; WR'
PositionCategory:
type:
- string
- 'null'
description: The category of the player's position (OFF; DEF; ST)
Activated:
type: integer
description: The total number of games that the player was active for in
the season
Played:
type: integer
description: The total number of games played by the the player in the season
Started:
type: integer
description: Total games started (on offense or defense) by the player in
the season
PassingAttempts:
type: number
description: Total passes thrown by the player in the season
PassingCompletions:
type: number
description: Total passes completed by the player in the season
PassingYards:
type: number
description: Total passing yards by the player in the season
PassingCompletionPercentage:
type: number
description: The percentage of passes completed by the player in the season
PassingYardsPerAttempt:
type: number
description: Total average passing yards per attempt by the player in the
season
PassingYardsPerCompletion:
type: number
description: Total average passing yards per completion by the player in
the season
PassingTouchdowns:
type: number
description: Total passing touchdowns by the player in the season
PassingInterceptions:
type: number
description: Total interceptions thrown by the player in the season
PassingRating:
type: number
description: The passer rating of the player in the season
PassingLong:
type: number
description: Total yards of longest completion by the player in the season
PassingSacks:
type: number
description: The total number of times the player was sacked in the season
PassingSackYards:
type: number
description: Total yards lost by the player in the season as a result of
being sacked
RushingAttempts:
type: number
description: Total rushing attempts by the player in the season
RushingYards:
type: number
description: Total rushing yards by the player in the season
RushingYardsPerAttempt:
type: number
description: Total rushing yards per attempt by the player in the season
RushingTouchdowns:
type: number
description: Total rushing touchdowns by the player in the season
RushingLong:
type: number
description: The longest rush by the player in the season
ReceivingTargets:
type:
- number
- 'null'
description: Total receiving targets by the player in the season
Receptions:
type: number
description: Total receptions by the player in the season
ReceivingYards:
type: number
description: Total receiving yards by the player in the season
ReceivingYardsPerReception:
type: number
description: Average receiving yards per reception by the player in the
season
ReceivingTouchdowns:
type: number
description: Total receiving touchdowns by the player in the season
ReceivingLong:
type: number
description: The longest reception by the player in the season
Fumbles:
type: number
description: Total fumbles by the player in the season
FumblesLost:
type:
- number
- 'null'
description: Total fumbles lost by the player in the season
PuntReturns:
type: number
description: Total punt returns by the player in the season
PuntReturnYards:
type: number
description: Total punt return yards by the player in the season
PuntReturnYardsPerAttempt:
type: number
description: Total average yards gained per punt return by the player in
the season
PuntReturnTouchdowns:
type: number
description: Total punt return touchdowns by the player in the season
PuntReturnLong:
type: number
description: The longest punt return by the player in the season
KickReturns:
type: number
description: Total kickoff returns by the player in the season
KickReturnYards:
type: number
description: Total kickoff return yards by the player in the season
KickReturnYardsPerAttempt:
type: number
description: Average yards gained per kick return by the player in the season
KickReturnTouchdowns:
type: number
description: Total kickoff return touchdowns by the player in the season
KickReturnLong:
type: number
description: Longest kick return by the player in the season
SoloTackles:
type: number
description: Total defensive solo (unassisted) tackles by the player in
the season
AssistedTackles:
type: number
description: Total defensive assisted tackles by the player in the season
TacklesForLoss:
type:
- number
- 'null'
description: 'Total tackles for loss by the player in the season. Note:
these are tackles behind the line of scrimmage for loss of yards (including
sacks)'
Sacks:
type: number
description: Total defensive sacks by the player in the season
SackYards:
type: number
description: Total defensive safeties scored by the player in the season
QuarterbackHits:
type:
- number
- 'null'
description: 'Total quarterback hits by the player in the season. Note:
This is a defensive stat that includes sacks'
PassesDefended:
type: number
description: Total passes defended by the player in the season
FumblesForced:
type: number
description: Total fumbles forced on defense by the player in the season
FumblesRecovered:
type: number
description: Total defensive fumble recoveries by the player in the season
FumbleReturnYards:
type: number
description: Total fumble return yards by the player in the season
FumbleReturnTouchdowns:
type: number
description: Total fumble return touchdowns by the player in the season
Interceptions:
type: number
description: Total defensive interceptions by the player in the season
InterceptionReturnYards:
type: number
description: Total defensive interception return yards by the player in
the season
InterceptionReturnTouchdowns:
type: number
description: Total defensive interception return touchdowns by the player
in the season
BlockedKicks:
type: number
description: 'Total blocked kicks by the player in the season. Note: BlockedKicks
include Field Goals and Punts but NOT Extra Points'
SpecialTeamsSoloTackles:
type: number
description: This field is deprecated
SpecialTeamsAssistedTackles:
type: number
description: This field is deprecated
MiscSoloTackles:
type: number
description: This field is deprecated
MiscAssistedTackles:
type: number
description: This field is deprecated
Punts:
type: number
description: Total number of punts by the player in the season
PuntYards:
type: number
description: Total punt yards by the player in the season
PuntAverage:
type: number
description: The average number of yards per punt by the player in the season
FieldGoalsAttempted:
type: number
description: Total field goals attempted by the player in the season
FieldGoalsMade:
type: number
description: Total field goals made by the player in season
FieldGoalsLongestMade:
type: number
description: Longest field goal made by the player in the season
ExtraPointsMade:
type: number
description: Total extra points made by the player in the season
TwoPointConversionPasses:
type: number
description: Total successful two point conversion passes by the player
in the season
TwoPointConversionRuns:
type: number
description: Total successful two point conversion rushes by the player
in the season
TwoPointConversionReceptions:
type: number
description: Total successful two point conversion receptions by the player
in the season
FantasyPoints:
type: number
description: Fantasy points scored based on basic fantasy scoring system
by the player in the season
FantasyPointsPPR:
type: number
description: Fantasy points scored based on basic PPR fantasy scoring system
by the player in the season
ReceptionPercentage:
type: number
description: Total percentage of receiving targets that were receptions
by the player in the season
ReceivingYardsPerTarget:
type: number
description: Average receiving yards per target by the player in the season
Tackles:
type: number
description: Total tackles (solo & assisted) by the player in the season
OffensiveTouchdowns:
type: number
description: Total offensive touchdowns scored by the player in the season
DefensiveTouchdowns:
type: number
description: Total defensive touchdowns scored by the player in the season
SpecialTeamsTouchdowns:
type: number
description: Total special teams touchdowns scored by the player in the
season
Touchdowns:
type: number
description: Total touchdowns scored by the player in the season
FantasyPosition:
type:
- string
- 'null'
description: 'The player''s fantasy football position. Possible values:
QB, RB, WR, TE, DL, LB, DB, K, P, OL'
FieldGoalPercentage:
type: number
description: Total field goal attempts made by the player in the season
PlayerSeasonID:
type: integer
description: Unique ID of PlayerSeason record (subject to change, although
it very rarely does). For a static ID, use a combination of SeasonType,
Season and PlayerID.
FumblesOwnRecoveries:
type:
- number
- 'null'
description: 'Total own fumble recoveries by the player in the season. Note:
this fumble doesn''t result in a turnover - the fumbling team recovers
the fumble'
FumblesOutOfBounds:
type:
- number
- 'null'
description: This field is deprecated
KickReturnFairCatches:
type:
- number
- 'null'
description: This field is deprecated
PuntReturnFairCatches:
type:
- number
- 'null'
description: This field is deprecated.
PuntTouchbacks:
type:
- number
- 'null'
description: Total punts that resulted in touchbacks by the player in the
season
PuntInside20:
type:
- number
- 'null'
description: Total punts downed inside the 20 yard line by the player in
the season
PuntNetAverage:
type:
- number
- 'null'
description: The average net yards per punt by the player in the season
ExtraPointsAttempted:
type:
- number
- 'null'
description: Total extra point kicks attempted by the player in the season
BlockedKickReturnTouchdowns:
type:
- number
- 'null'
description: Total blocked kick recovery return touchdowns for the player
in the season
FieldGoalReturnTouchdowns:
type:
- number
- 'null'
description: 'Total field goal return touchdowns by the player in the season.
Note: This field excludes blocked field goals'
Safeties:
type:
- number
- 'null'
description: Defensive safeties (sacks in end zone, solo tackles in end
zone, blocked kicks that went out of bounds in the end zone)
FieldGoalsHadBlocked:
type:
- number
- 'null'
description: Total field goals by the player that were blocked in the season
PuntsHadBlocked:
type:
- number
- 'null'
description: Total punts by the player that were blocked in the season
ExtraPointsHadBlocked:
type:
- number
- 'null'
description: Total extra point kick attempts by the player that were blocked
in the season
PuntLong:
type:
- number
- 'null'
description: The longest punt by the player in the season
BlockedKickReturnYards:
type:
- number
- 'null'
description: Total blocked kick recovery return yards for the player in
the season
FieldGoalReturnYards:
type:
- number
- 'null'
description: 'Total field goal return yards by the player in the season.
Note: This field excludes blocked field goals'
PuntNetYards:
type:
- number
- 'null'
description: The net yards of the punts by the player in the season
SpecialTeamsFumblesForced:
type:
- number
- 'null'
description: This field is deprecated
SpecialTeamsFumblesRecovered:
type:
- number
- 'null'
description: This field is deprecated
MiscFumblesForced:
type:
- number
- 'null'
description: This field is deprecated
MiscFumblesRecovered:
type:
- number
- 'null'
description: This field is deprecated
ShortName:
type:
- string
- 'null'
description: The first initial and last name of the player (J. Doe)
SafetiesAllowed:
type:
- number
- 'null'
description: This field is deprecated
Temperature:
type:
- integer
- 'null'
description: Temperature at game start (Fahrenheit)
Humidity:
type:
- integer
- 'null'
description: The humidity percentage at the start of the game
WindSpeed:
type:
- integer
- 'null'
description: The wind speed at the start of the game (in MPH)
OffensiveSnapsPlayed:
type:
- integer
- 'null'
description: 'Total snaps this player played on offensive in the season.
Note: Snap counts are available the morning after the game.'
DefensiveSnapsPlayed:
type:
- integer
- 'null'
description: 'Total snaps this player played on defense in the season. Note:
Snap counts are available the morning after the game.'
SpecialTeamsSnapsPlayed:
type:
- integer
- 'null'
description: 'Total snaps this player played on special teams in the season.
Note: Snap counts are available the morning after the game.'
OffensiveTeamSnaps:
type:
- integer
- 'null'
description: 'Total offensive snaps this player''s team played in the season.
Note: Snap counts are available the morning after the game.'
DefensiveTeamSnaps:
type:
- integer
- 'null'
description: 'Total defensive snaps this player''s team played in the season.
Note: Snap counts are available the morning after the game.'
SpecialTeamsTeamSnaps:
type:
- integer
- 'null'
description: 'Total special teams snaps this player''s team played in the
season. Note: Snap counts are available the morning after the game.'
AuctionValue:
type:
- number
- 'null'
description: Player's dollar value in a $200 salary cap auction draft.
AuctionValuePPR:
type:
- number
- 'null'
description: Player's dollar value in a $200 salary cap PPR auction draft.
TwoPointConversionReturns:
type:
- number
- 'null'
description: Total successful two point conversion returns by the player
in the season
FantasyPointsFanDuel:
type:
- number
- 'null'
description: Fantasy points based on FanDuel's scoring system by the player
in the season
FieldGoalsMade0to19:
type:
- number
- 'null'
description: Total field goals of 0 to 19 yards made by the player in season
FieldGoalsMade20to29:
type:
- number
- 'null'
description: Total field goals of 20 to 29 yards made by the player in season
FieldGoalsMade30to39:
type:
- number
- 'null'
description: Total field goals of 30 to 39 yards made by the player in season
FieldGoalsMade40to49:
type:
- number
- 'null'
description: Total field goals of 40 to 49 yards made by the player in season
FieldGoalsMade50Plus:
type:
- number
- 'null'
description: Total field goals of 50+ yards made by the player in season
FantasyPointsDraftKings:
type:
- number
- 'null'
description: Fantasy points based on DraftKings' scoring system by the player
in the season
FantasyPointsYahoo:
type:
- number
- 'null'
description: Fantasy points based on Yahoo's daily fantasy scoring system
by the player in the season
AverageDraftPosition:
type:
- number
- 'null'
description: The average draft position of the player in re-draft leagues
AverageDraftPositionPPR:
type:
- number
- 'null'
description: The average draft position of this player in Points Per Reception
(PPR) leagues.
TeamID:
type:
- integer
- 'null'
description: 'The unique ID of the team that the player is on. Note: If
the player is a free agent; this field is NULL'
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team. This value is guaranteed
to be unique across all sports/leagues
FantasyPointsFantasyDraft:
type:
- number
- 'null'
description: Fantasy points based on FantasyDraft's scoring system by the
player in the season
ScoringDetails:
type: array
items:
$ref: '#/components/schemas/ScoringDetail'
description: The details of the scoring plays this player recorded in the
season
AverageDraftPositionRookie:
type:
- number
- 'null'
description: The average draft position of this rookie in Points Per Reception
(PPR) leagues.
AverageDraftPositionDynasty:
type:
- number
- 'null'
description: The average draft position of this player in dynasty drafts
leagues
AverageDraftPosition2QB:
type:
- number
- 'null'
description: The average draft position of this player in 2 Quarterback
leagues
OffensiveFumbleRecoveryTouchdowns:
type:
- integer
- 'null'
description: This field is deprecated
BoxScoreV3:
properties:
Score:
$ref: '#/components/schemas/Score'
description: The Score object related to this game
Quarters:
type: array
items:
$ref: '#/components/schemas/Quarter'
description: The Quarters objects related to this game
TeamGames:
type: array
items:
$ref: '#/components/schemas/TeamGame'
description: The TeamGame objects related to this game
PlayerGames:
type: array
items:
$ref: '#/components/schemas/PlayerGame'
description: The PlayerGame objects related to this game
FantasyDefenseGames:
type: array
items:
$ref: '#/components/schemas/FantasyDefenseGame'
description: The FantasyDefenseGame objects related to this game
ScoringPlays:
type: array
items:
$ref: '#/components/schemas/ScoringPlay'
description: The ScoringPlay objects related to this game
ScoringDetails:
type: array
items:
$ref: '#/components/schemas/ScoringDetail'
description: The ScoringDetail objects related to this game
Quarter:
properties:
QuarterID:
type: integer
description: The unique ID of the quarter
ScoreID:
type: integer
description: The unique ID of the score this quarter belongs to
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)'
Description:
type:
- string
- 'null'
description: The long description of the quarter
AwayTeamScore:
type:
- integer
- 'null'
description: The total points scored by the away team in this Quarter.
HomeTeamScore:
type:
- integer
- 'null'
description: The total points scored by the home team in this Quarter.
Updated:
type:
- string
- 'null'
description: The database generated timestamp of when this Quarter was last
updated (in US Eastern time)
Created:
type:
- string
- 'null'
description: The database generated timestamp of when this Quarter was first
created (in US Eastern Time)
ScoringPlay:
properties:
GameKey:
type:
- string
- 'null'
description: 'A 9 digit unique code identifying the game that this record
corresponds to. The GameID is composed of Season; SeasonType; Week and
HomeTeam. Note: This value will be NULL for bye weeks'
SeasonType:
type: integer
description: The type of season that this game corresponds to (1=Regular
Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star)
ScoringPlayID:
type: integer
description: Unique ID of the scoring play
Season:
type: integer
description: The NFL season of the game
Week:
type: integer
description: 'The NFL week of the game (regular season: 1 to 18; preseason:
0 to 4; postseason: 1 to 4). Note: seasons after 2021 will have only 3
preseason weeks'
AwayTeam:
type:
- string
- 'null'
description: The abbreviation [Key} of the away team
HomeTeam:
type:
- string
- 'null'
description: The abbreviation [Key] of the home team
Date:
type:
- string
- 'null'
description: The date and time of the game (in US Eastern Time)
Sequence:
type:
- integer
- 'null'
description: The order in which the scoring play happened
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
Quarter:
type:
- string
- 'null'
description: The quarter of the scoring play (1; 2; 3; 4; OT)
TimeRemaining:
type:
- string
- 'null'
description: The amount of time remaining in the current quarter when the
scoring play occurred (e.g. 11:23; 5:34; NULL if game is not in progress
or at halftime)
PlayDescription:
type:
- string
- 'null'
description: The detailed description of the play for display purposes
AwayScore:
type:
- integer
- 'null'
description: The away team's score as a result of the scoring play (includes
point after)
HomeScore:
type:
- integer
- 'null'
description: The home team's score as a result of the scoring play (includes
point after)
ScoreID:
type: integer
description: Unique ID of the score/game
PlayerOwnership:
properties:
PlayerID:
type: integer
description: 'The unique PlayerID of the player as assigned by SportsDataIO.
Note: this ID will stay with the player throughout their entire career'
Season:
type: integer
description: The NFL season of the ownership info
SeasonType:
type: integer
description: The type of season that this record corresponds to (1=Regular
Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar).
Week:
type: integer
description: 'The NFL week of the game (regular season: 1 to 18; preseason:
0 to 4; postseason: 1 to 4). Note: seasons after 2021 will have only 3
preseason weeks'
Name:
type:
- string
- 'null'
description: The player's full name
Position:
type:
- string
- 'null'
description: 'The player''s fantasy football position. Possible values:
QB; RB; WR; TE; DL; LB; DB; K; P; OL'
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team that the player is on
TeamID:
type:
- integer
- 'null'
description: 'The unique ID of the team that the player is on. Note: If
the player is a free agent; this field is NULL'
OwnershipPercentage:
type:
- number
- 'null'
description: Player's ownership percentage on NFL.com fantasy leagues during
this week
DeltaOwnershipPercentage:
type:
- number
- 'null'
description: Player's change in ownership percentage on NFL.com fantasy
leagues during this week
StartPercentage:
type:
- number
- 'null'
description: Player's starting lineup percentage on NFL.com fantasy leagues
during this week
DeltaStartPercentage:
type:
- number
- 'null'
description: Player's change in starting lineup percentage on NFL.com fantasy
leagues during this week
PlayerGameRedZone:
properties:
GameKey:
type:
- string
- 'null'
description: 'A 9 digit unique code identifying the game that this record
corresponds to. The GameID is composed of Season; SeasonType; Week and
HomeTeam.. Note: This value will be NULL for bye weeks'
PlayerID:
type:
- integer
- 'null'
description: 'The unique PlayerID of the player as assigned by SportsDataIO.
Note: this ID will stay with the player throughout their entire career'
SeasonType:
type: integer
description: The type of season that this player corresponds to (1=Regular
Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star)
Season:
type: integer
description: The NFL season of the game
GameDate:
type:
- string
- 'null'
description: The date and time the game is scheduled to start
Week:
type: integer
description: 'The NFL week of the game (regular season: 1 to 18; preseason:
0 to 4; postseason: 1 to 4). Note: seasons after 2021 will have only 3
preseason weeks'
Team:
type:
- string
- 'null'
description: 'The abbreviation [Key] of the team that the player is on.
Note: if this player is a free agent; this field is NULL'
Opponent:
type:
- string
- 'null'
description: The abbreviation [Key] of the opponent team
HomeOrAway:
type:
- string
- 'null'
description: Whether the team is home or away
Number:
type: integer
description: Player's jersey number
Name:
type:
- string
- 'null'
description: Player's full name
Position:
type:
- string
- 'null'
description: 'The primary position of the player. Possible Values: C; CB;
DB; DE; DL; DT; FB; FS; G; ILB; K; KR; LB; LS; NT; OL; OLB; OT; P; QB;
RB; S; SS; T; TE; WR'
PositionCategory:
type:
- string
- 'null'
description: The category of the player's position (OFF; DEF; ST)
Activated:
type: integer
description: Whether or not the player was active for the game
Played:
type: integer
description: 'Whether the player played at least one snap in the game Note:
Will return "1" if player played at least one snap and "0" if they did
not'
Started:
type: integer
description: 'Whether the player started the game (on offensive or defense).
Note: Started = 1 / Did Not Start = 0'
PassingAttempts:
type: number
description: Total passes thrown by the player in the game
PassingCompletions:
type: number
description: Total passes completed by the player in the game
PassingYards:
type: number
description: Total passing yards by the player in the game
PassingCompletionPercentage:
type: number
description: The percentage of passes completed by the player in the game
PassingYardsPerAttempt:
type: number
description: Total average passing yards per attempt by the player in the
game
PassingYardsPerCompletion:
type: number
description: Total average passing yards per completion by the player in
the game
PassingTouchdowns:
type: number
description: Total passing touchdowns by the player in the game
PassingInterceptions:
type: number
description: Total interceptions thrown by the player in the game
PassingRating:
type: number
description: The passer rating of the player in the game
PassingLong:
type: number
description: Total yards of longest completion by the player in the game
PassingSacks:
type: number
description: The total number of times the player was sacked in the game
PassingSackYards:
type: number
description: Total yards lost by the player in the game as a result of being
sacked
RushingAttempts:
type: number
description: Total rushing attempts by the player in the game
RushingYards:
type: number
description: Total rushing yards by the player in the game
RushingYardsPerAttempt:
type: number
description: Total rushing yards per attempt by the player in the game
RushingTouchdowns:
type: number
description: Total rushing touchdowns by the player in the game
RushingLong:
type: number
description: The longest rush by the player in the game
ReceivingTargets:
type:
- number
- 'null'
description: Total receiving targets by the player in the game
Receptions:
type: number
description: Total receptions by the player in the game
ReceivingYards:
type: number
description: Total receiving yards by the player in the game
ReceivingYardsPerReception:
type: number
description: Average receiving yards per reception by the player in the
game
ReceivingTouchdowns:
type: number
description: Total receiving touchdowns by the player in the game
ReceivingLong:
type: number
description: The longest reception by the player in the game
Fumbles:
type: number
description: Total fumbles by the player in the game
FumblesLost:
type:
- number
- 'null'
description: Total fumbles lost by the player in the game
PuntReturns:
type: number
description: Total punt returns by the player in the game
PuntReturnYards:
type: number
description: Total punt return yards by the player in the game
PuntReturnYardsPerAttempt:
type: number
description: Total average yards gained per punt return by the player in
the game
PuntReturnTouchdowns:
type: number
description: Total punt return touchdowns by the player in the game
PuntReturnLong:
type: number
description: The longest punt return by the player in the game
KickReturns:
type: number
description: Total kickoff returns by the player in the game
KickReturnYards:
type: number
description: Total kickoff return yards by the player in the game
KickReturnYardsPerAttempt:
type: number
description: Average yards gained per kick return by the player in the game
KickReturnTouchdowns:
type: number
description: Total kickoff return touchdowns by the player in the game
KickReturnLong:
type: number
description: Longest kick return by the player in the game
SoloTackles:
type: number
description: Total defensive solo (unassisted) tackles by the player in
the game
AssistedTackles:
type: number
description: Total defensive assisted tackles by the player in the game
TacklesForLoss:
type:
- number
- 'null'
description: 'Total tackles for loss by the player in the game. Note: these
are tackles behind the line of scrimmage for loss of yards (including
sacks)'
Sacks:
type: number
description: Total defensive sacks by the player in the game
SackYards:
type: number
description: Total defensive sacks yards by the player in the game
QuarterbackHits:
type:
- number
- 'null'
description: 'Total quarterback hits by the player in the game. Note: This
is a defensive stat that includes sacks'
PassesDefended:
type: number
description: Total passes defended by the player in the game
FumblesForced:
type: number
description: Total fumbles forced on defense by the player in the game
FumblesRecovered:
type: number
description: Total defensive fumble recoveries by the player in the game
FumbleReturnYards:
type: number
description: Total fumble return yards by the player in the game
FumbleReturnTouchdowns:
type: number
description: Total fumble return touchdowns by the player in the game
Interceptions:
type: number
description: Total defensive interceptions by the player in the game
InterceptionReturnYards:
type: number
description: Total defensive interception return yards by the player in
the game
InterceptionReturnTouchdowns:
type: number
description: Total defensive interception return touchdowns by the player
in the game
BlockedKicks:
type: number
description: 'Total blocked kicks by the player in the game. Note: BlockedKicks
include Field Goals and Punts but NOT Extra Points'
SpecialTeamsSoloTackles:
type: number
description: This field is deprecated
SpecialTeamsAssistedTackles:
type: number
description: This field is deprecated
MiscSoloTackles:
type: number
description: This field is deprecated
MiscAssistedTackles:
type: number
description: This field is deprecated
Punts:
type: number
description: Total number of punts by the player in the game
PuntYards:
type: number
description: Total punt yards by the player in the game
PuntAverage:
type: number
description: The average number of yards per punt by the player in the game
FieldGoalsAttempted:
type: number
description: Total field goals attempted by the player in the game
FieldGoalsMade:
type: number
description: Total field goals made by the player in game
FieldGoalsLongestMade:
type: number
description: Longest field goal made by the player in the game
ExtraPointsMade:
type: number
description: Total extra points made by the player in the game
TwoPointConversionPasses:
type: number
description: Total successful two point conversion passes by the player
in the game
TwoPointConversionRuns:
type: number
description: Total successful two point conversion rushes by the player
in the game
TwoPointConversionReceptions:
type: number
description: Total successful two point conversion receptions by the player
in the game
FantasyPoints:
type: number
description: Fantasy points scored based on basic fantasy scoring system
by the player in the game
FantasyPointsPPR:
type: number
description: This field is expected to be NULL
ReceptionPercentage:
type: number
description: Total percentage of receiving targets that were receptions
by the player in the game
ReceivingYardsPerTarget:
type: number
description: Average receiving yards per target by the player in the game
Tackles:
type: number
description: Total tackles (solo & assisted) by the player in the game
OffensiveTouchdowns:
type: number
description: Total offensive touchdowns scored by the player in the game
DefensiveTouchdowns:
type: number
description: Total defensive touchdowns scored by the player in the game
SpecialTeamsTouchdowns:
type: number
description: Total special teams touchdowns scored by the player in the
game
Touchdowns:
type: number
description: Total touchdowns scored by the player in the game (excludes
passing touchdowns)
FantasyPosition:
type:
- string
- 'null'
description: 'The player''s fantasy football position. Possible values:
QB; RB; WR; TE; DL; LB; DB; K; P; OL'
FieldGoalPercentage:
type: number
description: Total field goal attempts made by the player in the game
PlayerGameID:
type: integer
description: Unique ID of PlayerGame record (subject to change, although
it very rarely does). For a static ID, use a combination of GameKey and
PlayerID.
FumblesOwnRecoveries:
type:
- number
- 'null'
description: 'Total own fumble recoveries by the player in the game. Note:
this fumble doesn''t result in a turnover - the fumbling team recovers
the fumble'
FumblesOutOfBounds:
type:
- number
- 'null'
description: This field is deprecated
KickReturnFairCatches:
type:
- number
- 'null'
description: This field is deprecated
PuntReturnFairCatches:
type:
- number
- 'null'
description: This field is deprecated
PuntTouchbacks:
type:
- number
- 'null'
description: Total punts that resulted in touchbacks by the player in the
game
PuntInside20:
type:
- number
- 'null'
description: Total punts downed inside the 20 yard line by the player in
the game
PuntNetAverage:
type:
- number
- 'null'
description: The average net yards per punt by the player in the game
ExtraPointsAttempted:
type:
- number
- 'null'
description: Total extra point kicks attempted by the player in the game
BlockedKickReturnTouchdowns:
type:
- number
- 'null'
description: Total blocked kick recovery return touchdowns for the player
in the game
FieldGoalReturnTouchdowns:
type:
- number
- 'null'
description: 'Total field goal return touchdowns by the player in the game.
Note: This field excludes blocked field goals'
Safeties:
type:
- number
- 'null'
description: Total defensive safeties scored by the player in the game
FieldGoalsHadBlocked:
type:
- number
- 'null'
description: Total field goals by the player that were blocked in the game
PuntsHadBlocked:
type:
- number
- 'null'
description: Total punts by the player that were blocked in the game
ExtraPointsHadBlocked:
type:
- number
- 'null'
description: Total extra point kick attempts by the player that were blocked
in the game
PuntLong:
type:
- number
- 'null'
description: The longest punt by the player in the game
BlockedKickReturnYards:
type:
- number
- 'null'
description: Total blocked kick recovery return yards for the player in
the game
FieldGoalReturnYards:
type:
- number
- 'null'
description: 'Total field goal return yards by the player in the game. Note:
This field excludes blocked field goals'
PuntNetYards:
type:
- number
- 'null'
description: The net yards of the punts by the player in the game
SpecialTeamsFumblesForced:
type:
- number
- 'null'
description: This field is deprecated
SpecialTeamsFumblesRecovered:
type:
- number
- 'null'
description: This field is deprecated
MiscFumblesForced:
type:
- number
- 'null'
description: This field is deprecated
MiscFumblesRecovered:
type:
- number
- 'null'
description: This field is deprecated
ShortName:
type:
- string
- 'null'
description: The first initial and last name of the player (J. Doe)
PlayingSurface:
type:
- string
- 'null'
description: The playing surface of the stadium
IsGameOver:
type:
- boolean
- 'null'
description: Whether the game is over (true/false)
SafetiesAllowed:
type:
- number
- 'null'
description: This field is deprecated
Stadium:
type:
- string
- 'null'
description: Stadium of the event
Temperature:
type:
- integer
- 'null'
description: Temperature at game start (Fahrenheit)
Humidity:
type:
- integer
- 'null'
description: The humidity percentage at the start of the game
WindSpeed:
type:
- integer
- 'null'
description: The wind speed at the start of the game (in MPH)
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).
OffensiveSnapsPlayed:
type:
- integer
- 'null'
description: 'Total snaps this player played on offense in the game. Note:
Snap counts are available the morning after the game.'
DefensiveSnapsPlayed:
type:
- integer
- 'null'
description: 'Total snaps this player played on defense in the game. Note:
Snap counts are available the morning after the game.'
SpecialTeamsSnapsPlayed:
type:
- integer
- 'null'
description: 'Total snaps this player played on special teams in the game.
Note: Snap counts are available the morning after the game.'
OffensiveTeamSnaps:
type:
- integer
- 'null'
description: 'Total offensive snaps this player''s team played in the game.
Note: Snap counts are available the morning after the game.'
DefensiveTeamSnaps:
type:
- integer
- 'null'
description: 'Total defensive snaps this player''s team played in the game.
Note: Snap counts are available the morning after the game.'
SpecialTeamsTeamSnaps:
type:
- integer
- 'null'
description: 'Total special teams snaps this player''s team played in the
game. Note: Snap counts are available the morning after the game.'
VictivSalary:
type:
- integer
- 'null'
description: The player's salary for Victiv daily fantasy contests.
TwoPointConversionReturns:
type:
- number
- 'null'
description: Total successful two point conversion returns by the player
in the game
FantasyPointsFanDuel:
type:
- number
- 'null'
description: Fantasy points based on FanDuel's scoring system by the player
in the game
FieldGoalsMade0to19:
type:
- number
- 'null'
description: Total field goals of 0 to 19 yards made by the player in game
FieldGoalsMade20to29:
type:
- number
- 'null'
description: Total field goals of 20 to 29 yards made by the player in game
FieldGoalsMade30to39:
type:
- number
- 'null'
description: Total field goals of 30 to 39 yards made by the player in game
FieldGoalsMade40to49:
type:
- number
- 'null'
description: Total field goals of 40 to 49 yards made by the player in game
FieldGoalsMade50Plus:
type:
- number
- 'null'
description: Total field goals of 50+ yards made by the player in game
FantasyPointsDraftKings:
type:
- number
- 'null'
description: Fantasy points based on DraftKings' scoring system by the player
in the game
YahooSalary:
type:
- integer
- 'null'
description: The player's salary for Yahoo daily fantasy contests
FantasyPointsYahoo:
type:
- number
- 'null'
description: Fantasy points based on Yahoo's daily fantasy scoring system
by the player in the game
InjuryStatus:
type:
- string
- 'null'
description: The player's current injury status; in the form of likelihood
that player plays (Probable; Questionable; Doubtful; Out)
InjuryBodyPart:
type:
- string
- 'null'
description: The body part that is injured for the player (Knee; Groin;
Calf; Hamstring; etc.)
InjuryStartDate:
type:
- string
- 'null'
description: The day that the player's injury started or was first discovered
InjuryNotes:
type:
- string
- 'null'
description: A 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.
InjuryPractice:
type:
- string
- 'null'
description: This field is deprecated
InjuryPracticeDescription:
type:
- string
- 'null'
description: This field is deprecated
DeclaredInactive:
type: boolean
description: 'Whether the player has been declared inactive. This value
is updated in the hours leading up to game start time; as teams announce
their inactive players. Note: This is only updated for offensive skill
position players (QB; RB; WR; TE)'
FantasyDraftSalary:
type:
- integer
- 'null'
description: The player's salary for FantasyDraft daily fantasy contests.
FantasyDraftPosition:
type:
- string
- 'null'
description: The player's eligible position in FantasyDraft's daily fantasy
sports platform.
TeamID:
type:
- integer
- 'null'
description: 'The unique ID of the team that the player is on. Note: if
the player is a free agent; this field is NULL'
OpponentID:
type:
- integer
- 'null'
description: The unique ID of this opponent team
Day:
type:
- string
- 'null'
description: The date of the game (in US Eastern Time)
DateTime:
type:
- string
- 'null'
description: The date and time of the game (in US Eastern Time)
GlobalGameID:
type:
- integer
- 'null'
description: A globally unique ID for this game. This value is guaranteed
to be unique across all sports/leagues
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team. This value is guaranteed
to be unique across all sports/leagues
GlobalOpponentID:
type:
- integer
- 'null'
description: A globally unique ID for this opposing team. This value is
guaranteed to be unique across all sports/leagues.
ScoreID:
type: integer
description: Unique ID of the score/game
FantasyPointsFantasyDraft:
type:
- number
- 'null'
description: This field is no longer in use and will return null.
ScoringDetails:
type: array
items:
$ref: '#/components/schemas/ScoringDetail'
description: The details of the scoring plays this player recorded in the
game
OffensiveFumbleRecoveryTouchdowns:
type:
- number
- 'null'
description: This field is deprecated
SnapCountsConfirmed:
type:
- boolean
- 'null'
description: 'Whether snap count fields are confirmed (true/false). Note:
This takes place the morning after the game.'
Updated:
type:
- string
- 'null'
description: 'Time of last update (in US Eastern time). Note: this does
not indicate that stats changed.'
PlayerInfo:
properties:
PlayerID:
type: integer
description: 'The unique PlayerID of the player 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 that the player is on. Note: If
the player is a free agent; this field is NULL'
Team:
type:
- string
- 'null'
description: 'The abbreviation [Key] of the team that the player is on.
Note: If this player is a free agent; this field is NULL'
Position:
type:
- string
- 'null'
description: 'The primary position of the player. Possible Values: C; CB;
DB; DE; DL; DT; FB; FS; G; ILB; K; KR; LB; LS; NT; OL; OLB; OT; P; QB;
RB; S; SS; T; TE; WR'
FantasyGame:
properties:
GameID:
type:
- integer
- 'null'
description: The unique ID of this game
PlayerID:
type:
- integer
- 'null'
description: 'The unique PlayerID of the player as assigned by SportsDataIO
tied to this FantasyGame record Note: this ID will stay with the player
throughout their entire career'
SeasonType:
type: integer
description: The type of season that this player corresponds to (1=Regular
Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star).
Season:
type: integer
description: The NFL season of the game
Day:
type:
- string
- 'null'
description: The date of the game (in US Eastern Time)
DateTime:
type:
- string
- 'null'
description: The date and time of the game (in US Eastern Time)
Week:
type: integer
description: 'The NFL week of the game (regular season: 1 to 18; preseason:
0 to 4; postseason: 1 to 4). Note: seasons after 2021 will have only 3
preseason weeks'
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
Opponent:
type:
- string
- 'null'
description: The abbreviation [Key] of the opponent team
HomeOrAway:
type:
- string
- 'null'
description: Whether the team is home or away
Number:
type: integer
description: Player's jersey number
Name:
type:
- string
- 'null'
description: Player's full name
Position:
type:
- string
- 'null'
description: 'The primary position of the player Possible Values: C; CB;
DB; DE; DL; DT; FB; FS; G; ILB; K; KR; LB; LS; NT; OL; OLB; OT; P; QB;
RB; S; SS; T; TE; WR'
PositionCategory:
type:
- string
- 'null'
description: The category of the player's position (OFF; DEF; ST)
Activated:
type: integer
description: Whether or not the player was active for the game
Played:
type: integer
description: 'Whether the player played at least one snap in the game Note:
Will return "1" if player played at least one snap and "0" if they did
not'
Started:
type: integer
description: 'Whether the player started the game (on offensive or defense)
Note: Started = 1 / Did Not Start = 0'
FantasyPoints:
type: number
description: Total fantasy points by the player in the game
FantasyPointsPPR:
type: number
description: Fantasy points scored based on basic PPR fantasy scoring system
by the player in the game
FantasyPosition:
type:
- string
- 'null'
description: 'The player''s fantasy football position Possible values: QB;
RB; WR; TE; DL; LB; DB; K; P; OL'
IsGameOver:
type:
- boolean
- 'null'
description: Whether the game is over (true/false)
FantasyPointsFanDuel:
type:
- number
- 'null'
description: Fantasy points based on FanDuel's scoring system by the player
in the game
FantasyPointsYahoo:
type:
- number
- 'null'
description: Fantasy points based on Yahoo's daily fantasy scoring system
by the player in the game
FantasyPointsDraftKings:
type:
- number
- 'null'
description: Total DraftKings daily fantasy points scored by the player
in the game
FanDuelPosition:
type:
- string
- 'null'
description: The player's eligible position in FanDuel's daily fantasy sports
platform
DraftKingsPosition:
type:
- string
- 'null'
description: The player's eligible position in DraftKings' daily fantasy
sports platform
YahooPosition:
type:
- string
- 'null'
description: The player's eligible position in Yahoo's daily fantasy sports
platform
OpponentRank:
type:
- integer
- 'null'
description: The ranking of the player's opponent with regards to fantasy
points allowed
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: 'Time of last update (in US Eastern time) Note: this does not
indicate that stats changed'
PlayByPlay:
properties:
Score:
$ref: '#/components/schemas/Score'
description: The score object and other game details of the given game
Quarters:
type: array
items:
$ref: '#/components/schemas/Quarter'
description: The details of the quarters (including overtime periods) for
the given game
Plays:
type: array
items:
$ref: '#/components/schemas/Play'
description: The list of plays for the given game
Play:
properties:
PlayID:
type: integer
description: The unique ID of the play
QuarterID:
type: integer
description: The unique ID of the quarter in which the play occurred
QuarterName:
type:
- string
- 'null'
description: The name of the quarter in which the play occurred
Sequence:
type:
- integer
- 'null'
description: The order in which this play and/or event happened over the
course of the game
TimeRemainingMinutes:
type:
- integer
- 'null'
description: The minutes of the time remaining in the Quarter, when this
play occurred.
TimeRemainingSeconds:
type:
- integer
- 'null'
description: The seconds of the time remaining in the Quarter, when this
play occurred.
PlayTime:
type:
- string
- 'null'
description: The estimated timestamp of when this Play occurred on the field.
Please note that we do not have scouts at the venue; so this is an estimate
based on our TV feed and estimated TV feed delay
Updated:
type:
- string
- 'null'
description: The database generated 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)
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team that completed the play
Opponent:
type:
- string
- 'null'
description: The abbreviation [Key] of the opponent of the team that this
play relates to
Down:
type:
- integer
- 'null'
description: The Down when this Play occurred.
Distance:
type:
- integer
- 'null'
description: 'The yards to go for a first down. Note: this can be any positive
number or "Goal"'
YardLine:
type:
- integer
- 'null'
description: the yard line of the ball's current position on the field when
this play occurred
YardLineTerritory:
type:
- string
- 'null'
description: The team's side of the field that the ball is on when the play
occurred
YardsToEndZone:
type:
- integer
- 'null'
description: The number of yards to go to reach the end zone at the start
of the play
Type:
type:
- string
- 'null'
description: 'The Type of Play that occurred (possible values: Rush, PassCompleted,
PassIncomplete, PassIntercepted, TwoPointConversion, Punt, Kickoff, FieldGoal,
ExtraPoint, Fumble, Penalty, Sack, Timeout, Period)'
YardsGained:
type:
- integer
- 'null'
description: The number of yards gained or lost on the play
Description:
type:
- string
- 'null'
description: The description of the Play.
IsScoringPlay:
type:
- boolean
- 'null'
description: Indicates whether this Play was a scoring play.
ScoringPlay:
$ref: '#/components/schemas/ScoringPlay'
description: The details of the scoring play attached to this play (if any).
PlayStats:
type: array
items:
$ref: '#/components/schemas/PlayStat'
description: The list of player stats accumulated during the play
PlayStat:
properties:
PlayStatID:
type: integer
description: The unique ID of the PlayStat on the play
PlayID:
type: integer
description: The unique ID of the play in which the PlayStat occurred
Sequence:
type: integer
description: The order in which the play stat was registered to the Play.
PlayerID:
type: integer
description: 'The unique PlayerID of the player whose stats are tied to
the play. Note: this ID will stay with the player throughout their entire
career'
Name:
type:
- string
- 'null'
description: The Name of the Player whose stats this represents.
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team the player belongs to
Opponent:
type:
- string
- 'null'
description: The abbreviation [Key] of the opponent team of the player who
recorded the stat
HomeOrAway:
type:
- string
- 'null'
description: 'Whether the Player was Home or Away (possible values: HOME,
AWAY)'
Direction:
type:
- string
- 'null'
description: 'The Direction this Play occurred (possible values: Left, Middle,
Right)'
Updated:
type:
- string
- 'null'
description: The database generated timestamp of when this PlayStat was
last updated (in US Eastern time)
Created:
type:
- string
- 'null'
description: The database generated timestamp of when this PlayStat was
first created (in US Eastern Time)
PassingAttempts:
type:
- integer
- 'null'
description: Total passes thrown by the player on the play
PassingCompletions:
type:
- integer
- 'null'
description: Total passing completions by the player on the play
PassingYards:
type:
- integer
- 'null'
description: Total passing yards by the player on the play
PassingTouchdowns:
type:
- integer
- 'null'
description: Total passing touchdowns thrown by the player on the play
PassingInterceptions:
type:
- integer
- 'null'
description: Total interceptions thrown by the player on the play
PassingSacks:
type:
- integer
- 'null'
description: The total number of times the player was sacked on the play
PassingSackYards:
type:
- integer
- 'null'
description: Total yards lost by the player as a result of being sacked
on the play
RushingAttempts:
type:
- integer
- 'null'
description: 'Rushing attempts by the player on the play. Note: this field
is expected to be 1 or 0'
RushingYards:
type:
- integer
- 'null'
description: Total rushing yards by the player on the play
RushingTouchdowns:
type:
- integer
- 'null'
description: 'Total rushing touchdowns by the player on the play. Note:
this field is expected to be 1 or 0'
ReceivingTargets:
type:
- integer
- 'null'
description: 'Total receiving targets by the player on the play. Note: this
field is expected to be 1 or 0'
Receptions:
type:
- integer
- 'null'
description: 'Total receptions by the player on the play. Note: this field
is expected to be 1 or 0'
ReceivingYards:
type:
- integer
- 'null'
description: Total receiving yards by the player on the play
ReceivingTouchdowns:
type:
- integer
- 'null'
description: 'Total receiving touchdowns by the player on the play. Note:
this field is expected to be 1 or 0'
Fumbles:
type:
- integer
- 'null'
description: Times the player fumbled on the play
FumblesLost:
type:
- integer
- 'null'
description: Fumbles lost by the player on the play
TwoPointConversionAttempts:
type:
- integer
- 'null'
description: 'Total two point conversion attempts by the player on the play.
Note: this field is expected to be 1 or 0'
TwoPointConversionPasses:
type:
- integer
- 'null'
description: 'Total successful two point conversion passes by the player
on the play. Note: this field is expected to be 1 or 0'
TwoPointConversionRuns:
type:
- integer
- 'null'
description: 'Total two point conversion rushes by the player on the play.
Note: this field is expected to be 1 or 0'
TwoPointConversionReceptions:
type:
- integer
- 'null'
description: 'Total successful two point conversion receptions by the player
on the play. Note: this field is expected to be 1 or 0'
TwoPointConversionReturns:
type:
- integer
- 'null'
description: 'Total successful two point conversion returns by the player
on the play. Note: this field is expected to be 1 or 0'
SoloTackles:
type:
- integer
- 'null'
description: 'Total defensive solo (unassisted) tackles by the player on
the play. Note: this field is expected to be 1 or 0'
AssistedTackles:
type:
- integer
- 'null'
description: Total defensive assisted tackles by the player on the play
TacklesForLoss:
type:
- integer
- 'null'
description: 'Tackles for loss of yards by the player on the play. Note:
These are tackles behind the line of scrimmage for loss of yards (including
sacks) - also this field is expected to be 1 or 0'
Sacks:
type:
- number
- 'null'
description: 'Total Sacks by this player on the play. Note: this field is
expected to be 1 or 0'
SackYards:
type:
- number
- 'null'
description: Total sack yards by this player on the play
PassesDefended:
type:
- integer
- 'null'
description: Total passes defended by the player on the play
Safeties:
type:
- integer
- 'null'
description: 'Total defensive safeties by the player on the play. Note:
this field is expected to be 1 or 0'
FumblesForced:
type:
- integer
- 'null'
description: Fumbles forced by the player on the play
FumblesRecovered:
type:
- integer
- 'null'
description: Defensive fumbles recovered by the player on the play
FumbleReturnYards:
type:
- integer
- 'null'
description: Fumble recoveries returned yards by the player on the play
FumbleReturnTouchdowns:
type:
- integer
- 'null'
description: Fumble recoveries returned for touchdowns by the player on
the play
Interceptions:
type:
- integer
- 'null'
description: Interceptions by the player on the play
InterceptionReturnYards:
type:
- integer
- 'null'
description: Interception return yards by the player on the play
InterceptionReturnTouchdowns:
type:
- integer
- 'null'
description: Interception return touchdowns by the player on the play
PuntReturns:
type:
- integer
- 'null'
description: Total punts returned by the player on the play
PuntReturnYards:
type:
- integer
- 'null'
description: Total punt return yards by the player on the play
PuntReturnTouchdowns:
type:
- integer
- 'null'
description: 'Punt returns for touchdowns by the player on the play. Note:
this field is expected to be 1 or 0'
KickReturns:
type:
- integer
- 'null'
description: Kicks returned by the player on the play
KickReturnYards:
type:
- integer
- 'null'
description: Kicks return yards by the player on the play
KickReturnTouchdowns:
type:
- integer
- 'null'
description: Kicks returned for touchdowns by the player on the play
BlockedKicks:
type:
- integer
- 'null'
description: 'Blocked kicks by the player on the play. Note: BlockedKicks
include Field Goals and Punts but NOT Extra Points'
BlockedKickReturns:
type:
- integer
- 'null'
description: Blocked kick recovery returns by the player on the play
BlockedKickReturnYards:
type:
- integer
- 'null'
description: Blocked kick recovery return yards by the player on the play
BlockedKickReturnTouchdowns:
type:
- integer
- 'null'
description: Blocked kick recovery return touchdowns by the player on the
play
FieldGoalReturns:
type:
- integer
- 'null'
description: Field goal returns by the player on the play
FieldGoalReturnYards:
type:
- integer
- 'null'
description: 'Field goal return yards by the player on the play. Note: This
field excludes blocked field goals'
FieldGoalReturnTouchdowns:
type:
- integer
- 'null'
description: 'Field goal return touchdowns by the player on the play. Note:
This field excludes blocked field goals'
Kickoffs:
type:
- integer
- 'null'
description: Total kickoffs by this player on the play
KickoffYards:
type:
- integer
- 'null'
description: Gross kickoff yards by the player on the play
KickoffTouchbacks:
type:
- integer
- 'null'
description: Kickoff touchbacks by the player on the play
Punts:
type:
- integer
- 'null'
description: 'Total number of punts by the player on the play. Note: this
field is expected to be 1 or 0'
PuntYards:
type:
- integer
- 'null'
description: Total gross punt yards by the player on the play
PuntTouchbacks:
type:
- integer
- 'null'
description: 'Total punt touchbacks by the player on the play. Note: this
field is expected to be either 1 or 0'
PuntsHadBlocked:
type:
- integer
- 'null'
description: 'Total punts by the player that were blocked on the play. Note:
this field is expected to be 1 or 0'
FieldGoalsAttempted:
type:
- integer
- 'null'
description: Field goals attempted by the player on the play
FieldGoalsMade:
type:
- integer
- 'null'
description: Field goals made by the player on the play
FieldGoalsYards:
type:
- integer
- 'null'
description: Field goal yards attempted by the player on the play
FieldGoalsHadBlocked:
type:
- integer
- 'null'
description: Field goals attempted by the player that were blocked on the
play
ExtraPointsAttempted:
type:
- integer
- 'null'
description: Extra points attempted by the player on the play
ExtraPointsMade:
type:
- integer
- 'null'
description: Extra points made by the player on the play
ExtraPointsHadBlocked:
type:
- integer
- 'null'
description: Extra point attempts by the player that were blocked on the
play
Penalties:
type:
- integer
- 'null'
description: 'Indicates the number of penalties against a player on a play.
Note: This serves as a placeholder for data intended to be added in the
future'
PenaltyYards:
type:
- integer
- 'null'
description: Total penalty yards enforced against the player on the play
Headshot:
properties:
PlayerID:
type: integer
description: 'The unique PlayerID of the player 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 team
Position:
type:
- string
- 'null'
description: 'The primary position of the player. Possible Values: C; CB;
DB; DE; DL; DT; FB; FS; G; ILB; K; KR; LB; LS; NT; OL; OLB; OT; P; QB;
RB; S; SS; T; TE; WR'
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: []