Endpoint

This endpoint returns basic information about a tournament (such as the dates of the tournament, the type of tournament, and the competitors in the tournament).

Please note that this endpoint provides details about tournaments with matches played within the past 7 days.

Endpoint Parameters

Parameter	Description	Possible Values
language Required	Language code for translation.	See all supported languages and their codes on language support
urn_type Required	The type of event to look up.	sr:stage, sr:season, sr:tournament, sr:simple_tournament, vf:season, vf:tournament, vbl:season, vbl:tournament, vto:season, vto:tournament, vdr:stage, vhc:stage, vti:tournament, vci:tournament, vbi:tournament
id Required	The ID for the tournament	e.g. 40

Information about a tournament

get

Basic information about a tournament (name, start/end date, list of competitors). XML schema

Authorizations

key

Path parameters

languagestringRequired

Language code for translation.

urn_typestring · enumRequired

The type of tournament you want to look up.

Possible values:

idintegerRequired

The ID for the tournament.

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/{urn_type}:{id}/info.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"?>
<tournament_info xmlns="http://schemas.sportradar.com/sportsapi/v1/unified" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" generated_at="2023-06-22T21:41:31+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:40" name="Allsvenskan">
    <sport id="sr:sport:1" name="Soccer"/>
    <category id="sr:category:9" name="Sweden" country_code="SWE"/>
    <current_season start_date="2023-04-01" end_date="2023-11-26" year="2023" id="sr:season:100875" name="Allsvenskan 2023"/>
  </tournament>
  <season start_date="2023-04-01" end_date="2023-11-26" year="2023" tournament_id="sr:tournament:40" id="sr:season:100875" name="Allsvenskan 2023"/>
  <round type="group" number="18"/>
  <season_coverage_info season_id="sr:season:100875" scheduled="240" played="98" max_coverage_level="gold" max_covered="94" min_coverage_level="silver"/>
  <coverage_info live_coverage="true"/>
  <groups>
    <group>
      <competitor id="sr:competitor:1764" name="AIK" abbreviation="AIK" country="Sweden" country_code="SWE" gender="male">
        <reference_ids>
          <reference_id name="betradar" value="4783"/>
        </reference_ids>
      </competitor>
      <competitor id="sr:competitor:1807" name="Degerfors IF" abbreviation="DEG" short_name="Degerfors" country="Sweden" country_code="SWE" gender="male">
        <reference_ids>
          <reference_id name="betradar" value="924523"/>
        </reference_ids>
      </competitor>
      ...
      <competitor id="sr:competitor:7101" name="Varbergs BoIS" abbreviation="VBG" short_name="Varbergs" country="Sweden" country_code="SWE" gender="male">
        <reference_ids>
          <reference_id name="betradar" value="12900512"/>
        </reference_ids>
      </competitor>
    </group>
  </groups>
</tournament_info>