Endpoint

This endpoint returns a list of all available tournaments for all the sports provided by SR.

*Special note on the tournament(s).xml endpoint

You can still receive information about a match that is associated with a tournament, even if it is not on the returned list from the endpoints. This could, for example, happen with lower-division soccer league matches where Sportradar does not provide full league coverage, but may do so only upon request from one or more bookmakers. Such tournaments are typically not listed, and Sportradar does not provide a tournament schedule for these tournaments.

Therefore, it is essential not to assume that these endpoints will return for every single tournament of interest, but rather for all available tournaments where Sportradar provides coverage, and/or customers purchase coverage for a particular match.

All available tournaments for all sports

get

Lists all available tournaments. XML schema

Authorizations

key

Path parameters

languagestringRequired

Language code for translation.

Responses

200

successful operation

application/xml

401

Unauthorized

application/json

403

Access denied

application/json

500

Internal server error

application/json

get

HTTPcURLJavaScriptPython

GET /v1/sports/{language}/tournaments.xml HTTP/1.1
Host: global.api.betradar.com
x-access-token: YOUR_API_KEY
Accept: */*

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<tournaments xmlns="http://schemas.sportradar.com/sportsapi/v1/unified" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" generated_at="2023-06-22T12:56:53+00:00" xsi:schemaLocation="http://schemas.sportradar.com/sportsapi/v1/unified http://schemas.sportradar.com/ufsportsapi/v1/endpoints/unified/ufsportsapi.xsd">
  <tournament id="sr:tournament:7" name="UEFA Champions League">
    <sport id="sr:sport:1" name="Soccer"/>
    <category id="sr:category:393" name="International Clubs"/>
    <current_season start_date="2023-06-27" end_date="2024-06-01" year="23/24" id="sr:season:106479" name="UEFA Champions League 23/24"/>
  </tournament>
  <tournament id="sr:tournament:8" name="LaLiga">
    <sport id="sr:sport:1" name="Soccer"/>
    <category id="sr:category:32" name="Spain" country_code="ESP"/>
    <current_season start_date="2023-08-11" end_date="2024-05-26" year="23/24" id="sr:season:106501" name="LaLiga 23/24"/>
  </tournament>
  <tournament id="sr:tournament:9" name="Challenger Pro League">
    <sport id="sr:sport:1" name="Soccer"/>
    <category id="sr:category:33" name="Belgium" country_code="BEL"/>
    <current_season start_date="2022-08-12" end_date="2023-05-15" year="22/23" id="sr:season:94835" name="Challenger Pro League 22/23"/>
    <season_coverage_info season_id="sr:season:94835" scheduled="199" played="197" max_coverage_level="silver" max_covered="197" min_coverage_level="silver"/>
  </tournament>
  ...
  <tournament id="sr:stage:1097065" name="PGA Tour 2024" scheduled="2023-04-11T00:05:00+00:00" scheduled_end="2024-12-31T23:55:00+00:00">
    <sport id="sr:sport:9" name="Golf"/>
    <category id="sr:category:28" name="Men"/>
  </tournament>
  <tournament id="sr:stage:1102729" name="Legends Tour 2023" scheduled="2023-06-05T00:00:00+00:00" scheduled_end="2023-12-31T23:55:00+00:00">
    <sport id="sr:sport:9" name="Golf"/>
    <category id="sr:category:28" name="Men"/>
  </tournament>
  <tournament id="sr:stage:1106021" name="KLPGA 2023" scheduled="2023-06-18T18:34:00+00:00" scheduled_end="2023-12-31T23:55:00+00:00">
    <sport id="sr:sport:9" name="Golf"/>
    <category id="sr:category:28" name="Men"/>
  </tournament>
</tournaments>