Fantasy Data

NFL Data Dictionary


The FantasyData NFL API has a new home over at SportsDataIO Discovery Lab, a platform built to offer affordable sports data for students, hobbyists and personal projects.

If you're looking for a more extensive product to power your website or application, we encourage you to check out SportsDataIO's commercial NFL API.

Below you will find a list of all data points that are contained within each feed that we offer. If any of the information provided below is unclear, or if you have a specific question, please contact support.

Go to our developer portal for a full list of operations including deprecated, legacy and test endpoints.

All dates & times are in US Eastern Time.

Choose League:

Core

This table is used in the following endpoints:
FantasyData NFL Fantasy API
Bye Weeks
FantasyData NFL Odds API
Bye Weeks
Name Type Size Nullable Scrambled CSV Description
Season integer 32 No No No The NFL season during which this bye week occurs.
This table is used in the following endpoints:
Name Type Size Nullable Scrambled CSV Description
Number integer 32 Yes No Yes Player's jersey number
FirstName string 50 Yes No Yes Player's first name
LastName string 50 Yes No Yes Player's last name
Status string 50 Yes No Yes The player's current status. Possible values include Active, Inactive, Injured Reserve, Physically Unable to Perform, Practice Squad, Suspended, Non Football Injury, Non-Football Illness, Commissioner Exempt List, Exempt/Left Team, Paternity, Bereavement, Reserve/COVID-19, and Voluntary Opt Out. Inactive indicates that this player is a free agent. Active indicates that this player is on his team's active roster.
Height string 50 Yes No Yes Height in feet, inches
IsUndraftedFreeAgent
from 2013
boolean No No Yes Whether this player was an undrafted free agent. This value is True if the player was drafted.
InjuryStatus string 50 Yes Yes Yes The player's current injury status, in the form of likelihood that player plays (Probable, Questionable, Doubtful, Out)
This table is used in the following endpoints:
FantasyData NFL Fantasy API
Teams (Active)
FantasyData NFL Odds API
Teams (Active)
Name Type Size Nullable Scrambled CSV Description
StadiumID integer 32 No No Yes The unique ID of the stadium
Name string 100 No No Yes The full name of the stadium
City string 50 No No Yes The city where the stadium is located
Capacity integer 32 Yes No Yes The estimated seating capacity of the stadium
PlayingSurface string 50 Yes No Yes The playing surface of the stadium (Grass, Artificial or Dome)
GeoLong decimal 32 Yes No Yes The geographic longitude coordinate of this venue.
Type string 50 Yes No Yes The type of the stadium (possible values: Outdoor, Dome, RetractableDome)
This table is used in the following endpoints:
FantasyData NFL Fantasy API
Standings
FantasyData NFL Odds API
Standings
Name Type Size Nullable Scrambled CSV Description
Name string 50 Yes No Yes The full name of the team
This table is used in the following endpoints:
FantasyData NFL Fantasy API
Teams (Active)
FantasyData NFL Odds API
Teams (Active)
Name Type Size Nullable Scrambled CSV Description
Conference string 50 Yes No Yes The conference of the team (e.g. AFC or NFC)
Division string 50 Yes No Yes The division of the team (e.g. East, North, South, West)
FullName string 50 Yes No Yes The full name of the team (e.g. New England Patriots)
StadiumID integer 32 Yes No Yes The unique ID of the team's current home stadium
PrimaryColor string 6 Yes No Yes The team's primary color. (This is not licensed for public or commercial use)
SecondaryColor string 6 Yes No Yes The team's secondary color. (This is not licensed for public or commercial use)
TertiaryColor string 6 Yes No Yes The team's tertiary color. (This is not licensed for public or commercial use)
QuaternaryColor string 6 Yes No Yes The team's quaternary color. (This is not licensed for public or commercial use)
FanDuelPlayerID integer 32 Yes No Yes Team's DST player ID on FanDuel daily fantasy contests
StadiumDetails Stadium Yes No No The details of this team's home stadium
This table is used in the following endpoints:
FantasyData NFL Fantasy API
Timeframes
FantasyData NFL Odds API
Timeframes
Name Type Size Nullable Scrambled CSV Description
SeasonType integer 32 No No No The season type of the timeframe (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=All-Star)
Season integer 32 No No No The league year of the timeframe (this gets incremented on the first day of the league year during free agency)
Name string 50 No No No The friendly name of the Timeframe
ShortName string 50 No No No The shorter name of the Timeframe
StartDate datetime No No No The start date/time of this Timeframe

Fantasy

This table is used in the following endpoints:
Name Type Size Nullable Scrambled CSV Description
SlateID integer 32 No No No Unique ID of a Slate (assigned by SportsDataIO).
Operator string 20 Yes No No The name of the operator who is running contests for this slate. Possible values: FanDuel, DraftKings, Yahoo, FantasyDraft, etc.
OperatorSlateID integer 32 Yes No No Unique ID of a slate (assigned by the operator).
OperatorName string 50 Yes No No The name of the slate (assigned by the operator). Possible values: Main, Express, Arcade, Late Night, etc.
OperatorDay date Yes No No The day (in EST/EDT) that the slate begins (assigned by the operator).
IsMultiDaySlate boolean Yes No No Whether this slate uses games that take place on different days.
RemovedByOperator boolean Yes No No Indicates whether this slate was removed/deleted by the operator.
OperatorGameType string 50 Yes No No The game type of the slate. Will often be null as most operators only have one game type.
SlateRosterSlots string[] Yes No Yes The positions that need to be filled for this particular slate
SalaryCap integer Yes No Yes The salary cap for the current slate (is null for slates with no salary cap such a Tiers gametypes)
This table is used in the following endpoints:
Name Type Size Nullable Scrambled CSV Description
SlateGameID integer 32 No No No Unique ID of a SlateGame (assigned by SportsDataIO).
RemovedByOperator boolean Yes Yes No Indicates whether this game was removed/deleted by the operator.
This table is used in the following endpoints:
Name Type Size Nullable Scrambled CSV Description
FantasyDefenseProjectionStatID integer 32 Yes No No The SportsDataIO StatID that this SlatePlayer refers to. This field is only filled for Defense/Special Teams. For the NFL feeds, this is the FantasyDefenseGameProjection.FantasyDefenseID.
OperatorSalary integer 32 Yes No No The player's salary for the contest (assigned by the operator).
RemovedByOperator boolean Yes No No Indicates whether this player was removed/deleted by the operator.
This table is used in the following endpoints:
FantasyData NFL Fantasy API
Fantasy Defense Game Stats
Name Type Size Nullable Scrambled CSV Description
Season integer 32 No No Yes The NFL season of the game
DefensiveTouchdowns decimal 32 Yes Yes Yes Total touchdowns scored by the defense
This table is used in the following endpoints:
FantasyData NFL Fantasy API
Projected Fantasy Defense Game Stats
Name Type Size Nullable Scrambled CSV Description
Season integer 32 No No Yes The NFL season of the game
DefensiveTouchdowns decimal 32 Yes Yes Yes Total touchdowns scored by the defense
This table is used in the following endpoints:
FantasyData NFL Fantasy API
Fantasy Defense Season Stats
Name Type Size Nullable Scrambled CSV Description
Season integer 32 No No Yes The NFL regular season for which these totals apply
AuctionValuePPR decimal 32 Yes Yes Yes Player's dollar value in a $200 salary cap PPR auction draft.
This table is used in the following endpoints:
Name Type Size Nullable Scrambled CSV Description
Season integer 32 No No Yes The NFL regular season for which these totals apply
AuctionValuePPR decimal 32 Yes Yes Yes Player's dollar value in a $200 salary cap PPR auction draft.
This table is used in the following endpoints:
FantasyData NFL Fantasy API
Player Game Stats by Week
Name Type Size Nullable Scrambled CSV Description
Season integer 32 No No Yes The NFL season of the game
Number integer 32 No No Yes Player's jersey number
PlayerGameID integer 32 No No Yes Unique ID of PlayerGame record (subject to change, although it very rarely does). For a static ID, use a combination of GameKey and PlayerID.
This table is used in the following endpoints:
Name Type Size Nullable Scrambled CSV Description
Season integer 32 No No Yes The NFL season of the game
Number integer 32 No No Yes Player's jersey number
PlayerGameID integer 32 No No Yes Unique ID of PlayerGame record (subject to change, although it very rarely does). For a static ID, use a combination of GameKey and PlayerID.
This table is used in the following endpoints:
FantasyData NFL Fantasy API
Player Season Stats
Name Type Size Nullable Scrambled CSV Description
Number integer 32 No No Yes Player's jersey number
FantasyPosition string 50 Yes No Yes The player's fantasy football position. Possible values: QB, RB, WR, TE, DL, LB, DB, K, P, OL
PlayerSeasonID integer 32 No No Yes Unique ID of PlayerSeason record (subject to change, although it very rarely does). For a static ID, use a combination of SeasonType, Season and PlayerID.
AuctionValue decimal 32 Yes Yes Yes Player's dollar value in a $200 salary cap auction draft.
AuctionValuePPR decimal 32 Yes Yes Yes Player's dollar value in a $200 salary cap PPR auction draft.
This table is used in the following endpoints:
FantasyData NFL Fantasy API
Projected Player Season Stats (w/ ADP)
Name Type Size Nullable Scrambled CSV Description
Number integer 32 No No Yes Player's jersey number
FantasyPosition string 50 Yes No Yes The player's fantasy football position. Possible values: QB, RB, WR, TE, DL, LB, DB, K, P, OL
PlayerSeasonID integer 32 No No Yes Unique ID of PlayerSeason record (subject to change, although it very rarely does). For a static ID, use a combination of SeasonType, Season and PlayerID.
AuctionValue decimal 32 Yes Yes Yes Player's dollar value in a $200 salary cap auction draft.
AuctionValuePPR decimal 32 Yes Yes Yes Player's dollar value in a $200 salary cap PPR auction draft.

Odds

This table is used in the following endpoints:
Name Type Size Nullable Scrambled CSV Description
Status string 10 Yes No No 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>.
HomeTeamName string 50 Yes No No The name of the home team.
PregameOdds GameOdd[] Yes No No List of Pregame Odds from different sportsbooks
HomeTeamScore integer Yes Yes No Score of the home team (updated after game ends to allow for resolving bets)
AwayTeamScore integer Yes Yes No Score of the away team (updated after game ends to allow for resolving bets)
HomeRotationNumber integer Yes Yes No Rotation Number of home team in this game
AwayRotationNumber integer Yes Yes No Rotation Number of away team in this game
This table is used in the following endpoints:
Name Type Size Nullable Scrambled CSV Description
Sportsbook string 25 No Yes No Name of sportsbook
Updated datetime No No No The timestamp of when these odds were last updated, based on US Eatern Time (EST/EDT). If these are the latest odds for this game, and they have not been updated within the last few minutes, then it indicates that there were problems connecting to the sportsbook.
HomePointSpread decimal 32 Yes Yes No The sportsbook's point spread for the home team
AwayPointSpread decimal 32 Yes Yes No The sportsbook's point spread for the away team
HomePointSpreadPayout integer 32 Yes Yes No The sportsbook's point spread payout for the home team
AwayPointSpreadPayout integer 32 Yes Yes No The sportsbook's point spread payout for the away team
UnderPayout integer 32 Yes Yes No The sportsbook's payout for the under
SportsbookId integer 32 Yes No No Unique ID of the Sportsbook
This table is used in the following endpoints:
FantasyData NFL Odds API
Scores by Season , Scores by Week
Name Type Size Nullable Scrambled CSV Description
SeasonType integer 32 No No Yes The type of season that this game corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=All-Star).
Season integer 32 No No Yes The NFL season of the game
AwayScore integer 32 Yes Yes Yes The final score of the Away Team
HomeScore integer 32 Yes Yes Yes The final score of the Home Team
StadiumID
from 2013
integer 32 Yes No Yes The unique ID of the team's current home stadium
ForecastDescription
from 2015
string 50 Yes No Yes The forecast description on game day at this venue.
ForecastWindChill
from 2015
integer 32 Yes No Yes The forecasted wind chill on game day at this venue.
ForecastWindSpeed
from 2015
integer 32 Yes No Yes The forecasted wind speed on game day at this venue.
ScoreID integer 32 No No Yes Unique ID of the Score/Game
StadiumDetails Stadium Yes No No The details of the stadium where this game is played
Status string 20 Yes No No 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>.
HomeRotationNumber integer 32 Yes Yes No Rotation number of home team in this game
AwayRotationNumber integer 32 Yes Yes No Rotation number of away team in this game
NeutralVenue boolean Yes No Yes Indicates whether this game is played in a neutral venue
This table is used in the following endpoints:
Name Type Size Nullable Scrambled CSV Description
StadiumID integer 32 No No Yes The unique ID of the stadium
Name string 100 No No Yes The full name of the stadium
City string 50 No No Yes The city where the stadium is located
Capacity integer 32 Yes No Yes The estimated seating capacity of the stadium
PlayingSurface string 50 Yes No Yes The playing surface of the stadium (Grass, Artificial or Dome)
GeoLong decimal 32 Yes No Yes The geographic longitude coordinate of this venue.
Type string 50 Yes No Yes The type of the stadium (possible values: Outdoor, Dome, RetractableDome)
This table is used in the following endpoints:
FantasyData NFL Odds API
Team Game Stats
Name Type Size Nullable Scrambled CSV Description
Season integer 32 No No Yes The NFL season of the game
Stadium
from 2001
string 50 Yes No Yes Stadium of the event
ThirdDownPercentage
from 2001
decimal 32 Yes Yes Yes Percentage of third downs converted
TeamID integer 32 Yes No Yes The unique ID of this team
This table is used in the following endpoints:
FantasyData NFL Odds API
Team Season Stats
Name Type Size Nullable Scrambled CSV Description
Season integer 32 No No Yes The NFL regular season for which these totals apply