Rugby v2

Frequently Asked Questions
API API Version
Rugby v2
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. ## Daily Live Results ```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. This endpoint retrieves Daily Live Results. https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/schedules/live/results.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | 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. http://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/results.xsd Return to API map ## Daily Live Summaries ```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. This endpoint retrieves Daily Live Summaries. https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/schedules/live/summaries.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | 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. http://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/summaries.xsd Return to API map ## Daily Results ```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. This endpoint retrieves the results information for a specific day. https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/schedules/`{year}`-`{month}`-`{day}`/results.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | 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. http://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/results.xsd Return to API map ## Daily Schedule ```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. To access the Daily Schedule, replace 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}` Replace placeholders with the following query parameters: | 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. http://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/schedule.xsd Return to API map ## Match Lineups ```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. This endpoint retrieves the Match Lineups information. https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/matches/`{match_id}`/lineups.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | 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. http://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/match_lineups.xsd Return to API map ## Match Probabilities ```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. This endpoint retrieves the Match Probabilities. https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/matches/`{match_id}`/probabilities.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | 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. http://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/match_probabilities.xsd Return to API map ## Match Summary ```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. This endpoint retrieves the Match Summary information for a specific match. https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/matches/`{match_id}`/summary.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | 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. http://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/match_summary.xsd Return to API map ## Match 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. This endpoint retrieves the Match Timeline information for a specific match. https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/matches/`{match_id}`/timeline.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | 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. http://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/match_timeline.xsd Return to API map ## Player Profile ```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. This endpoint retrieves Player Profiles. https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/players/`{player_id}`/profile.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | 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. http://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/player_profile.xsd Return to API map ## Season Info ```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. This endpoint retrieves Season Info. https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/seasons/`{season_id}`/info.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | 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. http://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/season_info.xsd Return to API map ## Season Leaders ```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. This endpoint retrieves the Season Leaders. https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/seasons/`{season_id}`/leaders.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | 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. http://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/season_leaders.xsd Return to API map ## Season List (Current) ```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. This endpoint retrieves the current Season List. https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/seasons.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | 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. http://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/seasons.xsd Return to API map ## Season List (Previous) ```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. This endpoint retrieves the Season List for previous seasons. 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}` Replace placeholders with the following query parameters: | 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. http://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/previous_seasons.xsd Return to API map ## Season Live Standings ```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. This endpoint retrieves the current standings for season. https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/seasons/`{season_id}`/live_standings.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | 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. http://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/season_live_standings.xsd Return to API map ## Season Results ```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. This endpoint retrieves the Season Results. https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/seasons/`{season_id}`/results.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | 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. http://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/season_results.xsd Return to API map ## Season Schedule ```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. This endpoint retrieves the Season Schedule. https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/seasons/`{season_id}`/schedule.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | 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. http://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/season_schedule.xsd Return to API map ## Season Standings ```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. This endpoint retrieves the Season Standings. https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/seasons/`{season_id}`/standings.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | 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. http://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/season_standings.xsd Return to API map ## Season Summaries ```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. This endpoint retrieves Season Summaries. https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/seasons/`{season_id}`/summaries.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | 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. http://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/summaries.xsd Return to API map ## Team Profile ```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. This endpoint retrieves the Team Profile. https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/teams/`{team_id}`/profile.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | 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. http://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/team_profile.xsd Return to API map ## Team Results ```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. This endpoint retrieves Team Results. https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/teams/`{team_id}`/results.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | 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. http://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/team_results.xsd Return to API map ## Team Schedule ```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. This endpoint retrieves the Team Schedule. https://api.sportradar.us/rugby/`{access_level}`/`{version}`/`{rugby_type}`/`{language_code}`/teams/`{team_id}`/schedule.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | 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. http://schemas.sportradar.com/bsa/rugby/v1/xml/endpoints/rugby/team_schedule.xsd Return to API map ## Team Versus Team ```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. This endpoint retrieves the Team Versus Team information. 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}` Replace placeholders with the following query parameters: | 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. http://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 match statuses and what are their definitions?

    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.
    • canceled – The match has been canceled.
    • 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).

    Return to top