naftiko: 1.0.0-alpha2
info:
label: NFL API — NFL v3 Stats
description: 'NFL API — NFL v3 Stats. 34 operations. Lead operation: Box Score [Live & Final]. Self-contained Naftiko capability
covering one Sportsdataio business surface.'
tags:
- Sportsdataio
- NFL v3 Stats
created: '2026-05-19'
modified: '2026-05-19'
binds:
- namespace: env
keys:
SPORTSDATAIO_API_KEY: SPORTSDATAIO_API_KEY
capability:
consumes:
- type: http
namespace: nfl-nfl-v3-stats
baseUri: https://api.sportsdata.io
description: NFL API — NFL v3 Stats business capability. Self-contained, no shared references.
resources:
- name: v3-nfl-stats-format-BoxScoreByScoreIDV3-scoreid
path: /v3/nfl/stats/{format}/BoxScoreByScoreIDV3/{scoreid}
operations:
- name: nflv3statsboxscorelivefinal
method: GET
description: Box Score [Live & Final]
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: scoreid
in: path
type: string
description: 'The ScoreID of the game. Possible values include: <code>16247</code>, <code>16245</code>, etc.'
required: true
- name: v3-nfl-stats-format-BoxScoreByTeamFinal-season-week-hometeam
path: /v3/nfl/stats/{format}/BoxScoreByTeamFinal/{season}/{week}/{hometeam}
operations:
- name: nflv3statsboxscorebyteamfinal
method: GET
description: Box Score - by Team [Final]
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: season
in: path
type: string
description: Year of the season and the season type. If no season type is provided, then the default is regular
season.
required: true
- name: week
in: path
type: string
description: 'Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason
1 to 4.'
required: true
- name: hometeam
in: path
type: string
description: 'Abbreviation of a team playing in this game. Example: <code>WAS</code>.'
required: true
- name: v3-nfl-stats-format-BoxScoreFinal-scoreid
path: /v3/nfl/stats/{format}/BoxScoreFinal/{scoreid}
operations:
- name: nflv3statsboxscorefinal
method: GET
description: Box Score [Final]
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: scoreid
in: path
type: string
description: 'The ScoreID of the game. Possible values include: <code>16247</code>, <code>16245</code>, etc.'
required: true
- name: v3-nfl-stats-format-BoxScoreV3-season-week-hometeam
path: /v3/nfl/stats/{format}/BoxScoreV3/{season}/{week}/{hometeam}
operations:
- name: nflv3statsboxscorebyteamlivefinal
method: GET
description: Box Score - by Team [Live & Final]
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: season
in: path
type: string
description: Year of the season and the season type. If no season type is provided, then the default is regular
season.
required: true
- name: week
in: path
type: string
description: 'Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason
1 to 4.'
required: true
- name: hometeam
in: path
type: string
description: 'Abbreviation of a team playing in this game. Example: <code>WAS</code>.'
required: true
- name: v3-nfl-stats-format-BoxScoresDeltaV3-season-week-playerstoinclude-minutes
path: /v3/nfl/stats/{format}/BoxScoresDeltaV3/{season}/{week}/{playerstoinclude}/{minutes}
operations:
- name: nflv3statsboxscoresdeltabyweek
method: GET
description: Box Scores Delta - by Week
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: season
in: path
type: string
description: Year of the season and the season type. If no season type is provided, then the default is regular
season.
required: true
- name: week
in: path
type: string
description: 'Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason
1 to 4.'
required: true
- name: playerstoinclude
in: path
type: string
description: The subcategory of players to include in the returned PlayerGame records. Possible values include:<br><br>
required: true
- name: minutes
in: path
type: string
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>,
required: true
- name: v3-nfl-stats-format-BoxScoresFinal-season-week
path: /v3/nfl/stats/{format}/BoxScoresFinal/{season}/{week}
operations:
- name: nflv3statsboxscoresbyweekfinal
method: GET
description: Box Scores - by Week [Final]
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: season
in: path
type: string
description: Year of the season and the season type. If no season type is provided, then the default is regular
season.
required: true
- name: week
in: path
type: string
description: 'Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason
1 to 4.'
required: true
- name: v3-nfl-stats-format-FantasyDefenseByGame-season-week
path: /v3/nfl/stats/{format}/FantasyDefenseByGame/{season}/{week}
operations:
- name: nflv3statsfantasydefensegamestatsall
method: GET
description: Fantasy Defense Game Stats - All
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: season
in: path
type: string
description: Year of the season and the season type. If no season type is provided, then the default is regular
season.
required: true
- name: week
in: path
type: string
description: 'Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason
1 to 4.'
required: true
- name: v3-nfl-stats-format-FantasyDefenseByGameByTeam-season-week-team
path: /v3/nfl/stats/{format}/FantasyDefenseByGameByTeam/{season}/{week}/{team}
operations:
- name: nflv3statsfantasydefensegamestatsbyteam
method: GET
description: Fantasy Defense Game Stats - by Team
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: season
in: path
type: string
description: Year of the season and the season type. If no season type is provided, then the default is regular
season.
required: true
- name: week
in: path
type: string
description: 'Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason
1 to 4.'
required: true
- name: team
in: path
type: string
description: 'Abbreviation of the team. Example: <code>WAS</code>.'
required: true
- name: v3-nfl-stats-format-FantasyDefenseBySeason-season
path: /v3/nfl/stats/{format}/FantasyDefenseBySeason/{season}
operations:
- name: nflv3statsfantasydefenseseasonstatsall
method: GET
description: Fantasy Defense Season Stats - All
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: season
in: path
type: string
description: Year of the season and the season type. If no season type is provided, then the default is regular
season.
required: true
- name: v3-nfl-stats-format-FantasyDefenseBySeasonByTeam-season-team
path: /v3/nfl/stats/{format}/FantasyDefenseBySeasonByTeam/{season}/{team}
operations:
- name: nflv3statsfantasydefenseseasonstatsbyteam
method: GET
description: Fantasy Defense Season Stats - by Team
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: season
in: path
type: string
description: Year of the season and the season type. If no season type is provided, then the default is regular
season.
required: true
- name: team
in: path
type: string
description: 'Abbreviation of the team. Example: <code>WAS</code>.'
required: true
- name: v3-nfl-stats-format-FantasyGameStatsByWeek-season-week
path: /v3/nfl/stats/{format}/FantasyGameStatsByWeek/{season}/{week}
operations:
- name: nflv3statsfantasypointsbyweek
method: GET
description: Fantasy Points - by Week
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: season
in: path
type: string
description: Year of the season and the season type. If no season type is provided, then the default is regular
season.
required: true
- name: week
in: path
type: string
description: 'Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason
1 to 4.'
required: true
- name: v3-nfl-stats-format-Injuries-season-week
path: /v3/nfl/stats/{format}/Injuries/{season}/{week}
operations:
- name: nflv3statsinjuriesall
method: GET
description: Injuries - All
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: season
in: path
type: string
description: Year of the season and the season type. If no season type is provided, then the default is regular
season.
required: true
- name: week
in: path
type: string
description: 'Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason
1 to 4.'
required: true
- name: v3-nfl-stats-format-Injuries-season-week-team
path: /v3/nfl/stats/{format}/Injuries/{season}/{week}/{team}
operations:
- name: nflv3statsinjuriesbyteam
method: GET
description: Injuries - by Team
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: season
in: path
type: string
description: Year of the season and the season type. If no season type is provided, then the default is regular
season.
required: true
- name: week
in: path
type: string
description: 'Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason
1 to 4.'
required: true
- name: team
in: path
type: string
description: 'Abbreviation of the team. Example: <code>WAS</code>.'
required: true
- name: v3-nfl-stats-format-PlayerGameRedZoneInsideFiveStats-season-week
path: /v3/nfl/stats/{format}/PlayerGameRedZoneInsideFiveStats/{season}/{week}
operations:
- name: nflv3statsplayergameredzonestatsinsidefive
method: GET
description: Player Game Red Zone Stats (Inside Five)
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: season
in: path
type: string
description: Year of the season and the season type. If no season type is provided, then the default is regular
season.
required: true
- name: week
in: path
type: string
description: 'Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason
1 to 4.'
required: true
- name: v3-nfl-stats-format-PlayerGameRedZoneInsideTenStats-season-week
path: /v3/nfl/stats/{format}/PlayerGameRedZoneInsideTenStats/{season}/{week}
operations:
- name: nflv3statsplayergameredzonestatsinsideten
method: GET
description: Player Game Red Zone Stats (Inside Ten)
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: season
in: path
type: string
description: Year of the season and the season type. If no season type is provided, then the default is regular
season.
required: true
- name: week
in: path
type: string
description: 'Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason
1 to 4.'
required: true
- name: v3-nfl-stats-format-PlayerGameRedZoneStats-season-week
path: /v3/nfl/stats/{format}/PlayerGameRedZoneStats/{season}/{week}
operations:
- name: nflv3statsplayergameredzonestats
method: GET
description: Player Game Red Zone Stats
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: season
in: path
type: string
description: Year of the season and the season type. If no season type is provided, then the default is regular
season.
required: true
- name: week
in: path
type: string
description: 'Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason
1 to 4.'
required: true
- name: v3-nfl-stats-format-PlayerGameStatsBySeason-season-playerid-numberofgames
path: /v3/nfl/stats/{format}/PlayerGameStatsBySeason/{season}/{playerid}/{numberofgames}
operations:
- name: nflv3statsplayergamelogsbyseason
method: GET
description: Player Game Logs - by Season
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: season
in: path
type: string
description: Season to get games from. Example <code>2019POST</code>, <code>2020</code>
required: true
- name: playerid
in: path
type: string
description: Unique SportsDataIO Player ID. Example:<code>17920</code>.
required: true
- name: numberofgames
in: path
type: string
description: How many games to return. Example <code>all</code>, <code>10</code>, <code>25</code>
required: true
- name: v3-nfl-stats-format-PlayerGameStatsByTeam-season-week-team
path: /v3/nfl/stats/{format}/PlayerGameStatsByTeam/{season}/{week}/{team}
operations:
- name: nflv3statsplayergamestatsbyteamlivefinal
method: GET
description: Player Game Stats - by Team [Live & Final]
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: season
in: path
type: string
description: Year of the season and the season type. If no season type is provided, then the default is regular
season.
required: true
- name: week
in: path
type: string
description: 'Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason
1 to 4.'
required: true
- name: team
in: path
type: string
description: 'Abbreviation of the team. Example: <code>WAS</code>.'
required: true
- name: v3-nfl-stats-format-PlayerGameStatsByTeamFinal-season-week-team
path: /v3/nfl/stats/{format}/PlayerGameStatsByTeamFinal/{season}/{week}/{team}
operations:
- name: nflv3statsplayergamestatsbyteamfinal
method: GET
description: Player Game Stats - by Team [Final]
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: season
in: path
type: string
description: Year of the season and the season type. If no season type is provided, then the default is regular
season.
required: true
- name: week
in: path
type: string
description: 'Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason
1 to 4.'
required: true
- name: team
in: path
type: string
description: 'Abbreviation of the team. Example: <code>WAS</code>.'
required: true
- name: v3-nfl-stats-format-PlayerGameStatsByWeek-season-week
path: /v3/nfl/stats/{format}/PlayerGameStatsByWeek/{season}/{week}
operations:
- name: nflv3statsplayergamestatsbyweeklivefinal
method: GET
description: Player Game Stats - by Week [Live & Final]
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: season
in: path
type: string
description: Year of the season and the season type. If no season type is provided, then the default is regular
season.
required: true
- name: week
in: path
type: string
description: 'Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason
1 to 4.'
required: true
- name: v3-nfl-stats-format-PlayerGameStatsByWeekDelta-season-week-minutes
path: /v3/nfl/stats/{format}/PlayerGameStatsByWeekDelta/{season}/{week}/{minutes}
operations:
- name: nflv3statsplayergamestatsdeltabyweek
method: GET
description: Player Game Stats Delta - by Week
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: season
in: path
type: string
description: Year of the season and the season type. If no season type is provided, then the default is regular
season.
required: true
- name: week
in: path
type: string
description: 'Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason
1 to 4.'
required: true
- name: minutes
in: path
type: string
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>
required: true
- name: v3-nfl-stats-format-PlayerGameStatsByWeekFinal-season-week
path: /v3/nfl/stats/{format}/PlayerGameStatsByWeekFinal/{season}/{week}
operations:
- name: nflv3statsplayergamestatsbyweekfinal
method: GET
description: Player Game Stats - by Week [Final]
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: season
in: path
type: string
description: Year of the season and the season type. If no season type is provided, then the default is regular
season.
required: true
- name: week
in: path
type: string
description: 'Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason
1 to 4.'
required: true
- name: v3-nfl-stats-format-PlayerGameStatsDelta-minutes
path: /v3/nfl/stats/{format}/PlayerGameStatsDelta/{minutes}
operations:
- name: nflv3statsplayergamestatsdelta
method: GET
description: Player Game Stats Delta
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: minutes
in: path
type: string
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:'
required: true
- name: v3-nfl-stats-format-PlayerOwnership-season-week
path: /v3/nfl/stats/{format}/PlayerOwnership/{season}/{week}
operations:
- name: nflv3statsfantasyplayerownershippercentagesseasonlongbyweek
method: GET
description: Fantasy Player Ownership Percentages (Season-Long) - by Week
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: season
in: path
type: string
description: Year of the season and the season type. If no season type is provided, then the default is regular
season.
required: true
- name: week
in: path
type: string
description: 'Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason
1 to 4.'
required: true
- name: v3-nfl-stats-format-PlayerSeasonRedZoneInsideFiveStats-season
path: /v3/nfl/stats/{format}/PlayerSeasonRedZoneInsideFiveStats/{season}
operations:
- name: nflv3statsplayerseasonredzonestatsinsidefive
method: GET
description: Player Season Red Zone Stats (Inside Five)
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: season
in: path
type: string
description: Year of the season and the season type. If no season type is provided, then the default is regular
season.
required: true
- name: v3-nfl-stats-format-PlayerSeasonRedZoneInsideTenStats-season
path: /v3/nfl/stats/{format}/PlayerSeasonRedZoneInsideTenStats/{season}
operations:
- name: nflv3statsplayerseasonredzonestatsinsideten
method: GET
description: Player Season Red Zone Stats (Inside Ten)
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: season
in: path
type: string
description: Year of the season and the season type. If no season type is provided, then the default is regular
season.
required: true
- name: v3-nfl-stats-format-PlayerSeasonRedZoneStats-season
path: /v3/nfl/stats/{format}/PlayerSeasonRedZoneStats/{season}
operations:
- name: nflv3statsplayerseasonredzonestats
method: GET
description: Player Season Red Zone Stats
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: season
in: path
type: string
description: Year of the season and the season type. If no season type is provided, then the default is regular
season.
required: true
- name: v3-nfl-stats-format-PlayerSeasonStats-season
path: /v3/nfl/stats/{format}/PlayerSeasonStats/{season}
operations:
- name: nflv3statsplayerseasonstats
method: GET
description: Player Season Stats
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: season
in: path
type: string
description: Year of the season and the season type. If no season type is provided, then the default is regular
season.
required: true
- name: v3-nfl-stats-format-PlayerSeasonStatsByTeam-season-team
path: /v3/nfl/stats/{format}/PlayerSeasonStatsByTeam/{season}/{team}
operations:
- name: nflv3statsplayerseasonstatsbyteam
method: GET
description: Player Season Stats - by Team
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
- name: season
in: path
type: string
description: Year of the season and the season type. If no season type is provided, then the default is regular
season.
required: true
- name: team
in: path
type: string
description: 'Abbreviation of the team. Example: <code>WAS</code>.'
required: true
- name: v3-nfl-stats-format-PlayerSeasonThirdDownStats-season
path: /v3/nfl/stats/{format}/PlayerSeasonThirdDownStats/{season}
operations:
- name: nflv3statsplayerseasonthirddownstats
method: GET
description: Player Season Third Down Stats
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: format
in: path
type: string
descr
# --- truncated at 32 KB (70 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/sportsdataio/refs/heads/main/capabilities/nfl-nfl-v3-stats.yaml