Schedule for a Tournament Endpoint

About the Endpoint

Endpoint PATH

/sports/{language}/tournaments/{urn_type}:{id}/schedule.xml 

Endpoint Description

This endpoint provides the complete schedule of all scheduled matches within the specified tournament.

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:match, sr:stage, sr:season, sr:tournament, sr:simple_tournament, vf:match, vf:season, vf:tournament, vbl:match, vbl:season, vbl:tournament, vto:match, vto:season, vto:tournament, vdr:stage, vhc:stage, vti:match, vti:tournament, codds:competition_group, vci:match, vci:tournament, vbi:match, vbi:tournament
id Required	The tournament ID for the tournament to get schedule for.	e.g. 8696826

Endpoint Structure

Change hint typeFor a full breakdown of each endpoint and its structure, refer to the Element page​

The schema is as follows:

• <tournament_schedule>

  • <tournament>

    • <sport>

    • <category>

  • sport_events

    • <sport_event>

      • <tournament_round>

      • <season>

      • <tournament>

        • <sport>

        • <category>

      • <competitors>

        • competitor

          • reference_ids

            • reference_id

      • <venue>

XML Example

Request URL

https://api.betradar.com/v1/sports/en/tournaments/sr:tournament:28743/schedule.xml

Response

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <tournament_schedule xmlns="http://schemas.sportradar.com/sportsapi/v1/unified" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" generated_at="2023-06-13T21:50:54+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"/>
    </tournament>
    <sport_events>
      <sport_event status="closed" id="sr:match:37843985" scheduled="2023-04-01T13:00:00+00:00" start_time_tbd="false">
        <tournament_round type="group" number="1" group_long_name="Allsvenskan" betradar_id="24" phase="regular season"/>
        <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"/>
        <tournament id="sr:tournament:40" name="Allsvenskan">
          <sport id="sr:sport:1" name="Soccer"/>
          <category id="sr:category:9" name="Sweden" country_code="SWE"/>
        </tournament>
        <competitors>
          <competitor qualifier="home" id="sr:competitor:1892" name="Malmo FF" abbreviation="MAL" short_name="Malmo" country="Sweden" country_code="SWE" gender="male">
            <reference_ids>
              <reference_id name="betradar" value="22631"/>
            </reference_ids>
          </competitor>
          <competitor qualifier="away" id="sr:competitor:1891" name="Kalmar FF" abbreviation="KAL" short_name="Kalmar" country="Sweden" country_code="SWE" gender="male">
            <reference_ids>
              <reference_id name="betradar" value="93298"/>
            </reference_ids>
          </competitor>
        </competitors>
        <venue id="sr:venue:1211" name="Stadion" capacity="22500" city_name="Malmo" country_name="Sweden" country_code="SWE" map_coordinates="55.583611,12.987778"/>
      </sport_event>
      ....
</tournament_schedule>