openapi: 3.1.0
info:
title: MLB MLB v3 Headshots NFL v3 Scores API
version: '1.0'
description: MLB API - OpenAPI 3.1 Specification
servers:
- url: https://api.sportsdata.io
description: Production server
security:
- apiKeyHeader: []
- apiKeyQuery: []
tags:
- name: NFL v3 Scores
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
components:
schemas:
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.
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
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.
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
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
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.
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
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
Unauthorized:
properties:
HttpStatusCode:
type: integer
Code:
type: integer
Description:
type: string
Help:
type: string
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
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
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)
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)
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)
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)'
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
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
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.
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
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.
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.
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)
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.
securitySchemes:
apiKeyHeader:
type: apiKey
name: Ocp-Apim-Subscription-Key
in: header
apiKeyQuery:
type: apiKey
name: key
in: query