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
- Teams, Players & Rosters
| Name | Type (Size) | Nullable | Description |
|---|---|---|---|
| GlobalSportsParticipantId | integer (32) | NOT NULL | The unchanging ID number of this specific person |
| Name | string (500) | NULL | The name of this athlete. |
| Type | string (50) | NULL | The type of athlete (e.g., player, coach). |
| Gender | string (50) | NULL | The gender of this athlete. |
| CountryName | string (50) | NULL | The name of the country this athlete is associated with. |
| Updated | datetime | NULL | The date and time this record was last updated. |
| Status | string (50) | NULL | The current activity status of this athlete (e.g., Active, Inactive). |
| DateOfBirth | string (50) | NULL | The date of birth of this athlete. |
| Height | integer (32) | NULL | The height of this athlete in centimeters |
| Weight | integer (32) | NULL | The weight of this athlete in kilograms. |
| Properties | object (0) | NULL | Additional 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
- Sports & Competitions
| Name | Type (Size) | Nullable | Description |
|---|---|---|---|
| GlobalSportsCompetitionId | integer (32) | NOT NULL | The unchanging ID number of this specific competition. |
| Name | string (500) | NULL | The name of this competition/league |
| Key | string (50) | NULL | The unique key of this competition |
| GlobalSportsSportId | integer (32) | NOT NULL | The unique ID of the sport to which this competition belongs. |
| DisplayName | string (500) | NULL | The friendly display name of this competition |
| Slug | string (500) | NULL | The 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:
-
Event Feeds
- Event Schedules & Game Day Info
-
Scores & Game State
- Final Only (No Game State)
- Live & Final (With Game State)
| Name | Type (Size) | Nullable | Description |
|---|---|---|---|
| GlobalSportsEventId | integer (32) | NOT NULL | The unchanging ID number of this specific event |
| GlobalSportsPhaseId | integer (32) | NOT NULL | The unchanging ID number of the phase to which this event belongs |
| Name | string (50) | NULL | The name of this event. |
| StartDate | datetime | NULL | The scheduled start date and time of this event. |
| Status | string (50) | NULL | The current status of this event. |
| StatusDescription | string (50) | NULL | A human-readable description of the current event status. |
| Updated | datetime | NULL | The date and time this record was last updated. |
| LiveCoverage | boolean | NULL | Whether this event has live score coverage available. |
| Attendance | integer (32) | NULL | The recorded attendance for this event. |
| Closed | boolean | NULL | Whether the results for this event have been confirmed and finalized. |
| Venue | string (50) | NULL | The name of the venue where this event takes place. |
EventState
Represents the live timing state of an event
| Name | Type (Size) | Nullable | Description |
|---|---|---|---|
| EventStarted | datetime | NULL | The actual date and time this event started. |
| EventEnded | datetime | NULL | The actual date and time this event ended. |
Participant
Represents a participant (team or individual) in an event
| Name | Type (Size) | Nullable | Description |
|---|---|---|---|
| GlobalSportsParticipantId | integer (32) | NOT NULL | The unchanging ID number of this specific participant. |
| Name | string (50) | NULL | The name of this participant. |
| Type | string (50) | NULL | The type of participant (e.g., team, individual). |
ParticipantResults
Represents the results recorded for a participant in an event
| Name | Type (Size) | Nullable | Description |
|---|
Period
Represents a scoring period within an event (e.g., half, quarter, set)
| Name | Type (Size) | Nullable | Description |
|---|---|---|---|
| Name | string (50) | NULL | The name of this period (e.g., 1st Half, 3rd Quarter, Set 1). |
| Type | string (50) | NULL | The type of period (e.g., half, quarter, set, overtime). |
| Order | integer (32) | NOT NULL | The sequential order of this period within the event. |
| Score | integer (32) | NULL | The score recorded during this period. |
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
| Name | Type (Size) | Nullable | Description |
|---|---|---|---|
| GlobalSportsPhaseId | integer (32) | NOT NULL | The unchanging ID number of this specific phase |
| Name | string (500) | NULL | The name of this phase (e.g., Regular Season, Playoffs). |
| GlobalSportsSeasonId | integer (32) | NOT NULL | The unique ID of the season to which this phase belongs. |
| StartDate | datetime | NULL | The date and time this phase begins. |
| EndDate | datetime | NULL | The date and time this phase ends. |
| Properties | object | NULL | Additional 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:
-
Event Feeds
- Event Schedules & Game Day Info
-
Scores & Game State
- Final Only (No Game State)
- Live & Final (With Game State)
| Name | Type (Size) | Nullable | Description |
|---|---|---|---|
| Name | string (50) | NULL | The human readable name of this round |
| Knockout | boolean | NULL | Whether 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
- Sports & Competitions
| Name | Type (Size) | Nullable | Description |
|---|---|---|---|
| GlobalSportsSeasonId | integer (32) | NOT NULL | The unchanging ID number of this specific season |
| Name | string (500) | NULL | The name of this season. |
| GlobalSportsCompetitionId | integer (32) | NOT NULL | The unique ID of the competition to which this season belongs. |
| CompetitionName | string (50) | NULL | The name of the competition to which this season belongs. |
| GlobalSportsSportId | integer (32) | NOT NULL | The unique ID of the sport to which this season belongs. |
| SportName | string (50) | NULL | The name of the sport to which this season belongs. |
| Updated | datetime | NULL | The date and time this record was last updated. |
| Properties | object | NULL | Additional 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
| Name | Type (Size) | Nullable | Description |
|---|---|---|---|
| GlobalSportsSportId | integer (32) | NOT NULL | The unchanging ID number of this specific sport |
| Name | string (50) | NULL | The name of this sport |
| Slug | string (50) | NULL | The 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
| Name | Type (Size) | Nullable | Description |
|---|---|---|---|
| GlobalSportsParticipantId | integer (32) | NOT NULL | The unchanging ID number of this specific team |
| Name | string (50) | NULL | The name of this team. |
| Type | string (50) | NULL | The type of team (e.g., club, national). |
| CountryName | string (50) | NULL | The name of the country this team is associated with. |
| Updated | datetime | NULL | The date and time this record was last updated. |
| HomePage | string (50) | NULL | The URL of this team's official website. |
| IsNationalTeam | boolean | NULL | Whether this team is a national team. |
| Properties | object | NULL | Additional sport-specific properties for this team. |
TennisEventFormat
Available Endpoints
This table is used in the following endpoints:
-
Event Feeds
- Event Schedules & Game Day Info
-
Scores & Game State
- Final Only (No Game State)
- Live & Final (With Game State)
| Name | Type (Size) | Nullable | Description |
|---|---|---|---|
| EventTypeName | string (50) | NULL | |
| Sets | integer (32) | NULL | |
| LastSetTiebreak | boolean | NULL | |
| LastSetTiebreakTo | integer (32) | NULL | |
| LastSetTiebreakAfter | string (50) | NULL |
Venue
Represents a physical location where events take place
Available Endpoints
This table is used in the following endpoints:
-
Sport & Competition Feeds
- Venues & Officials
| Name | Type (Size) | Nullable | Description |
|---|---|---|---|
| GlobalSportsVenueId | integer (32) | NOT NULL | The unchanging ID number of this specific venue. |
| Name | string (50) | NULL | The name of this venue. |
| VenueType | string (50) | NULL | The type of venue (e.g., stadium, arena, course). |
| CountryName | string (50) | NULL | The name of the country this venue is located in. |
| Updated | datetime | NULL | The date and time this record was last updated. |
| City | string (50) | NULL | The city in which this venue is located. |
| Capacity | integer (32) | NULL | The seating capacity of this venue. |
| Longitude | decimal (32) | NULL | The geographic longitude coordinate of this venue. |
| Latitude | decimal (32) | NULL | The geographic latitude coordinate of this venue. |