openapi: 3.1.0
info:
title: MLB MLB v3 Headshots NFL v3 Projections 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 Projections
paths:
/v3/nfl/projections/{format}/FantasyDefenseProjectionsBySeason/{season}:
get:
description: SportsDataIO's proprietary projections, including average draft position, for all fantasy defense teams for the season. Does not contain Individual Defensive Players (IDP), which have their own endpoint.
operationId: nfl_v3_projections_projected_fantasy_defense_season_stats_with_adp
summary: Projected Fantasy Defense Season Stats With ADP
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: season
in: path
description: "Year of the season and the season type. If no season type is provided, then the default is regular season.\n <br>Examples: <code>2015REG</code>, <code>2015PRE</code>, <code>2015POST</code>.\n "
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/FantasyDefenseSeasonProjection'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Projections
/v3/nfl/projections/{format}/FantasyDefenseProjectionsByGame/{season}/{week}:
get:
description: SportsDataIO's proprietary projections, including DFS salary information, for all fantasy defense teams. Called by season and week. Does not contain Individual Defensive Players (IDP), which have their own endpoint.
operationId: nfl_v3_projections_projected_fantasy_defense_game_stats_with_dfs_salaries
summary: Projected Fantasy Defense Game Stats With DFS Salaries
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: season
in: path
description: "Year of the season and the season type. If no season type is provided, then the default is regular season.\n <br>Examples: <code>2015REG</code>, <code>2015PRE</code>, <code>2015POST</code>.\n "
required: true
schema:
type: string
- name: week
in: path
description: "Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.\n Example: <code>1</code>\n "
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/FantasyDefenseGameProjection'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Projections
/v3/nfl/projections/{format}/PlayerGameProjectionStatsByTeam/{season}/{week}/{team}:
get:
description: SportsDataIO's proprietary projections, including DFS salary information and injuries, for fantasy players, for a given game, called by team.
operationId: nfl_v3_projections_projected_player_game_stats___by_team
summary: Projected Player Game Stats - by Team
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: season
in: path
description: "Year of the season and the season type. If no season type is provided, then the default is regular season.\n <br>Examples: <code>2015REG</code>, <code>2015PRE</code>, <code>2015POST</code>.\n "
required: true
schema:
type: string
- name: week
in: path
description: "Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.\n Example: <code>1</code>\n "
required: true
schema:
type: string
- name: team
in: path
description: 'Abbreviation of the team. Example: <code>WAS</code>.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PlayerGameProjection'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Projections
/v3/nfl/projections/{format}/PlayerSeasonProjectionStats/{season}:
get:
description: SportsDataIO's proprietary projections on a season-long basis, including Average Draft Position (ADP), for fantasy players, for a given season.
operationId: nfl_v3_projections_projected_player_season_stats_with_adp
summary: Projected Player Season Stats With ADP
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: season
in: path
description: "Year of the season and the season type. If no season type is provided, then the default is regular season.\n <br>Examples: <code>2015REG</code>, <code>2015PRE</code>, <code>2015POST</code>.\n "
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PlayerSeasonProjection'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Projections
/v3/nfl/projections/{format}/PlayerSeasonProjectionStatsByTeam/{season}/{team}:
get:
description: SportsDataIO's proprietary projections on a season-long basis, including ADP, for fantasy players, for a given season and team.
operationId: nfl_v3_projections_projected_player_season_stats_with_adp___by_team
summary: Projected Player Season Stats With ADP - by Team
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: season
in: path
description: "Year of the season and the season type. If no season type is provided, then the default is regular season.\n <br>Examples: <code>2015REG</code>, <code>2015PRE</code>, <code>2015POST</code>.\n "
required: true
schema:
type: string
- name: team
in: path
description: 'Abbreviation of the team. Example: <code>WAS</code>.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PlayerSeasonProjection'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Projections
/v3/nfl/projections/{format}/PlayerGameProjectionStatsByWeek/{season}/{week}:
get:
description: SportsDataIO's proprietary projections, including DFS salary information and injuries, for fantasy players, called by week.
operationId: nfl_v3_projections_projected_player_game_stats___by_week
summary: Projected Player Game Stats - by Week
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: season
in: path
description: "Year of the season and the season type. If no season type is provided, then the default is regular season.\n <br>Examples: <code>2015REG</code>, <code>2015PRE</code>, <code>2015POST</code>.\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: <code>1</code>\n "
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PlayerGameProjection'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Projections
/v3/nfl/projections/{format}/DfsSlatesByDate/{date}:
get:
description: Returns DFS slates, including eligible games, positions, captain mode, players and salaries, for a given date.
operationId: nfl_v3_projections_dfs_slates___by_date
summary: DFS Slates - by Date
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: date
in: path
description: 'The date of the slates.
<br>Examples: <code>2017-SEP-25</code>, <code>2017-10-31</code>.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/DfsSlate'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Projections
/v3/nfl/projections/{format}/DfsSlatesByWeek/{season}/{week}:
get:
description: Returns DFS slates, including eligible games, positions, captain mode, players and salaries, for a given week.
operationId: nfl_v3_projections_dfs_slates___by_week
summary: DFS Slates - by Week
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: season
in: path
description: "Year of the season and the season type. If no season type is provided, then the default is regular season.\n <br>Examples: <code>2015REG</code>, <code>2015PRE</code>, <code>2015POST</code>"
required: true
schema:
type: string
- name: week
in: path
description: "Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.\n Example: <code>1</code>"
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/DfsSlate'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Projections
/v3/nfl/projections/{format}/IdpPlayerGameProjectionStatsByWeek/{season}/{week}:
get:
description: Individual Defensive Player (IDP stats, including DFS salary information and injuries, for fantasy players, called by week.
operationId: nfl_v3_projections_idp_projected_player_game_stats___by_week
summary: IDP Projected Player Game Stats - by Week
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: season
in: path
description: "Year of the season and the season type. If no season type is provided, then the default is regular season.\n <br>Examples: <code>2015REG</code>, <code>2015PRE</code>, <code>2015POST</code>.\n "
required: true
schema:
type: string
- name: week
in: path
description: "Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.\n Example: <code>1</code>\n "
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PlayerGameProjection'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Projections
/v3/nfl/projections/{format}/IdpPlayerGameProjectionStatsByTeam/{season}/{week}/{team}:
get:
description: Individual Defensive Player (IDP stats, including DFS salary information and injuries, for fantasy players, called by team.
operationId: nfl_v3_projections_idp_projected_player_game_stats___by_team
summary: IDP Projected Player Game Stats - by Team
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: season
in: path
description: "Year of the season and the season type. If no season type is provided, then the default is regular season.\n <br>Examples: <code>2015REG</code>, <code>2015PRE</code>, <code>2015POST</code>.\n "
required: true
schema:
type: string
- name: week
in: path
description: "Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.\n Example: <code>1</code>\n "
required: true
schema:
type: string
- name: team
in: path
description: 'Abbreviation of the team. Example: <code>WAS</code>.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PlayerGameProjection'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Projections
/v3/nfl/projections/{format}/UpcomingDfsSlateOwnershipProjections:
get:
description: Returns DFS Slates which have not yet started for which we have DFS Ownership projections.
operationId: nfl_v3_projections_dfs_slate_ownership_projections___upcoming
summary: DFS Slate Ownership Projections - Upcoming
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/DfsSlateWithOwnershipProjection'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Projections
/v3/nfl/projections/{format}/DfsSlateOwnershipProjectionsBySlateID/{slateId}:
get:
description: Slate Ownership Projections for a specific slate. Projections are for Guaranteed Prize Pool (GPP) format ownership. Will return an empty list if the slate is not yet projected or not a slate we have projections for.
operationId: nfl_v3_projections_dfs_slate_ownership_projections___by_slate
summary: DFS Slate Ownership Projections - by Slate
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: slateId
in: path
description: SlateID of the DFS Slate you wish to get ownership projections for. Will have an empty SlateOwnershipProjections if this slate was not projected
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/DfsSlateWithOwnershipProjection'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Projections
/v3/nfl/projections/{format}/InjuredPlayers:
get:
description: This endpoint provides all currently injured NFL players, along with injury details.
operationId: nfl_v3_projections_player_details___by_injured
summary: Player Details - by Injured
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Player'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Projections
components:
schemas:
FantasyDefenseGameProjection:
properties:
GameKey:
type:
- string
- 'null'
description: 'A 9 digit unique code identifying the game that this record corresponds to. The GameID is composed of Season; SeasonType; Week and HomeTeam. Note: This value will be NULL for bye weeks'
SeasonType:
type: integer
description: The type of season that this player corresponds to (1=Regular Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star)
Season:
type: integer
description: The NFL season of the game
Week:
type:
- integer
- 'null'
description: 'The NFL week of the game (regular season: 1 to 18; preseason: 0 to 4; postseason: 1 to 4). Note: seasons after 2021 will have only 3 preseason weeks'
Date:
type:
- string
- 'null'
description: The date and time of the game (in US Eastern Time)
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
Opponent:
type:
- string
- 'null'
description: The abbreviation [Key] of the opponent team
PointsAllowed:
type: number
description: Total points allowed by the team during the game
TouchdownsScored:
type: number
description: Total defensive and special teams touchdowns scored by the team in the game
SoloTackles:
type: number
description: Total defensive solo (unassisted) tackles by the team in the game
AssistedTackles:
type: number
description: Total defensive assisted tackles by the team in the game
Sacks:
type: number
description: Total defensive sacks by the team in the game
SackYards:
type: number
description: Total defensive sack yards by the team in the game
PassesDefended:
type: number
description: Total passes defended by the team in the game
FumblesForced:
type: number
description: Total fumbles forced on defense by the team in the game
FumblesRecovered:
type: number
description: Total defensive fumble recoveries by the team in the game
FumbleReturnYards:
type: number
description: Total fumble return yards by the team in the game
FumbleReturnTouchdowns:
type: number
description: Total fumble return touchdowns by the team in the game
Interceptions:
type: number
description: Total defensive interceptions by the team in the game
InterceptionReturnYards:
type: number
description: Total defensive interception return yards by the team in the game
InterceptionReturnTouchdowns:
type: number
description: Total defensive interception return touchdowns by the team in the game
BlockedKicks:
type: number
description: 'Total blocked kicks by team in the game. Note: BlockedKicks include Field Goals and Punts but NOT Extra Points'
Safeties:
type: number
description: Total defensive safeties scored by the team in the game
PuntReturns:
type: number
description: Total punt returns by the team in the game
PuntReturnYards:
type: number
description: Total punt return yards by the team in the game
PuntReturnTouchdowns:
type: number
description: Total punt return touchdowns by the team in the game
PuntReturnLong:
type: number
description: The longest punt return by the team in the game
KickReturns:
type: number
description: Total kickoff returns by the team in the game
KickReturnYards:
type: number
description: Total kickoff return yards by the team in the game
KickReturnTouchdowns:
type: number
description: Total kickoff return touchdowns by the team in the game
KickReturnLong:
type: number
description: Longest kick return by the team in the game
BlockedKickReturnTouchdowns:
type:
- number
- 'null'
description: Total blocked kick recovery return touchdowns for the team in the game
FieldGoalReturnTouchdowns:
type:
- number
- 'null'
description: 'Total field goal return touchdowns by the team in the game. Note: This field excludes blocked field goals'
FantasyPointsAllowed:
type:
- number
- 'null'
description: 'Fantasy points allowed to opposing offensive players in the season. Note: positions include: QB; RB; WR; TE'
QuarterbackFantasyPointsAllowed:
type:
- number
- 'null'
description: Fantasy points allowed to opposing quarterbacks by the team in the game
RunningbackFantasyPointsAllowed:
type:
- number
- 'null'
description: Total fantasy points allowed to opposing running backs by the team in the game
WideReceiverFantasyPointsAllowed:
type:
- number
- 'null'
description: Fantasy points allowed to opposing wide receivers
TightEndFantasyPointsAllowed:
type:
- number
- 'null'
description: Fantasy points allowed to opposing tight ends by the team in the game
KickerFantasyPointsAllowed:
type:
- number
- 'null'
description: Fantasy points allowed to opponent kickers by the team in the game
BlockedKickReturnYards:
type:
- number
- 'null'
description: Total blocked kick recovery return yards for the team in the game
FieldGoalReturnYards:
type:
- number
- 'null'
description: 'Total field goal return yards by the team in the game. Note: This field excludes blocked field goals'
QuarterbackHits:
type:
- number
- 'null'
description: 'Total quarterback hits by the team in the game. Note: This is a defensive stat that includes sacks'
TacklesForLoss:
type:
- number
- 'null'
description: 'Total tackles for loss by the team in the game. Note: These are tackles behind the line of scrimmage for loss of yards (including sacks)'
DefensiveTouchdowns:
type:
- number
- 'null'
description: Total touchdowns scored by the defense
SpecialTeamsTouchdowns:
type:
- number
- 'null'
description: Total special teams touchdowns scored by the team in the game
IsGameOver:
type:
- boolean
- 'null'
description: Whether the game is over (true/false)
FantasyPoints:
type:
- number
- 'null'
description: Fantasy points scored based on basic fantasy scoring system by the team's D/ST in the game
Stadium:
type:
- string
- 'null'
description: Stadium of the event
Temperature:
type:
- integer
- 'null'
description: Temperature at game start (Fahrenheit)
Humidity:
type:
- integer
- 'null'
description: The humidity percentage at the start of the game
WindSpeed:
type:
- integer
- 'null'
description: The wind speed at the start of the game (in MPH)
ThirdDownAttempts:
type:
- number
- 'null'
description: Total third down attempts against the team in the game
ThirdDownConversions:
type:
- number
- 'null'
description: Total third down conversions against the team in the game
FourthDownAttempts:
type:
- number
- 'null'
description: Opponent's fourth down attempts against the team in the game
FourthDownConversions:
type:
- number
- 'null'
description: Opponent's fourth down conversions against the team in the game
PointsAllowedByDefenseSpecialTeams:
type:
- number
- 'null'
description: 'Total number of points allowed by the team in the game to the opposing offense and special teams. Note: This field excludes points scored by the opponent''s defense'
FanDuelSalary:
type:
- integer
- 'null'
description: The team's D/ST salary for FanDuel daily fantasy contests
DraftKingsSalary:
type:
- integer
- 'null'
description: The team's D/ST salary for DraftKings daily fantasy contests.
FantasyDataSalary:
type:
- integer
- 'null'
description: The team's D/ST salary as calculated by SportsDataIO (formerly known as FantasyData). Based on the same salary cap as DraftKings contests ($50,000)
VictivSalary:
type:
- integer
- 'null'
description: The player's salary for Victiv daily fantasy contests.
TwoPointConversionReturns:
type:
- number
- 'null'
description: Total successful two point conversion returns by the team in the game
FantasyPointsFanDuel:
type:
- number
- 'null'
description: Fantasy points based on FanDuel's scoring system by the team in the game
FantasyPointsDraftKings:
type:
- number
- 'null'
description: Fantasy points based on DraftKings' scoring system by the team in the game
OffensiveYardsAllowed:
type:
- number
- 'null'
description: Offensive yards allowed by the team's defense in the game
YahooSalary:
type:
- integer
- 'null'
description: The player's salary for Yahoo daily fantasy contests
PlayerID:
type:
- integer
- 'null'
description: 'The unique PlayerID of the player as assigned by SportsDataIO for use when combining with player feeds. Note: this ID will stay with the player throughout their entire career'
FantasyPointsYahoo:
type:
- number
- 'null'
description: Fantasy points based on Yahoo's daily fantasy scoring system by the team in the game
HomeOrAway:
type:
- string
- 'null'
description: Whether the team is home or away
OpponentRank:
type:
- integer
- 'null'
description: The ranking of the opposing team's offense with regards to fantasy points allowed to fantasy DST
OpponentPositionRank:
type:
- integer
- 'null'
description: The ranking of the opposing team's offense with regards to fantasy points allowed to fantasy DST
FantasyDraftSalary:
type:
- integer
- 'null'
description: The team's D/ST salary for FantasyDraft daily fantasy contests.
TeamID:
type:
- integer
- 'null'
description: The unique ID of the team
OpponentID:
type:
- integer
- 'null'
description: The unique ID of this opponent team
Day:
type:
- string
- 'null'
description: The date of the game (in US Eastern Time)
DateTime:
type:
- string
# --- truncated at 32 KB (133 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/sportsdataio/refs/heads/main/openapi/sportsdataio-nfl-v3-projections-api-openapi.yml