⏱️
Update Frequency
300s Time To Live / Cache

Data Points

Category & Sport

Attribute	Parent Element	Type	Description
`country_code`	`sport_event_context` - `category`	String	Country code for a sport event's category ex. `ENG` (England)
`id`	`sport_event_context` - `category`	String	Unique category ID for a sport event ex. `sr:category:83`
`name`	`sport_event_context` - `category`	String	Name for a sport event's category ex. `Rugby League`
`id`	`sport_event_context` - `sport`	String	Unique sport ID for a sport event ex. `sr:sport:12`
`name`	`sport_event_context` - `sport`	String	Name for a sport event's sport ex. `Rugby`

Competition

Attribute	Parent Element	Type	Description
`gender`	`sport_event_context` - `competition`	String	Gender for a competition `men`, `women`
`id`	`sport_event_context` - `competition`	String	Unique ID for a competition ex. `sr:competition:302` (Super League)
`name`	`sport_event_context` - `competition`	String	Name of a competition ex. `Super League`, `NRL, Women`

Groups

Attribute	Parent Element	Type	Description
`id`	`sport_event_context` - `groups` - `group`	String	Unique ID for a sport event's group ex. `sr:league:80301` (Super League 2024)
`name`	`sport_event_context` - `groups` - `group`	String	Name of a sport event's group ex. `Super League 2024`, `Super League 2024, Playoffs`
`group_name`	`sport_event_context` - `groups` - `group`	String	Abbreviated name of a sport event's group ex. `D`

Rounds

Attribute	Parent Element	Type	Description
`competition_sport_event_number`	`sport_event_context` - `round`	Integer	Sport event number within a competition. Used for competitions that have fixed match numbers.
`cup_round_id`	`sport_event_context` - `round`	String	Unique ID for a sport event's cup round ex. `sr:cup_round:2120411`
`cup_round_number_of_sport_events`	`sport_event_context` - `round`	Integer	Number of events in a sport event's round
`cup_round_sport_event_number`	`sport_event_context` - `round`	Integer	Number within the `cup_round` of a match ID. For example, 1st leg of 2
`name`	`sport_event_context` - `round`	String	Name of a sport event's round ex. `semifinal` or `final`
`number`	`sport_event_context` - `round`	Integer	Number of a sport event's round
`other_sport_event_id`	`sport_event_context` - `round`	String	A linked sport event ID, typically in a two-legged tie ex. `sr:sport_event:47395897`

Seasons

Attribute	Parent Element	Type	Description
`competition_id`	`sport_event_context` - `season`	String	Unique ID for the competition a sport event belongs to ex. `sr:competition:302` (Super League)
`disabled`	`sport_event_context` - `season`	Boolean	Signifies a season has been disabled when `true`
`end_date`	`sport_event_context` - `season`	Date	End date of a sport event's season ex. `2024-10-12`
`id`	`sport_event_context` - `season`	String	Unique ID for a sport event's season ex. `sr:season:112664` (Super League 2024)
`name`	`sport_event_context` - `season`	String	Name of a sport event's season ex. `Super League 2024`
`start_date`	`sport_event_context` - `season`	Date	Start date of a sport event's season ex. `2024-02-15`
`year`	`sport_event_context` - `season`	String	Year of a sport event's season ex. `2024`

Stages

Attribute	Parent Element	Type	Description
`end_date`	`sport_event_context` - `stage`	Date	End date of a sport event's stage ex. `2024-09-21`
`order`	`sport_event_context` - `stage`	Integer	Order of a stage within a season
`phase`	`sport_event_context` - `stage`	String	Name of a sport event's stage ex. `final_phase`, `knockout_stage`, `playoffs` See the enum_phase entry in our Rugby OpenAPI specs for a complete list of valid `phase` enum values
`start_date`	`sport_event_context` - `stage`	Date	Start date of a sport event's stage ex. `2024-02-15`
`type`	`sport_event_context` - `stage`	String	Type of a sport event's stage `cup`, `league`
`year`	`sport_event_context` - `stage`	String	Year of a sport event's stage ex. `2024`

Competitor

Attribute	Parent Element	Type	Description
`abbreviation`	`competitors` - `competitor`	String	Abbreviation for a competitor name ex. `WGW` (Wigan Warriors)
`age_group`	`competitors` - `competitor`	String	Age group of a competitor, when applicable ex. `U23`
`gender`	`competitors` - `competitor`	String	Gender for a competitor `male`, `female`
`id`	`competitors` - `competitor`	String	Unique ID for a competitor ex. `sr:competitor:4233` (Wigan Warriors)
`name`	`competitors` - `competitor`	String	Name for a competitor ex. `Wigan Warriors`
`qualifier`	`competitors` - `competitor`	String	Designation of a competitor for a sport event `home`, `away`
`virtual`	`competitors` - `competitor`	Boolean	Signifies a competitor is a virtual team whan `true`. Used for placeholder teams in TBD vs TBD matchups.

Player

Attribute	Parent Element	Type	Description
`id`	`statistics` - `competitor` - `player`	String	Unique ID of a player ex. `sr:player:474906`
`name`	`statistics` - `competitor` - `player`	String	Name of a player ex. `Gallo, Thomas`

Sport Event

Attribute	Parent Element	Type	Description
`id`	`sport_event`	String	Unique ID of a sport event ex. `sr:sport_event:53800561`
`replaced_by`	`sport_event`	String	An alternative sport event ID if the match is postponed and played at a later date ex. `sr:sport_event:47395897`
`resume_time`	`sport_event`	Date	An updated timestamp if there is a delay at the start or interruption during a match ex. `2024-03-26T20:00:00+00:00`
`start_time`	`sport_event`	Date	Start time of a sport event ex. `2024-03-26T20:00:00+00:00`
`start_time_confirmed`	`sport_event`	Boolean	Signifies the start time of a sport event is confirmed when `true`
`overall_conditions`	`sport_event_conditions` - `weather`	String	Weather conditions for a sport event `good`, `medium`, `bad`, `indoor`, `extreme`
`pitch_conditions`	`sport_event_conditions` - `weather`	String	Pitch conditions for a sport event `good`, `medium`, `bad`

Sport Event - Coverage Properties

Attribute	Parent Element	Type	Description
`live`	`sport_event` - `coverage`	Boolean	Signifies a sport event is covered live when `true`
`type`	`sport_event` - `coverage` - `property`	String	Type of coverage for a sport event ex. `boxscore`, `lineups`, `match_clock`
`value`	`sport_event` - `coverage` - `property`	Boolean	Signifies a coverage type is available when `true` For example, `type="boxscore" value="true"` signifies additional team and player stats are available for this sport event. See our FAQ for more info on coverage.

Sport Event - Referee

Attribute	Parent Element	Type	Description
`id`	`sport_event_conditions` - `referees` - `referee`	String	Unique ID for a referee ex. `sr:referee:766676`
`name`	`sport_event_conditions` - `referees` - `referee`	String	Name of a referee ex. `Ridley, Christophe`
`nationality`	`sport_event_conditions` - `referees` - `referee`	String	Nationality of a referee ex. `Wales`
`country_code`	`sport_event_conditions` - `referees` - `referee`	String	Country code of a referee ex. `WAL`
`type`	`sport_event_conditions` - `referees` - `referee`	String	Type of a referee ex. `main_referee`

Sport Event Status

Attribute	Parent Element	Type	Description
`away_score`	`sport_event_status`	Integer	Total score for the away team in the match
`away_normaltime_score`	`sport_event_status`	Integer	Score for the away team in normal time
`home_score`	`sport_event_status`	Integer	Total score for the home team in the match
`home_normaltime_score`	`sport_event_status`	Integer	Score for the home team in normal time
`match_status`	`sport_event_status`	String	Status within a match (sport event). Provides more detail on the state of a sport event when live than `status` ex. `not_started`, `1st_quarter`, `ended`, `cancelled` See our FAQ for a complete list of statuses and their definitions.
`match_tie`	`sport_event_status`	Boolean	Signifies a match ended in a tie when `true`
`scount_abandoned`	`sport_event_status`	Boolean	Signifies a sport event was abandoned by a scout when `true`
`status`	`sport_event_status`	String	Status of a sport event ex. `not_started`, `live`, `ended`, `closed` See our FAQ for a complete list of statuses and their definitions.
`winner_id`	`sport_event_status`	String	Unique ID of the match winner ex. `sr:competitor:4231`

Period Scores

Attribute	Parent Element	Type	Description
`away_score`	`sport_event_status` - `period_scores` - `period_score`	Integer	Away team period score
`home_score`	`sport_event_status` - `period_scores` - `period_score`	Integer	Home team period score
`number`	`sport_event_status` - `period_scores` - `period_score`	Integer	Period number
`type`	`sport_event_status` - `period_scores` - `period_score`	String	Period type ex. `1st_half`, `2nd_half`, `pause`, `1st_extra`, `2nd_extra`, `extra_time_halftime`, `awaiting_extra`, `interrupted`, `overtime`, `regular_period`

Game Stats (Player)

Attribute	Parent Element	Type	Description
`carries`	`player` - `statistics`	Integer	Number of carries for a player in a match
`clean_breaks`	`player` - `statistics`	Integer	Number of clean breaks for a player in a match
`meters_run`	`player` - `statistics`	Integer	Number of meters run for a player in a match
`offloads`	`player` - `statistics`	Integer	Number of offloads for a player in a match
`passes`	`player` - `statistics`	Integer	Number of passes for a player in a match
`tackle_missed`	`player` - `statistics`	Integer	Number of missed tackles for a player in a match
`tackles`	`player` - `statistics`	Integer	Number of tackles for a player in a match
`try_assist`	`player` - `statistics`	Integer	Number of try assists for a player in a match
`turnovers_won`	`player` - `statistics`	Integer	Number of turnovers won for a player in a match

Game Stats (Team)

Attribute	Parent Element	Type	Description
`ball_possession`	`competitor` - `statistics`	Integer	Percentage of team ball possession for a match
`carries`	`competitor` - `statistics`	Integer	Number of carries for a team in a match
`clean_breaks`	`competitor` - `statistics`	Integer	Number of clean breaks for a team in a match
`conversions`	`competitor` - `statistics`	Integer	Number of conversions for a team in a match
`drop_goals`	`competitor` - `statistics`	Integer	Number of drop goals for a team in a match
`lineouts_won`	`competitor` - `statistics`	Integer	Number of lineouts won for a team in a match
`meters_run`	`competitor` - `statistics`	Integer	Number of meters run for a team in a match
`offloads`	`competitor` - `statistics`	Integer	Number of offloads for a team in a match
`passes`	`competitor` - `statistics`	Integer	Number of passes for a team in a match
`penalties_conceded`	`competitor` - `statistics`	Integer	Number of penalties conceded for a team in a match
`penalty_goals`	`competitor` - `statistics`	Integer	Number of penalty goals for a team in a match
`red_cards`	`competitor` - `statistics`	Integer	Number of red cards for a team in a match
`scrums_lost`	`competitor` - `statistics`	Integer	Number of scrums lost for a team in a match
`scrums_won`	`competitor` - `statistics`	Integer	Number of scrums won for a team in a match
`tackle_missed`	`competitor` - `statistics`	Integer	Number of tackles missed for a team in a match
`tackles`	`competitor` - `statistics`	Integer	Number of tackles for a team in a match
`total_scrums`	`competitor` - `statistics`	Integer	Number of total scrums for a team in a match
`tries`	`competitor` - `statistics`	Integer	Number of tries for a team in a match
`try_assist`	`competitor` - `statistics`	Integer	Number of try assists for a team in a match
`turnovers_won`	`competitor` - `statistics`	Integer	Number of turnovers won for a team in a match
`yellow_cards`	`competitor` - `statistics`	Integer	Number of yellow cards for a team in a match

Venue

Attribute	Parent Element	Type	Description
`capacity`	`venue`	Integer	Capacity of a venue ex. `25138`
`changed`	`venue`	Boolean	Signifies a venue has been changed when `true`
`city_name`	`venue`	String	City name of a venue ex. `Wigan`
`country_code`	`venue`	String	Country code of a venue ex. `ENG` (England)
`country_name`	`venue`	String	Country name of a venue ex. `England`
`id`	`venue`	String	Unique ID of a venue ex. `sr:venue:666`
`map_coordinates`	`venue`	String	Coordinates of a venue ex. `53.547367,-2.654146`
`name`	`venue`	String	Name of a venue ex. `DW Stadium`
`reduced_capacity`	`venue`	Boolean	Optional attribute signifying a venue has a restricted capacity when `true`
`reduced_capacity_max`	`venue`	Integer	Value of a venue's restricted capacity
`timezone`	`venue`	String	Timezone of a venue ex. `Europe/London`