Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.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:
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 <a href="https://support.sportsdata.io/hc/en-us/articles/14287629964567-Process-Guide-Game-Status" target="_blank">here.</a> For how suspended and postponed games are handled specifically, see <a href="https://support.sportsdata.io/hc/en-us/articles/4404845580567-Postponed-and-Rescheduled-Games" target="_blank">here</a>.
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)
FantasyDefenseSeasonProjection:
properties:
SeasonType:
type: integer
description: The type of season that this team corresponds to (1=Regular Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star)
Season:
type: integer
description: The NFL regular season for which these totals apply
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
PointsAllowed:
type: number
description: Total points allowed by the team during the season
TouchdownsScored:
type: number
description: Total defensive and special teams touchdowns scored by the team in the season
SoloTackles:
type: number
description: Total defensive solo (unassisted) tackles by the team in the season
AssistedTackles:
type: number
description: Total defensive assisted tackles by the team in the season
Sacks:
type: number
description: Total defensive sacks by the team in the season
SackYards:
type: number
description: Total defensive sack yards by the team in the season
PassesDefended:
type: number
description: Total passes defended by the team in the season
FumblesForced:
type: number
description: Total fumbles forced on defense by the team in the season
FumblesRecovered:
type: number
description: Total defensive fumble recoveries by the team in the season
FumbleReturnYards:
type: number
description: Total fumble return yards by the team in the season
FumbleReturnTouchdowns:
type: number
description: Total fumble return touchdowns by the team in the season
Interceptions:
type: number
description: Total defensive interceptions by the team in the season
InterceptionReturnYards:
type: number
description: Total defensive interception return yards by the team in the season
InterceptionReturnTouchdowns:
type: number
description: Total defensive interception return touchdowns by the team in the season
BlockedKicks:
type: number
description: 'Total blocked kicks by the team in the season. Note: BlockedKicks include Field Goals and Punts but NOT Extra Points'
Safeties:
type: number
description: Total defensive safeties scored by the team in the season
PuntReturns:
type: number
description: Total punt returns by the team in the season
PuntReturnYards:
type: number
description: Total punt return yards by the team in the season
PuntReturnTouchdowns:
type: number
description: Total punt return touchdowns by the team in the season
PuntReturnLong:
type: number
description: The longest punt return by the team in the season
KickReturns:
type: number
description: Total kickoff returns by the team in the season
KickReturnYards:
type: number
description: Total kickoff return yards by the team in the season
KickReturnTouchdowns:
type: number
description: Total kickoff return touchdowns by the team in the season
KickReturnLong:
type: number
description: Longest kick return by the team in the season
BlockedKickReturnTouchdowns:
type:
- number
- 'null'
description: Total blocked kick recovery return touchdowns for the team in the season
FieldGoalReturnTouchdowns:
type:
- number
- 'null'
description: 'Total field goal return touchdowns by the team in the season. Note: This field excludes blocked field goals'
FantasyPointsAllowed:
type:
- number
- 'null'
description: 'Fantasy points allowed to opposing offensive players in the season. Note: positions include: QB; RB; WR; TE'
QuarterbackFantasyPointsAllowed:
type:
- number
- 'null'
description: Fantasy points allowed to opposing quarterbacks by the team in the season
RunningbackFantasyPointsAllowed:
type:
- number
- 'null'
description: Total fantasy points allowed to opposing running backs by the team in the season
WideReceiverFantasyPointsAllowed:
type:
- number
- 'null'
description: Fantasy points allowed to opposing wide receivers
TightEndFantasyPointsAllowed:
type:
- number
- 'null'
description: Fantasy points allowed to opposing tight ends by the team in the season
KickerFantasyPointsAllowed:
type:
- number
- 'null'
description: Fantasy points allowed to opponent kickers by the team in the season
Games:
type:
- integer
- 'null'
description: The total number of games played by the team in the season
BlockedKickReturnYards:
type:
- number
- 'null'
description: Total blocked kick recovery return yards for the team in the season
FieldGoalReturnYards:
type:
- number
- 'null'
description: 'Total field goal return yards by the team in the season. Note: This field excludes blocked field goals'
QuarterbackHits:
type:
- number
- 'null'
description: 'Total quarterback hits by the team in the season. Note: This is a defensive stat that includes sacks'
TacklesForLoss:
type:
- number
- 'null'
description: 'Total tackles for loss by the team in the season. Note: these are tackles behind the line of scrimmage for loss of yards (including sacks)'
DefensiveTouchdowns:
type:
- number
- 'null'
description: Total defensive touchdowns scored by the team in the season
SpecialTeamsTouchdowns:
type:
- number
- 'null'
description: Total special teams touchdowns scored by the team in the season
FantasyPoints:
type:
- number
- 'null'
description: F
# --- 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