Rugby v2
API | API Version | XSD Schema |
Rugby | v2 | Download |
Note: Authentication is required for all API calls. |
Examples:
>To find the league leader in points for a given tournament: >- Call the Season List (Current) and find the Season Id for the chosen season
- Call the Season Leaders using the Season Id
- Find the top points statistics and locate the points rank attribute and find the rank 1
- Call the daily schedule or results for the day your chosen team played and find the id for the team
- Call the Team Profile using the Team ID
- Locate your chosen season within the statistics element
- Find the points scored attribute
If our scout feed goes down or becomes unavailable, Sportradar takes over Live Data Entry (LDE) to provide a failover.
In case of a failover, we do not expect a drop of coverage. Yet the failover may cause a delay due to handover between teams.
## Daily Live Results Provides a summary of match results with live updates post-match. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby/trial/v2/league/en/schedules/live/results.xml?api_key={your_api_key}") 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) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/rugby/trial/v2/league/en/schedules/live/results.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/rugby/trial/v2/league/en/schedules/live/results.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Daily Live Results feed by replacing the parameters in the following URL: https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/schedules/live/results.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v2). | | `rugby_type` | Rugby rules type: Union (union) or League (league). | | `language_code` | Optional 2 letter code for supported languages: en (English), ru (Russian), and zh (simplified Chinese). | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Daily Live Results, use the following URL. https://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/results.xsd Return to API map ## Daily Live Summaries Provides a summary of the match with live updates throughout the match. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby/trial/v2/league/en/schedules/live/summaries.xml?api_key={your_api_key}") 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) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/rugby/trial/v2/league/en/schedules/live/summaries.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/rugby/trial/v2/league/en/schedules/live/summaries.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Daily Live Summaries feed by replacing the parameters in the following URL: https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/schedules/live/summaries.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v2). | | `rugby_type` | Rugby rules type: Union (union) or League (league). | | `language_code` | Optional 2 letter code for supported languages: en (English), ru (Russian), and zh (simplified Chinese). | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Daily Live Summaries, use the following URL. https://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/summaries.xsd Return to API map ## Daily Results Provides a summary of match results for all matches played on a given day. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby/trial/v2/league/en/schedules/2017-09-21/results.xml?api_key={your_api_key}") 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) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/rugby/trial/v2/league/en/schedules/2017-09-21/results.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/rugby/trial/v2/league/en/schedules/2017-09-21/results.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Daily Results feed by replacing the parameters in the following URL: https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/schedules/`{year}`-`{month}`-`{day}`/results.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v2). | | `rugby_type` | Rugby rules type: Union (union) or League (league). | | `language_code` | Optional 2 letter code for supported languages: en (English), ru (Russian), and zh (simplified Chinese). | | `year` | Year in 4 digit format (YYYY). | | `month` | Month in 2 digit format (MM). | | `day` | Day of month in 2 digit format (DD). | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Daily Results, use the following URL. https://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/results.xsd Return to API map ## Daily Schedule Provides scheduled match information, for all matches on a given day. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby/trial/v2/league/en/schedules/2016-07-04/schedule.xml?api_key={your_api_key}") 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) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/rugby/trial/v2/league/en/schedules/2016-07-04/schedule.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/rugby/trial/v2/league/en/schedules/2016-07-04/schedule.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Daily Schdule feed by replacing the parameters in the following URL: https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/schedules/`{year}`-`{month}`-`{day}`/schedule.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v2). | | `rugby_type` | Rugby rules type: Union (union) or League (league). | | `language_code` | Optional 2 letter code for supported languages: en (English), ru (Russian), and zh (simplified Chinese). | | `year` | Year in 4 digit format (YYYY). | | `month` | Month in 2 digit format (MM). | | `day` | Day of month in 2 digit format (DD). | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Daily Schedule, use the following URL. https://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/schedule.xsd Return to API map ## Match Lineups Provides full lineups for a given match. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby/trial/v2/league/en/matches/sr:match:12094786/lineups.xml?api_key={your_api_key}") 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) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/rugby/trial/v2/league/en/matches/sr:match:12094786/lineups.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/rugby/trial/v2/league/en/matches/sr:match:12094786/lineups.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Match Lineups feed by replacing the parameters in the following URL: https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/matches/`{match_id}`/lineups.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v2). | | `rugby_type` | Rugby rules type: Union (union) or League (league). | | `language_code` | Optional 2 letter code for supported languages: en (English), ru (Russian), and zh (simplified Chinese). | | `match_id` | Id of a given match. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Match Lineups, use the following URL. https://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/match_lineups.xsd Return to API map ## Match Probabilities Provides 3-way win probabilities (home team win, away team win, draw) for a given match. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby/trial/v2/league/en/matches/sr:match:12094786/probabilities.xml?api_key={your_api_key}") 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) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/rugby/trial/v2/league/en/matches/sr:match:12094786/probabilities.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/rugby/trial/v2/league/en/matches/sr:match:12094786/probabilities.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Match Probabilities feed by replacing the parameters in the following URL: https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/matches/`{match_id}`/probabilities.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v2). | | `rugby_type` | Rugby rules type: Union (union) or League (league). | | `language_code` | Optional 2 letter code for supported languages: en (English), ru (Russian), and zh (simplified Chinese). | | `match_id` | Id of a given match. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for Match Probabilities, use the following URL. https://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/match_probabilities.xsd Return to API map ## Match Summary Provides match information and scoring for a given match. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby/trial/v2/league/en/matches/sr:match:12094786/summary.xml?api_key={your_api_key}") 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) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/rugby/trial/v2/league/en/matches/sr:match:12094786/summary.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/rugby/trial/v2/league/en/matches/sr:match:12094786/summary.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Match Summary feed by replacing the parameters in the following URL: https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/matches/`{match_id}`/summary.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v2). | | `rugby_type` | Rugby rules type: Union (union) or League (league). | | `language_code` | Optional 2 letter code for supported languages: en (English), ru (Russian), and zh (simplified Chinese). | | `match_id` | Id of a given match. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Match Summary, use the following URL. https://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/match_summary.xsd Return to API map ## Match Timeline Provides match information, scoring, match statistics, and event timeline. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby/trial/v2/league/en/matches/sr:match:12094786/timeline.xml?api_key={your_api_key}") 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) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/rugby/trial/v2/league/en/matches/sr:match:12094786/timeline.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/rugby/trial/v2/league/en/matches/sr:match:12094786/timeline.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Match Timeline feed by replacing the parameters in the following URL: https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/matches/`{match_id}`/timeline.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v2). | | `rugby_type` | Rugby rules type: Union (union) or League (league). | | `language_code` | Optional 2 letter code for supported languages: en (English), ru (Russian), and zh (simplified Chinese). | | `match_id` | Id of a given match. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Match Timeline, use the following URL. https://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/match_timeline.xsd Return to API map ## Player Profile Provides player information including and current statistics. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby/trial/v2/league/en/players/sr:player:472906/profile.xml?api_key={your_api_key}") 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) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/rugby/trial/v2/league/en/players/sr:player:472906/profile.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/rugby/trial/v2/league/en/players/sr:player:472906/profile.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Player Profile feed by replacing the parameters in the following URL: https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/players/`{player_id}`/profile.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v2). | | `rugby_type` | Rugby rules type: Union (union) or League (league). | | `language_code` | Optional 2 letter code for supported languages: en (English), ru (Russian), and zh (simplified Chinese). | | `player_id` | Id of a given player. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Player Profiles, use the following URL. https://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/player_profile.xsd Return to API map ## Season Info Provides competitor information for each season covered. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby/trial/v2/league/en/seasons/sr:season:47418/info.xml?api_key={your_api_key}") 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) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/rugby/trial/v2/league/en/seasons/sr:season:47418/info.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/rugby/trial/v2/league/en/seasons/sr:season:47418/info.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Season Info feed by replacing the parameters in the following URL: https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/seasons/`{season_id}`/info.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v2). | | `rugby_type` | Rugby rules type: Union (union) or League (league). | | `language_code` | Optional 2 letter code for supported languages: en (English), ru (Russian), and zh (simplified Chinese). | | `season_id` | Id of a given season. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for Season Info, use the following URL. https://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/season_info.xsd Return to API map ## Season Leaders Provides a list of leaders in a given season for top points, penalty goals, drop goals, conversions, cards, and tries. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby/trial/v2/league/en/seasons/sr:season:36392/leaders.xml?api_key={your_api_key}") 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) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/rugby/trial/v2/league/en/seasons/sr:season:36392/leaders.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/rugby/trial/v2/league/en/seasons/sr:season:36392/leaders.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Season Leaders feed by replacing the parameters in the following URL: https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/seasons/`{season_id}`/leaders.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v2). | | `rugby_type` | Rugby rules type: Union (union) or League (league). | | `language_code` | Optional 2 letter code for supported languages: en (English), ru (Russian), and zh (simplified Chinese). | | `season_id` | Id of a given season. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Season Leaders, use the following URL. https://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/season_leaders.xsd Return to API map ## Season List (Current) Provides a list of each current season covered including seasonal tournament information. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby/trial/v2/league/en/seasons.xml?api_key={your_api_key}") 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) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/rugby/trial/v2/league/en/seasons.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/rugby/trial/v2/league/en/seasons.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Season List (Current) feed by replacing the parameters in the following URL: https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/seasons.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v2). | | `rugby_type` | Rugby rules type: Union (union) or League (league). | | `language_code` | Optional 2 letter code for supported languages: en (English), ru (Russian), and zh (simplified Chinese). | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the current Season List, use the following URL. https://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/seasons.xsd Return to API map ## Season List (Previous) Provides a list of each previous season covered including seasonal tournament information. Season IDs can be interchanged with tournament IDs to retrieve historical data. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby/trial/v2/league/en/seasons/sr:season:47418/previous_seasons.xml?api_key={your_api_key}") 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) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/rugby/trial/v2/league/en/seasons/sr:season:47418/previous_seasons.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/rugby/trial/v2/league/en/seasons/sr:season:47418/previous_seasons.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Season List (Previous) feed by replacing the parameters in the following URL: https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/seasons/`{tournament_id or season_id}`/previous_seasons.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v2). | | `rugby_type` | Rugby rules type: Union (union) or League (league). | | `language_code` | Optional 2 letter code for supported languages: en (English), ru (Russian), and zh (simplified Chinese). | | `tournament_id or season_id` | Id of a given tournament or season. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the previous Season List, use the following URL. https://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/previous_seasons.xsd Return to API map ## Season Live Standings Provides total, home, and away standings for a live season. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby/trial/v2/league/en/seasons/sr:season:34603/live_standings.xml?api_key={your_api_key}") 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) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/rugby/trial/v2/league/en/seasons/sr:season:34603/live_standings.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/rugby/trial/v2/league/en/seasons/sr:season:34603/live_standings.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Season Live Standings feed by replacing the parameters in the following URL: https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/seasons/`{season_id}`/live_standings.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v2). | | `rugby_type` | Rugby rules type: Union (union) or League (league). | | `language_code` | Optional 2 letter code for supported languages: en (English), ru (Russian), and zh (simplified Chinese). | | `season_id` | Id of a given season. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Season Live Standings, use the following URL. https://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/season_live_standings.xsd Return to API map ## Season Results Provides all results for played matches in a season. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby/trial/v2/league/en/seasons/sr:season:34603/results.xml?api_key={your_api_key}") 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) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/rugby/trial/v2/league/en/seasons/sr:season:34603/results.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/rugby/trial/v2/league/en/seasons/sr:season:34603/results.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Season Results feed by replacing the parameters in the following URL: https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/seasons/`{season_id}`/results.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v2). | | `rugby_type` | Rugby rules type: Union (union) or League (league). | | `language_code` | Optional 2 letter code for supported languages: en (English), ru (Russian), and zh (simplified Chinese). | | `season_id` | Id of a given season. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Season Results, use the following URL. https://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/season_results.xsd Return to API map ## Season Schedule Provides all scheduled matches for a season. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby/trial/v2/league/en/seasons/sr:season:34603/schedule.xml?api_key={your_api_key}") 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) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/rugby/trial/v2/league/en/seasons/sr:season:34603/schedule.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/rugby/trial/v2/league/en/seasons/sr:season:34603/schedule.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Season Schedule feed by replacing the parameters in the following URL: https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/seasons/`{season_id}`/schedule.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v2). | | `rugby_type` | Rugby rules type: Union (union) or League (league). | | `language_code` | Optional 2 letter code for supported languages: en (English), ru (Russian), and zh (simplified Chinese). | | `season_id` | Id of a given season. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Season Schedule, use the following URL. https://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/season_schedule.xsd Return to API map ## Season Standings Provides total, home, and away standings for a season. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby/trial/v2/league/en/seasons/sr:season:34603/standings.xml?api_key={your_api_key}") 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) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/rugby/trial/v2/league/en/seasons/sr:season:34603/standings.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/rugby/trial/v2/league/en/seasons/sr:season:34603/standings.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Season Standings feed by replacing the parameters in the following URL: https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/seasons/`{season_id}`/standings.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v2). | | `rugby_type` | Rugby rules type: Union (union) or League (league). | | `language_code` | Optional 2 letter code for supported languages: en (English), ru (Russian), and zh (simplified Chinese). | | `season_id` | Id of a given season. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Season Standings, use the following URL. https://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/season_standings.xsd Return to API map ## Season Summaries Provides match information, scoring, for a given season. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby/trial/v2/league/en/seasons/sr:season:35996/summaries.xml?api_key={your_api_key}") 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) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/rugby/trial/v2/league/en/seasons/sr:season:35996/summaries.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/rugby/trial/v2/league/en/seasons/sr:season:35996/summaries.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Season Summaries feed by replacing the parameters in the following URL: https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/seasons/`{season_id}`/summaries.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v2). | | `rugby_type` | Rugby rules type: Union (union) or League (league). | | `language_code` | Optional 2 letter code for supported languages: en (English), ru (Russian), and zh (simplified Chinese). | | `season_id` | Id of a given season. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Season Summaries, use the following URL. https://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/summaries.xsd Return to API map ## Team Profile Provides team information including current roster and team seasonal statistics. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby/trial/v2/league/en/teams/sr:competitor:4270/profile.xml?api_key={your_api_key}") 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) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/rugby/trial/v2/league/en/teams/sr:competitor:4270/profile.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/rugby/trial/v2/league/en/teams/sr:competitor:4270/profile.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Team Profile feed by replacing the parameters in the following URL: https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/teams/`{team_id}`/profile.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v2). | | `rugby_type` | Rugby rules type: Union (union) or League (league). | | `language_code` | Optional 2 letter code for supported languages: en (English), ru (Russian), and zh (simplified Chinese). | | `team_id` | Id of a given team. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Team Profile, use the following URL. https://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/team_profile.xsd Return to API map ## Team Results Provides all results for played matches by a given team. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby/trial/v2/league/en/teams/sr:competitor:4270/results.xml?api_key={your_api_key}") 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) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/rugby/trial/v2/league/en/teams/sr:competitor:4270/results.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/rugby/trial/v2/league/en/teams/sr:competitor:4270/results.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Team Results feed by replacing the parameters in the following URL: https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/teams/`{team_id}`/results.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v2). | | `rugby_type` | Rugby rules type: Union (union) or League (league). | | `language_code` | Optional 2 letter code for supported languages: en (English), ru (Russian), and zh (simplified Chinese). | | `team_id` | Id of a given team. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Team Results, use the following URL. https://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/team_results.xsd Return to API map ## Team Schedule Provides upcoming matches for a team. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby/trial/v2/league/en/teams/sr:competitor:4270/schedule.xml?api_key={your_api_key}") 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) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/rugby/trial/v2/league/en/teams/sr:competitor:4270/schedule.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/rugby/trial/v2/league/en/teams/sr:competitor:4270/schedule.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Team Schedule feed by replacing the parameters in the following URL: https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/teams/`{team_id}`/schedule.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v2). | | `rugby_type` | Rugby rules type: Union (union) or League (league). | | `language_code` | Optional 2 letter code for supported languages: en (English), ru (Russian), and zh (simplified Chinese). | | `team_id` | Id of a given team. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Team Schedule, use the following URL. https://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/team_schedule.xsd Return to API map ## Team Versus Team Provides previous and upcoming meetings between two teams including results. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby/trial/v2/league/en/teams/sr:competitor:4270/versus/sr:competitor:4234/matches.xml?api_key={your_api_key}") 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) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/rugby/trial/v2/league/en/teams/sr:competitor:4270/versus/sr:competitor:4234/matches.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/rugby/trial/v2/league/en/teams/sr:competitor:4270/versus/sr:competitor:4234/matches.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Team Versus Team feed by replacing the parameters in the following URL: https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/teams/`{team_id}`/versus/`{team_id2}`/matches.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v2). | | `rugby_type` | Rugby rules type: Union (union) or League (league). | | `language_code` | Optional 2 letter code for supported languages: en (English), ru (Russian), and zh (simplified Chinese). | | `team_id` | Id of a given team. | | `team_id2` | Id of a given team. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for Team Versus Team, use the following URL. https://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/team_versus_matches.xsd Return to API map ## Frequently Asked QuestionsQ: What format are date fields presented in?
A: When we present date only values we present these in the ISO 8601 standard format.
ex: 2013-04-03
We use these for attributes that have date and no time (such as birthdate). For more information: https://en.wikipedia.org/wiki/ISO_8601
Q: What format are the date/time fields presented in?
A: All of our Date/Time attributes are in UTC, presented in the ISO 8601 standard format.
ex: 2013-04-03T18:15:00+00:00
For more information: https://en.wikipedia.org/wiki/ISO_8601
Q: How do I find out the coverage for a particular match?
A: Find the node called: coverage_info. The attribute live_coverage reports whether Sportradar has live coverage of the match or not. The level can be gold, silver or bronze. Bronze includes basic_score. Silver includes basic_score and key_events. Gold includes everything in silver and detailed events and lineups.
Q: What are the valid sport_event_status – status values?
A: Here is a list of the valid match statuses and their definitions:
- scheduled – The match is scheduled to occur.
- live – The match is currently in progress.
- postponed – The match has been postponed.
- delayed – The start of the match is currently delayed.
- interrupted - The match began, but coverage has stopped for a short time. Note that match scores may not be updated during this period, the last recorded match score will be displayed instead
- cancelled – The match has been cancelled.
- suspended – The match has been suspended.
- closed – The match has been completed.
Q: What leagues and tournaments do you currently cover?
A: For a list of all tournaments that we currently cover you can call the “Season List” endpoint or see our global coverage document here: https://www.sportradar.com/wp-content/uploads/sites/5/2014/12/Sportradar_Coverage.pdf
Q: What are the valid player positions for rugby union?
A: Position appears as player - type and can contain the following values:
- PR - Prop, jersey #1 and #3, positioning: front-row of the scrum
- HO - Hooker, jersey #2 position: front-row of the scrum between the props
- L - Lock, or 'second-rower', jersey: #4 and #5, positioning: second row of the scrum
- FL - Flanker, often referred to as 'blindside' and 'openside' or ‘backrowers’, jersey #6 and #7, position: side of the scrum 'flanking' the scrum
- BR - Backrow, more commonly referred to as 'Number 8', jersey #8. positioning: back of the scrum
- SH - Scrumhalf, jersey #9, positioning between the backs and the forwards - sometimes referred to as 'halfback'
- FH - Flyhalf, jersey #10, positioning: first receiver from scrumhalf
- W - Wing, jersey #11 and #14 positioning: wide, in the backline
- C - Centre, jersey #12 and 13, positioning in the backline between the flyhalf and the wing
- FB - Fullback, jersey #15, positioning last line of defense in the backline
Q: Why are the positions in rugby different from the jersey numbers in the lineups feed?
A: The positions (denoted as 'type' in the player nodes) belongs to the player and signifies the player's primary position as understood by Sportradar. The jersey number in the lineups endpoint - for those tournaments that provide lineups - is what determines which position a player will play in for a particular match. So a player whose position is ordinarily 'c' for 'center' may find himself playing in jersey 11 or 14 (winger) for a given match. (for league a winger's jersey number is 2 or 5).
Q: How are group IDs delivered in the stage array with the various types?
A: With the type of "league" they will have a sr:league prefix. With the type of "cup" they will have a sr:cup prefix.
Q: How will a sport event behave when it is not covered with live scores?
A: When a sport_event is not covered live, the status and match_status will remain as not_started until results are entered post-match.
Return to topDocs Navigation
- Documentation
- Football (American Football)
- Football (Soccer)
- Australian Rules Football
- Baseball
- Basketball
- NBA v8
- NBA v7
- NBA v5
- NBA v4
- WNBA v8
- WNBA v7
- WNBA v4
- WNBA v3
- NBA G League v8
- NBA G League v7
- NBA G League v5
- NCAA Men's Basketball v8
- NCAA Men's Basketball v7
- NCAA Men's Basketball v4
- NCAA Men's Basketball v3
- NCAA Women's Basketball v8
- NCAA Women's Basketball v7
- NCAA Women's Basketball v3
- Global Basketball v2
- Global Basketball v1
- NBA Historical v1
- Combat Sports
- Cricket
- Editorial Content
- Golf
- Handball
- Hockey
- Images
- Insights
- Insights User Interface
- NBA Insights v1
- NHL Insights v1
- MLB Insights v1
- NFL Insights v1
- MLB Betting Splits v2
- MLB Betting Splits v1
- NBA Betting Splits v2
- NBA Betting Splits v1
- NCAAFB Betting Splits v2
- NCAAFB Betting Splits v1
- NCAAMB Betting Splits v2
- NCAAMB Betting Splits v1
- NFL Betting Splits v2
- NFL Betting Splits v1
- NHL Betting Splits v2
- NHL Betting Splits v1
- Soccer Betting Splits v2
- Soccer Betting Splits v1
- Odds
- Broadcast Graphics
- Racing
- Rugby
- Tennis
- Widgets
- Baseline Sports Coverage
- Badminton v2
- Badminton v1
- Bandy v2
- Bandy v1
- Beach Soccer v2
- Beach Soccer v1
- Curling v2
- Curling v1
- Cycling v2
- Darts v2
- Darts v1
- Field Hockey v2
- Field Hockey v1
- Floorball v2
- Floorball v1
- Futsal v2
- Futsal v1
- Pesapallo v2
- Pesapallo v1
- Snooker v2
- Snooker v1
- Squash v2
- Squash v1
- Table Tennis v2
- Volleyball (Beach) v2
- Volleyball (Beach) v1
- Volleyball (Indoor) v2
- Volleyball (Indoor) v1
- Waterpolo v2
- Waterpolo v1
- Winter Sports v1