Rugby v2

Frequently Asked Questions
API API Version XSD Schema
Rugby v2 Download
Note: Authentication is required for all API calls.
## Rugby v2 API Map To best utilize the Rugby API v2, you will need several parameters to create your API calls. The map below illustrates how you can obtain the parameters you need. >

Examples:

>To find the league leader in points for a given tournament: >
  1. Call the Season List (Current) and find the Season Id for the chosen season
  2. Call the Season Leaders using the Season Id
  3. Find the top points statistics and locate the points rank attribute and find the rank 1
>The competitor's name and id is displayed. >
    >To find a teams's points scored per season: >
    1. Call the daily schedule or results for the day your chosen team played and find the id for the team
    2. Call the Team Profile using the Team ID
    3. Locate your chosen season within the statistics element
    4. Find the points scored attribute
    >The teams's total points for the season are displayed. The primary feeds require only a date or other human readable values to call the endpoints. Those feeds provide Season, Match, Team, or Player Ids which can be used to generate the season, match, team, and player feeds. ## Rugby v2 Failover Information

    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` | English (en) is the only fully supported language | | `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` | English (en) is the only fully supported language | | `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` | English (en) is the only fully supported language | | `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` | English (en) is the only fully supported language | | `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` | English (en) is the only fully supported language | | `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` | English (en) is the only fully supported language | | `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` | English (en) is the only fully supported language | | `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` | English (en) is the only fully supported language | | `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` | English (en) is the only fully supported language | | `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` | English (en) is the only fully supported language | | `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` | English (en) is the only fully supported language | | `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` | English (en) is the only fully supported language | | `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` | English (en) is the only fully supported language | | `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` | English (en) is the only fully supported language | | `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` | English (en) is the only fully supported language | | `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` | English (en) is the only fully supported language | | `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` | English (en) is the only fully supported language | | `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` | English (en) is the only fully supported language | | `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` | English (en) is the only fully supported language | | `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` | English (en) is the only fully supported language | | `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` | English (en) is the only fully supported language | | `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` | English (en) is the only fully supported language | | `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 Questions

    Q: 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 top

    Docs Navigation