Syntax

https://api.sportradar.com/rugby-{package}/{access_level}/stream/statistics/subscribe

Parameters

Parameter	Description
`package`	Defines the Rugby package to access `league` (Rugby League), `union` (Rugby Union), `sevens` (Rugby Sevens)
`access_level`	Defines the access level of your API key `production`, `trial`

Optional Query String Parameters

By default, a Push feed will provide all data available for all in progress games. If needed, you can filter the data returned by including query strings.

Each query string parameter can be added with a preceding ampersand (&).

URL Parameters	Description
`channel`	Channel type `channel=rugby`
`competition_id`	Competition id Example: `competition_id=sr:competition:421`
`event_id`	Event type Example: `event_id=score_change`
`format`	Format type `format=json`, `format=xml`
`season_id`	Season id Example: `season_id=sr:season:59616`
`sport_event_id`	Sport event id Example: `sport_event_id=sr:sport_event_id:16166956`
`sport_id`	Sport id `sport_id=sr:sport:12`

Code Samples

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.sportradar.com/rugby-league/trial/stream/statistics/subscribe")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Get.new(url)
request["x-api-key"] = "{your_api_key}"  # Replace with your actual key

response = http.request(request)
puts response.read_body

import requests
import json

headers = {
'x-api-key': 'your_api_key'  # Replace with your actual key
}

r = requests.get(
"https://api.sportradar.com/rugby-league/trial/stream/statistics/subscribe",
headers=headers,
allow_redirects=False
)

redirect_url = r.headers['Location']
r = requests.get(redirect_url, stream=True, headers=headers)

for line in r.iter_lines():
# filter out keep-alive new lines
if line:
decoded_line = line.decode('utf-8')
print(json.loads(decoded_line))

curl -L -X GET 'https://api.sportradar.com/rugby-league/trial/stream/statistics/subscribe' \
-H 'x-api-key: {your_api_key}'

Samples with Query String Params

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.sportradar.com/rugby-league/trial/stream/statistics/subscribe?&format=json&sport_event_id=sr:sport_event_id:16166956")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Get.new(url)
request["x-api-key"] = "{your_api_key}"  # Replace with your actual key

response = http.request(request)
puts response.read_body

import requests
import json

headers = {
'x-api-key': 'your_api_key'  # Replace with your actual key
}

r = requests.get("https://api.sportradar.com/rugby-league/trial/stream/statistics/subscribe",
params = {'format': 'json', 'sport_event_id': 'sr:sport_event_id:16166956'},
allow_redirects=False)

redirect_url = r.headers['Location']
r = requests.get(redirect_url, stream=True)

for line in r.iter_lines():
# filter out keep-alive new lines
if line:
decoded_line = line.decode('utf-8')
print(json.loads(decoded_line))

curl -L -X GET 'api.sportradar.com/rugby-league/trial/stream/statistics/subscribe?&format=json&sport_event_id=sr:sport_event_id:16166956'
-H 'x-api-key: {your_api_key}'

Response Sample

The above commands return json like this.

Data Points

Metadata

Attribute	Parent Element	Type	Description
`channel`	`metadata`	String	Sport of the stream connection ex. `rugby-union`
`competition_id`	`metadata`	String	Unique Id of a competition ex. `sr:competition:421`
`event_id`	`metadata`	String	Type of timeline event ex. `match_started`, `score_change`, `ball_kicked`, `turnover`, `substitution` See our FAQ for a complete list of timeline event values
`format`	`metadata`	String	Format type of the response `json`, `xml`
`season_id`	`metadata`	String	Unique Id of a season ex. `sr:season:59616`
`sport_event_id`	`metadata`	String	Unique Id of a sport event ex. `sr:sport_event_id:16166956`
`sport_id`	`metadata`	String	Unique Id of a sport ex. `sr:sport:12`
`from`	`heartbeat`	Integer	Unix timestamp of the beginning of a heartbeat message ex. `1713804799`
`to`	`heartbeat`	Integer	Unix timestamp of the end of a heartbeat message ex. `1713804804`
`interval`	`heartbeat`	Integer	Interval of a heartbeat message in seconds
`type`	`heartbeat`	String	Type of heartbeat message ex. `events`, `statistics`
`package`	`heartbeat`	String	Package of a heartbeat message ex. `rugby-v3`

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`	Integer	Away team period score
`home_score`	`sport_event_status` - `period_scores`	Integer	Home team period score
`number`	`sport_event_status` - `period_scores`	Integer	Period number
`type`	`sport_event_status` - `period_scores`	String	Period type ex. `1st_half`, `2nd_half`, `pause`, `1st_extra`, `2nd_extra`, `extra_time_halftime`, `awaiting_extra`, `interrupted`, `overtime`, `regular_period`

Player

Attribute	Parent Element	Type	Description
`id`	`statistics` - `competitors` - `players`	String	Unique ID of a player ex. `sr:player:509236`
`name`	`statistics` - `competitors` - `players`	String	Name of a player ex. `Neale, Lachie`

Competitor

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

Game Stats (Player)

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

Game Stats (Team)

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