Cricket v2

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

Example:

>To find the statistics of a match: >
  1. Call the Daily Schedule for the day the match takes place and find the associated Sport Event Id
  2. Call the Match Summary feed using the Sport Event Id for your match
>The statistics for this match are now displayed. The primary feeds require only a date or human-readable parameters to call the endpoints. Those feeds provide Sport Event Ids, Competitor Ids, or Season Ids which can be used to generate the match, team, and tournament feeds. ## Daily Live Schedule ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/cricket-t2/en/schedules/live/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", "/cricket-t2/en/schedules/live/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.com/cricket-t2/en/schedules/live/schedule.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. To access the Daily Live Schedule feed use the following URL: https://api.sportradar.us/cricket-`{access_level}{version}`/`{language_code}`/schedules/live/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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 2). | | `language_code` | English (en). | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Daily Live Schedule use the following URL. http://schemas.sportradar.com/bsa/v1/endpoints/cricket/schedule.xsd Return to API map ## Daily Results ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/cricket-t2/en/schedules/2017-03-16/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", "/cricket-t2/en/schedules/2017-03-16/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.com/cricket-t2/en/schedules/2017-03-16/results.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Daily Results. https://api.sportradar.us/cricket-`{access_level}{version}`/`{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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 2). | | `language_code` | English (en). | | `year` | Year in 4 digit format (YYYY). | | `month` | Month in 2 digit format (MM). | | `day` | Day 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/v1/endpoints/cricket/results.xsd Return to API map ## Daily Schedule ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/cricket-t2/en/schedules/2017-03-16/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", "/cricket-t2/en/schedules/2017-03-16/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.com/cricket-t2/en/schedules/2017-03-16/schedule.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. To access the Daily Schedule feed use the following URL: https://api.sportradar.us/cricket-`{access_level}{version}`/`{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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 2). | | `language_code` | English (en). | | `year` | Year in 4 digit format (YYYY). | | `month` | Month in 2 digit format (MM). | | `day` | Day 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/v1/endpoints/cricket/schedule.xsd Return to API map ## Match Lineups ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/cricket-t2/en/matches/sr:match:11233407/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", "/cricket-t2/en/matches/sr:match:11233407/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.com/cricket-t2/en/matches/sr:match:11233407/lineups.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Match Lineups information for a specific match. https://api.sportradar.us/cricket-`{access_level}{version}`/`{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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 2). | | `language_code` | English (en). | | `match_id` | ID for 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/v1/endpoints/cricket/match_lineups.xsd Return to API map ## Match Probabilities ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/cricket-t2/en/matches/sr:match:11233407/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", "/cricket-t2/en/matches/sr:match:11233407/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.com/cricket-t2/en/matches/sr:match:11233407/probabilities.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Match Probabilities information for a specific match. https://api.sportradar.us/cricket-`{access_level}{version}`/`{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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 2). | | `language_code` | English (en). | | `match_id` | ID for a given match. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Match Probabilities use the following URL. http://schemas.sportradar.com/bsa/v1/endpoints/cricket/match_probabilities.xsd Return to API map ## Match Summary ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/cricket-t2/en/matches/sr:match:11233407/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", "/cricket-t2/en/matches/sr:match:11233407/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.com/cricket-t2/en/matches/sr:match:11233407/summary.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Match Summary. https://api.sportradar.us/cricket-`{access_level}{version}`/`{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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 2). | | `language_code` | English (en). | | `match_id` | ID for 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/v1/endpoints/cricket/match_summary.xsd Return to API map ## Match Timeline ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/cricket-t2/en/matches/sr:match:11233407/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", "/cricket-t2/en/matches/sr:match:11233407/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.com/cricket-t2/en/matches/sr:match:11233407/timeline.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Match Timeline. https://api.sportradar.us/cricket-`{access_level}{version}`/`{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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 2). | | `language_code` | English (en). | | `match_id` | ID for 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/v1/endpoints/cricket/match_timeline.xsd Return to API map ## Match Timeline (Delta) ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/cricket-t2/en/matches/sr:match:11233407/timeline/delta.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", "/cricket-t2/en/matches/sr:match:11233407/timeline/delta.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.com/cricket-t2/en/matches/sr:match:11233407/timeline/delta.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Match Timeline delta. During a live match, the timeline delta provides all the same data as the match timeline feed, but in 5 minute increments. https://api.sportradar.us/cricket-`{access_level}{version}`/`{language_code}`/matches/`{match_id}`/timeline/delta.`{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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 2). | | `language_code` | English (en). | | `match_id` | ID for a given match. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Match Timeline delta use the following URL. http://schemas.sportradar.com/bsa/v1/endpoints/cricket/match_timeline_delta.xsd Return to API map ## Player Profile ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/cricket-t2/en/players/sr:player:646278/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", "/cricket-t2/en/players/sr:player:646278/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.com/cricket-t2/en/players/sr:player:646278/profile.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Player Profile. https://api.sportradar.us/cricket-`{access_level}{version}`/`{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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 2). | | `language_code` | English (en). | | `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 Profile use the following URL. http://schemas.sportradar.com/bsa/v1/endpoints/cricket/player_profile.xsd Return to API map ## Team Profile ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/cricket-t2/en/teams/sr:competitor:107203/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", "/cricket-t2/en/teams/sr:competitor:107203/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.com/cricket-t2/en/teams/sr:competitor:107203/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/cricket-`{access_level}{version}`/`{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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 2). | | `language_code` | English (en). | | `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/v1/endpoints/cricket/team_profile.xsd Return to API map ## Team Results ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/cricket-t2/en/teams/sr:competitor:107203/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", "/cricket-t2/en/teams/sr:competitor:107203/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.com/cricket-t2/en/teams/sr:competitor:107203/results.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves Team Results. https://api.sportradar.us/cricket-`{access_level}{version}`/`{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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 2). | | `language_code` | English (en). | | `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 Team Results use the following URL. http://schemas.sportradar.com/bsa/v1/endpoints/cricket/team_results.xsd Return to API map ## Team Schedule ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/cricket-t2/en/teams/sr:competitor:152316/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", "/cricket-t2/en/teams/sr:competitor:152316/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.com/cricket-t2/en/teams/sr:competitor:152316/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/cricket-`{access_level}{version}`/`{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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 2). | | `language_code` | English (en). | | `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 Team Schedule use the following URL. http://schemas.sportradar.com/bsa/v1/endpoints/cricket/team_schedule.xsd Return to API map ## Team Versus Team ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/cricket-t2/en/teams/sr:competitor:107203/versus/sr:competitor:142690/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", "/cricket-t2/en/teams/sr:competitor:107203/versus/sr:competitor:142690/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.com/cricket-t2/en/teams/sr:competitor:107203/versus/sr:competitor:142690/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/cricket-`{access_level}{version}`/`{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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 2). | | `language_code` | English (en). | | `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/v1/endpoints/cricket/team_versus_matches.xsd Return to API map ## Tour List ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/cricket-t2/en/tours.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", "/cricket-t2/en/tours.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.com/cricket-t2/en/tours.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Tour List. https://api.sportradar.us/cricket-`{access_level}{version}`/`{language_code}`/tours.`{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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 2). | | `language_code` | English (en). | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for Tour List use the following URL. http://schemas.sportradar.com/bsa/v1/endpoints/cricket/tours.xsd Return to API map ## Tour Schedule ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/cricket-t2/en/tours/sr:tour:15540/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", "/cricket-t2/en/tours/sr:tour:15540/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.com/cricket-t2/en/tours/sr:tour:15540/schedule.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Tour Schedule. https://api.sportradar.us/cricket-`{access_level}{version}`/`{language_code}`/tours/`{tour_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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 2). | | `language_code` | English (en). | | `tour_id` | ID of a given tour. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for Tour Schedule use the following URL. http://schemas.sportradar.com/bsa/v1/endpoints/cricket/tour_schedule.xsd Return to API map ## Tournament Info ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/cricket-t2/en/tournaments/sr:tournament:2472/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", "/cricket-t2/en/tournaments/sr:tournament:2472/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.com/cricket-t2/en/tournaments/sr:tournament:2472/info.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Tournament Info. https://api.sportradar.us/cricket-`{access_level}{version}`/`{language_code}`/tournaments/`{tournament_id or 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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 2). | | `language_code` | English (en). | | `tournament_id or season_id` | ID for a given tournament or seasons. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for Tournament Info use the following URL. http://schemas.sportradar.com/bsa/v1/endpoints/cricket/tournament_info.xsd Return to API map ## Tournament Leaders ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/cricket-t2/en/tournaments/sr:tournament:2472/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", "/cricket-t2/en/tournaments/sr:tournament:2472/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.com/cricket-t2/en/tournaments/sr:tournament:2472/leaders.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves Tournament Leaders. https://api.sportradar.us/cricket-`{access_level}{version}`/`{language_code}`/tournaments/`{tournament_id or 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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 2). | | `language_code` | English (en). | | `tournament_id or season_id` | ID for a given tournament or seasons. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for Tournament Leaders use the following URL. http://schemas.sportradar.com/bsa/v1/endpoints/cricket/tournament_leaders.xsd Return to API map ## Tournament List ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/cricket-t2/en/tournaments.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", "/cricket-t2/en/tournaments.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.com/cricket-t2/en/tournaments.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Tournament List. https://api.sportradar.us/cricket-`{access_level}{version}`/`{language_code}`/tournaments.`{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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 2). | | `language_code` | English (en). | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for Tournament List use the following URL. http://schemas.sportradar.com/bsa/v1/endpoints/cricket/tournaments.xsd Return to API map ## Tournament Results ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/cricket-t2/en/tournaments/sr:tournament:15103/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", "/cricket-t2/en/tournaments/sr:tournament:15103/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.com/cricket-t2/en/tournaments/sr:tournament:15103/results.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Tournament Results. https://api.sportradar.us/cricket-`{access_level}{version}`/`{language_code}`/tournaments/`{tournament_id or 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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 2). | | `language_code` | English (en). | | `tournament_id or season_id` | ID for a given tournament or seasons. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Tournament Results use the following URL. http://schemas.sportradar.com/bsa/v1/endpoints/cricket/tournament_results.xsd Return to API map ## Tournament Schedule ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/cricket-t2/en/tournaments/sr:tournament:2472/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", "/cricket-t2/en/tournaments/sr:tournament:2472/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.com/cricket-t2/en/tournaments/sr:tournament:2472/schedule.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Tournament Schedule. https://api.sportradar.us/cricket-`{access_level}{version}`/`{language_code}`/tournaments/`{tournament_id or 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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 2). | | `language_code` | English (en). | | `tournament_id or season_id` | ID for a given tournament or seasons. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for Tournament Schedule use the following URL. http://schemas.sportradar.com/bsa/v1/endpoints/cricket/tournament_schedule.xsd Return to API map ## Tournament Seasons ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/cricket-t2/en/tournaments/sr:tournament:2472/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", "/cricket-t2/en/tournaments/sr:tournament:2472/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.com/cricket-t2/en/tournaments/sr:tournament:2472/seasons.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves Tournament Seasons Information. https://api.sportradar.us/cricket-`{access_level}{version}`/`{language_code}`/tournaments/`{tournament_id or season_id}`/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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 2). | | `language_code` | English (en). | | `tournament_id or season_id` | ID for a given tournament or seasons. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for Tournament Seasons use the following URL. http://schemas.sportradar.com/bsa/v1/endpoints/cricket/tournament_seasons.xsd Return to API map ## Tournament Squads ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/cricket-t2/en/tournaments/sr:tournament:2472/teams/sr:competitor:152316/squads.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", "/cricket-t2/en/tournaments/sr:tournament:2472/teams/sr:competitor:152316/squads.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.com/cricket-t2/en/tournaments/sr:tournament:2472/teams/sr:competitor:152316/squads.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Tournament Squads. https://api.sportradar.us/cricket-`{access_level}{version}`/`{language_code}`/tournaments/`{tournament_id or season_id}`/teams/`{team_id}`/squads.`{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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 2). | | `language_code` | English (en). | | `tournament_id or season_id` | ID for a given tournament or seasons. | | `team_id` | ID for a given team. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Tournament Squads use the following URL. http://schemas.sportradar.com/bsa/v1/endpoints/cricket/tournament_team_squad.xsd Return to API map ## Tournament Standings ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/cricket-t2/en/tournaments/sr:tournament:14892/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", "/cricket-t2/en/tournaments/sr:tournament:14892/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.com/cricket-t2/en/tournaments/sr:tournament:14892/standings.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Tournament Standings. https://api.sportradar.us/cricket-`{access_level}{version}`/`{language_code}`/tournaments/`{tournament_id or 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 (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 2). | | `language_code` | English (en). | | `tournament_id or season_id` | ID for a given tournament or seasons. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Tournament Standings use the following URL. http://schemas.sportradar.com/bsa/v1/endpoints/cricket/tournament_standings.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: What valid languages you support?

A: Currently only English (en)

Q: What are the valid outcomes for probabilities?

A: Here are the valid outcome probabilities:

  • home_team_winner
  • away_team_winner
  • draw

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.

Q: When are Team and Player seasonal statistics calculated?

A: Team and Player Season Statistics are updated shortly after the match goes to “Match Ended” status.

Q: What are the possible weather conditions?

A: Here are the possible weather conditions:

  • bright_and_sunny
  • cool
  • hot_and_humid
  • raining
  • overcast

Q: Why do different groups have coverage information for a tournament?

A: The notion of “groups” is versatile and is used to distinguish between playoffs, and our tournaments structures and is therefore necessary to describe coverage at a group level for consistency. Generally, however, within a tournament in Cricket, there will be no difference between tournament coverage between conferences.

Q: What are markets and what are the different markets?

A: Markets is something you can bet on that we provide probabilities for. Over time we intend to provide more and more markets in the API. Currently the only market we provide is 3-way (will the home team win? Or the away team? Or will it be a draw?)

Q: How far back does the Timeline Delta feed go?

A: 5 mins during a live match. When the match isn’t live, the timeline node isn’t displayed in the Match Timeline feed.

Q: What are the possible event types?

A: Here are the possible event types conditions:

  • boundary
  • six
  • wicket
  • general
  • weather
  • toss
  • power_play
  • next_batsman_in
  • change_of_bowler
  • new_record
  • milestone
  • highlight
  • change_of_ball
  • slow_over_rate
  • penalty
  • free_hit
  • play_halted
  • drinks
  • lunch
  • tea
  • dinner
  • time-out
  • innings_break
  • stumps
  • close_of_play
  • super_over
  • rain_stoppage
  • bad_light
  • udrs
  • significant_event
  • match_started
  • period_start
  • ball

Q: What are the valid tournament types?

A: Here are the valid tournament types:

  • test
  • odi
  • t20i
  • list_a
  • first_class
  • t20

Q: How is distance traveled measured?

A: Distance traveled is defined by a simple integer that defines the scope of travel.

  • 1 – Very Short (under 15 yards)
  • 2 – Short (between 15 and 30 yards)
  • 3 – Medium (between 30 and 50 yards)
  • 4 – Full (approximately 60 yards, or the edge of the outfield)
  • 5 – Edge (used for boundaries)
  • 6 – Out (over the boundary on the full, used for sixes)

Q: What are the valid dismissal details?

A: Here are the valid dismissal details:

  • bowled
  • caught
  • caught_and_bowled
  • lbw
  • run_out
  • stumped
  • handled_the_ball
  • hit_wicket
  • retired_hurt
  • retired_out
  • hit_the_ball_twice
  • obstructing_the_field
  • timed_out

Q: What are the valid “sport_event_status – status” values?

A: Here are the valid status values and their definitions:

  • not_started – The match is scheduled to be played.
  • live – The match is currently in progress.
  • postponed – The match has been postponed to a future date.
  • suspended – The match has been suspended.
  • delayed – The match has been temporarily delayed and will be continued.
  • cancelled – The match has been cancelled and will not be played.
  • abandoned – The match began, but was abandoned.
  • 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
  • ended – The match is over.
  • closed – The match is over and the results have been confirmed.

Q: What are the valid “sport_event_status – match_status” values?

A: Here are the valid match status values and their definitions:

  • awaiting_super_over
  • dinner
  • drinks
  • ended
  • first_innings_away
  • first_innings_home
  • fourth_innings_away
  • fourth_innings_home
  • innings_break
  • interrupted
  • lunch_break
  • second_innings_away
  • second_innings_home
  • stumps
  • super_over
  • tea_break
  • third_innings_away
  • third_innings_home

Q: What are the valid dismissal decision reasons?

A: Here are the valid dismissal decisions:

  • no_contact_with_the_ball
  • batsman_knicked_the_ball
  • too_high_to_attempt
  • too_wide_to_attempt
  • hit_in_line_with_the_stumps
  • hit_outside_the_line_of_the_stumps
  • height_of_the_ball
  • batsman_well_forward
  • bowler_overstepped
  • bowler_did_not_overstep
  • batsman_safe
  • batsman_short_of_crease
  • benefit_of_doubtt

Q: What are the valid delivery types for bowling parameters?

A: Here are the valid delivery types:

  • angled_away
  • angled_in
  • arm_ball
  • beamer
  • bouncer
  • carrom_ball
  • chinaman
  • doosra
  • flipper
  • full_toss
  • googly
  • in_swinger
  • left_arm_orthodox
  • leg_cutter
  • leg_spin
  • normal
  • off_cutter
  • off_spin
  • out_swinger
  • reverse_swing
  • seamed_in
  • seamed_out
  • slider
  • slow_ball
  • slow_bouncer
  • top_spin
  • wide_yorker
  • yorker

Q: What are the possible statuses within Sport Event Status?

A: Here are the valid statuses:

  • match_delayed_due_to_wet
  • match_abandoned
  • ground_conditions
  • bad_ground_condition
  • bad_light
  • bad_pitch
  • bad_weather_condition
  • crowd_invasion
  • crowd_trouble
  • dinner
  • drinks
  • fog
  • innings_break
  • light_failure
  • lunch
  • match_abandoned
  • match_ended
  • play_halted
  • rain_stoppage
  • stumps
  • super_over
  • in_progress
  • tea
  • wet_ground_condition
  • wet_pitch_condition

Q: What are the possible match result types within Sport Event Status?

A: Here are the valid match results types:

  • r - win by runs
  • w - win by wickets
  • i - win by an innings
  • t - match tied
  • a - match abandoned
  • d - match drawn

Q: What are the possible shot types within batting parameters?

A: Here are the valid shot types:

  • attacking
  • semi-attacking
  • defensive
  • left_alone

Q: What are the possible stroke types within batting parameters?

A: Here are the valid stroke types:

  • hook
  • pull_shot
  • flick
  • backfoot_punch
  • sweep
  • leg_glance
  • paddle_sweep
  • reverse_sweep
  • guided
  • upper_cut
  • square_cut
  • square_drive
  • punched
  • pushed
  • cover_drive
  • off_drive
  • straight_drive
  • on_drive
  • slog
  • lofted_shot
  • slog_sweep
  • chinese_cut
  • backfoot_defense
  • forward_defense
  • left_alone
  • deliberate_padding
  • ducked_
  • inside_out
  • switch-hit
  • scoop
  • helicopter_shot
  • normal
  • inside_edge
  • late_cut

Q: What are the possible connects within batting parameters?

A: Here are the valid connects:

  • middled
  • played_&_missed
  • left_alone
  • bottom_edge
  • inside_edge
  • outside_edge
  • top_edge
  • rapped_on_pads
  • hit_on_glove
  • hit_on_helmet
  • hit_on_foot
  • hit_on_body
  • other

Q: What are the possible values for angle traversed and their meanings within batting parameters?

A: Here are the valid connects:

  • square_leg – (0-45)
  • fine_leg – (46-90)
  • third_man – (91-135)
  • point – (136–180)
  • cover – (181-225)
  • mid_off – (226-270)
  • mid_on – (271-315)
  • mid_wicket – (316-359)

Q: What are the possible values for fielding positions within dismissal details?

A: Here are the valid fielding positions:

  • square_leg
  • deep_square_leg
  • backward_sq._leg
  • deep_backward_sq._leg
  • leg_gully
  • leg_slip
  • short_fine_leg
  • deep_fine_leg
  • wicket-keeper
  • 1st_slip
  • 2nd_slip
  • 3rd_slip
  • 4th_slip
  • gully
  • short_third_man
  • deep_third_man
  • point
  • backward_point
  • deep_backward_point
  • sweeper
  • cover_point
  • silly_point
  • short_cover
  • cover
  • deep_cover
  • extra_cover
  • deep_extra_cover
  • mid_off
  • short_mid_off
  • long_off
  • bowler
  • mid_on
  • short_mid_on
  • long_on
  • mid_wicket
  • short_mid_wicket
  • deep_mid_wicket
  • short_leg
  • square_short_leg
  • forward_short_lg
  • silly_mid_on
  • square_leg
  • fine_leg
  • third_man
  • deep_point
  • short_point

Q: What are the possible values for pitch info?

A: Here are the valid pitch conditions:

  • cracked
  • damp
  • dry
  • dusty
  • green

Q: What are the possible values for outfield info?

A: Here are the valid outfield conditions:

  • fast
  • slow_damp
  • slow_dewy
  • slow_grassy
  • slow_uneven
Return to top

Docs Navigation