Developer Portal

Global API Data Dictionary

Below you will find a list of all data points contained within the Global API. If anything is unclear, please contact support.

Go to our Global API documentation for a full list of endpoints.

Sport
Filter by Tier...
Represents a human athlete
This table is used in the following endpoints:
  • Sport & Competition Feeds
Name Type Size Nullable Description
GlobalSportsParticipantId integer 32 No The unchanging ID number of this specific person
Name string 500 Yes The name of this athlete.
Type string 50 Yes The type of athlete (e.g., player, coach).
Gender string 50 Yes The gender of this athlete.
CountryName string 50 Yes The name of the country this athlete is associated with.
Updated datetime Yes The date and time this record was last updated.
Status string 50 Yes The current activity status of this athlete (e.g., Active, Inactive).
DateOfBirth string 50 Yes The date of birth of this athlete.
Height integer 32 Yes The height of this athlete in centimeters
Weight integer 32 Yes The weight of this athlete in kilograms.
Properties object 0 Yes Additional sport-specific properties for this athlete.
Represents a specific competition/league for the given sport
This table is used in the following endpoints:
  • Sport & Competition Feeds
Name Type Size Nullable Description
GlobalSportsCompetitionId integer 32 No The unchanging ID number of this specific competition.
Name string 500 Yes The name of this competition/league
Key string 50 Yes The unique key of this competition
GlobalSportsSportId integer 32 No The unique ID of the sport to which this competition belongs.
DisplayName string 500 Yes The friendly display name of this competition
Slug string 500 Yes The unique URL slug of this competition
Represents a specific event (e.g. a game, match or race)
This table is used in the following endpoints:
Name Type Size Nullable Description
GlobalSportsEventId integer 32 No The unchanging ID number of this specific event
GlobalSportsPhaseId integer 32 No The unchanging ID number of the phase to which this event belongs
Name string 50 Yes The name of this event.
StartDate datetime Yes The scheduled start date and time of this event.
Status string 50 Yes The current status of this event.
StatusDescription string 50 Yes A human-readable description of the current event status.
Updated datetime Yes The date and time this record was last updated.
LiveCoverage boolean Yes Whether this event has live score coverage available.
Attendance integer 32 Yes The recorded attendance for this event.
Closed boolean Yes Whether the results for this event have been confirmed and finalized.
Venue string 50 Yes The name of the venue where this event takes place.
RoundInfo RoundInfo No The Round to which this Event belongs
EventState AmFootballEventState No The current State of the Event
Participants AmFootballParticipant[] Yes The records of the Participant(s) involved in the Event
RoundInfo RoundInfo No
EventState BaseballEventState No
Participants BaseballParticipant[] Yes
RoundInfo RoundInfo No
EventState BasketballEventState No
Participants BasketballParticipant[] Yes
RoundInfo RoundInfo No
EventState IceHockeyEventState No
Participants IceHockeyParticipant[] Yes
RoundInfo RoundInfo No
EventState SoccerEventState No
Participants SoccerParticipant[] Yes
RoundInfo RoundInfo No
EventState TennisEventState No
Participants TennisParticipant[] Yes
StatusComment string 50 Yes
Format TennisEventFormat No
Represents the live timing state of an event
Name Type Size Nullable Description
EventStarted datetime Yes The actual date and time this event started.
EventEnded datetime Yes The actual date and time this event ended.
Outs integer 32 Yes
BallCount integer 32 Yes
StrikeCount integer 32 Yes
RunnerOnFirst boolean Yes
RunnerOnSecond boolean Yes
RunnerOnThird boolean Yes
CurrentBatter integer 32 Yes
CurrentPitcher integer 32 Yes
ExtraInningsPlayed integer 32 Yes
Clock integer 32 Yes
Clock integer 32 Yes
Period1Started datetime Yes
Period2Started datetime Yes
Period3Started datetime Yes
FirstHalfEnded datetime Yes
SecondHalfStarted datetime Yes
SecondHalfEnded datetime Yes
LineupConfirmed boolean Yes
Clock integer 32 Yes
ClockExtra integer 32 Yes
Represents a participant (team or individual) in an event
Name Type Size Nullable Description
GlobalSportsParticipantId integer 32 No The unchanging ID number of this specific participant.
Name string 50 Yes The name of this participant.
Type string 50 Yes The type of participant (e.g., team, individual).
Results AmFootballParticipantResults No
Results BaseballParticipantResults No
Results BasketballParticipantResults No
Results IceHockeyParticipantResults No
Results SoccerParticipantResults No
Results TennisParticipantResults No
Side string 50 Yes
SideFirstToServe boolean Yes
Represents the results recorded for a participant in an event
Name Type Size Nullable Description
Score integer 32 Yes
ScoreOrdinaryTime integer 32 Yes
ScoreFinal integer 32 Yes
Hits integer 32 Yes
Errors integer 32 Yes
Periods Period[] Yes
Score integer 32 Yes
ScoreOrdinaryTime integer 32 Yes
ScoreHalftime integer 32 Yes
ScoreFinal integer 32 Yes
Periods Period[] Yes
Score integer 32 Yes
ScoreOrdinaryTime integer 32 Yes
ScoreFinal integer 32 Yes
ScoreOvertime integer 32 Yes
ScorePenaltyShootout integer 32 Yes
Periods Period[] Yes
Score integer 32 Yes
ScorePeriod1 integer 32 Yes
ScorePeriod2 integer 32 Yes
ScoreOrdinaryTime integer 32 Yes
ScoreExtraTime integer 32 Yes
ScorePenalty integer 32 Yes
SetsWon integer 32 Yes
GameScore string 50 Yes
Win boolean Yes
SideCurrentlyServing boolean Yes
Periods TennisPeriod[] Yes
Represents a scoring period within an event (e.g., half, quarter, set)
Name Type Size Nullable Description
Name string 50 Yes The name of this period (e.g., 1st Half, 3rd Quarter, Set 1).
Type string 50 Yes The type of period (e.g., half, quarter, set, overtime).
Order integer 32 No The sequential order of this period within the event.
Score integer 32 Yes The score recorded during this period.
TiebreakScore integer 32 Yes
Represents a specific phase of a competition's season (eg Reg, Pre, Post, etc)
This table is used in the following endpoints:
  • Sport & Competition Feeds
    • Sports & Competitions
Name Type Size Nullable Description
GlobalSportsPhaseId integer 32 No The unchanging ID number of this specific phase
Name string 500 Yes The name of this phase (e.g., Regular Season, Playoffs).
GlobalSportsSeasonId integer 32 No The unique ID of the season to which this phase belongs.
StartDate datetime Yes The date and time this phase begins.
EndDate datetime Yes The date and time this phase ends.
Properties object Yes Additional sport- and competition-specific properties for this phase.
Represents a round within a phase
This table is used in the following endpoints:
Name Type Size Nullable Description
Name string 50 Yes The human readable name of this round
Knockout boolean Yes Whether or not this is a knockout (i.e. elimination) round
Represents a specific season for a competition/league
This table is used in the following endpoints:
  • Sport & Competition Feeds
Name Type Size Nullable Description
GlobalSportsSeasonId integer 32 No The unchanging ID number of this specific season
Name string 500 Yes The name of this season.
GlobalSportsCompetitionId integer 32 No The unique ID of the competition to which this season belongs.
CompetitionName string 50 Yes The name of the competition to which this season belongs.
GlobalSportsSportId integer 32 No The unique ID of the sport to which this season belongs.
SportName string 50 Yes The name of the sport to which this season belongs.
Updated datetime Yes The date and time this record was last updated.
Properties object Yes Additional sport- and competition-specific properties for this season.
Represents a playable sport
This table is used in the following endpoints:
  • Sport & Competition Feeds
    • Sports & Competitions
Name Type Size Nullable Description
GlobalSportsSportId integer 32 No The unchanging ID number of this specific sport
Name string 50 Yes The name of this sport
Slug string 50 Yes The slug used to call this sport in the API's URL
Represents a team within a given sport
This table is used in the following endpoints:
  • Sport & Competition Feeds
    • Teams, Players & Rosters
Name Type Size Nullable Description
GlobalSportsParticipantId integer 32 No The unchanging ID number of this specific team
Name string 50 Yes The name of this team.
Type string 50 Yes The type of team (e.g., club, national).
CountryName string 50 Yes The name of the country this team is associated with.
Updated datetime Yes The date and time this record was last updated.
HomePage string 50 Yes The URL of this team's official website.
IsNationalTeam boolean Yes Whether this team is a national team.
Properties object Yes Additional sport-specific properties for this team.
This table is used in the following endpoints:
Name Type Size Nullable Description
EventTypeName string 50 Yes
Sets integer 32 Yes
LastSetTiebreak boolean Yes
LastSetTiebreakTo integer 32 Yes
LastSetTiebreakAfter string 50 Yes
Represents a physical location where events take place
This table is used in the following endpoints:
  • Sport & Competition Feeds
Name Type Size Nullable Description
GlobalSportsVenueId integer 32 No The unchanging ID number of this specific venue.
Name string 50 Yes The name of this venue.
VenueType string 50 Yes The type of venue (e.g., stadium, arena, course).
CountryName string 50 Yes The name of the country this venue is located in.
Updated datetime Yes The date and time this record was last updated.
City string 50 Yes The city in which this venue is located.
Capacity integer 32 Yes The seating capacity of this venue.
Longitude decimal 32 Yes The geographic longitude coordinate of this venue.
Latitude decimal 32 Yes The geographic latitude coordinate of this venue.
Copyright © 2026 SportsDataIOTM
Contact Us