Developer Portal

Data Dictionary

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.

Filter by a Subfeed...
Download CSV
This table is used in the following endpoints:
Name Type Size Nullable Scrambled CSV Description
ConferenceID integer 32 No No Yes The ID of the team's conference
Name string 50 No No No The name of the team's conference (e.g. American Conference; Big Ten Conference; Conference USA)
Teams Team[] Yes No No The list of teams within the conference
Name Type Size Nullable Scrambled CSV Description
GameID integer 32 No No No The unique ID of the game
Season integer 32 No No No The season that the game occurs in Note: season is a single year that the majority of the season occurs in
SeasonType integer 32 No No No The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar)
Status string 20 Yes No No Indicates the game's status. Possible values include: Scheduled; InProgress; Final; F/OT; Suspended; Postponed; Delayed; Canceled; Forfeit; NotNecessary
Day date Yes No No The date the game is scheduled to occur
DateTime datetime Yes No No The timestamp of when the game is scheduled to start
AwayTeam string 10 Yes No No The abbreviation [Key] of the away team
HomeTeam string 10 Yes No No The abbreviation [Key] of the home team
AwayTeamID integer 32 Yes No Yes The unique ID of the away team
HomeTeamID integer 32 Yes No Yes The unique ID of the home team
AwayTeamScore integer 32 Yes Yes No Total number of points the away team scored in the game
HomeTeamScore integer 32 Yes Yes Yes Total number of points the home team scored in this game
Updated datetime Yes No Yes The timestamp of when this game was last updated (in US Eastern Time)
Period string 10 Yes No Yes The current quarter of the game (Possible Values: 1, 2, 3, 4, OT, F, F/OT, NULL)
TimeRemainingMinutes integer 32 Yes No Yes Number of minutes remaining in the quarter
TimeRemainingSeconds integer 32 Yes No Yes Number of seconds remaining in the quarter
GlobalGameID integer 32 No No No A globally unique ID for this game. This value is guaranteed to be unique across all sports/leagues
GlobalAwayTeamID integer 32 Yes No No A globally unique ID for the away team. This value is guaranteed to be unique across all sports/leagues
GlobalHomeTeamID integer 32 Yes No No A globally unique ID for the home team. This value is guaranteed to be unique across all sports/leagues
Periods
from 2016 		Period[] Yes No No The details of the periods (quarters & overtime) for this game
DateTimeUTC datetime Yes No No The timestamp in UTC of when the game is scheduled to start
Name Type Size Nullable Scrambled CSV Description
PeriodID integer 32 No No Yes The unique ID for the period
GameID integer 32 No No No The unique ID of the game relating to this period
Number integer 32 No No No The number (order) of the period within the scope of the game
Name string 10 No No Yes The Name of the Quarter (possible values: 1, 2, 3, 4, OT, OT2, OT3, etc)
Type string 10 No No Yes Indicates whether this period is a regulation quarter or overtime (possible values: Quarter, Overtime)
AwayScore integer 32 Yes Yes No The total points scored by the away team in this period only
HomeScore integer 32 Yes Yes No The total points scored by the home team in this period only
This table is used in the following endpoints:
Name Type Size Nullable Scrambled CSV Description
GameID integer 32 No No No The unique ID of the game
Season integer 32 No No No The season that the game occurs in. Note: season is a single year that the majority of the season occurs in
SeasonType integer 32 No No No The type of season that this record corresponds to (1=Regular Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=AllStar)
Status string 20 Yes No Yes Indicates the game's status. Possible values include: Scheduled, InProgress, Final, F/OT, Suspended, Postponed, Delayed, Canceled, Forfeit, NotNecessary
Day date Yes No No The date the game is scheduled to occur
DateTime datetime Yes No No The timestamp of when the game is scheduled to start
AwayTeam string 10 Yes No No The abbreviation [Key] of the away team
HomeTeam string 10 Yes No No The abbreviation [Key] of the home team
AwayTeamID integer 32 Yes No Yes The unique ID of the away team
HomeTeamID integer 32 Yes No No The unique ID of the home team
AwayTeamScore integer 32 Yes No No Total number of points the away team scored in the game
HomeTeamScore integer 32 Yes No Yes Total number of points the home team scored in this game
Updated datetime Yes No Yes The timestamp of when this game was last updated (in US Eastern Time)
GlobalGameID integer 32 No No No A globally unique ID for this game. This value is guaranteed to be unique across all sports/leagues
TournamentID integer 32 Yes No Yes The unique ID of the tournament
Bracket string 50 Yes No No The specific bracket/region of the tournament
Round integer 32 Yes No Yes The current round of the tournament
AwayTeamSeed integer 32 Yes No No The seed of the away team (1-16). Note: specific to March Madness tournament & does not include other tournaments
HomeTeamSeed integer 32 Yes No No The seed of the home team (1-16). Note: specific to March Madness tournament & does not include other tournaments
IsClosed boolean Yes No Yes Indicates whether the game is over and the final score has been verified and closed out.
GameEndDateTime datetime Yes No No The date and time that the game ended (in US Eastern Time)
NeutralVenue boolean Yes No Yes Indicates whether this game is played in a neutral venue
DateTimeUTC datetime Yes No No The timestamp in UTC of when the game is scheduled to start
GlobalAwayTeamID integer 32 No No No A globally unique ID for the away team. This value is guaranteed to be unique across all sports/leagues
GlobalHomeTeamID integer 32 No No No A globally unique ID for the home team. This value is guaranteed to be unique across all sports/leagues
This table is used in the following endpoints:
Name Type Size Nullable Scrambled CSV Description
CurrentSeason integer 32 No No Yes The college basketball season of the game
StartYear integer 32 No No Yes The year in which the season started
EndYear integer 32 No No Yes The year in which the season ended
Description string 10 Yes No Yes The description of this season for display purposes (e.g. 2017-18, 2018-19, etc)
RegularSeasonStartDate date Yes No Yes The start date of the regular season
PostSeasonStartDate date Yes No Yes The start date of the postseason
ApiSeason string 50 Yes No No The string to pass into subsequent API calls in the season parameter (e.g. 2025REG, 2025POST, etc.)
This table is used in the following endpoints:
Name Type Size Nullable Scrambled CSV Description
TeamID integer 32 No No No The unique ID of the team
[Key] string 10 No No No A unique abbreviation of the team (e.g. OKL; TXTECH; USC; UK; etc.). Note: Due to being selected for uniqueness; these are not always matching broadcaster abbreviations. For that use case; use ShortDisplayName
Active boolean No No No Indicates whether or not this team is active
School string 50 Yes No No The name of the team 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.)
ApRank integer 32 Yes No No The AP Rank of the team (1-25)
Wins integer 32 Yes No No The total number of wins by the team
Losses integer 32 Yes No No The total number of losses by the team
ConferenceWins integer 32 Yes No No The total number of conference wins by the team
ConferenceLosses integer 32 Yes No No The total number of conference losses by the team
GlobalTeamID integer 32 No No No A globally unique ID for this team. This value is guaranteed to be unique across all sports/leagues
ConferenceID integer 32 Yes No Yes The ID of the team's conference
Conference string 50 Yes No No The name of the team's conference (e.g. American Conference; Big Ten Conference; Conference USA)
TeamLogoUrl string 100 Yes No No The URL of the team logo image
ShortDisplayName string 10 Yes No No A abbreviation of the team as seen on most broadcasts. Note: This field could have the same name for multiple teams. If a completely unique name is need use [Key]
PrimaryColor string 6 Yes No No The team's primary color. (This is not licensed for public or commercial use)
SecondaryColor string 6 Yes No No The team's secondary color. (This is not licensed for public or commercial use)
TertiaryColor string 6 Yes No No The team's tertiary color. (This is not licensed for public or commercial use)
QuaternaryColor string 6 Yes No No The team's quaternary color. (This is not licensed for public or commercial use)
Copyright © 2025 SportsDataIOTM
Contact Us