Rugby v1

Frequently Asked Questions
API API Version
Rugby v1
Note: Authentication is required for all API calls.
## Daily Boxscore ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby-t1/matches/2015/06/15/boxscore.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-t1/matches/2015/06/15/boxscore.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-t1/matches/2015/06/15/boxscore.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the boxscore information for a specific day. https://api.sportradar.us/rugby-`{access_level}{version}`/matches/`{year}`/`{month}`/`{day}`/boxscore.xml?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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `year` | Year in 4 digit format (YYYY). | | `month` | Month in 2 digit format (MM). | | `day` | Day of month in 2 digit format (DD). | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Daily Boxscore, replace the parameters in the following URL. https://api.sportradar.us/ruby-`{access_level}{version}`/schema/matches-boxscore.xsd?api_key=`{your_api_key}` ## Daily Schedule ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby-t1/matches/2013/12/21/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-t1/matches/2013/12/21/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-t1/matches/2013/12/21/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}`/matches/`{year}`/`{month}`/`{day}`/schedule.xml?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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `year` | Year in 4 digit format (YYYY). | | `month` | Month in 2 digit format (MM). | | `day` | Day of month in 2 digit format (DD). | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Daily Schedule, replace the parameters in the following URL. https://api.sportradar.us/rugby-`{access_level}{version}`/schema/matches-schedule.xsd?api_key=`{your_api_key}` ## Daily Summary ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby-t1/matches/2015/09/18/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-t1/matches/2015/09/18/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-t1/matches/2015/09/18/summary.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Daily Summary information. https://api.sportradar.us/rugby-`{access_level}{version}`/matches/`{year}`/`{month}`/`{day}`/summary.xml?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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `year` | Year in 4 digit format (YYYY). | | `month` | Month in 2 digit format (MM). | | `day` | Day of month in 2 digit format (DD). | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Daily Summary, replace the parameters in the following URL. https://api.sportradar.us/rugby-`{access_level}{version}`/schema/matches-summary.xsd?api_key=`{your_api_key}` ## League Hierarchy ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby-t1/teams/2015/hierarchy.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-t1/teams/2015/hierarchy.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-t1/teams/2015/hierarchy.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the League Hierarchy. https://api.sportradar.us/rugby-`{access_level}{version}`/teams/`{year}`/hierarchy.xml?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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `year` | Year in 4 digit format (YYYY). | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for League Hierarchy, replace the parameters in the following URL. https://api.sportradar.us/rugby-`{access_level}{version}`/schema/teams-hierarchy.xsd?api_key=`{your_api_key}` ## Match Boxscore ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby-t1/matches/2fadc372-1bc2-4b13-af76-85997e0c389f/boxscore.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-t1/matches/2fadc372-1bc2-4b13-af76-85997e0c389f/boxscore.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-t1/matches/2fadc372-1bc2-4b13-af76-85997e0c389f/boxscore.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Match Boxscore information for a specific match. https://api.sportradar.us/rugby-`{access_level}{version}`/matches/`{match_id}`/boxscore.xml?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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `match_id` | ID for a given match. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Match Boxscore, replace the parameters in the following URL. https://api.sportradar.us/match-`{access_level}{version}`/schema/matches-boxscore.xsd?api_key=`{your_api_key}` ## Match Summary ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby-t1/matches/2fadc372-1bc2-4b13-af76-85997e0c389f/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-t1/matches/2fadc372-1bc2-4b13-af76-85997e0c389f/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-t1/matches/2fadc372-1bc2-4b13-af76-85997e0c389f/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/match-`{access_level}{version}`/matches/`{match_id}`/summary.xml?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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `match_id` | ID for a given match. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Match Summary, replace the parameters in the following URL. https://api.sportradar.us/rugby-`{access_level}{version}`/schema/matches-summary.xsd?api_key=`{your_api_key}` ## Schedule ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby-t1/2015/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-t1/2015/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-t1/2015/schedule.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Schedule. https://api.sportradar.us/rugby-`{access_level}{version}`/`{season_year}`/schedule.xml?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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `season_year` | Year in 4 digit format (YYYY). | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Schedule, replace the parameters in the following URL. https://api.sportradar.us/rugby-`{access_level}{version}`/schema/matches-schedule.xsd?api_key=`{your_api_key}` ## Standings ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby-t1/teams/2015/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-t1/teams/2015/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-t1/teams/2015/standings.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the current Standings. https://api.sportradar.us/rugby-`{access_level}{version}`/teams/`{season_year}`/standings.xml?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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `season_year` | Year in 4 digit format (YYYY). | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for Standings, replace the parameters in the following URL. https://api.sportradar.us/rugby-`{access_level}{version}`/schema/teams-standing.xsd?api_key=`{your_api_key}` ## Team Profile ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/rugby-t1/teams/ea140a99-5b41-400d-b189-5c098b753b3d/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-t1/teams/ea140a99-5b41-400d-b189-5c098b753b3d/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-t1/teams/ea140a99-5b41-400d-b189-5c098b753b3d/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}`/teams/`{team_id}`/profile.xml?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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `team_id` | ID for a given team. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Team Profile, replace the parameters in the following URL. https://api.sportradar.us/rugby-`{access_level}{version}`/schema/teams-profile.xsd?api_key=`{your_api_key}` ## 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: What are the valid coverage levels and what are their definitions?

A: Here is a list of the valid match coverage levels and their definitions:

  • 1 – We provide team lineups, match facts, and team statistics in near real-time
  • 2 – We provide match scores in near real-time, but no lineups, facts, or statistics are provided
  • 3 – We provide post match scores, but no lineups, facts, or statistics are provided

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.
  • inprogress – 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: Here are the current leagues and tournaments we are currently covering for 2016.

Rugby Union

  • Varsity Cup
  • Super Rugby
  • Six Nations

Rugby League

  • NRL
  • NRL Championship
  • RFL Challenge Cup
  • RFL Championship 1
  • Super League

Q: What are the possible values for fact type?

A: Here is a list of the valid fact types:

  • 20m_restart
  • 20m_restart
  • ball_kicked
  • ball_possession
  • ball_recycled
  • ballcoordinates
  • conversion
  • denied_try
  • drop_out
  • free_kick
  • goal
  • going_for_kick_at_goal
  • kick_to_touch
  • line_out
  • line_out_won
  • match_ended
  • match_start
  • match_started
  • matchsituation
  • missed_drop_goal
  • missed_rugby_goal
  • penalty_advantage
  • penalty_awarded
  • penalty_points
  • penalty_try
  • period_score
  • period_score_after_period_1
  • period_start
  • players_on_pitch
  • red_card
  • replacement
  • scrum
  • scrum_outcome
  • scrum_reset
  • second_period_start
  • tackle
  • tap_and_go
  • television_match_official_assists
  • time_start_stop
  • try
  • turnover
  • twentytwo_drop_out
  • video_referee
  • yellow_card
Return to top

Docs Navigation