Skip to main content

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...
Athlete
Represents a human athlete
Available Endpoints
This table is used in the following endpoints:
  • Sport & Competition Feeds
NameType (Size)NullableDescription
GlobalSportsParticipantIdinteger (32)NOT NULLThe unchanging ID number of this specific person
Namestring (500)NULLThe name of this athlete.
Typestring (50)NULLThe type of athlete (e.g., player, coach).
Genderstring (50)NULLThe gender of this athlete.
CountryNamestring (50)NULLThe name of the country this athlete is associated with.
UpdateddatetimeNULLThe date and time this record was last updated.
Statusstring (50)NULLThe current activity status of this athlete (e.g., Active, Inactive).
DateOfBirthstring (50)NULLThe date of birth of this athlete.
Heightinteger (32)NULLThe height of this athlete in centimeters
Weightinteger (32)NULLThe weight of this athlete in kilograms.
Propertiesobject (0)NULLAdditional sport-specific properties for this athlete.
Competition
Represents a specific competition/league for the given sport
Available Endpoints
This table is used in the following endpoints:
  • Sport & Competition Feeds
NameType (Size)NullableDescription
GlobalSportsCompetitionIdinteger (32)NOT NULLThe unchanging ID number of this specific competition.
Namestring (500)NULLThe name of this competition/league
Keystring (50)NULLThe unique key of this competition
GlobalSportsSportIdinteger (32)NOT NULLThe unique ID of the sport to which this competition belongs.
DisplayNamestring (500)NULLThe friendly display name of this competition
Slugstring (500)NULLThe unique URL slug of this competition
Event
Represents a specific event (e.g. a game, match or race)
Available Endpoints
This table is used in the following endpoints:
NameType (Size)NullableDescription
GlobalSportsEventIdinteger (32)NOT NULLThe unchanging ID number of this specific event
GlobalSportsPhaseIdinteger (32)NOT NULLThe unchanging ID number of the phase to which this event belongs
Namestring (50)NULLThe name of this event.
StartDatedatetimeNULLThe scheduled start date and time of this event.
Statusstring (50)NULLThe current status of this event.
StatusDescriptionstring (50)NULLA human-readable description of the current event status.
UpdateddatetimeNULLThe date and time this record was last updated.
LiveCoveragebooleanNULLWhether this event has live score coverage available.
Attendanceinteger (32)NULLThe recorded attendance for this event.
ClosedbooleanNULLWhether the results for this event have been confirmed and finalized.
Venuestring (50)NULLThe name of the venue where this event takes place.
RoundInfoRoundInfoNOT NULLThe Round to which this Event belongs
EventStateAmFootballEventStateNOT NULLThe current State of the Event
ParticipantsAmFootballParticipant[]NULLThe records of the Participant(s) involved in the Event
RoundInfoRoundInfoNOT NULL
EventStateBaseballEventStateNOT NULL
ParticipantsBaseballParticipant[]NULL
RoundInfoRoundInfoNOT NULL
EventStateBasketballEventStateNOT NULL
ParticipantsBasketballParticipant[]NULL
RoundInfoRoundInfoNOT NULL
EventStateIceHockeyEventStateNOT NULL
ParticipantsIceHockeyParticipant[]NULL
RoundInfoRoundInfoNOT NULLThe information about the round to which the event belongs.
EventStateSoccerEventStateNOT NULLThe status of the event.
ParticipantsSoccerParticipant[]NULLThe participants involved in this event.
RoundInfoRoundInfoNOT NULL
EventStateTennisEventStateNOT NULL
ParticipantsTennisParticipant[]NULL
StatusCommentstring (50)NULL
FormatTennisEventFormatNOT NULL
EventState
Represents the live timing state of an event
NameType (Size)NullableDescription
EventStarteddatetimeNULLThe actual date and time this event started.
EventEndeddatetimeNULLThe actual date and time this event ended.
Outsinteger (32)NULL
BallCountinteger (32)NULL
StrikeCountinteger (32)NULL
RunnerOnFirstbooleanNULL
RunnerOnSecondbooleanNULL
RunnerOnThirdbooleanNULL
CurrentBatterinteger (32)NULL
CurrentPitcherinteger (32)NULL
ExtraInningsPlayedinteger (32)NULL
Clockinteger (32)NULL
Clockinteger (32)NULL
Period1StarteddatetimeNULL
Period2StarteddatetimeNULL
Period3StarteddatetimeNULL
FirstHalfEndeddatetimeNULLWhat time and date the first half of regular time ended.
SecondHalfStarteddatetimeNULLWhat time and date the second half of regular time started.
SecondHalfEndeddatetimeNULLWhat time and date the second half of regular time ended.
LineupConfirmedbooleanNULLWhether the starting eleven for both teams has been confirmed or if it is still unconfirmed.
Clockinteger (32)NULLThe game clock in minutes.
ClockExtrainteger (32)NULLTime added on (aka stoppage time or injury time) in minutes.
Participant
Represents a participant (team or individual) in an event
NameType (Size)NullableDescription
GlobalSportsParticipantIdinteger (32)NOT NULLThe unchanging ID number of this specific participant.
Namestring (50)NULLThe name of this participant.
Typestring (50)NULLThe type of participant (e.g., team, individual).
ResultsAmFootballParticipantResultsNOT NULL
ResultsBaseballParticipantResultsNOT NULL
ResultsBasketballParticipantResultsNOT NULL
ResultsIceHockeyParticipantResultsNOT NULL
ResultsSoccerParticipantResultsNOT NULLContains the results for this participant in their event.
ResultsTennisParticipantResultsNOT NULL
Sidestring (50)NULL
SideFirstToServebooleanNULL
ParticipantResults
Represents the results recorded for a participant in an event
NameType (Size)NullableDescription
Scoreinteger (32)NULL
ScoreOrdinaryTimeinteger (32)NULL
ScoreFinalinteger (32)NULL
Hitsinteger (32)NULL
Errorsinteger (32)NULL
PeriodsPeriod[]NULL
Scoreinteger (32)NULL
ScoreOrdinaryTimeinteger (32)NULL
ScoreHalftimeinteger (32)NULL
ScoreFinalinteger (32)NULL
PeriodsPeriod[]NULL
Scoreinteger (32)NULL
ScoreOrdinaryTimeinteger (32)NULL
ScoreFinalinteger (32)NULL
ScoreOvertimeinteger (32)NULL
ScorePenaltyShootoutinteger (32)NULL
PeriodsPeriod[]NULL
Scoreinteger (32)NULLThe team's score of the total game, excluding penalty shoot-out.
ScorePeriod1integer (32)NULLThe team's score of the first half.
ScorePeriod2integer (32)NULLThe team's score of the second half.
ScoreOrdinaryTimeinteger (32)NULLThe team's score of the regulation time (i.e. 90 minutes plus stoppages, no extra time or penalties.)
ScoreExtraTimeinteger (32)NULLThe team's score of both periods of extra time.
ScorePenaltyinteger (32)NULLThe team's score of the penalty shootout.
SetsWoninteger (32)NULL
GameScorestring (50)NULL
WinbooleanNULL
SideCurrentlyServingbooleanNULL
PeriodsTennisPeriod[]NULL
Period
Represents a scoring period within an event (e.g., half, quarter, set)
NameType (Size)NullableDescription
Namestring (50)NULLThe name of this period (e.g., 1st Half, 3rd Quarter, Set 1).
Typestring (50)NULLThe type of period (e.g., half, quarter, set, overtime).
Orderinteger (32)NOT NULLThe sequential order of this period within the event.
Scoreinteger (32)NULLThe score recorded during this period.
TiebreakScoreinteger (32)NULL
Phase
Represents a specific phase of a competition's season (eg Reg, Pre, Post, etc)
Available Endpoints
This table is used in the following endpoints:
  • Sport & Competition Feeds
    • Sports & Competitions
NameType (Size)NullableDescription
GlobalSportsPhaseIdinteger (32)NOT NULLThe unchanging ID number of this specific phase
Namestring (500)NULLThe name of this phase (e.g., Regular Season, Playoffs).
GlobalSportsSeasonIdinteger (32)NOT NULLThe unique ID of the season to which this phase belongs.
StartDatedatetimeNULLThe date and time this phase begins.
EndDatedatetimeNULLThe date and time this phase ends.
PropertiesobjectNULLAdditional sport- and competition-specific properties for this phase.
RoundInfo
Represents a round within a phase
Available Endpoints
This table is used in the following endpoints:
NameType (Size)NullableDescription
Namestring (50)NULLThe human readable name of this round
KnockoutbooleanNULLWhether or not this is a knockout (i.e. elimination) round
Season
Represents a specific season for a competition/league
Available Endpoints
This table is used in the following endpoints:
  • Sport & Competition Feeds
NameType (Size)NullableDescription
GlobalSportsSeasonIdinteger (32)NOT NULLThe unchanging ID number of this specific season
Namestring (500)NULLThe name of this season.
GlobalSportsCompetitionIdinteger (32)NOT NULLThe unique ID of the competition to which this season belongs.
CompetitionNamestring (50)NULLThe name of the competition to which this season belongs.
GlobalSportsSportIdinteger (32)NOT NULLThe unique ID of the sport to which this season belongs.
SportNamestring (50)NULLThe name of the sport to which this season belongs.
UpdateddatetimeNULLThe date and time this record was last updated.
PropertiesobjectNULLAdditional sport- and competition-specific properties for this season.
Sport
Represents a playable sport
Available Endpoints
This table is used in the following endpoints:
  • Sport & Competition Feeds
    • Sports & Competitions
NameType (Size)NullableDescription
GlobalSportsSportIdinteger (32)NOT NULLThe unchanging ID number of this specific sport
Namestring (50)NULLThe name of this sport
Slugstring (50)NULLThe slug used to call this sport in the API's URL
Team
Represents a team within a given sport
Available Endpoints
This table is used in the following endpoints:
  • Sport & Competition Feeds
    • Teams, Players & Rosters
NameType (Size)NullableDescription
GlobalSportsParticipantIdinteger (32)NOT NULLThe unchanging ID number of this specific team
Namestring (50)NULLThe name of this team.
Typestring (50)NULLThe type of team (e.g., club, national).
CountryNamestring (50)NULLThe name of the country this team is associated with.
UpdateddatetimeNULLThe date and time this record was last updated.
HomePagestring (50)NULLThe URL of this team's official website.
IsNationalTeambooleanNULLWhether this team is a national team.
PropertiesobjectNULLAdditional sport-specific properties for this team.
TennisEventFormat
Available Endpoints
This table is used in the following endpoints:
NameType (Size)NullableDescription
EventTypeNamestring (50)NULL
Setsinteger (32)NULL
LastSetTiebreakbooleanNULL
LastSetTiebreakTointeger (32)NULL
LastSetTiebreakAfterstring (50)NULL
Venue
Represents a physical location where events take place
Available Endpoints
This table is used in the following endpoints:
  • Sport & Competition Feeds
NameType (Size)NullableDescription
GlobalSportsVenueIdinteger (32)NOT NULLThe unchanging ID number of this specific venue.
Namestring (50)NULLThe name of this venue.
VenueTypestring (50)NULLThe type of venue (e.g., stadium, arena, course).
CountryNamestring (50)NULLThe name of the country this venue is located in.
UpdateddatetimeNULLThe date and time this record was last updated.
Citystring (50)NULLThe city in which this venue is located.
Capacityinteger (32)NULLThe seating capacity of this venue.
Longitudedecimal (32)NULLThe geographic longitude coordinate of this venue.
Latitudedecimal (32)NULLThe geographic latitude coordinate of this venue.
Contact Us