Note: Authentication is required for all API calls.
## BIG3 API Map
To best utilize the BIG3 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 probability of a home team win for a given game:
>
Call the Daily Schedule for the day the sport event takes place and find the Season Id for the chosen sport event
Make note of the Sport Event Id for the given sport event
Call the Season Probabilities using the Season Id
Find Sport Event Id within the results locate the home team and the outcome probability
>The probability of a home team win is 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.
## Competitor Profile
Update Frequency:
As Necessary
Content Type:
XML or JSON
Category & Sport Info Data Points:
Category Country Code Category Id
Category Name Sport Id
Sport Name
Competitor Info Data Points:
Abbreviation Country
Country Code Id
Name
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/big3/trial/v1/en/competitors/sr:competitor:451579/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", "/big3/trial/v1/en/competitors/sr:competitor:451579/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/big3/trial/v1/en/competitors/sr:competitor:451579/profile.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Competitor Profile.
https://api.sportradar.com/big3/`{access_level}`/`{version}`/`{language_code}`/competitors/`{competitor_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: v1). |
| `language_code` | Supported Locales |
| `competitor_id` | Id of a given competitor. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
Return to API map
## Competitor Summaries
Update Frequency:
As Necessary
Content Type:
XML or JSON
Category & Sport Info Data Points:
Category Country Code Category Id
Category Name Sport Id
Sport Name
Competition Info Data Points:
Competition Id Competition Name Coverage Live Group Id Group Live Group Name Round Number
Season Competition Id Season End Date Season Id Season Name Season Start Date Season Year
Stage End Date Stage Order Stage Phase Stage Start Date Stage Type Stage Year
Competitor Info Data Points:
Abbreviation Country
Country Code Id
Name
Match Info Data Points:
Away Score Competitor Qualifier Home Score Period Number Period Type
Sport Event Id Sport Event Replaced By Sport Event Start Time Sport Event Start Time Confirmed Sport Event Status Sport Event Status Away Score
Sport Event Status Decided by Fed Sport Event Status Home Score Sport Event Status Match Status Sport Event Status Scout Abandoned Sport Event Status Winner Id
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/big3/trial/v1/en/competitors/sr:competitor:451579/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", "/big3/trial/v1/en/competitors/sr:competitor:451579/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/big3/trial/v1/en/competitors/sr:competitor:451579/summaries.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves Competitor Summaries.
https://api.sportradar.com/big3/`{access_level}`/`{version}`/`{language_code}`/competitors/`{competitor_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: v1). |
| `language_code` | Supported Locales |
| `competitor_id` | ID for a given competitor. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
Return to API map
## Competitor vs Competitor
Update Frequency:
As Necessary
Content Type:
XML or JSON
Category & Sport Info Data Points:
Category Country Code Category Id
Category Name Sport Id
Sport Name
Competition Info Data Points:
Competition Id Competition Name Coverage Live Group Id Group Live Group Name Round Number
Season Competition Id Season End Date Season Id Season Name Season Start Date Season Year
Stage End Date Stage Order Stage Phase Stage Start Date Stage Type Stage Year
Competitor Info Data Points:
Abbreviation Country
Country Code Id
Name
Match Info Data Points:
Away Score Competitor Qualifier Home Score Period Number Period Type
Sport Event Id Sport Event Replaced By Sport Event Start Time Sport Event Start Time Confirmed Sport Event Status Sport Event Status Away Score
Sport Event Status Decided by Fed Sport Event Status Home Score Sport Event Status Match Status Sport Event Status Scout Abandoned Sport Event Status Winner Id
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/big3/trial/v1/en/competitors/sr:competitor:451585/versus/sr:competitor:451579/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", "/big3/trial/v1/en/competitors/sr:competitor:451585/versus/sr:competitor:451579/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/big3/trial/v1/en/competitors/sr:competitor:451585/versus/sr:competitor:451579/summaries.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Competitor vs Competitor Summaries.
https://api.sportradar.com/big3/`{access_level}`/`{version}`/`{language_code}`/competitors/`{competitor_id}`/versus/`{competitor2_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: v1). |
| `language_code` | Supported Locales |
| `competitor_id` | ID for a given competitor. |
| `competitor2_id` | ID for a given competitor. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
Return to API map
## Daily Summaries
Update Frequency:
As Necessary
Content Type:
XML or JSON
Category & Sport Info Data Points:
Category Country Code Category Id
Category Name Sport Id
Sport Name
Competition Info Data Points:
Competition Id Competition Name Coverage Live Group Id Group Live Group Name Round Number
Season Competition Id Season End Date Season Id Season Name Season Start Date Season Year
Stage End Date Stage Order Stage Phase Stage Start Date Stage Type Stage Year
Competitor Info Data Points:
Abbreviation Country
Country Code Id
Name
Match Info Data Points:
Away Score Competitor Qualifier Home Score Period Number Period Type
Sport Event Id Sport Event Replaced By Sport Event Start Time Sport Event Start Time Confirmed Sport Event Status Sport Event Status Away Score
Sport Event Status Decided by Fed Sport Event Status Home Score Sport Event Status Match Status Sport Event Status Scout Abandoned Sport Event Status Winner Id
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/big3/trial/v1/en/schedules/2018-08-18/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", "/big3/trial/v1/en/schedules/2018-08-18/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/big3/trial/v1/en/schedules/2018-08-18/summaries.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves Daily Summaries.
https://api.sportradar.com/big3/`{access_level}`/`{version}`/`{language_code}`/schedules/`{year}`-`{month}`-`{day}`/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: v1). |
| `language_code` | Supported Locales |
| `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. |
Return to API map
## Season Info
Update Frequency:
As Necessary
Content Type:
XML or JSON
Category & Sport Info Data Points:
Category Country Code Category Id
Category Name Sport Id
Sport Name
Competition Info Data Points:
Competition Id Competition Name Group Id Group Max Rounds Group Name Season Competition Id
Season End Date Season Id Season Name Season Start Date Season Year Stage End Date
Stage Order Stage Phase Stage Start Date Stage Type Stage Year
Competitor Info Data Points:
Abbreviation Country
Country Code Id
Name
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/big3/trial/v1/en/seasons/sr:season:54353/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", "/big3/trial/v1/en/seasons/sr:season:54353/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/big3/trial/v1/en/seasons/sr:season:54353/info.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves Seasons Information.
https://api.sportradar.com/big3/`{access_level}`/`{version}`/`{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: v1). |
| `language_code` | Supported Locales |
| `season_id` | ID of a given season. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
Return to API map
## Season Probabilities
Update Frequency:
As Necessary
Content Type:
XML or JSON
Category & Sport Info Data Points:
Category Country Code Category Id
Category Name Sport Id
Sport Name
Competition Info Data Points:
Competition Id Competition Name Group Id Group Name Round Number Season Competition Id
Season End Date Season Id Season Name Season Start Date Season Year Stage End Date
Stage Order Stage Phase Stage Start Date Stage Type Stage Year
Competitor Info Data Points:
Abbreviation Country
Country Code Id
Name
Probability Info Data Points:
Away Team Win Probability Home Team Win Probability
Market Name
Outcome Name
Match Info Data Points:
Competitor Qualifier Sport Event Id
Sport Event Replaced By Sport Event Start Time
Sport Event Start Time Confirmed
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/big3/trial/v1/en/seasons/sr:season:54353/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", "/big3/trial/v1/en/seasons/sr:season:54353/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/big3/trial/v1/en/seasons/sr:season:54353/probabilities.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves Season Probabilities.
https://api.sportradar.com/big3/`{access_level}`/`{version}`/`{language_code}`/seasons/`{season_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: v1). |
| `language_code` | Supported Locales |
| `season_id` | Id of a given season. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
Return to API map
## Season Standings
Update Frequency:
As Necessary
Content Type:
XML or JSON
Competition Info Data Points:
Group Id Group Live Group Name
Stage End Date Stage Order Stage Phase
Stage Start Date Stage Type Stage Year
Competitor Info Data Points:
Abbreviation Country
Country Code Id
Name
Standings Info Data Points:
Draw Group Id Group Live Group Name Losses
Played Points Points Against Points Difference Points For
Rank Season Standings Tie Break Rule Season Standings Type Wins
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/big3/trial/v1/en/seasons/sr:season:54353/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", "/big3/trial/v1/en/seasons/sr:season:54353/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/big3/trial/v1/en/seasons/sr:season:54353/standings.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Season Standings.
https://api.sportradar.com/big3/`{access_level}`/`{version}`/`{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: v1). |
| `language_code` | Supported Locales |
| `season_id` | ID of a given season. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
Return to API map
## Season Summaries
Update Frequency:
As Necessary
Content Type:
XML or JSON
Category & Sport Info Data Points:
Category Country Code Category Id
Category Name Sport Id
Sport Name
Competition Info Data Points:
Competition Id Competition Name Coverage Live Group Id Group Live Group Name Round Number
Season Competition Id Season End Date Season Id Season Name Season Start Date Season Year
Stage End Date Stage Order Stage Phase Stage Start Date Stage Type Stage Year
Competitor Info Data Points:
Abbreviation Country
Country Code Id
Name
Match Info Data Points:
Away Score Competitor Qualifier Home Score Period Number Period Type
Sport Event Id Sport Event Replaced By Sport Event Start Time Sport Event Start Time Confirmed Sport Event Status Sport Event Status Away Score
Sport Event Status Decided by Fed Sport Event Status Home Score Sport Event Status Match Status Sport Event Status Scout Abandoned Sport Event Status Winner Id
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/big3/trial/v1/en/seasons/sr:season:54353/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", "/big3/trial/v1/en/seasons/sr:season:54353/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/big3/trial/v1/en/seasons/sr:season:54353/summaries.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves Season Summaries.
https://api.sportradar.com/big3/`{access_level}`/`{version}`/`{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: v1). |
| `language_code` | Supported Locales |
| `season_id` | ID of a given season. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
Return to API map
## Seasons
Update Frequency:
As Necessary
Content Type:
XML or JSON
Competition Info Data Points:
Season Competition Id Season End Date
Season Id Season Name
Season Start Date Season Year
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/big3/trial/v1/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", "/big3/trial/v1/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/big3/trial/v1/en/seasons.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves Seasons.
https://api.sportradar.com/big3/`{access_level}`/`{version}`/`{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: v1). |
| `language_code` | Supported Locales |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
Return to API map
## Sport Event Summary
Update Frequency:
As Necessary
Content Type:
XML or JSON
Category & Sport Info Data Points:
Category Country Code Category Id
Category Name Sport Id
Sport Name
Competition Info Data Points:
Competition Id Competition Name Coverage Live Group Id Group Live Group Name Round Number
Season Competition Id Season End Date Season Id Season Name Season Start Date Season Year
Stage End Date Stage Order Stage Phase Stage Start Date Stage Type Stage Year
Competitor Info Data Points:
Abbreviation Country
Country Code Id
Name
Match Info Data Points:
Away Score Competitor Qualifier Home Score Period Number Period Type
Sport Event Id Sport Event Replaced By Sport Event Start Time Sport Event Start Time Confirmed Sport Event Status Sport Event Status Away Score
Sport Event Status Decided by Fed Sport Event Status Home Score Sport Event Status Match Status Sport Event Status Scout Abandoned Sport Event Status Winner Id
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/big3/trial/v1/en/sport_events/sr:match:14770109/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", "/big3/trial/v1/en/sport_events/sr:match:14770109/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/big3/trial/v1/en/sport_events/sr:match:14770109/summary.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Sport Event Summary.
https://api.sportradar.com/big3/`{access_level}`/`{version}`/`{language_code}`/sport_events/`{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: v1). |
| `language_code` | Supported Locales |
| `match_id` | ID of a given match. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
Return to API map
## Sport Events Removed
Update Frequency:
As Necessary
Content Type:
XML or JSON
Match Info Data Points:
Sport Event Removed Id
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/big3/trial/v1/en/sport_events/removed.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", "/big3/trial/v1/en/sport_events/removed.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/big3/trial/v1/en/sport_events/removed.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves Sport Events Removed from the API.
https://api.sportradar.com/big3/`{access_level}`/`{version}`/`{language_code}`/sport_events/removed.`{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: v1). |
| `language_code` | Supported Locales |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
Return to API map
## Sport Events Updated
Update Frequency:
As Necessary
Content Type:
XML or JSON
Match Info Data Points:
Id
Updated At
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/big3/trial/v1/en/sport_events/updated.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", "/big3/trial/v1/en/sport_events/updated.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/big3/trial/v1/en/sport_events/updated.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves Sport Events Updated in the API.
https://api.sportradar.com/big3/`{access_level}`/`{version}`/`{language_code}`/sport_events/updated.`{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: v1). |
| `language_code` | Supported Locales |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
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 are the valid sport_event_status – status values?
A: Here are the valid match status values and their definitions:
not_started – The match is scheduled to be played
postponed – The match has been postponed to a future date
interrupted - The match began, but coverage has stopped for a short time. Note that match scores may not be updated during this period, the last recorded match score will be displayed instead
cancelled – The match has been cancelled and will not be played
ended – The match is over
closed – The match results have been confirmed
abandoned – The match began, but was then cancelled
Q: What are the valid sport_event_status – status values?
A: Here are the valid sport_event_status - status values:
not_started
closed
Q: How do I access past seasons results and stats?
A: Use the Seasons endpoint to locate the season_id for the season you want to access. Use that season_id to interrogate the various seasons endpoints.