College Football Data Dictionary
The FantasyData College Football 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 College Football 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
Conference
This table is used in the following endpoints:
FantasyData CFB Fantasy API
Conference Hierarchy (with Teams)
FantasyData CFB Odds API
Conference Hierarchy (with Teams)
| Name | Type | Size | Nullable | Scrambled | CSV | Description |
|---|---|---|---|---|---|---|
| Name | string | 50 | No | No | Yes | The name of the team's conference |
| Teams | Team[] | Yes | No | Yes | The teams that play within this conference | |
| ConferenceName | string | 50 | Yes | No | Yes | The name of the team's parent conference (e.g. SEC, Big Ten, etc) |
Player
This table is used in the following endpoints:
| Name | Type | Size | Nullable | Scrambled | CSV | Description |
|---|---|---|---|---|---|---|
| PositionCategory | string | 3 | Yes | No | Yes | The category (Offense, Defense or Special Teams) of the players position (OFF, DEF, ST) |
|
InjuryStatus
from 2018 |
string | 50 | Yes | No | Yes | Indicates the player's injury status (possible values include: Probable, Questionable, Doubtful, Out) |
Team
This table is used in the following endpoints:
| Name | Type | Size | Nullable | Scrambled | CSV | Description |
|---|---|---|---|---|---|---|
| TeamID | integer | 32 | No | No | Yes | The auto-generated unique ID of the Team |
| [Key] | string | 10 | No | No | Yes | A unique abbreviation of the team (e.g. OU, TTU, USC, UK, etc.) Due to being selected for uniqueness, these are not always a match with broadcaster abbreviations. For that use case, use ShortDisplayName. |
| Active | boolean | No | No | Yes | Whether or not this team is active | |
| School | string | 50 | Yes | No | Yes | The name of the school as used in college sports (e.g. SMU, South Florida, Stony Brook, UCLA, etc.) |
| Name | string | 50 | Yes | No | Yes | The mascot of the team (e.g. Sooners, Red Raiders, Trojans, Wildcats, etc.) |
| StadiumID | integer | 32 | No | No | Yes | The unique ID of the stadium |
| ApRank | integer | 32 | Yes | No | Yes | The AP Rank of the team |
| Wins | integer | 32 | Yes | No | Yes | The total number of wins by the school |
| Losses | integer | 32 | Yes | No | Yes | The total number of losses by the school |
| ConferenceWins | integer | 32 | Yes | No | Yes | The total number of conference wins by the school |
| ConferenceLosses | integer | 32 | Yes | No | Yes | The total number of conference losses by the school |
| TeamLogoUrl | string | 100 | Yes | No | Yes | The url of the team logo image. |
| ConferenceID | integer | 32 | Yes | No | Yes | The ID of the team's conference |
| Conference | string | 50 | Yes | No | Yes | The name of the team's conference |
| ShortDisplayName | string | 10 | Yes | No | Yes | The short display name of the team |
| RankWeek | integer | 32 | Yes | No | Yes | The week that the ApRank/CoachesRank was last updated |
| RankSeason | integer | 32 | Yes | No | Yes | The season that the ApRank/CoachesRank was last updated |
| RankSeasonType | integer | 32 | Yes | No | Yes | The season type that the ApRank/CoachesRank was last updated |
Fantasy
PlayerGame
This table is used in the following endpoints:
FantasyData CFB Fantasy API
Player Game Stats by Week
| Name | Type | Size | Nullable | Scrambled | CSV | Description |
|---|---|---|---|---|---|---|
| SeasonType | integer | 32 | Yes | No | Yes | The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar). |
| Season | integer | 32 | Yes | No | Yes | The college football season of the game |
| PositionCategory | string | 10 | Yes | No | Yes | The category (Offense, Defense or Special Teams) of the players position (OFF, DEF, ST) |
|
InjuryStatus
from 2018 |
string | 50 | Yes | No | Yes | Indicates the player's injury status (possible values include: Probable, Questionable, Doubtful, Out) |
| Week | integer | 32 | Yes | No | Yes | The NFL week of the game (weeks 18-21 denote playoff games) |
| GameID | integer | 32 | Yes | No | Yes | The unique ID of this game |
| OpponentID | integer | 32 | Yes | No | Yes | The unique ID of the team's opponent |
| Opponent | string | 10 | Yes | No | Yes | The name of the opponent |
| Day | date | Yes | No | Yes | The day of the game | |
| DateTime | datetime | Yes | No | Yes | The date and time of the game | |
| HomeOrAway | string | 4 | Yes | No | Yes | Whether the team is home or away |
| Games | integer | 32 | Yes | No | Yes | Indicates whether or not a player has recorded any stats for a given game. |
| FantasyPoints | decimal | 32 | Yes | Yes | Yes | Total fantasy points |
| PassingAttempts | decimal | 32 | Yes | Yes | Yes | Total passing attempts |
| PassingCompletions | decimal | 32 | Yes | Yes | Yes | Total passing completions |
| PassingYards | decimal | 32 | Yes | Yes | Yes | Total passing yards |
| PassingCompletionPercentage | decimal | 32 | Yes | Yes | Yes | Total passing completion percentage |
| PassingYardsPerAttempt | decimal | 32 | Yes | Yes | Yes | Total passing yards per attempts |
| PassingYardsPerCompletion | decimal | 32 | Yes | Yes | Yes | Total passing yards per completion |
| PassingTouchdowns | decimal | 32 | Yes | Yes | Yes | Total passing touchdowns |
| PassingInterceptions | decimal | 32 | Yes | Yes | Yes | Total passing interceptions |
| PassingRating | decimal | 32 | Yes | Yes | Yes | Total passing rating |
| RushingAttempts | decimal | 32 | Yes | Yes | Yes | Total rushing attempts |
| RushingYards | decimal | 32 | Yes | Yes | Yes | Total rushing yards |
| RushingYardsPerAttempt | decimal | 32 | Yes | Yes | Yes | Total rushing yards per attempt |
| RushingTouchdowns | decimal | 32 | Yes | Yes | Yes | Total rushing touchdowns |
| RushingLong | decimal | 32 | Yes | Yes | Yes | Longest rushing attempt |
| Receptions | decimal | 32 | Yes | Yes | Yes | Total receptions |
| ReceivingYards | decimal | 32 | Yes | Yes | Yes | Total receiving yards |
| ReceivingYardsPerReception | decimal | 32 | Yes | Yes | Yes | Total receiving yards per reception |
| ReceivingTouchdowns | decimal | 32 | Yes | Yes | Yes | Total receiving touchdowns |
| ReceivingLong | decimal | 32 | Yes | Yes | Yes | Long receiving reception |
| FieldGoalsAttempted | decimal | 32 | Yes | Yes | Yes | Total field goals attempted |
| FieldGoalsMade | decimal | 32 | Yes | Yes | Yes | Total field goals made |
| FieldGoalPercentage | decimal | 32 | Yes | Yes | Yes | Total field goal percentage |
| FieldGoalsLongestMade | decimal | 32 | Yes | Yes | Yes | Longest field goal made |
| ExtraPointsAttempted | decimal | 32 | Yes | Yes | Yes | Total extra points attempted |
| ExtraPointsMade | decimal | 32 | Yes | Yes | Yes | Total extra points made |
PlayerSeason
This table is used in the following endpoints:
| Name | Type | Size | Nullable | Scrambled | CSV | Description |
|---|---|---|---|---|---|---|
| SeasonType | integer | 32 | Yes | No | Yes | The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar). |
| Position | string | 10 | Yes | No | Yes | Player's position in the starting lineup (if started), otherwise the position he substituted for |
| PositionCategory | string | 10 | Yes | No | Yes | The category (Offense, Defense or Special Teams) of the players position (OFF, DEF, ST) |
| Games | integer | 32 | Yes | No | Yes | Indicates whether or not a player has recorded any stats for a given game. |
| FantasyPoints | decimal | 32 | Yes | Yes | Yes | Total fantasy points |
| PassingAttempts | decimal | 32 | Yes | Yes | Yes | Total passing attempts |
| PassingCompletions | decimal | 32 | Yes | Yes | Yes | Total passing completions |
| PassingYards | decimal | 32 | Yes | Yes | Yes | Total passing yards |
| PassingCompletionPercentage | decimal | 32 | Yes | Yes | Yes | Total passing completion percentage |
| PassingYardsPerAttempt | decimal | 32 | Yes | Yes | Yes | Total passing yards per attempts |
| PassingYardsPerCompletion | decimal | 32 | Yes | Yes | Yes | Total passing yards per completion |
| PassingTouchdowns | decimal | 32 | Yes | Yes | Yes | Total passing touchdowns |
| PassingInterceptions | decimal | 32 | Yes | Yes | Yes | Total passing interceptions |
| PassingRating | decimal | 32 | Yes | Yes | Yes | Total passing rating |
| RushingAttempts | decimal | 32 | Yes | Yes | Yes | Total rushing attempts |
| RushingYards | decimal | 32 | Yes | Yes | Yes | Total rushing yards |
| RushingYardsPerAttempt | decimal | 32 | Yes | Yes | Yes | Total rushing yards per attempt |
| RushingTouchdowns | decimal | 32 | Yes | Yes | Yes | Total rushing touchdowns |
| RushingLong | decimal | 32 | Yes | Yes | Yes | Longest rushing attempt |
| Receptions | decimal | 32 | Yes | Yes | Yes | Total receptions |
| ReceivingYards | decimal | 32 | Yes | Yes | Yes | Total receiving yards |
| ReceivingYardsPerReception | decimal | 32 | Yes | Yes | Yes | Total receiving yards per reception |
| ReceivingTouchdowns | decimal | 32 | Yes | Yes | Yes | Total receiving touchdowns |
| ReceivingLong | decimal | 32 | Yes | Yes | Yes | Long receiving reception |
| FieldGoalsAttempted | decimal | 32 | Yes | Yes | Yes | Total field goals attempted |
| FieldGoalsMade | decimal | 32 | Yes | Yes | Yes | Total field goals made |
| FieldGoalPercentage | decimal | 32 | Yes | Yes | Yes | Total field goal percentage |
| FieldGoalsLongestMade | decimal | 32 | Yes | Yes | Yes | Longest field goal made |
| ExtraPointsAttempted | decimal | 32 | Yes | Yes | Yes | Total extra points attempted |
| ExtraPointsMade | decimal | 32 | Yes | Yes | Yes | Total extra points made |
Odds
Game
This table is used in the following endpoints:
| Name | Type | Size | Nullable | Scrambled | CSV | Description |
|---|---|---|---|---|---|---|
| GameID | integer | 32 | No | No | Yes | The unique ID of this game |
| Season | integer | 32 | No | No | Yes | The College Football season of the game |
| SeasonType | integer | 32 | No | No | Yes | The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar). |
| Day | date | Yes | No | Yes | The date of the game | |
| AwayTeamID | integer | 32 | No | No | Yes | The unique ID of the away team |
| HomeTeamID | integer | 32 | No | No | Yes | The unique ID of the home team |
| AwayTeamName | string | 100 | Yes | No | Yes | The name of the away team |
| HomeTeamName | string | 100 | Yes | No | Yes | The name of the home team |
| AwayTeamScore | integer | 32 | Yes | Yes | Yes | Total number of points the away team scored in this game |
| HomeTeamScore | integer | 32 | Yes | Yes | Yes | Total number of points the home team scored in this game |
| Stadium | Stadium | Yes | No | Yes | The details of the stadium where this game is played | |
| Periods | Period[] | Yes | No | Yes | The details of the periods (quarters & overtime) for this game | |
|
Title
from 2018 |
string | 50 | Yes | No | Yes | The title of the game (e.g. Rose Bowl, Citrus Bowl, etc) |
| HomeRotationNumber | integer | 32 | Yes | Yes | Yes | Rotation number of home team for this game |
| AwayRotationNumber | integer | 32 | Yes | Yes | Yes | Rotation number of away team for this game |
|
NeutralVenue
from 2020 |
boolean | Yes | No | Yes | Indicates whether this game is played in a neutral venue | |
|
HomePointSpreadPayout
from 2021 |
integer | 32 | Yes | Yes | Yes | The point spread payout for the home team |
GameInfo
This table is used in the following endpoints:
| Name | Type | Size | Nullable | Scrambled | CSV | Description |
|---|---|---|---|---|---|---|
| SeasonType | integer | 32 | No | No | Yes | The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar). |
| PregameOdds | GameOdd[] | Yes | No | Yes | List of Pregame Odds from different sportsbooks | |
| HomeTeamScore | integer | Yes | Yes | Yes | Score of the home team (updated after game ends to allow for resolving bets) | |
| AwayTeamScore | integer | Yes | Yes | Yes | Score of the away team (updated after game ends to allow for resolving bets) | |
| HomeRotationNumber | integer | 32 | Yes | Yes | Yes | Rotation number of home team for this game |
| AwayRotationNumber | integer | 32 | Yes | Yes | Yes | Rotation number of away team for this game |
GameOdd
This table is used in the following endpoints:
| Name | Type | Size | Nullable | Scrambled | CSV | Description |
|---|---|---|---|---|---|---|
| GameOddId | integer | 32 | No | No | Yes | Unique ID of this odd |
| Updated | datetime | No | No | Yes | The timestamp of when these odds were last updated, based on US Eastern 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 | Yes | The sportsbook's point spread for the home team |
| AwayPointSpread | decimal | 32 | Yes | Yes | Yes | The sportsbook's point spread for the away team |
| HomePointSpreadPayout | integer | 32 | Yes | Yes | Yes | The sportsbook's point spread payout for the home team |
| AwayPointSpreadPayout | integer | 32 | Yes | Yes | Yes | The sportsbook's point spread payout for the away team |
| UnderPayout | integer | 32 | Yes | Yes | Yes | The sportsbook's payout for the under |
Period
This table is used in the following endpoints:
| Name | Type | Size | Nullable | Scrambled | CSV | Description |
|---|---|---|---|---|---|---|
| Number | integer | 32 | No | No | Yes | The Number (Order) of the Period in the scope of the Game. |
Stadium
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 |
| Active | boolean | No | No | Yes | Whether or not this stadium is the home venue for an active team | |
| Name | string | 50 | No | No | Yes | The full name of the stadium |
| Dome | boolean | No | No | Yes | Indicates whether this stadium is a dome | |
| City | string | 50 | Yes | No | Yes | The city where the stadium is located |
| State | string | 10 | Yes | No | Yes | The US state where the stadium is located (if Stadium is outside US, this value is NULL) |
| GeoLat | decimal | 32 | Yes | No | Yes | The geographic latitude coordinate of this venue. |
| GeoLong | decimal | 32 | Yes | No | Yes | The geographic longitude coordinate of this venue. |
TeamGame
This table is used in the following endpoints:
FantasyData CFB Odds API
Team Game Stats by Week
| Name | Type | Size | Nullable | Scrambled | CSV | Description |
|---|---|---|---|---|---|---|
| TeamID | integer | 32 | Yes | No | Yes | The unique ID of the team |
| SeasonType | integer | 32 | Yes | No | Yes | The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar). |
| Week | integer | 32 | Yes | No | Yes | The NFL week of the game (weeks 18-21 denote playoff games) |
| GameID | integer | 32 | Yes | No | Yes | The unique ID of this game |
| OpponentID | integer | 32 | Yes | No | Yes | The unique ID of the team's opponent |
| Opponent | string | 10 | Yes | No | Yes | The name of the opponent |
| Day | date | Yes | No | Yes | The day of the game | |
| DateTime | datetime | Yes | No | Yes | The date and time of the game | |
| HomeOrAway | string | 4 | Yes | No | Yes | Whether the team is home or away |
| Games | integer | 32 | Yes | No | Yes | Indicates whether or not a player has recorded any stats for a given game. |
| FantasyPoints | decimal | 32 | Yes | Yes | Yes | Total fantasy points |
| PassingAttempts | decimal | 32 | Yes | Yes | Yes | Total passing attempts |
| PassingCompletions | decimal | 32 | Yes | Yes | Yes | Total passing completions |
| PassingYards | decimal | 32 | Yes | Yes | Yes | Total passing yards |
| PassingCompletionPercentage | decimal | 32 | Yes | Yes | Yes | Total passing completion percentage |
| PassingYardsPerAttempt | decimal | 32 | Yes | Yes | Yes | Total passing yards per attempts |
| PassingYardsPerCompletion | decimal | 32 | Yes | Yes | Yes | Total passing yards per completion |
| PassingTouchdowns | decimal | 32 | Yes | Yes | Yes | Total passing touchdowns |
| PassingInterceptions | decimal | 32 | Yes | Yes | Yes | Total passing interceptions |
| PassingRating | decimal | 32 | Yes | Yes | Yes | Total passing rating |
| RushingAttempts | decimal | 32 | Yes | Yes | Yes | Total rushing attempts |
| RushingYards | decimal | 32 | Yes | Yes | Yes | Total rushing yards |
| RushingYardsPerAttempt | decimal | 32 | Yes | Yes | Yes | Total rushing yards per attempt |
| RushingTouchdowns | decimal | 32 | Yes | Yes | Yes | Total rushing touchdowns |
| RushingLong | decimal | 32 | Yes | Yes | Yes | Longest rushing attempt |
| Receptions | decimal | 32 | Yes | Yes | Yes | Total receptions |
| ReceivingYards | decimal | 32 | Yes | Yes | Yes | Total receiving yards |
| ReceivingYardsPerReception | decimal | 32 | Yes | Yes | Yes | Total receiving yards per reception |
| ReceivingTouchdowns | decimal | 32 | Yes | Yes | Yes | Total receiving touchdowns |
| ReceivingLong | decimal | 32 | Yes | Yes | Yes | Long receiving reception |
| FieldGoalsAttempted | decimal | 32 | Yes | Yes | Yes | Total field goals attempted |
| FieldGoalsMade | decimal | 32 | Yes | Yes | Yes | Total field goals made |
| FieldGoalPercentage | decimal | 32 | Yes | Yes | Yes | Total field goal percentage |
| FieldGoalsLongestMade | decimal | 32 | Yes | Yes | Yes | Longest field goal made |
| ExtraPointsAttempted | decimal | 32 | Yes | Yes | Yes | Total extra points attempted |
| ExtraPointsMade | decimal | 32 | Yes | Yes | Yes | Total extra points made |
TeamSeason
This table is used in the following endpoints:
FantasyData CFB Odds API
Team Season Stats & Standings
| Name | Type | Size | Nullable | Scrambled | CSV | Description |
|---|---|---|---|---|---|---|
| TeamID | integer | 32 | Yes | No | Yes | The unique ID of the team |
| SeasonType | integer | 32 | Yes | No | Yes | The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar). |
| Games | integer | 32 | Yes | No | Yes | Indicates whether or not a player has recorded any stats for a given game. |
| FantasyPoints | decimal | 32 | Yes | Yes | Yes | Total fantasy points |
| PassingAttempts | decimal | 32 | Yes | Yes | Yes | Total passing attempts |
| PassingCompletions | decimal | 32 | Yes | Yes | Yes | Total passing completions |
| PassingYards | decimal | 32 | Yes | Yes | Yes | Total passing yards |
| PassingCompletionPercentage | decimal | 32 | Yes | Yes | Yes | Total passing completion percentage |
| PassingYardsPerAttempt | decimal | 32 | Yes | Yes | Yes | Total passing yards per attempts |
| PassingYardsPerCompletion | decimal | 32 | Yes | Yes | Yes | Total passing yards per completion |
| PassingTouchdowns | decimal | 32 | Yes | Yes | Yes | Total passing touchdowns |
| PassingInterceptions | decimal | 32 | Yes | Yes | Yes | Total passing interceptions |
| PassingRating | decimal | 32 | Yes | Yes | Yes | Total passing rating |
| RushingAttempts | decimal | 32 | Yes | Yes | Yes | Total rushing attempts |
| RushingYards | decimal | 32 | Yes | Yes | Yes | Total rushing yards |
| RushingYardsPerAttempt | decimal | 32 | Yes | Yes | Yes | Total rushing yards per attempt |
| RushingTouchdowns | decimal | 32 | Yes | Yes | Yes | Total rushing touchdowns |
| RushingLong | decimal | 32 | Yes | Yes | Yes | Longest rushing attempt |
| Receptions | decimal | 32 | Yes | Yes | Yes | Total receptions |
| ReceivingYards | decimal | 32 | Yes | Yes | Yes | Total receiving yards |
| ReceivingYardsPerReception | decimal | 32 | Yes | Yes | Yes | Total receiving yards per reception |
| ReceivingTouchdowns | decimal | 32 | Yes | Yes | Yes | Total receiving touchdowns |
| ReceivingLong | decimal | 32 | Yes | Yes | Yes | Long receiving reception |
| FieldGoalsAttempted | decimal | 32 | Yes | Yes | Yes | Total field goals attempted |
| FieldGoalsMade | decimal | 32 | Yes | Yes | Yes | Total field goals made |
| FieldGoalPercentage | decimal | 32 | Yes | Yes | Yes | Total field goal percentage |
| FieldGoalsLongestMade | decimal | 32 | Yes | Yes | Yes | Longest field goal made |
| ExtraPointsAttempted | decimal | 32 | Yes | Yes | Yes | Total extra points attempted |
| ExtraPointsMade | decimal | 32 | Yes | Yes | Yes | Total extra points made |