Soccer v4

Frequently Asked Questions

API	API Version
Soccer	v4

Note: Each league group requires a separate API key and authentication is required for all API calls.

## Soccer v4 API Map To best utilize the Soccer v4 API, you will need several parameters to create your API calls. The map below illustrates how you can obtain the parameters you need. >

Examples:

>To find the fun facts for a given match: >

Call the daily summaries for the date of the match and find the Sport Event Id for the chosen match
Call the Sport Event Fun Facts using the Sport Event Id
Locate the Fact Statement

>The fun facts for the match are displayed. >

>To find a teams number of goals by headers for the current season: >

Call the daily summaries and find the desired Competitor Id
Make note of the Season Id for the current season
Call the seasonal competitor statistics using the Team Id and Season Id
Locate the statistics - goals_by_head

>The teams number of goals by headers is displayed. Primary and mapping feeds only require dates, human-readable parameters or a Competition Id (which can be found in the competitions endpoint), while other feeds require a global unique identifier (GUID) to identify the sport event, competitor, or player that the feed will describe. The primary feeds provide GUIDs for sport events, competitions, and competitors, while sport event and competitors provide GUIDS for players.

## Soccer v4 Failover Information

If our scout feed goes down or becomes unavailable, Sportradar takes over Live Data Entry (LDE) to provide a failover.

In case of a failover, we follow one of the following scenarios:

We are unable to provide deeper player or team stats, such as shots, corners, assists, and offsides. We will deliver only basic stats and events such as goals, cards, and substitutions with player names.
We are unable to provide deeper player or team stats and player names for all basic events, such as cards, substitutions, shots, corners, assists, and offsides. We will display player names for goals.

## Competition Info

Update Frequency:	As Necessary
Content Type:	XML or JSON
Competition Info Data Points:	Id	Name	Parent Id

```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/soccer/trial/v4/en/competitions/sr:competition:17/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", "/soccer/trial/v4/en/competitions/sr:competition:17/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/soccer/trial/v4/en/competitions/sr:competition:17/info.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Competition Information. https://api.sportradar.us/soccer/`{access_level}`/`{version}`/`{language_code}`/competitions/`{competition_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: v4). | | `language_code` | Supported Locales | | `competition_id` | Id of a given competition. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the OpenAPI Schema Definition for the Competition Info feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/competitions/getCompetitionInfo Return to API map ## Competition 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.com/soccer/trial/v4/en/competitions/sr:competition:17/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", "/soccer/trial/v4/en/competitions/sr:competition:17/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/soccer/trial/v4/en/competitions/sr:competition:17/seasons.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Competition Seasons. https://api.sportradar.us/soccer/`{access_level}`/`{version}`/`{language_code}`/competitions/`{competition_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 (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v4). | | `language_code` | Supported Locales | | `competition_id` | Id of a given competition. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the OpenAPI Schema Definition for the Competition Seasons feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/competitions/getCompetitionSeasons Return to API map ## Competitions

Update Frequency:	As Necessary
Content Type:	XML or JSON
Competition Info Data Points:	Competition Id	Competition Name	Competition Parent Id

```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/soccer/trial/v4/en/competitions.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", "/soccer/trial/v4/en/competitions.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/soccer/trial/v4/en/competitions.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Competitions. https://api.sportradar.us/soccer/`{access_level}`/`{version}`/`{language_code}`/competitions.`{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: v4). | | `language_code` | Supported Locales | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the OpenAPI Schema Definition for the Competitions feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/competitions/getCompetitions Return to API map ## Competitor Mappings

Update Frequency:	As Necessary
Content Type:	XML or JSON
Mappings Info Data Points:	External Id Id	Merged Id	Retained Id

```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/soccer/trial/v4/en/competitors/mappings.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", "/soccer/trial/v4/en/competitors/mappings.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/soccer/trial/v4/en/competitors/mappings.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Competitor Mappings. https://api.sportradar.us/soccer/`{access_level}`/`{version}`/`{language_code}`/competitors/mappings.`{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: v4). | | `language_code` | Supported Locales | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the OpenAPI Schema Definition for the Competitor Mappings feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/competitors/getCompetitorMappings Return to API map ## Competitor Profile

Update Frequency:	As Necessary
Content Type:	XML or JSON
Sport & Category Info Data Points:	Category Country Code Category Id	Category Name Sport Id	Sport Name
Competitor Info Data Points:	Competitor Abbreviation Competitor Age Group Competitor Country Competitor Country Code Competitor Gender Competitor Id Competitor Name Competitor Qualifier Competitor Virtual Jersey Base Color Jersey Horizontal Stripes	Jersey Horizontal Stripes Color Jersey Number Color Jersey Shirt Type Jersey Sleeve Color Jersey Sleeve Detail Jersey Split Jersey Split Color Jersey Squares Jersey Squares Color Jersey Stripes	Jersey Stripes Color Jersey Type Manager Country Code Manager Date of Birth Manager Gender Manager Id Manager Name Manager Nationality Manager Nickname Manager Preferred Foot
Player Info Data Points:	Country Code Date of Birth Gender Height	Id Jersey Number Name Nationality	Nickname Preferred Foot Type Weight
Venue Info Data Points:	Capacity City Country	Country Code Id	Map Coordinates Name

```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/soccer/trial/v4/en/competitors/sr:competitor:44/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", "/soccer/trial/v4/en/competitors/sr:competitor:44/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/soccer/trial/v4/en/competitors/sr:competitor:44/profile.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Competitor Profile. https://api.sportradar.us/soccer/`{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: v4). | | `language_code` | Supported Locales | | `competitor_id` | Id of a given competitor. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the OpenAPI Schema Definition for the Competitor Profile feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/competitors/getCompetitorProfile Return to API map ## Competitor Summaries

Update Frequency:	As Necessary
Content Type:	XML or JSON
Sport & Category Info Data Points:	Category Country Code Category Id	Category Name Sport Id	Sport Name
Competition Info Data Points:	Competition Id Competition Name Competition Parent Id Competition Properties Brackets Competition Properties Missing Players Competition Properties Player Transfer History Competition Properties Schedules Competition Properties Season Player Statistics Competition Properties Season Probabilities Competition Properties Season Stats Leaders	Competition Properties Season Team Statistics Competition Properties Standings Competition Properties Team Squads Group Group Name Group Id Group Name Round Cup Round Number of Sport Events Round Cup Round Sport Event Number Round Name Round Number Round Other Sport Event Id Season End Date Season Id	Season Name Season Start Date Season Competition Id Season Year Stage End Date Stage Order Stage Phase Stage Start Date Stage Type Stage Year
Competitor Info Data Points:	Competitor Abbreviation Competitor Age Group Competitor Country	Competitor Country Code Competitor Gender Competitor Id	Competitor Name Competitor Qualifier Competitor Virtual
Player Info Data Points:	Id	Name	Starter
Sport Event Info Data Points:	Attendance Count Channel Country Channel Name Channel URL Coverage Type Ground Neutral Group Properties Brackets Group Properties Cup Group Properties League Group Properties Missing Players Group Properties Qualification Group Properties Results Group Properties Schedules Group Properties Standings Referee Id	Referee Name Referee Nationality Referee Country Code Referee Type Sport Event Id Sport Event Replaced By Sport Event Resume Time Sport Event Start Time Sport Event Start Time Confirmed Sport Event Properties Ballspotting Sport Event Properties Basic Play-by-Play Sport Event Properties Basic Player Stats Sport Event Properties Basic Team Stats Sport Event Properties Commentary	Sport Event Properties Deeper Player Stats Sport Event Properties Deeper Team Stats Sport Event Properties Extended Play-by-Play Sport Event Properties Extended Player Stats Sport Event Properties Extended Team Stats Sport Event Properties Fun Facts Sport Event Properties Game Clock Sport Event Properties Goal Scorers Sport Event Properties Lineups Sport Event Properties Lineups Availability Sport Event Properties Probabilities Sport Event Properties Scores Weather Overall Conditions Weather Pitch Conditions
Boxscore Info Data Points:	Clock Played Clock Stoppage Time Announced Clock Stoppage Time Played Period Score Away Score Period Score Home Score Period Score Number	Period Score Type Sport Event Status Away Normaltime Score Sport Event Status Away Score Sport Event Status Decided by Fed Sport Event Status Home Normaltime Score	Sport Event Status Home Score Sport Event Status Match Status Sport Event Status Scout Abandoned Sport Event Status Status Sport Event Status Winner Id
Play by Play Info Data Points:	Order	X Coordinate	Y Coordinate
Player Match Statistics Data Points:	Assists Corner Kicks Goals Scored Offsides Own Goals	Penalties Missed Red Cards Shots Blocked Shots Off Target Shots On Target	Substituted In Substituted Out Yellow Cards Yellow/Red Cards
Team Match Statistics Data Points:	Ball Possession Cards Given Corner Kicks Fouls Free Kicks Goal Kicks	Injuries Offsides Penalties Missed Red Cards Shots Blocked Shots Off Target	Shots On Target Shots Saved Shots Total Throw Ins Yellow Cards Yellow/Red Cards
Venue Info Data Points:	Capacity City Country	Country Code Id	Map Coordinates Name

```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/soccer/trial/v4/en/competitors/sr:competitor:44/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", "/soccer/trial/v4/en/competitors/sr:competitor:44/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.com/soccer/trial/v4/en/competitors/sr:competitor:44/summaries.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Competitor Summaries. https://api.sportradar.us/soccer/`{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: v4). | | `language_code` | Supported Locales | | `competitor_id` | Id of a given competitor. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the OpenAPI Schema Definition for the Competitor Summaries feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/competitors/getCompetitorSummaries Return to API map ## Competitor vs Competitor

Update Frequency:	As Necessary
Content Type:	XML or JSON
Sport & Category Info Data Points:	Category Country Code Category Id	Category Name Sport Id	Sport Name
Competition Info Data Points:	Competition Id Competition Name Competition Parent Id Competition Properties Brackets Competition Properties Missing Players Competition Properties Player Transfer History Competition Properties Schedules Competition Properties Season Player Statistics Competition Properties Season Probabilities Competition Properties Season Stats Leaders	Competition Properties Season Team Statistics Competition Properties Standings Competition Properties Team Squads Group Group Name Group Id Group Name Round Cup Round Number of Sport Events Round Cup Round Sport Event Number Round Name Round Number Round Other Sport Event Id Season End Date Season Id	Season Name Season Start Date Season Competition Id Season Year Stage End Date Stage Order Stage Phase Stage Start Date Stage Type Stage Year
Competitor Info Data Points:	Competitor Abbreviation Competitor Age Group Competitor Country	Competitor Country Code Competitor Gender Competitor Id	Competitor Name Competitor Qualifier Competitor Virtual
Player Info Data Points:	Id	Name	Starter
Sport Event Info Data Points:	Attendance Count Channel Country Channel Name Channel URL Coverage Type Ground Neutral Group Properties Brackets Group Properties Cup Group Properties League Group Properties Missing Players Group Properties Qualification Group Properties Results Group Properties Schedules Group Properties Standings Referee Id	Referee Name Referee Nationality Referee Country Code Referee Type Sport Event Id Sport Event Replaced By Sport Event Resume Time Sport Event Start Time Sport Event Start Time Confirmed Sport Event Properties Ballspotting Sport Event Properties Basic Play-by-Play Sport Event Properties Basic Player Stats Sport Event Properties Basic Team Stats Sport Event Properties Commentary	Sport Event Properties Deeper Player Stats Sport Event Properties Deeper Team Stats Sport Event Properties Extended Play-by-Play Sport Event Properties Extended Player Stats Sport Event Properties Extended Team Stats Sport Event Properties Fun Facts Sport Event Properties Game Clock Sport Event Properties Goal Scorers Sport Event Properties Lineups Sport Event Properties Lineups Availability Sport Event Properties Probabilities Sport Event Properties Scores Weather Overall Conditions Weather Pitch Conditions
Boxscore Info Data Points:	Clock Played Clock Stoppage Time Announced Clock Stoppage Time Played Period Score Away Score Period Score Home Score Period Score Number	Period Score Type Sport Event Status Away Normaltime Score Sport Event Status Away Score Sport Event Status Decided by Fed Sport Event Status Home Normaltime Score	Sport Event Status Home Score Sport Event Status Match Status Sport Event Status Scout Abandoned Sport Event Status Status Sport Event Status Winner Id
Play by Play Info Data Points:	Order	X Coordinate	Y Coordinate
Player Match Statistics Data Points:	Assists Corner Kicks Goals Scored Offsides Own Goals	Penalties Missed Red Cards Shots Blocked Shots Off Target Shots On Target	Substituted In Substituted Out Yellow Cards Yellow/Red Cards
Team Match Statistics Data Points:	Ball Possession Cards Given Corner Kicks Fouls Free Kicks Goal Kicks	Injuries Offsides Penalties Missed Red Cards Shots Blocked Shots Off Target	Shots On Target Shots Saved Shots Total Throw Ins Yellow Cards Yellow/Red Cards
Venue Info Data Points:	Capacity City Country	Country Code Id	Map Coordinates Name

```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/soccer/trial/v4/en/competitors/sr:competitor:44/versus/sr:competitor:42/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", "/soccer/trial/v4/en/competitors/sr:competitor:44/versus/sr:competitor:42/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.com/soccer/trial/v4/en/competitors/sr:competitor:44/versus/sr:competitor:42/summaries.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Competitor vs Competitor. https://api.sportradar.us/soccer/`{access_level}`/`{version}`/`{language_code}`/competitors/`{competitor_id}`/versus/`{competitor_id2}`/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: v4). | | `language_code` | Supported Locales | | `competitor_id` | Id of a given competitor. | | `competitor_id2` | Id of a given competitor. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the OpenAPI Schema Definition for the Competitor vs Competitor feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/summaries/getCompetitorVersusSummaries Return to API map ## Daily Summaries

Update Frequency:	As Necessary
Content Type:	XML or JSON
Sport & Category Info Data Points:	Category Country Code Category Id	Category Name Sport Id	Sport Name
Competition Info Data Points:	Competition Id Competition Name Competition Parent Id Competition Properties Brackets Competition Properties Missing Players Competition Properties Player Transfer History Competition Properties Schedules Competition Properties Season Player Statistics Competition Properties Season Probabilities Competition Properties Season Stats Leaders	Competition Properties Season Team Statistics Competition Properties Standings Competition Properties Team Squads Group Group Name Group Id Group Name Round Cup Round Number of Sport Events Round Cup Round Sport Event Number Round Name Round Number Round Other Sport Event Id Season End Date Season Id	Season Name Season Start Date Season Competition Id Season Year Stage End Date Stage Order Stage Phase Stage Start Date Stage Type Stage Year
Competitor Info Data Points:	Competitor Abbreviation Competitor Age Group Competitor Country	Competitor Country Code Competitor Gender Competitor Id	Competitor Name Competitor Qualifier Competitor Virtual
Player Info Data Points:	Id	Name	Starter
Sport Event Info Data Points:	Attendance Count Channel Country Channel Name Channel URL Coverage Type Ground Neutral Group Properties Brackets Group Properties Cup Group Properties League Group Properties Missing Players Group Properties Qualification Group Properties Results Group Properties Schedules Group Properties Standings Referee Id	Referee Name Referee Nationality Referee Country Code Referee Type Sport Event Id Sport Event Replaced By Sport Event Resume Time Sport Event Start Time Sport Event Start Time Confirmed Sport Event Properties Ballspotting Sport Event Properties Basic Play-by-Play Sport Event Properties Basic Player Stats Sport Event Properties Basic Team Stats Sport Event Properties Commentary	Sport Event Properties Deeper Player Stats Sport Event Properties Deeper Team Stats Sport Event Properties Extended Play-by-Play Sport Event Properties Extended Player Stats Sport Event Properties Extended Team Stats Sport Event Properties Fun Facts Sport Event Properties Game Clock Sport Event Properties Goal Scorers Sport Event Properties Lineups Sport Event Properties Lineups Availability Sport Event Properties Probabilities Sport Event Properties Scores Weather Overall Conditions Weather Pitch Conditions
Boxscore Info Data Points:	Clock Played Clock Stoppage Time Announced Clock Stoppage Time Played Period Score Away Score Period Score Home Score Period Score Number	Period Score Type Sport Event Status Away Normaltime Score Sport Event Status Away Score Sport Event Status Decided by Fed Sport Event Status Home Normaltime Score	Sport Event Status Home Score Sport Event Status Match Status Sport Event Status Scout Abandoned Sport Event Status Status Sport Event Status Winner Id
Play by Play Info Data Points:	Order	X Coordinate	Y Coordinate
Player Match Statistics Data Points:	Assists Corner Kicks Goals Scored Offsides Own Goals	Penalties Missed Red Cards Shots Blocked Shots Off Target Shots On Target	Substituted In Substituted Out Yellow Cards Yellow/Red Cards
Team Match Statistics Data Points:	Ball Possession Cards Given Corner Kicks Fouls Free Kicks Goal Kicks	Injuries Offsides Penalties Missed Red Cards Shots Blocked Shots Off Target	Shots On Target Shots Saved Shots Total Throw Ins Yellow Cards Yellow/Red Cards
Venue Info Data Points:	Capacity City Country	Country Code Id	Map Coordinates Name

```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/soccer/trial/v4/en/schedules/2019-07-23/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", "/soccer/trial/v4/en/schedules/2019-07-23/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.com/soccer/trial/v4/en/schedules/2019-07-23/summaries.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Daily Summaries. https://api.sportradar.us/soccer/`{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: v4). | | `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. | To retrieve the OpenAPI Schema Definition for the Daily Summaries feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/summaries/getScheduleSummaries Return to API map ## Live Summaries

Update Frequency:	As Necessary
Content Type:	XML or JSON
Sport & Category Info Data Points:	Category Country Code Category Id	Category Name Sport Id	Sport Name
Competition Info Data Points:	Competition Id Competition Name Competition Parent Id Competition Properties Brackets Competition Properties Missing Players Competition Properties Player Transfer History Competition Properties Schedules Competition Properties Season Player Statistics Competition Properties Season Probabilities Competition Properties Season Stats Leaders	Competition Properties Season Team Statistics Competition Properties Standings Competition Properties Team Squads Group Group Name Group Id Group Name Round Cup Round Number of Sport Events Round Cup Round Sport Event Number Round Name Round Number Round Other Sport Event Id Season End Date Season Id	Season Name Season Start Date Season Competition Id Season Year Stage End Date Stage Order Stage Phase Stage Start Date Stage Type Stage Year
Competitor Info Data Points:	Competitor Abbreviation Competitor Age Group Competitor Country	Competitor Country Code Competitor Gender Competitor Id	Competitor Name Competitor Qualifier Competitor Virtual
Player Info Data Points:	Id	Name	Starter
Sport Event Info Data Points:	Attendance Count Channel Country Channel Name Channel URL Coverage Type Ground Neutral Group Properties Brackets Group Properties Cup Group Properties League Group Properties Missing Players Group Properties Qualification Group Properties Results Group Properties Schedules Group Properties Standings Referee Id	Referee Name Referee Nationality Referee Country Code Referee Type Sport Event Id Sport Event Replaced By Sport Event Resume Time Sport Event Start Time Sport Event Start Time Confirmed Sport Event Properties Ballspotting Sport Event Properties Basic Play-by-Play Sport Event Properties Basic Player Stats Sport Event Properties Basic Team Stats Sport Event Properties Commentary	Sport Event Properties Deeper Player Stats Sport Event Properties Deeper Team Stats Sport Event Properties Extended Play-by-Play Sport Event Properties Extended Player Stats Sport Event Properties Extended Team Stats Sport Event Properties Fun Facts Sport Event Properties Game Clock Sport Event Properties Goal Scorers Sport Event Properties Lineups Sport Event Properties Lineups Availability Sport Event Properties Probabilities Sport Event Properties Scores Weather Overall Conditions Weather Pitch Conditions
Boxscore Info Data Points:	Clock Played Clock Stoppage Time Announced Clock Stoppage Time Played Period Score Away Score Period Score Home Score Period Score Number	Period Score Type Sport Event Status Away Normaltime Score Sport Event Status Away Score Sport Event Status Decided by Fed Sport Event Status Home Normaltime Score	Sport Event Status Home Score Sport Event Status Match Status Sport Event Status Scout Abandoned Sport Event Status Status Sport Event Status Winner Id
Play by Play Info Data Points:	Order	X Coordinate	Y Coordinate
Player Match Statistics Data Points:	Assists Corner Kicks Goals Scored Offsides Own Goals	Penalties Missed Red Cards Shots Blocked Shots Off Target Shots On Target	Substituted In Substituted Out Yellow Cards Yellow/Red Cards
Team Match Statistics Data Points:	Ball Possession Cards Given Corner Kicks Fouls Free Kicks Goal Kicks	Injuries Offsides Penalties Missed Red Cards Shots Blocked Shots Off Target	Shots On Target Shots Saved Shots Total Throw Ins Yellow Cards Yellow/Red Cards
Venue Info Data Points:	Capacity City Country	Country Code Id	Map Coordinates Name

```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/soccer/trial/v4/en/schedules/live/summaries.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/soccer/trial/v4/en/schedules/live/summaries.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.com/soccer/trial/v4/en/schedules/live/summaries.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Live Summaries. https://api.sportradar.us/soccer/`{access_level}`/`{version}`/`{language_code}`/schedules/live/summaries.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v4). | | `language_code` | Supported Locales | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the OpenAPI Schema Definition for the Live Summaries feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/summaries/getScheduleLiveSummaries Return to API map ## Live Timelines

Update Frequency:	As Necessary
Content Type:	XML or JSON
Player Info Data Points:	Id	Name	Starter
Boxscore Info Data Points:	Clock Played Clock Stoppage Time Announced Clock Stoppage Time Played Period Score Away Score Period Score Home Score Period Score Number	Period Score Type Sport Event Status Away Normaltime Score Sport Event Status Away Score Sport Event Status Decided by Fed Sport Event Status Home Normaltime Score	Sport Event Status Home Score Sport Event Status Match Status Sport Event Status Scout Abandoned Sport Event Status Status Sport Event Status Winner Id
Play by Play Info Data Points:	Away Team Score Ball Location Order Ball Location X Coordinate Ball Location Y Coordinate Event Break Name Event Card Description Event Commentary Event Competitor Event Coordinate X Event Coordinate Y	Event Id Event Injury Time Announced Event Match Clock Event Match Time Event Method Event Outcome Event Period Event Period Name Event Period Type	Event Shootout Away Score Event Shootout Home Score Event Stoppage Time Event Type Event Time Home Team Score Sport Event Timeline Id Sport Event Timeline Start Time
Play Details Data Points:	Assisting Player Id Assisting Player Method Assisting Player Name Assisting Player Type Goal Scorer Id Goal Scorer Method	Goal Scorer Name Goal Scorer Type Substitution Player In Id Substitution Player In Method Substitution Player In Name	Substitution Player In Type Substitution Player Out Id Substitution Player Out Method Substitution Player Out Name Substitution Player Out Type

```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/soccer/trial/v4/en/schedules/live/timelines.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", "/soccer/trial/v4/en/schedules/live/timelines.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/soccer/trial/v4/en/schedules/live/timelines.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Live Timelines. https://api.sportradar.us/soccer/`{access_level}`/`{version}`/`{language_code}`/schedules/live/timelines.`{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: v4). | | `language_code` | Supported Locales | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the OpenAPI Schema Definition for the Live Timelines feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/timelines/getLiveTimelines Return to API map ## Live Timelines Delta

Update Frequency:	As Necessary
Content Type:	XML or JSON
Player Info Data Points:	Id	Name	Starter
Boxscore Info Data Points:	Clock Played Clock Stoppage Time Announced Clock Stoppage Time Played Period Score Away Score Period Score Home Score Period Score Number	Period Score Type Sport Event Status Away Normaltime Score Sport Event Status Away Score Sport Event Status Decided by Fed Sport Event Status Home Normaltime Score	Sport Event Status Home Score Sport Event Status Match Status Sport Event Status Scout Abandoned Sport Event Status Status Sport Event Status Winner Id
Play by Play Info Data Points:	Away Team Score Ball Location Order Ball Location X Coordinate Ball Location Y Coordinate Event Break Name Event Card Description Event Commentary Event Competitor Event Coordinate X Event Coordinate Y	Event Id Event Injury Time Announced Event Match Clock Event Match Time Event Method Event Outcome Event Period Event Period Name Event Period Type	Event Shootout Away Score Event Shootout Home Score Event Stoppage Time Event Type Event Time Home Team Score Sport Event Timeline Delta Id Sport Event Timeline Delta Start Time
Play Details Data Points:	Assisting Player Id Assisting Player Method Assisting Player Name Assisting Player Type Goal Scorer Id Goal Scorer Method	Goal Scorer Name Goal Scorer Type Substitution Player In Id Substitution Player In Method Substitution Player In Name	Substitution Player In Type Substitution Player Out Id Substitution Player Out Method Substitution Player Out Name Substitution Player Out Type

```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/soccer/trial/v4/en/schedules/live/timelines_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", "/soccer/trial/v4/en/schedules/live/timelines_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/soccer/trial/v4/en/schedules/live/timelines_delta.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Live Timelines Delta. https://api.sportradar.us/soccer/`{access_level}`/`{version}`/`{language_code}`/schedules/live/timelines_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 (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v4). | | `language_code` | Supported Locales | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the OpenAPI Schema Definition for the Live Timelines Delta feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/timelines/getLiveTimelinesDelta Return to API map ## Player Mappings

Update Frequency:	As Necessary
Content Type:	XML or JSON
Mappings Info Data Points:	External Id Id	Merged Id	Retained Id

```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/soccer/trial/v4/en/players/mappings.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", "/soccer/trial/v4/en/players/mappings.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/soccer/trial/v4/en/players/mappings.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Player Mappings. https://api.sportradar.us/soccer/`{access_level}`/`{version}`/`{language_code}`/players/mappings.`{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: v4). | | `language_code` | Supported Locales | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the OpenAPI Schema Definition for the Player Mappings feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/players/getPlayerMappings Return to API map ## Player Merge Mappings

Update Frequency:	As Necessary
Content Type:	XML or JSON
Mappings Info Data Points:	Merged Id	Retained Id

```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/soccer/trial/v4/en/players/merge_mappings.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", "/soccer/trial/v4/en/players/merge_mappings.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/soccer/trial/v4/en/players/merge_mappings.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Player Merge Mappings. https://api.sportradar.us/soccer/`{access_level}`/`{version}`/`{language_code}`/players/merge_mappings.`{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: v4). | | `language_code` | Supported Locales | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the OpenAPI Schema Definition for the Player Merge Mappings feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/players/getPlayerMergeMappings Return to API map ## Player Profile

Update Frequency:	As Necessary
Content Type:	XML or JSON
Competitor Info Data Points:	Competitor Abbreviation Competitor Age Group Competitor Country	Competitor Country Code Competitor Gender Competitor Id	Competitor Name Competitor Qualifier Competitor Virtual
Player Info Data Points:	Country Code Date of Birth Gender Height Id Jersey Number	Name Nationality Nickname Preferred Foot Team Membership Active Flag Team Membership End Date	Team Membership Jersey Number Team Membership Start Date Team Membership Type Type Weight

```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/soccer/trial/v4/en/players/sr:player:159665/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", "/soccer/trial/v4/en/players/sr:player:159665/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/soccer/trial/v4/en/players/sr:player:159665/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/soccer/`{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 (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v4). | | `language_code` | Supported Locales | | `player_id` | Id of a given player. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the OpenAPI Schema Definition for the Player Profile feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/players/getPlayerProfile Return to API map ## Player Summaries

Update Frequency:	As Necessary
Content Type:	XML or JSON
Sport & Category Info Data Points:	Category Country Code Category Id	Category Name Sport Id	Sport Name
Competition Info Data Points:	Competition Id Competition Name Competition Parent Id Competition Properties Brackets Competition Properties Missing Players Competition Properties Player Transfer History Competition Properties Schedules Competition Properties Season Player Statistics Competition Properties Season Probabilities Competition Properties Season Stats Leaders	Competition Properties Season Team Statistics Competition Properties Standings Competition Properties Team Squads Group Group Name Group Id Group Name Round Cup Round Number of Sport Events Round Cup Round Sport Event Number Round Name Round Number Round Other Sport Event Id Season End Date Season Id	Season Name Season Start Date Season Competition Id Season Year Stage End Date Stage Order Stage Phase Stage Start Date Stage Type Stage Year
Competitor Info Data Points:	Competitor Abbreviation Competitor Age Group Competitor Country	Competitor Country Code Competitor Gender Competitor Id	Competitor Name Competitor Qualifier Competitor Virtual
Player Info Data Points:	Id	Name	Starter
Sport Event Info Data Points:	Attendance Count Channel Country Channel Name Channel URL Coverage Type Ground Neutral Group Properties Brackets Group Properties Cup Group Properties League Group Properties Missing Players Group Properties Qualification Group Properties Results Group Properties Schedules Group Properties Standings Referee Id	Referee Name Referee Nationality Referee Country Code Referee Type Sport Event Id Sport Event Replaced By Sport Event Resume Time Sport Event Start Time Sport Event Start Time Confirmed Sport Event Properties Ballspotting Sport Event Properties Basic Play-by-Play Sport Event Properties Basic Player Stats Sport Event Properties Basic Team Stats Sport Event Properties Commentary	Sport Event Properties Deeper Player Stats Sport Event Properties Deeper Team Stats Sport Event Properties Extended Play-by-Play Sport Event Properties Extended Player Stats Sport Event Properties Extended Team Stats Sport Event Properties Fun Facts Sport Event Properties Game Clock Sport Event Properties Goal Scorers Sport Event Properties Lineups Sport Event Properties Lineups Availability Sport Event Properties Probabilities Sport Event Properties Scores Weather Overall Conditions Weather Pitch Conditions
Boxscore Info Data Points:	Clock Played Clock Stoppage Time Announced Clock Stoppage Time Played Period Score Away Score Period Score Home Score Period Score Number	Period Score Type Sport Event Status Away Normaltime Score Sport Event Status Away Score Sport Event Status Decided by Fed Sport Event Status Home Normaltime Score	Sport Event Status Home Score Sport Event Status Match Status Sport Event Status Scout Abandoned Sport Event Status Status Sport Event Status Winner Id
Play by Play Info Data Points:	Order	X Coordinate	Y Coordinate
Player Match Statistics Data Points:	Assists Corner Kicks Goals Scored Offsides Own Goals	Penalties Missed Red Cards Shots Blocked Shots Off Target Shots On Target	Substituted In Substituted Out Yellow Cards Yellow/Red Cards
Team Match Statistics Data Points:	Ball Possession Cards Given Corner Kicks Fouls Free Kicks Goal Kicks	Injuries Offsides Penalties Missed Red Cards Shots Blocked Shots Off Target	Shots On Target Shots Saved Shots Total Throw Ins Yellow Cards Yellow/Red Cards
Venue Info Data Points:	Capacity City Country	Country Code Id	Map Coordinates Name

```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/soccer/trial/v4/en/players/sr:player:159665/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", "/soccer/trial/v4/en/players/sr:player:159665/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.com/soccer/trial/v4/en/players/sr:player:159665/summaries.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Player Summaries. https://api.sportradar.us/soccer/`{access_level}`/`{version}`/`{language_code}`/players/`{player_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: v4). | | `language_code` | Supported Locales | | `player_id` | Id of a given player. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the OpenAPI Schema Definition for the Player Summaries feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/players/getPlayerSummaries Return to API map ## Season Info

Update Frequency:	As Necessary
Content Type:	XML or JSON
Sport & Category Info Data Points:	Category Country Code Category Id	Category Name Sport Id	Sport Name
Competition Info Data Points:	Competition Id Competition Name Competition Parent Id Competition Properties Brackets Competition Properties Missing Players Competition Properties Player Transfer History Competition Properties Schedules Competition Properties Season Player Statistics Competition Properties Season Probabilities Competition Properties Season Stats Leaders	Competition Properties Season Team Statistics Competition Properties Standings Competition Properties Team Squads Group Group Name Group Id Group Max Rounds Group Name Season End Date Season Id	Season Name Season Start Date Season Competition Id Season Year Stage End Date Stage Order Stage Phase Stage Start Date Stage Type Stage Year
Competitor Info Data Points:	Competitor Abbreviation Competitor Age Group Competitor Country	Competitor Country Code Competitor Gender Competitor Id	Competitor Name Competitor Qualifier Competitor Virtual
Sport Event Info Data Points:	Coverage Type Group Properties Brackets Group Properties Cup Group Properties League Group Properties Missing Players Group Properties Qualification Group Properties Results Group Properties Schedules Group Properties Standings	Sport Event Properties Ballspotting Sport Event Properties Basic Play-by-Play Sport Event Properties Basic Player Stats Sport Event Properties Basic Team Stats Sport Event Properties Commentary Sport Event Properties Deeper Player Stats Sport Event Properties Deeper Team Stats Sport Event Properties Extended Play-by-Play	Sport Event Properties Extended Player Stats Sport Event Properties Extended Team Stats Sport Event Properties Fun Facts Sport Event Properties Game Clock Sport Event Properties Goal Scorers Sport Event Properties Lineups Sport Event Properties Lineups Availability Sport Event Properties Probabilities Sport Event Properties Scores

```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/soccer/trial/v4/en/seasons/sr:season:66441/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", "/soccer/trial/v4/en/seasons/sr:season:66441/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/soccer/trial/v4/en/seasons/sr:season:66441/info.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Season Info. https://api.sportradar.us/soccer/`{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: v4). | | `language_code` | Supported Locales | | `season_id` | Id of a given season. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the OpenAPI Schema Definition for the Season Info feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/seasons/getSeasonInfo Return to API map ## Season Leaders

Update Frequency:	As Necessary
Content Type:	XML or JSON
Competitor Info Data Points:	Competitor Abbreviation	Competitor Id	Competitor Name
Player Info Data Points:	Player Id	Player Name
Season Leader Info Data Points:	List Type Leader Rank	Datapoint Type	Datapoint Value

```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/soccer/trial/v4/en/seasons/sr:season:66441/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", "/soccer/trial/v4/en/seasons/sr:season:66441/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/soccer/trial/v4/en/seasons/sr:season:66441/leaders.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Season Leaders. https://api.sportradar.us/soccer/`{access_level}`/`{version}`/`{language_code}`/seasons/`{season_id}`/leaders.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v4). | | `language_code` | Supported Locales | | `season_id` | Id of a given season. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the OpenAPI Schema Definition for the Season Leaders feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/seasons/getSeasonLeaders Return to API map ## Season Lineups

Update Frequency:	As Necessary
Content Type:	XML or JSON
Sport & Category Info Data Points:	Category Country Code Category Id	Category Name Sport Id	Sport Name
Competition Info Data Points:	Competition Id Competition Name Competition Parent Id Competition Properties Brackets Competition Properties Missing Players Competition Properties Player Transfer History Competition Properties Schedules Competition Properties Season Player Statistics Competition Properties Season Probabilities Competition Properties Season Stats Leaders	Competition Properties Season Team Statistics Competition Properties Standings Competition Properties Team Squads Group Group Name Group Id Group Name Round Cup Round Number of Sport Events Round Cup Round Sport Event Number Round Name Round Number Round Other Sport Event Id Season End Date Season Id	Season Name Season Start Date Season Competition Id Season Year Stage End Date Stage Order Stage Phase Stage Start Date Stage Type Stage Year
Competitor Info Data Points:	Competitor Abbreviation Competitor Age Group Competitor Country	Competitor Country Code Competitor Gender Competitor Id	Competitor Name Competitor Qualifier Competitor Virtual
Player Info Data Points:	Country Code Date of Birth Gender Height Id	Jersey Number Name Nationality Nickname Played	Preferred Foot Starter Type Weight
Sport Event Info Data Points:	Attendance Count Channel Country Channel Name Channel URL Coverage Type Ground Neutral Group Properties Brackets Group Properties Cup Group Properties League Group Properties Missing Players Group Properties Qualification Group Properties Results Group Properties Schedules Group Properties Standings Referee Id	Referee Name Referee Nationality Referee Country Code Referee Type Sport Event Id Sport Event Replaced By Sport Event Resume Time Sport Event Start Time Sport Event Start Time Confirmed Sport Event Properties Ballspotting Sport Event Properties Basic Play-by-Play Sport Event Properties Basic Player Stats Sport Event Properties Basic Team Stats Sport Event Properties Commentary	Sport Event Properties Deeper Player Stats Sport Event Properties Deeper Team Stats Sport Event Properties Extended Play-by-Play Sport Event Properties Extended Player Stats Sport Event Properties Extended Team Stats Sport Event Properties Fun Facts Sport Event Properties Game Clock Sport Event Properties Goal Scorers Sport Event Properties Lineups Sport Event Properties Lineups Availability Sport Event Properties Probabilities Sport Event Properties Scores Weather Overall Conditions Weather Pitch Conditions
Boxscore Info Data Points:	Clock Played Clock Stoppage Time Announced Clock Stoppage Time Played Period Score Away Score Period Score Home Score Period Score Number	Period Score Type Sport Event Status Away Normaltime Score Sport Event Status Away Score Sport Event Status Decided by Fed Sport Event Status Home Normaltime Score	Sport Event Status Home Score Sport Event Status Match Status Sport Event Status Scout Abandoned Sport Event Status Status Sport Event Status Winner Id
Play by Play Info Data Points:	Order	X Coordinate	Y Coordinate
Match Lineups Data Points:	Player Order Player Position	Team Designation	Team Formation
Venue Info Data Points:	Capacity City Country	Country Code Id	Map Coordinates Name

```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/soccer/trial/v4/en/seasons/sr:season:66441/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", "/soccer/trial/v4/en/seasons/sr:season:66441/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/soccer/trial/v4/en/seasons/sr:season:66441/lineups.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Season Lineups. https://api.sportradar.us/soccer/`{access_level}`/`{version}`/`{language_code}`/seasons/`{season_id}`/lineups.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v4). | | `language_code` | Supported Locales | | `season_id` | Id of a given season. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the OpenAPI Schema Definition for the Season Lineups feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/seasons/getSeasonLineups ### Optional Query String Parameters >Example including optional query string parameters: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("http://api.sportradar.us/soccer/trial/v4/en/seasons/sr:season:66441/lineups.xml?api_key={your_api_key}&start=0&limit=75") 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", "/soccer/trial/v4/en/seasons/sr:season:66441/lineups.xml?api_key={your_api_key}&start=0&limit=75") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -L GET 'api.sportradar.us/soccer/trial/v4/en/seasons/sr:season:66441/lineups.xml?api_key={your_api_key}&start=0&limit=75' ``` In addition to the URL parameters listed above, you can paginate the lineup information with one or more of the following optional query string parameters.

Note: Optional query string parameters must be added after your API key with an ampersand (&).

Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `start` | Number to start the list of results from.
Example: start=0 | | `limit` | Number to limit the number of results. Minimum value is 1, suggested maximum value is 75.
Example: limit=75 | Return to API map ## Season Missing Players

Update Frequency:	As Necessary
Content Type:	XML or JSON
Competitor Info Data Points:	Competitor Abbreviation	Competitor Id	Competitor Name
Player Info Data Points:	Id Missing Reason	Name	Status

```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/soccer/trial/v4/en/seasons/sr:season:66441/missing_players.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", "/soccer/trial/v4/en/seasons/sr:season:66441/missing_players.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/soccer/trial/v4/en/seasons/sr:season:66441/missing_players.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Season Missing Players. https://api.sportradar.us/soccer/`{access_level}`/`{version}`/`{language_code}`/seasons/`{season_id}`/missing_players.`{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: v4). | | `language_code` | Supported Locales | | `season_id` | Id of a given season. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the OpenAPI Schema Definition for the Season Missing Players feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/seasons/getSeasonMissingPlayers Return to API map ## Season Probabilities

Update Frequency:	As Necessary
Content Type:	XML or JSON
Sport & Category Info Data Points:	Category Country Code Category Id	Category Name Sport Id	Sport Name
Competition Info Data Points:	Competition Id Competition Name Competition Parent Id Competition Properties Brackets Competition Properties Missing Players Competition Properties Player Transfer History Competition Properties Schedules Competition Properties Season Player Statistics Competition Properties Season Probabilities Competition Properties Season Stats Leaders	Competition Properties Season Team Statistics Competition Properties Standings Competition Properties Team Squads Group Group Name Group Id Group Name Round Cup Round Number of Sport Events Round Cup Round Sport Event Number Round Name Round Number Round Other Sport Event Id Season End Date Season Id	Season Name Season Start Date Season Competition Id Season Year Stage End Date Stage Order Stage Phase Stage Start Date Stage Type Stage Year
Competitor Info Data Points:	Competitor Abbreviation Competitor Age Group Competitor Country	Competitor Country Code Competitor Gender Competitor Id	Competitor Name Competitor Qualifier Competitor Virtual
Sport Event Info Data Points:	Channel Country Channel Name Channel URL Coverage Type Ground Neutral Group Properties Brackets Group Properties Cup Group Properties League Group Properties Missing Players Group Properties Qualification Group Properties Results Group Properties Schedules Group Properties Standings	Sport Event Id Sport Event Replaced By Sport Event Resume Time Sport Event Start Time Sport Event Start Time Confirmed Sport Event Properties Ballspotting Sport Event Properties Basic Play-by-Play Sport Event Properties Basic Player Stats Sport Event Properties Basic Team Stats Sport Event Properties Commentary Sport Event Properties Deeper Player Stats Sport Event Properties Deeper Team Stats	Sport Event Properties Extended Play-by-Play Sport Event Properties Extended Player Stats Sport Event Properties Extended Team Stats Sport Event Properties Fun Facts Sport Event Properties Game Clock Sport Event Properties Goal Scorers Sport Event Properties Lineups Sport Event Properties Lineups Availability Sport Event Properties Probabilities Sport Event Properties Scores Weather Overall Conditions Weather Pitch Conditions
Boxscore Info Data Points:	Clock Played Clock Stoppage Time Announced Clock Stoppage Time Played Period Score Away Score Period Score Home Score Period Score Number	Period Score Type Sport Event Status Away Normaltime Score Sport Event Status Away Score Sport Event Status Decided by Fed Sport Event Status Home Normaltime Score	Sport Event Status Home Score Sport Event Status Match Status Sport Event Status Scout Abandoned Sport Event Status Status Sport Event Status Winner Id
Play by Play Info Data Points:	Order	X Coordinate	Y Coordinate
Match Probabilities Data Points:	Away Team Win Probabilities Draw Probabilities	Home Team Win Probabilities Market Name	Outcome Name
Venue Info Data Points:	Capacity City Country	Country Code Id	Map Coordinates Name

```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/soccer/trial/v4/en/seasons/sr:season:66441/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", "/soccer/trial/v4/en/seasons/sr:season:66441/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/soccer/trial/v4/en/seasons/sr:season:66441/probabilities.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Season Probabilities. https://api.sportradar.us/soccer/`{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: v4). | | `language_code` | Supported Locales | | `season_id` | Id of a given season. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the OpenAPI Schema Definition for the Season Probabilities feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/seasons/getSeasonProbabilities Return to API map ## Season Standings

Update Frequency:	As Necessary
Content Type:	XML or JSON
Competition Info Data Points:	Group - Group Name Group Id Group Name	Stage End Date Stage Order Stage Phase	Stage Start Date Stage Type Stage Year
Competitor Info Data Points:	Competitor Abbreviation Competitor Age Group Competitor Country	Competitor Country Code Competitor Gender Competitor Id	Competitor Name Competitor Qualifier Competitor Virtual
Standings Info Data Points:	Change Current Outcome Draws Goals Against Goals Differential Goals For	Group - Group Name Group Id Group Live Group Name Losses Matches Played	Points Rank Round Tie Break Rule Type Wins

```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/soccer/trial/v4/en/seasons/sr:season:66441/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", "/soccer/trial/v4/en/seasons/sr:season:66441/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/soccer/trial/v4/en/seasons/sr:season:66441/standings.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Season Standings. https://api.sportradar.us/soccer/`{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: v4). | | `language_code` | Supported Locales | | `season_id` | Id of a given season. | | `format` | xml or json. | | `your_api_key` | Your API key. | ### Optional Query String Parameters >Example including optional query string parameters: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("http://api.sportradar.com/soccer/trial/v4/en/seasons/sr:season:66441/standings.xml?api_key={your_api_key}&round=1") 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", "/soccer/trial/v4/en/seasons/sr:season:66441/standings.xml?api_key={your_api_key}&round=1") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -L GET 'api.sportradar.com/soccer/trial/v4/en/seasons/sr:season:66441/standings.xml?api_key={your_api_key}&round=1' ``` In addition to the URL parameters listed above, you can filter the Standings information with the following optional query string parameter.

Note: Optional query string parameters must be added after your API key with an ampersand (&). If you are filtering for more than one result, separate the results with a comma (,) and no spaces.

Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `round` | Round number expressed as: {round}.
Example: round=1 | To retrieve the OpenAPI Schema Definition for the Season Standings feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/seasons/getSeasonStandings Return to API map ## Season Summaries

Update Frequency:	As Necessary
Content Type:	XML or JSON
Sport & Category Info Data Points:	Category Country Code Category Id	Category Name Sport Id	Sport Name
Competition Info Data Points:	Competition Id Competition Name Competition Parent Id Competition Properties Brackets Competition Properties Missing Players Competition Properties Player Transfer History Competition Properties Schedules Competition Properties Season Player Statistics Competition Properties Season Probabilities Competition Properties Season Stats Leaders	Competition Properties Season Team Statistics Competition Properties Standings Competition Properties Team Squads Group Group Name Group Id Group Name Round Cup Round Number of Sport Events Round Cup Round Sport Event Number Round Name Round Number Round Other Sport Event Id Season End Date Season Id	Season Name Season Start Date Season Competition Id Season Year Stage End Date Stage Order Stage Phase Stage Start Date Stage Type Stage Year
Competitor Info Data Points:	Competitor Abbreviation Competitor Age Group Competitor Country	Competitor Country Code Competitor Gender Competitor Id	Competitor Name Competitor Qualifier Competitor Virtual
Sport Event Info Data Points:	Attendance Count Channel Country Channel Name Channel URL Coverage Type Ground Neutral Group Properties Brackets Group Properties Cup Group Properties League Group Properties Missing Players Group Properties Qualification Group Properties Results Group Properties Schedules Group Properties Standings Referee Id	Referee Name Referee Nationality Referee Country Code Referee Type Sport Event Id Sport Event Replaced By Sport Event Resume Time Sport Event Start Time Sport Event Start Time Confirmed Sport Event Properties Ballspotting Sport Event Properties Basic Play-by-Play Sport Event Properties Basic Player Stats Sport Event Properties Basic Team Stats Sport Event Properties Commentary	Sport Event Properties Deeper Player Stats Sport Event Properties Deeper Team Stats Sport Event Properties Extended Play-by-Play Sport Event Properties Extended Player Stats Sport Event Properties Extended Team Stats Sport Event Properties Fun Facts Sport Event Properties Game Clock Sport Event Properties Goal Scorers Sport Event Properties Lineups Sport Event Properties Lineups Availability Sport Event Properties Probabilities Sport Event Properties Scores Weather Overall Conditions Weather Pitch Conditions
Boxscore Info Data Points:	Clock Played Clock Stoppage Time Announced Clock Stoppage Time Played Period Score Away Score Period Score Home Score Period Score Number	Period Score Type Sport Event Status Away Normaltime Score Sport Event Status Away Score Sport Event Status Decided by Fed Sport Event Status Home Normaltime Score	Sport Event Status Home Score Sport Event Status Match Status Sport Event Status Scout Abandoned Sport Event Status Status Sport Event Status Winner Id
Play by Play Info Data Points:	Order	X Coordinate	Y Coordinate
Player Match Statistics Data Points:	Assists Corner Kicks Goals Scored Offsides Own Goals	Penalties Missed Red Cards Shots Blocked Shots Off Target Shots On Target	Substituted In Substituted Out Yellow Cards Yellow/Red Cards
Team Match Statistics Data Points:	Ball Possession Cards Given Corner Kicks Fouls Free Kicks Goal Kicks	Injuries Offsides Penalties Missed Red Cards Shots Blocked Shots Off Target	Shots On Target Shots Saved Shots Total Throw Ins Yellow Cards Yellow/Red Cards
Venue Info Data Points:	Capacity City Country	Country Code Id	Map Coordinates Name

```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/soccer/trial/v4/en/seasons/sr:season:66441/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", "/soccer/trial/v4/en/seasons/sr:season:66441/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.com/soccer/trial/v4/en/seasons/sr:season:66441/summaries.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Season Summaries. https://api.sportradar.us/soccer/`{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: v4). | | `language_code` | Supported Locales | | `season_id` | Id of a given season. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the OpenAPI Schema Definition for the Season Summaries feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/seasons/getSeasonSummaries ### Optional Query String Parameters >Example including optional query string parameters: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("http://api.sportradar.us/soccer/trial/v4/en/seasons/sr:season:66441/summaries.xml?api_key={your_api_key}&start=0&limit=75") 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", "/soccer/trial/v4/en/seasons/sr:season:66441/summaries.xml?api_key={your_api_key}&start=0&limit=75") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -L GET 'api.sportradar.us/soccer/trial/v4/en/seasons/sr:season:66441/summaries.xml?api_key={your_api_key}&start=0&limit=75' ``` In addition to the URL parameters listed above, you can paginate the summaries with one or more of the following optional query string parameters.

Note: Optional query string parameters must be added after your API key with an ampersand (&).

Update Frequency:	As Necessary
Content Type:	XML or JSON
Sport & Category Info Data Points:	Category Country Code Category Id	Category Name Sport Id	Sport Name
Competition Info Data Points:	Competition Id Competition Name Competition Parent Id	Season Competition Id Season End Date Season Id	Season Name Season Start Date Season Year
Player Info Data Points:	Id	Name	Starter
Player Seasonal Statistics Data Points:	Assists Corner Kicks Goals Scored Offsides Own Goals	Red Cards Shots Blocked Shots Off Target Shots On Target	Substituted In Substituted Out Yellow Cards Yellow/Red Cards
Team Seasonal Statistics Data Points:	Average Ball Possession Cards Given Corner Kicks Free Kicks Goals by Foot Goals by Head Goals Conceded Goals Conceded First Half	Goals Conceded Second Half Goals Scored Goals Scored First Half Goals Scored Second Half Offsides Red Cards Shots Blocked	Shots off Target Shots on Bar Shots on Post Shots on Target Shots Total Yellow Cards Yellow/Red Cards

```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/soccer/trial/v4/en/seasons/sr:season:54571/competitors/sr:competitor:17/statistics.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", "/soccer/trial/v4/en/seasons/sr:season:54571/competitors/sr:competitor:17/statistics.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/soccer/trial/v4/en/seasons/sr:season:54571/competitors/sr:competitor:17/statistics.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Competitor Seasonal Statistics. https://api.sportradar.us/soccer/`{access_level}`/`{version}`/`{language_code}`/seasons/`{season_id}`/competitors/`{competitor_id}`/statistics.`{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: v4). | | `language_code` | Supported Locales | | `season_id` | Id of a given season. | | `competitor_id` | Id of a given competitor. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the OpenAPI Schema Definition for the Competitor Seasonal Statistics feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/competitors/getSeasonCompetitorStatistics 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.com/soccer/trial/v4/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", "/soccer/trial/v4/en/soccer/trial/v4/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.com/soccer/trial/v4/en/seasons.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Seasons. https://api.sportradar.us/soccer/`{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: v4). | | `language_code` | Supported Locales | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the OpenAPI Schema Definition for the Seasons feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/seasons/getSeasons Return to API map ## Sport Event Fun Facts

Update Frequency:	As Necessary
Content Type:	XML or JSON
Sport Event Info Data Points:	Match Facts

```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/soccer/trial/v4/en/sport_events/sr:sport_event:18427304/fun_facts.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", "/soccer/trial/v4/en/sport_events/sr:sport_event:18427304/fun_facts.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/soccer/trial/v4/en/sport_events/sr:sport_event:18427304/fun_facts.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Sport Event Fun Facts. https://api.sportradar.us/soccer/`{access_level}`/`{version}`/`{language_code}`/sport_events/`{sport_event_id}`/fun_facts.`{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: v4). | | `language_code` | Supported Locales | | `sport_event_id` | Id of a given sport event. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the OpenAPI Schema Definition for the Sport Event Fun Facts feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/sport_events/getSportEventFunFacts Return to API map ## Sport Event Lineups

Update Frequency:	As Necessary
Content Type:	XML or JSON
Sport & Category Info Data Points:	Category Country Code Category Id	Category Name Sport Id	Sport Name
Competition Info Data Points:	Competition Id Competition Name Competition Parent Id Competition Properties Brackets Competition Properties Missing Players Competition Properties Player Transfer History Competition Properties Schedules Competition Properties Season Player Statistics Competition Properties Season Probabilities Competition Properties Season Stats Leaders	Competition Properties Season Team Statistics Competition Properties Standings Competition Properties Team Squads Group Group Name Group Id Group Name Round Cup Round Number of Sport Events Round Cup Round Sport Event Number Round Name Round Number Round Other Sport Event Id Season End Date Season Id	Season Name Season Start Date Season Competition Id Season Year Stage End Date Stage Order Stage Phase Stage Start Date Stage Type Stage Year
Competitor Info Data Points:	Competitor Abbreviation Competitor Age Group Competitor Country	Competitor Country Code Competitor Gender Competitor Id	Competitor Name Competitor Qualifier Competitor Virtual
Player Info Data Points:	Country Code Date of Birth Gender Height Id	Jersey Number Name Nationality Nickname Played	Preferred Foot Starter Type Weight
Sport Event Info Data Points:	Attendance Count Channel Country Channel Name Channel URL Coverage Type Ground Neutral Group Properties Brackets Group Properties Cup Group Properties League Group Properties Missing Players Group Properties Qualification Group Properties Results Group Properties Schedules Group Properties Standings Referee Id	Referee Name Referee Nationality Referee Country Code Referee Type Sport Event Id Sport Event Replaced By Sport Event Resume Time Sport Event Start Time Sport Event Start Time Confirmed Sport Event Properties Ballspotting Sport Event Properties Basic Play-by-Play Sport Event Properties Basic Player Stats Sport Event Properties Basic Team Stats Sport Event Properties Commentary	Sport Event Properties Deeper Player Stats Sport Event Properties Deeper Team Stats Sport Event Properties Extended Play-by-Play Sport Event Properties Extended Player Stats Sport Event Properties Extended Team Stats Sport Event Properties Fun Facts Sport Event Properties Game Clock Sport Event Properties Goal Scorers Sport Event Properties Lineups Sport Event Properties Lineups Availability Sport Event Properties Probabilities Sport Event Properties Scores Weather Overall Conditions Weather Pitch Conditions
Boxscore Info Data Points:	Clock Played Clock Stoppage Time Announced Clock Stoppage Time Played Period Score Away Score Period Score Home Score Period Score Number	Period Score Type Sport Event Status Away Normaltime Score Sport Event Status Away Score Sport Event Status Decided by Fed Sport Event Status Home Normaltime Score	Sport Event Status Home Score Sport Event Status Match Status Sport Event Status Scout Abandoned Sport Event Status Status Sport Event Status Winner Id
Play by Play Info Data Points:	Order	X Coordinate	Y Coordinate
Match Lineups Data Points:	Player Order Player Position	Team Designation	Team Formation
Venue Info Data Points:	Capacity City Country	Country Code Id	Map Coordinates Name

```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/soccer/trial/v4/en/sport_events/sr:sport_event:18427304/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", "/soccer/trial/v4/en/sport_events/sr:sport_event:18427304/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/soccer/trial/v4/en/sport_events/sr:sport_event:18427304/lineups.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Sport Event Lineups. https://api.sportradar.us/soccer/`{access_level}`/`{version}`/`{language_code}`/sport_events/`{sport_event_id}`/lineups.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v4). | | `language_code` | Supported Locales | | `sport_event_id` | Id of a given sport event. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the OpenAPI Schema Definition for the Sport Event Lineups feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/sport_events/getSportEventLineups Return to API map ## Sport Event Summary

Update Frequency:	As Necessary
Content Type:	XML or JSON
Sport & Category Info Data Points:	Category Country Code Category Id	Category Name Sport Id	Sport Name
Competition Info Data Points:	Competition Id Competition Name Competition Parent Id Competition Properties Brackets Competition Properties Missing Players Competition Properties Player Transfer History Competition Properties Schedules Competition Properties Season Player Statistics Competition Properties Season Probabilities Competition Properties Season Stats Leaders	Competition Properties Season Team Statistics Competition Properties Standings Competition Properties Team Squads Group Group Name Group Id Group Name Round Cup Round Number of Sport Events Round Cup Round Sport Event Number Round Name Round Number Round Other Sport Event Id Season End Date Season Id	Season Name Season Start Date Season Competition Id Season Year Stage End Date Stage Order Stage Phase Stage Start Date Stage Type Stage Year
Competitor Info Data Points:	Competitor Abbreviation Competitor Age Group Competitor Country	Competitor Country Code Competitor Gender Competitor Id	Competitor Name Competitor Qualifier Competitor Virtual
Player Info Data Points:	Id	Name	Starter
Sport Event Info Data Points:	Attendance Count Channel Country Channel Name Channel URL Coverage Type Ground Neutral Group Properties Brackets Group Properties Cup Group Properties League Group Properties Missing Players Group Properties Qualification Group Properties Results Group Properties Schedules Group Properties Standings Referee Id	Referee Name Referee Nationality Referee Country Code Referee Type Sport Event Id Sport Event Replaced By Sport Event Resume Time Sport Event Start Time Sport Event Start Time Confirmed Sport Event Properties Ballspotting Sport Event Properties Basic Play-by-Play Sport Event Properties Basic Player Stats Sport Event Properties Basic Team Stats Sport Event Properties Commentary	Sport Event Properties Deeper Player Stats Sport Event Properties Deeper Team Stats Sport Event Properties Extended Play-by-Play Sport Event Properties Extended Player Stats Sport Event Properties Extended Team Stats Sport Event Properties Fun Facts Sport Event Properties Game Clock Sport Event Properties Goal Scorers Sport Event Properties Lineups Sport Event Properties Lineups Availability Sport Event Properties Probabilities Sport Event Properties Scores Weather Overall Conditions Weather Pitch Conditions
Boxscore Info Data Points:	Clock Played Clock Stoppage Time Announced Clock Stoppage Time Played Period Score Away Score Period Score Home Score Period Score Number	Period Score Type Sport Event Status Away Normaltime Score Sport Event Status Away Score Sport Event Status Decided by Fed Sport Event Status Home Normaltime Score	Sport Event Status Home Score Sport Event Status Match Status Sport Event Status Scout Abandoned Sport Event Status Status Sport Event Status Winner Id
Play by Play Info Data Points:	Order	X Coordinate	Y Coordinate
Player Match Statistics Data Points:	Assists Corner Kicks Goals Scored Offsides Own Goals	Penalties Missed Red Cards Shots Blocked Shots Off Target Shots On Target	Substituted In Substituted Out Yellow Cards Yellow/Red Cards
Team Match Statistics Data Points:	Ball Possession Cards Given Corner Kicks Fouls Free Kicks Goal Kicks	Injuries Offsides Penalties Missed Red Cards Shots Blocked Shots Off Target	Shots On Target Shots Saved Shots Total Throw Ins Yellow Cards Yellow/Red Cards
Venue Info Data Points:	Capacity City Country	Country Code Id	Map Coordinates Name

```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/soccer/trial/v4/en/sport_events/sr:sport_event:18427304/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", "/soccer/trial/v4/en/sport_events/sr:sport_event:18427304/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/soccer/trial/v4/en/sport_events/sr:sport_event:18427304/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.us/soccer/`{access_level}`/`{version}`/`{language_code}`/sport_events/`{sport_event_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: v4). | | `language_code` | Supported Locales | | `sport_event_id` | Id of a given sport event. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the OpenAPI Schema Definition for the Sport Event Summary feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/sport_events/getSportEventSummary Return to API map ## Sport Event Timeline

Update Frequency:	As Necessary
Content Type:	XML or JSON
Sport & Category Info Data Points:	Category Country Code Category Id	Category Name Sport Id	Sport Name
Competition Info Data Points:	Competition Id Competition Name Competition Parent Id Competition Properties Brackets Competition Properties Missing Players Competition Properties Player Transfer History Competition Properties Schedules Competition Properties Season Player Statistics Competition Properties Season Probabilities Competition Properties Season Stats Leaders	Competition Properties Season Team Statistics Competition Properties Standings Competition Properties Team Squads Group Group Name Group Id Group Name Round Cup Round Number of Sport Events Round Cup Round Sport Event Number Round Name Round Number Round Other Sport Event Id Season End Date Season Id	Season Name Season Start Date Season Competition Id Season Year Stage End Date Stage Order Stage Phase Stage Start Date Stage Type Stage Year
Competitor Info Data Points:	Competitor Abbreviation Competitor Age Group Competitor Country	Competitor Country Code Competitor Gender Competitor Id	Competitor Name Competitor Qualifier Competitor Virtual
Player Info Data Points:	Id	Name	Starter
Sport Event Info Data Points:	Attendance Count Channel Country Channel Name Channel URL Coverage Type Ground Neutral Group Properties Brackets Group Properties Cup Group Properties League Group Properties Missing Players Group Properties Qualification Group Properties Results Group Properties Schedules Group Properties Standings Referee Id	Referee Name Referee Nationality Referee Country Code Referee Type Sport Event Id Sport Event Replaced By Sport Event Resume Time Sport Event Start Time Sport Event Start Time Confirmed Sport Event Properties Ballspotting Sport Event Properties Basic Play-by-Play Sport Event Properties Basic Player Stats Sport Event Properties Basic Team Stats Sport Event Properties Commentary	Sport Event Properties Deeper Player Stats Sport Event Properties Deeper Team Stats Sport Event Properties Extended Play-by-Play Sport Event Properties Extended Player Stats Sport Event Properties Extended Team Stats Sport Event Properties Fun Facts Sport Event Properties Game Clock Sport Event Properties Goal Scorers Sport Event Properties Lineups Sport Event Properties Lineups Availability Sport Event Properties Probabilities Sport Event Properties Scores Weather Overall Conditions Weather Pitch Conditions
Boxscore Info Data Points:	Clock Played Clock Stoppage Time Announced Clock Stoppage Time Played Period Score Away Score Period Score Home Score Period Score Number	Period Score Type Sport Event Status Away Normaltime Score Sport Event Status Away Score Sport Event Status Decided by Fed Sport Event Status Home Normaltime Score	Sport Event Status Home Score Sport Event Status Match Status Sport Event Status Scout Abandoned Sport Event Status Status Sport Event Status Winner Id
Play by Play Info Data Points:	Away Team Score Ball Location Order Ball Location X Coordinate Ball Location Y Coordinate Event Break Name Event Card Description Event Commentary Event Competitor Event Coordinate X	Event Coordinate Y Event Id Event Injury Time Announced Event Match Clock Event Match Time Event Method Event Outcome Event Period	Event Period Name Event Period Type Event Shootout Away Score Event Shootout Home Score Event Stoppage Time Event Type Event Time Home Team Score
Play Details Data Points:	Assisting Player Id Assisting Player Method Assisting Player Name Assisting Player Type Goal Scorer Id Goal Scorer Method	Goal Scorer Name Goal Scorer Type Substitution Player In Id Substitution Player In Method Substitution Player In Name	Substitution Player In Type Substitution Player Out Id Substitution Player Out Method Substitution Player Out Name Substitution Player Out Type
Player Match Statistics Data Points:	Assists Corner Kicks Goals Scored Offsides Own Goals	Penalties Missed Red Cards Shots Blocked Shots Off Target Shots On Target	Substituted In Substituted Out Yellow Cards Yellow/Red Cards
Team Match Statistics Data Points:	Ball Possession Cards Given Corner Kicks Fouls Free Kicks Goal Kicks	Injuries Offsides Penalties Missed Red Cards Shots Blocked Shots Off Target	Shots On Target Shots Saved Shots Total Throw Ins Yellow Cards Yellow/Red Cards
Venue Info Data Points:	Capacity City Country	Country Code Id	Map Coordinates Name

```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/soccer/trial/v4/en/sport_events/sr:sport_event:18427304/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", "/soccer/trial/v4/en/sport_events/sr:sport_event:18427304/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/soccer/trial/v4/en/sport_events/sr:sport_event:18427304/timeline.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Sport Event Timeline. https://api.sportradar.us/soccer/`{access_level}`/`{version}`/`{language_code}`/sport_events/`{sport_event_id}`/timeline.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). | | `version` | Version number of the API you are accessing (Current Version: v4). | | `language_code` | Supported Locales | | `sport_event_id` | Id of a given sport event. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the OpenAPI Schema Definition for the Sport Event Timeline feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/sport_events/getSportEventTimeline Return to API map ## Sport Events Removed

Update Frequency:	As Necessary
Content Type:	XML or JSON
Sport Event Info Data Points:	Sport Event Removed Id	Sport Event Removed Replaced By

```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/soccer/trial/v4/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", "/soccer/trial/v4/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.com/soccer/trial/v4/en/sport_events/removed.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Sport Events Removed. https://api.sportradar.us/soccer/`{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: v4). | | `language_code` | Supported Locales | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the OpenAPI Schema Definition for the Sport Events Removed feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/sport_events/getSportEventsRemoved Return to API map ## Sport Events Updated

Update Frequency:	As Necessary
Content Type:	XML or JSON
Sport Event Info Data Points:	Sport Event Updated Id	Sport Event Updated - Updated At

```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/soccer/trial/v4/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", "/soccer/trial/v4/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.com/soccer/trial/v4/en/sport_events/updated.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Sport Events Updated. https://api.sportradar.us/soccer/`{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: v4). | | `language_code` | Supported Locales | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the OpenAPI Schema Definition for the Sport Events Updated feed, use the following URL. https://api.sportradar.com/soccer/trial/v4/openapi/swagger/index.html#/sport_events/getSportEventsUpdated Return to API map ## Frequently Asked Questions Q: What leagues or tournaments do you cover for soccer? A: We cover numerous leagues and tournaments. Here is a table with the groups and leagues currently covered:

Region	Category	Tournament
Asia	Australia	A-League
	China	Chinese Super League
	India	I-League
	India	Indian Super League
	International Clubs	AFC Champions League
	International Clubs	AFC Cup
	Japan	J. League
	Qatar	Stars League
	South Korea	K-League Classic
	United Arab Emirates	Arabian Gulf League
Americas	Argentina	Primera Division
	Brazil	Brasileiro Serie A
	Chile	Primera Division
	Colombia	Primera A
	International Clubs	CONCACAF Champions League
		Copa Liberatores
		Copa Sudamerica
		Recopa Sudamericana
	Mexico	Primera Division Apatura
	Mexico	Primera Division Clausura
	Uruguay	Primera Division
	United States	Major League Soccer *
Europe	Belgium	First Division A
	England	Premier League
	France	Ligue 1
	Germany	Bundesliga
	Greece	Super League
	International Clubs	UEFA Champions League
		UEFA Europa League
		UEFA Super Cup
		UEFA Nations League
	International Youth	UEFA Youth League
	Italy	Serie A
	Netherlands	Eredivisie
	Portugal	Primeira Liga
	Russia	Premiere League
	Spain	LaLiga
	Turkey	Super Lig
	Ukraine	Premier League
International	International	40 Leagues & Tournaments
International	International Youth	43 Leagues & Tournaments
All Other	Various Countries	800+ Leagues & Tournaments

Q: Are simulations available for Soccer v4?

A: Simulations for Soccer v4 are not currently available.

Q: How are friendlies handled in the Summary feeds?

A: The Summary feeds will return all Friendlies that have been played the last two weeks and that will be played the next 4 weeks.

Q: What is the Date format?

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 time zone 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: When is coverage information added to the feeds?

A: On the first day of the season.

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
delayed – The match has been temporarily delayed and will be continued
start_delayed – The start of the match has been temporarily delayed
interrupted - The match began, but coverage has stopped for a short time. Note that match scores may not be updated during this period, the last recorded match score will be displayed instead
cancelled – The match has been cancelled and will not be played
ended – The match is over
closed – The match results have been confirmed
abandoned – The match has been abandoned

Q: What are the valid sport_event_status – match_status values?

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

not_started – The match is scheduled to be played
live – The match is currently in progress
1^st_half – The match is in the first half
2^nd_half – The match is in the second half
overtime – The match is in overtime
1^st_extra – The match is in the first extra period
2^nd_extra – The match is in the second extra period
awaiting_penalties – Waiting for announcement of penalties
penalties – Penalties are ongoing
pause – The match is paused
awaiting_extra_time – Waiting on referee to announce extra time
interrupted – The match has been interrupted
abandoned – The match has been abandoned
postponed – The match has been postponed to a future date
delayed – The match has been temporarily delayed and will be continued
cancelled – The match has been cancelled and will not be played
ended – The match is over
closed – The match results have been confirmed
halftime – The match is in halftime
full-time – The match has ended
extra_time – Extra time has been added
ended – The match has ended
aet – The match has ended after extra time
ap – The match has ended after penalties

Q: What are the valid period type values?

A: Here are the valid period type values:

regular_period
overtime
penalties

Q: What are the valid period name values?

A: Here are the valid period name values:

1st half
2nd half
1st extra
2nd extra
awaiting extra
extra time halftime
pause
awaiting penalties
penalties

Q: What are the valid lineup types (player position) values?

A: Here are the valid lineup type

goalkeeper
defender
midfielder
forward

Q: What are the valid lineups descriptions (player tactical position) values?

A: Here are the valid lineups descriptions:

goalkeeper
right back
central defender
left back
right winger
central midfielder
left winger
striker

Q: What are the valid current outcome values?

A: Here are the valid current outcome types

AFC Champions League
AFC Cup
CAF Confederation Cup
Champions League
Champions League Qualification
Champions Round
Championship Round
Club Championship
Copa Libertadores
Copa Libertadores Qualification
Copa Sudamericana
Cup Winners
Eliminated
Europa League
Europa League Qualification
European Cup
Final Four
Final Round
Finals
Group Matches
International Competition
Main Round
Next Group Phase
Placement Matches
Playoffs
Preliminary Round
Promotion
Promotion Playoff
Promotion Playoffs
Promotion Round
Qualification Playoffs
Qualified
Qualifying Round
Relegation
Relegation Playoff
Relegation Playoffs
Relegation Round
Semifinal
Top Six
UEFA Cup
UEFA Cup Qualification
UEFA Intertoto Cup

Q: How do I find out the coverage for a particular match?

A: Within the Summaries, Lineups, and Timeline feeds, find the node for “coverage”. Coverage nodes have three types: season level, group level, and sport_event level.

The season level describes data coverage you can expect for matches involved in that given season.
The group level is similar because there exists competitions where coverage levels differ at different stages or in different groups - mostly cup competitions.
The sport_event level, this exists to describe the data depth of a specific match within the group and season.

Note: There are occasions when the sport_event coverage can vary from the anticipated season coverage and this node exists to highlight that in that event to assist in handling any discrepancies.

Q: How is coverage for a particular match defined?

A: The coverage nodes contain classifications of data types which are expressed as Boolean values or denoted as “live” or “post”, for example: ballspotting="true" commentary="true" extended_play_by_play="true" extended_player_stats="true" extended_team_stats="true" fun_facts="true" goal_scorers="true" scores="live" basic_play_by_play="true" basic_player_stats="true" basic_team_stats="true" lineups="true" deeper_player_stats="true" deeper_team_stats="true".

Q: What are the possible pitch values?

A: Here are the possible pitch values:

good
medium
bad

Q: What are the possible weather conditions?

A: Here are the possible weather conditions:

indoor
good
medium
bad
extreme

Q: What are the possible event types?

A: Here are all of the possible event types we log:

break_start
corner_kick
free_kick
goal_kick
injury
injury_return
injury_time_shown
match_ended
match_started
offside
penalty_awarded
penalty_missed
penalty_shootout
period_score
period_start
red_card
score_change
shot_off_target
shot_on_target
shot_saved
substitution
throw_in
video_assistant_referee
video_assistant_referee_over
yellow_card
yellow_red_card

* Availability of Video Assistant Referee is subject to the VAR coverage of the league.

Q: How does the possible_goal event type work?

A: This event will occur immediately if one team scores a goal or if they are in a very clear scoring opportunity (1on1 with the goalkeeper, clear shot at an empty net, etc).

Q: What are the possible values for video assistant referee?

A: Here are the valid values:

goal
penalty
red_card
no_red_card
no_penalty
no_goal

Q: What are the possible values for video assistant referee over?

A: Here are the valid values:

call_stands
call_overturned

Q: What is the scale of the X Y coordinates?

A: The pitch we use is 100 by 100. Here is a layout of the pitch:

0,0	X	100,0





Y	50,50





0,100		100,100

X = Horizontal position on the pitch. X is a number between 0 and 100. The reference point 0 is at the home team’s goal.

Y = Vertical position on the pitch. Y is a number between 0 and 100. The reference point 0 is on the top of the pitch where the home team’s goal is on the left hand side.

Q: What are the possible values for referee_assistant type?

A: Here are the valid referee assistant types:

first_assistant_referee
second_assistant_referee
fourth_official
video_assistant_referee
first_additional_assistant
second_additional_assistant
third_additional_assistant

Q: How does the ball location attribute work?

A: Our scouts mark down the x (lateral) and y (longitudinal) coordinates as observed on the pitch. The data can come in sporadically as events on the field play out, but new ball_location data is potentially available every 1 sec. This is only available for matches carrying GOLD coverage and above. The element "ball_locations" stores the last four known ball locations, after which the data is not available unless it corresponds with another event in the timeline such as "throw_in", "shot_on_goal" etc. The ball_location order illustrates the most recent location as 4 and the oldest location as 1.

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: What are the possible outcomes?

A: Different markets have different outcomes. The available markets are currently:

home_team_winner
away_team_winner
draw

Q: Why don’t I see commentary in the timeline when the coverage has the “commentary” sport_event_property as “true”?

A: Commentary is only available in the feed for a fixed amount of time (14 days typically). The attribute, which denotes that commentary is or was available, remains even after the commentary is removed.

Q: When are fun facts added to the Sport Event Fun Facts feed?

A: Fun facts appear in the feed starting 7 days before a match and are available for a fixed amount of time (14 days typically).

Q: How is the order value in the Lineups feed organized?

A: Order number 1 is always the goalie (star marking) and formations as well as numbering should start with the goalkeeper. In the example diagram the formation 4-2-3-1 is used.

4 is the number of players in the line in front of the goalkeeper, then comes the line with 2 players and so on. Numbering in every line starts at the right-hand side of the goalkeeper – this causes the numbering to be mirrored for home and away team.

Q: What are the possible reasons for a player to appear in the Missing Players feed?

A: Listed below are the reasons why a player may appear in the missing players feed:

injured
ill
other
suspension
on_loan

Q: What are the possible values for stage – phase in the feeds?

A: Listed below are the values for phase:

1st_part_of_season_1st_leg
2nd_part_of_season_2nd_leg
3rd_round
champions_round
conference
division
final_eight
final_four
final_phase
final_round
final_stage
grand_final
grand_finals
group_phase_1
group_phase_2
knockout_stage
main_round_1
main_round_2
none
placement_matches
placement_matches_13_to_16
placement_matches_5_to_8
placement_matches_9_to_12
placement_matches_9_to_16
playoffs
playout
pre-season
preliminary_round
president_cup
promotion_playoffs
promotion_round
qualification
qualification_playoffs
qualification_to_allsvenskan
regular_season
relegation_playoffs
relegation_promotion
relegation_promotion_round
relegation_round
stage_1
stage_1 no_stats
stage_2
stage_2 no_stats
stage_3
uefa_europa_league_playoffs

Q: How long is full match data available for matches in the API?

A: Match data is archived after one year and you will only be able to service basic score information from the API feeds. A historical statistics API for Soccer is on the roadmap, but no ETA is available at this time.

Q: What are the possible values for role - type in the feeds?

A: Listed below are some of the values for role type. Note that new values may be added as required.

player
manager
team_captain
on_loan
in_jail
referee
other

Q: What are the possible values for event – time_description in the feeds?

A: Listed below are some of the values for time descriptions on yellow/red cards.

pre_match
half_time
post_match

Q: What are the possible values for list – type in the leaders feeds?

A: Listed below are the values for list - type. Note: Not all values may be available for each season, based on the coverage available for that season.

goals
assists
red_cards
yellow_cards
yellow_red_cards
own_goals
shots_on_target
shots_off_target
goals_by_head
goals_by_penalty
clearances
interceptions
chances_created
crosses_successful
passes_successful
long_passes_successful
tackles_successful
clean_sheets
penalties_saved
dribbles_completed
loss_of_possession
minutes_played

Q: What are the possible values for event – card_description in the timeline feeds?

A: Listed below are the values for event – card_description.

pre_match
half_time
post_match
player_on_bench
first_half
second_half
during_penalty_shootout

Q: Why does the coverage of past seasons not match the data in the feeds?

A: Coverage properties are set at a competition level and only reflect the current or last season of that competition. Previous seasons may have greater or lesser coverage.

Q: When does the Lineups Availability update in the feeds?

A: The lineups_availability data is updated 30 days before the sport event is scheduled to begin.

Q: What are the possible values for sport_event_properties – lineups_availability in the summary and timeline feeds?

A: Listed below are the values for sport_event_properties – lineups_availability:

pre
post

Q: How do you define Team Statistics and Player Statistics as sport_event_properties in terms of coverage?

A: We define those properties as:

Team Statistics:

basic_team_stats: yellow_cards, yellow_red_cards, red_cards, and corner_kicks.

deeper_team_stats: shots_total, shots_on_target, shots_off_target, shots_blocked, ball_possession, free_kicks, offsides, goal_kicks, throw_ins, shots_saved, fouls, and injuries.

Player Statistics:

basic_player_stats: goals_scored, yellow_cards, yellow_red_cards, red_cards, own_goals, assists, substituted_in, and substituted_out.

deeper_player_stats: offsides, corner_kicks, shots_on_target, shots_off_target, and shots_blocked.

Q: How are replay cup matches handled in the feeds?

A: Within the Summary, Timeline, or Lineups feeds you can locate the round data for a given match. In that round data you can find the number of matches in the cup round (cup_round_number_of_sport_events) and the number of the given match in the cup round (cup_round_sport_event_number). The values for cup_round_sport_event_number are detailed below:

1 = Replay
2 = 1st Replay
3 = 2nd Replay

Q: How do you define the key data points?

Data Points	Type of Data Point	Definition
Goal	regular	A goal is assigned to a player of the attacking team if his shot taken by foot, head or any other part of the body leads to a score. All attempts are counted. Uncontrolled deflections resulting in a goal will be attributed to the player who kicked the ball, not the player who deflects the ball.
	own goal	When a defender kicks or heads the ball into the defender’s goal with the intent of making a pass to a teammate or of clearing the ball and it is obvious that no other player of the attacking team tried a shot on target, a goal is recorded as an "own goal". An "own goal" counts towards the offensive team's season statistics. No assist shall be given to the attacking team. If an attacking player shots on goal and the defender deflects the ball into the net, in a controlled action it will be deemed an own goal. If two players of the defending team touched the ball, the player who last touched it is the own goal scorer.
Assist	in general	An assist considered to be a contribution by a player which directly helps a teammate to score a goal. In order to be considered for an assist a player needs to have given the last successful pass. However, the last successful pass does not necessarily automatically constitute an assist.
	counted	Includes corners and throw ins A cross by a team member is converted into a goal Passes/crosses, which are slightly deflected and then lead to a team member score a goal
	not counted	Where goals resulting from penalties are concerned, the player who is fouled in the area receives no assist point shot hits the post/bar and then leads to a goal by a team member The goal scorer made considerable self-effort in order to score
Throw-In		If the ball crosses any of the side lines by its diameter, the game will continue with a throw-in.
Free kicks	team statistics	In accordance with the rules, a free kick stat counted for the team who executes a free kick. Direct or indirect free kicks are all counted as free kicks.
Goal kick	team statistics	Total number of kicks awarded to the team as a result of the ball traveling out of bounds over the goal line of the defending team
Throw ins	team statistics	Total number of thrown in events for a team
Offsides	team statistics	Total number of offside infringements awarded against a team.
Fouls	team statistics	Total number of fouls awarded against a team (including those which draw cards)
Corner Kicks	team statistics	Total number of corner kicks taken by a team.
Shots Saved	team statistics	Total number of goal keeper saves attributed to a team.
Ball Possession	team statistics	Ball possession is the amount of time a team has possession of the ball. It is calculated in percentage, and the total amount of time the match is being played is considered 100%.

Return to top

version 17 as of 2 weeks ago by m.wood

Soccer v4

Examples:

Docs Navigation

Sportradar

Sportradar is Social