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 API documentation for a full list of operations including deprecated, legacy and test endpoints.

All dates & times are in US Eastern Time.

Download CSV
This table is used in the following endpoints:
Name Type Size Nullable Scrambled CSV Description
Sport Metadata 0 No No No The associated Sport that this competition applies to
Id string 36 No No No A GUID/UUID for this metadata item
Name string 500 No No No The name of this metadata item
This table is used in the following endpoints:
Name Type Size Nullable Scrambled CSV Description
Id string 36 No No No A GUID/UUID for this metadata item
Name string 500 No No No The name of this metadata item
Name Type Size Nullable Scrambled CSV Description
PlayerGRid string 36 No No No The GUID/UUID of the player in the GRid system
FirstName string 100 Yes No No The given name of the player
LastName string 100 Yes No No The surname of the player
CommonName string 200 Yes No No The most commonly used name for the player (typically just `{FirstName} {LastName}`)
Birthdate string 12 Yes No No Players Birthdate if available
Mappings PlayerMapping[] No No No The list of relevant Player Mappings from originators
SportsDataIOPlayerProfile SportsDataIOPlayerProfile Yes No No Extra player information about the player from SportsDataIO, intended for assistance in player identification
Name Type Size Nullable Scrambled CSV Description
PlayerGRid string 36 No No No Id of the Player in the GRid system
OriginatorGRid string 36 No No No The Id of the Originator (which source the OriginatorPlayerId maps to).
OriginatorPlayerId string 100 No No No The Id of the player in the originator's system
CompetitionGRid string 36 No No No The Id of the competition this mapping relates to in the GRid system. Players may have multiple Ids for a given originator across different competitions (e.g. one for CFB and one for the NFL).
Created datetime 32 No No No Timestamp in UTC of the mappings initial creation/match in the GRid system
OriginatorName string 100 Yes No No The name of the originator
CompetitionName string 100 Yes No No The name of the competition
Name Type Size Nullable Scrambled CSV Description
Height int 32 Yes No No The height of the player (in inches)
Weight int 32 Yes No No The weight of the player (in pounds/lbs)
Jersey int 32 Yes No No The jersey number of the player where applicable
Position string 50 Yes No No The position of the player where applicable
CurrentTeamGRid string 36 Yes No No The GRid of the player's current team
This table is used in the following endpoints:
Name Type Size Nullable Scrambled CSV Description
TeamGRid string 36 No No No The GUID/UUID of the team in the GRid system
Location string 50 No No No The location of the team (or school for NCAA)
Name string 50 No No No The teams name
Created datetime No No No When this team was first created in GRid
Mappings TeamMapping[] No No No The list of originator's id mappings
This table is used in the following endpoints:
Name Type Size Nullable Scrambled CSV Description
TeamGRid string 36 No No No Id of the Team in the GRid system
OriginatorGRid string 36 No No No Id of the Originator (which source the OriginatorTeamId maps to)
OriginatorTeamId string 100 No No No Id of the team in the originator's system
CompetitionGRid string 36 No No No Id of the competition this mapping relates to in the GRid system.
Created datetime No No No The creation date in UTC of this mapping in GRid
OriginatorName string 100 Yes No No The name of the originator
CompetitionName string 100 Yes No No The name of the competition
Copyright © 2026 SportsDataIOTM