openapi: 3.1.0
info:
title: MLB MLB v3 Headshots NFL v3 Stats 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 Stats
paths:
/v3/nfl/stats/{format}/PlayerGameStatsDelta/{minutes}:
get:
description: This method returns all player game stats, but only returns player stats that have changed in the last X minutes as specified in your API call. By definition this is a live endpoint, not final.
operationId: nfl_v3_stats_player_game_stats_delta
summary: Player Game Stats Delta
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: minutes
in: path
description: "\n Only returns player statistics that have changed in the last X minutes. You specify how many minutes in time to go back. Valid entries are:\n <code>1</code> or <code>2</code>.\n "
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PlayerGame'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/FantasyDefenseByGame/{season}/{week}:
get:
description: Returns stats and fantasy points for a given game for the fantasy defense team (not IDP.)
operationId: nfl_v3_stats_fantasy_defense_game_stats___all
summary: Fantasy Defense Game Stats - All
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
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 <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/FantasyDefenseGame'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/FantasyDefenseBySeason/{season}:
get:
description: Returns stats and fantasy points for a given season for the fantasy defense team (not IDP.)
operationId: nfl_v3_stats_fantasy_defense_season_stats___all
summary: Fantasy Defense Season Stats - All
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
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 <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/FantasyDefenseSeason'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/Injuries/{season}/{week}:
get:
description: A list of all injured players and a description of their injuries.
operationId: nfl_v3_stats_injuries___all
summary: Injuries - All
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
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 <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/Injury'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/Injuries/{season}/{week}/{team}:
get:
description: A list of all injured players on a specified team and a description of their injuries.
operationId: nfl_v3_stats_injuries___by_team
summary: Injuries - by Team
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
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 <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
- 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/Injury'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/PlayerGameStatsByTeam/{season}/{week}/{team}:
get:
description: Returns the box score statistical record for all involved players across a given team's game in a given week, updated live as the game takes place.
operationId: nfl_v3_stats_player_game_stats___by_team__live___final
summary: Player Game Stats - by Team [Live & Final]
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
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 <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
- 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/PlayerGame'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/PlayerGameStatsByWeekDelta/{season}/{week}/{minutes}:
get:
description: This method returns all player scores for a given season and week, but only returns player stats that have changed in the last X minutes as specified in your API call. Ideal for live applications.
operationId: nfl_v3_stats_player_game_stats_delta___by_week
summary: Player Game Stats Delta - by Week
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
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 <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
- name: minutes
in: path
description: "Only returns player statistics that have changed in the last X minutes. You specify how many minutes in time to go back. Valid entries are:<br>\n <code>1</code> or <code>2</code>.\n "
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PlayerGame'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/PlayerSeasonStatsByTeam/{season}/{team}:
get:
description: Returns all season-long stats (i.e. the season total, not each individual game record) for a given team's players in a given season.
operationId: nfl_v3_stats_player_season_stats___by_team
summary: Player Season Stats - by Team
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
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 <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/PlayerSeason'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/PlayerGameStatsByWeek/{season}/{week}:
get:
description: Returns the box score statistical record for all involved players across a given week, updated live as the game takes place.
operationId: nfl_v3_stats_player_game_stats___by_week__live___final
summary: Player Game Stats - by Week [Live & Final]
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
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 <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/PlayerGame'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/PlayerSeasonStats/{season}:
get:
description: Returns all season-long stats (i.e. the season total, not each individual game record) for all players for a given season.
operationId: nfl_v3_stats_player_season_stats
summary: Player Season Stats
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
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 <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/PlayerSeason'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/FantasyDefenseByGameByTeam/{season}/{week}/{team}:
get:
description: Returns stats and fantasy points for a given team's game for the fantasy defense team (not IDP.)
operationId: nfl_v3_stats_fantasy_defense_game_stats___by_team
summary: Fantasy Defense Game Stats - by Team
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <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:
$ref: '#/components/schemas/FantasyDefenseGame'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/FantasyDefenseBySeasonByTeam/{season}/{team}:
get:
description: Returns stats and fantasy points for a given team and season for the fantasy defense team (not IDP.)
operationId: nfl_v3_stats_fantasy_defense_season_stats___by_team
summary: Fantasy Defense Season Stats - by Team
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <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:
$ref: '#/components/schemas/FantasyDefenseSeason'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/PlayerSeasonRedZoneStats/{season}:
get:
description: Delivers all offensive stats within the red zone (within the 20-yard line of the defensive team) for all players in a given season (i.e. the season total, not each individual game record.)
operationId: nfl_v3_stats_player_season_red_zone_stats
summary: Player Season Red Zone Stats
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <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/PlayerSeasonRedZone'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/PlayerSeasonThirdDownStats/{season}:
get:
description: Returns all season-long stats (i.e. the season total, not each individual game record) for all players on the third down for a given season.
operationId: nfl_v3_stats_player_season_third_down_stats
summary: Player Season Third Down Stats
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
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 <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/PlayerSeasonThirdDown'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/BoxScoresDeltaV3/{season}/{week}/{playerstoinclude}/{minutes}:
get:
description: This method returns all box scores for a given season and week, but only returns player stats that have changed in the last X minutes as specified in your API call. You can also filter by type of player stats to include, such as traditional fantasy players, IDP players or all players. by definition this is a live endpoint, not final.
operationId: nfl_v3_stats_box_scores_delta___by_week
summary: Box Scores Delta - by Week
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <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: playerstoinclude
in: path
description: 'The subcategory of players to include in the returned PlayerGame records. Possible values include:<br><br>
<code>all</code> Returns all players<br>
<code>fantasy</code> Returns traditional fantasy players (QB, RB, WR, TE, K, DST)<br>
<code>idp</code> Returns traditional fantasy players and IDP players.'
required: true
schema:
type: string
enum:
- all
- fantasy
- idp
default: all
- name: minutes
in: path
description: "Only returns player statistics that have changed in the last X minutes. You specify how many minutes in time to go back. Valid entries are:<br><code>1</code>,\n <code>2</code>, etc.\n "
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BoxScoreV3'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/BoxScoreV3/{season}/{week}/{hometeam}:
get:
description: Full statistical information for a specified game, down to the team and player stat level, delivered live during the game, called for a given team's game in a given week and season.
operationId: nfl_v3_stats_box_score___by_team__live___final
summary: Box Score - by Team [Live & Final]
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <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: hometeam
in: path
description: 'Abbreviation of a team playing in this game. Example: <code>WAS</code>.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/BoxScoreV3'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/BoxScoreByScoreIDV3/{scoreid}:
get:
description: Full statistical information for a specified game, down to the team and player stat level, delivered live during the game, called per individual game.
operationId: nfl_v3_stats_box_score__live___final
summary: Box Score [Live & Final]
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: scoreid
in: path
description: 'The ScoreID of the game. Possible values include: <code>16247</code>, <code>16245</code>, etc.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/BoxScoreV3'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/PlayerOwnership/{season}/{week}:
get:
description: Projected fantasy ownership of all players for a given season.
operationId: nfl_v3_stats_fantasy_player_ownership_percentages__season_long____by_week
summary: Fantasy Player Ownership Percentages (Season-Long) - by Week
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <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/PlayerOwnership'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/PlayerGameRedZoneStats/{season}/{week}:
get:
description: Delivers all offensive stats within the red zone (within the 20-yard line of the defensive team) for all players in a given season or week.
operationId: nfl_v3_stats_player_game_red_zone_stats
summary: Player Game Red Zone Stats
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <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/PlayerGameRedZone'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- NFL v3 Stats
/v3/nfl/stats/{format}/ProBowlers/{season}:
get:
description: A list of players involved in the Pro Bowl, by season.
operationId: nfl_v3_stats_pro_bow
# --- truncated at 32 KB (278 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/sportsdataio/refs/heads/main/openapi/sportsdataio-nfl-v3-stats-api-openapi.yml