XML Configuration

This section contains information about general XML configuration settings with XML examples, XML attributes, and element descriptions. These configurations can be for a single sport, multiple sports or for all sports we offer.

When new features are released for a sport, they will not automatically be included in the feed. Clients need to enable the features on the Live Data XML configuration page before they will start receiving them. This interface can be found online at: portal.betradar.com > Configuration > Live > Live Data > Configuration. To activate a new feature, simply check them on or off in this configuration window.

Currently, the following XML features are available:

Note Not every sport currently has sport specific XML configurations. Information about sport specific XML settings can be found in each individual sport section.

Send matchlist updates (ID 18)

If this setting is enabled, the server sends out matchlistupdate messages over the feed automatically. These updates are sent to connected sessions when access to a match is either lost or gained. Example: Booking a match triggers a matchlistupdate message. Matchlistupdate messages look very similar to normal matchlist messages. The only differences are the name of the root element (<matchlistupdate> instead of <matchlist>) and a new attribute active in the <match> element.

XML example

<matchlistupdate>
<match active="1" booked="0" coveredfrom="venue" extrainfo="0" matchid="956" st1id="14321" st2id="14329" start="1361437625000" t1id="
11403" t1name="AGASSI, ANDRE" t2id="11749" t2name="GAUDIO, GASTON">
<status id="0" name="NOT_STARTED" start="0"/>
<score t1="0" t2="0" type="match"/>
<tournament id="568" name="Paris TMS, France"/>
<category id="3" name="ATP"/>
<sport id="5" name="Tennis"/>
</match>
</matchlistupdate>

XML attributes definition

Element	Attributes
	Attribute	Description	Possible values
match	active	Whether the match is available (for example right after booking) or unavailable (if it was just removed).	Integer 1 = The match is available 0 = The match is unavailable

Include matchstatus in events (ID 111)

Enabling this setting will include the match status attribute in every event. For more information about match statuses see each individual "information per sport section".

Include sportid in events (ID 109)

Enabling this setting will include the "sportid" attribute in the match element. Sport ID information can be found in here:

Information per Sport

Fullfeed matchtime (ID 3)

If this setting is enabled, the full feed will contain a matchtime attribute in the <match> element.

XML example

<match betstatus="BETSTOP" connectionstatus="0" dc="1" extrainfo="0" feedtype="full" matchid="4973358" matchtime="00:08" start="
1407582900000" t1id="33137" t1name="DALLAS COWBOYS" t2id="35256" t2name="WASHINGTON REDSKINS">
<!-- Message truncated -->
</match>

Include super team ID in the XML (ID 13)

If this setting is enabled, all <match> elements which are inside a <matchlist> will get the attributes st1id and st2id. In Live Data feed we send two team/competitor IDs. Example of "Miami Heat" in Live Data Product: Super Team Id is a unique team id that corresponds to "sr:competitor:xxx" across all other SR products. Team Id is a context of tournament "Miami Heat" team Id in NBA has id = 19441.

XML example

<match t1namenatural="Miami Heat" t2namenatural="Cleveland Cavaliers" t2name="CLEVELAND CAVALIERS" t2id="19395" t1name="MIAMI HEAT" t1id="19441" t1abbr="MIA" t2abbr="CLE" start="1733698800000" matchid="52630259" feedtype="full" extrainfo="7" distance="1757" betstatus="BETSTOP" connectionstatus="0" dc="1" device="5" coveredfrom="venue" timerunning="0" wonjumpball="away" st1id="3435" st2id="3432" matchtime="48:00" sportid="2" stime="1733925336637">  

Match list example with the config enabled: XML example

<matchlist>
<match active="1" coveredfrom="tv" dc="1" extrainfo="0" matchid="7236421" st1id="14794" st2id="53183" start="1430218200000" t1id="
345501" t1name="GIMENO-TRAVER, DANIEL" t2id="5800045" t2name="ILKEL, CEM">
<!-- Message truncated -->
</match>
</matchlist>

Send the matchtime periodically (ID 21)

Enabling this setting will periodically send the client the matches they are subscribed to, and add the matchtime attribute for those matches. Matchtime updates will be sent only during the match. TO reduce the numebr of messages the server will not send matchtime updates before the start and after the match has finished.

Use match status ABANDONED (ID 12)

Enabling this setting will allow the system to send match status ABANDONED.

XML example

<match t1namenatural="Barretos SP" t2namenatural="EC Noroeste SP" t2name="EC NOROESTE SP" t2id="9400194" t1name="BARRETOS SP" t1id="9400163" t1abbr="BAR" t2abbr="NOR" start="1645052400000" matchid="30892375" feedtype="full" extrainfo="0" distance="203" betstatus="BETSTOP" connectionstatus="0" device="-1" coveredfrom="venue" var="0" st1id="189840" st2id="6962" matchtime="00:00" sportid="1" stime="1645092056575">
<status name="ABANDONED" id="90"/>
<score type="current" t2="0" t1="0"/>
<red t2="0" t1="0"/>
<yellow t2="0" t1="0"/>
<corners t2="0" t1="0"/>
<dangerousattacks t2="0" t1="0"/>
<attacks t2="0" t1="0"/>
<penalties t2="0" t1="0"/>
<weatherconditions name="UNKNOWN" id="0"/>
<pitchconditions name="UNKNOWN" id="0"/>
<kickoffteam team="0"/>
<events/>
<tournament name="Paulista, Serie A3" id="56349"/>
<category name="Brazil" id="13"/>
<sport name="Soccer" id="1"/>
</match>

Include device ID for matches in matchlist (ID 38)

Enabling this setting will add the ID of the device used for scouting to the <match> element in the matchlist. The device will also be added to the <match> element when the client subscribes to a match.

XML example

<matchlist>
<match t2name="CHELSEA FC" t2id="4870" t1name="ARSENAL FC" t1id="4871" start="1443175200000" matchid="10029090" extrainfo="0"
distance="10" coveredfrom="venue" st1id="42" st2id="38" device="4">
<status start="0" name="NOT_STARTED" id="0"/>
<score type="current" t2="0" t1="0"/>
<tournament name="Premier League" id="1"/>
<category name="England" id="1"/>
<sport name="Soccer" id="1"/>
</match>
</matchlist>

Possible values for the device attribute

ID	Device
-1	No scout allocated yet
1	Hardphone/Asterisk
3	XSA (ScouTVAdmin/Scout platform)
4	Scout mobile app - iScout/ITF Scorer/UTR Scorer
5	External data feed
6	hScout

Add team abbreviations to the matchlist response and full feed (ID 94)

Enabling this setting will add the t1abbr and t2abbr to the <match>-element for all sports. These attributes get added to the full feed and to matchlist responses.

XML example

<match betstatus="BETSTOP" feedtype="full" matchid="10115513" matchtime="45:00 +1:32" start="1464864780000" t1id="5093" t1name="
WERDER BREMEN" t1abbr="BRE" t2id="5090" t2name="FC SCHALKE 04" t2abbr="FCS">
...
</match>

XML elements and attributes definition

Element	Attributes
	Attribute	Description	Possible values
Match	t1abbr	3 letter abbreviation of home team name.	String
t2abbr	3 letter abbreviation of away team name.	String

Please note that American Football matches always contain the t1abbr and t2abbr attributes, regardless of whether this setting is enabled or not.

Enable coverage status in matchlist (ID 97)

Enabling this setting will add the ID of the coverage status to the <match> element in the matchlist.

XML example

<matchlist>
<match coveragestatusid="0" coveredfrom="venue" dc="1" extrainfo="0" matchid="1103194689" start="1490013260000" t1id="1296685"
t1name="BERMUDA" t2id="1334221" t2name="NETHERLANDS">
<status id="0" name="NOT_STARTED" start="0"/>
<score t1="0" t2="0" type="match"/>
<tournament id="177" name="NBA"/>
<category id="83" name="Rugby League"/>
<sport id="3" name="Baseball"/>
</match>
</matchlist>

Possible values for coverage status

ID	Coverage status
0	Covered
1	Coverage abandoned
2	Not covered

Include matchid in bookmatch replay (ID 24)

If this setting is enabled, the attribute matchid gets added to the <bookmatch> element.

XML example

<bookmatch matchid="944423" result="valid" message="OK"/>

Send jersey color information (ID 105)

Enabling this setting will add will add <jerseys> element to the <match> element in the full feed containing jersey color information.

XML example

<match... >
...
<jerseys>
<jersey base="FFFFFF" number="000000" outline="000000" side="1" jersey_type="1" horizontal_stripes="FFFFFF" vertical_stripes="
FFFFFF" split="FFFFFF" squares="FFFFFF" shirt_type="1" sleeve="FFFFFF"/>
<jersey base="990000" number="FFFFFF" outline="990000" side="1" jersey_type="4" horizontal_stripes="FFFFFF" vertical_stripes="
FFFFFF" split="FFFFFF" squares="FFFFFF" shirt_type="1" sleeve="FFFFFF"/>
<jersey base="FFFFFF" number="000000" outline="000000" side="2" jersey_type="2" horizontal_stripes="FFFFFF" vertical_stripes="
FFFFFF" split="FFFFFF" squares="FFFFFF" shirt_type="1" sleeve="FFFFFF"/>
<jersey base="990000" number="FFFFFF" outline="990000" side="2" jersey_type="4" horizontal_stripes="FFFFFF" vertical_stripes="
FFFFFF" split="FFFFFF" squares="FFFFFF" shirt_type="1" sleeve="FFFFFF"/>
</jerseys>
</match>

The different values for the jersey_type attribute are: 1. HOME, "Home kit" 2. AWAY, "Away kit" 3. ALTERNATE, "Alternate kit" 4. GOALKEEPER, "Goal keeper kit"

Include naturally capitalized team names (ID 108)

Enabling this setting will add naturally capitalized team names for home and away teams to the <match> element in the full feed with attributes t1namenatural and t2namenatural, respectively.

XML example

<match betstatus="BETSTOP" connectionstatus="0" coveredfrom="tv" dc="1" device="3" distance="0" extrainfo="0" feedtype="full" firstserve="
home" matchid="12893097" matchtime="1:53:07" numberofsets="1" st1id="46125" st2id="26272" start="1511851140000" t1id="6586501
" t1name="CHISNALL, DAVE" t2id="1032178" t2name="ANDERSON, GARY" t1namenatural="Chisnall, Dave" t2namenatural="Anderson,
Gary">
...
</match>

Include UUID attribute to all events (ID 140)

Enabling this setting in the configuration will include a Universally Unique Identifier (UUID) to all <event.../> messages in the feed.

XML example

<event type="1024" stime="1563441172124" side="none" mtime="00:00" 
info="Match about to start" id="948531510" uuid="2a7e0432-a6e7-45ad-ac4f-l4lfl8ffbba0" matcshore="0:0" 
matchstatus="NOT_STARTED"/>

Include UUID of deleted events (ID 141)

Enabling this setting in the configuration will include a reference to the Universally Unique Identifier (UUID) of the deleted event to all <event.../> messages in the feed that are of eventtype 1044 (DELETE_EVENT_ALERT). The reference is in the attribute "refuuid".

XML example

<event type="1044" stime="1590590593442" side="away" mtime="00:37:36" info="Event deleted : Tennis point (originally entered at 14:42:51
UTC)"id="2564731569" refuuid="5b7ef738-b7ae-4731-88c4-5da02dbb6a96" uuid="8ef9dbbc-20e4-4426-8e79-ab68a5dd7411" extrainfo="2564731021" 
gamenumber="6" setnumber="1" gamescore="15:40" setscore="4:1" matchscore="0:0" matchstatus="FIRST_SET"/>

Include an attribute called teamsreversed to the matchlist message and fullfeed message (ID 170)

There can be a situation when the home/away team association cannot be confirmed in time or it is changed at the last minute. New attribute added to matchlist and fullfeed called 'teamsreversed' will be added with possible values: 1 - Order not confirmed 2 - Order reversed in the official sources If teams order (home/away) is officially confirmed there will be no change in the feed. In Live Data Client app - teams will be displayed in the correct order.

<matchlist>
<match booked="1" distance="10" matchid="798175" start="1244822400000" t1id="560764" t1name="BRØNDBY IF II" t2id="560743" t2name="KØBENHAVNS BK" teamsreversed="1"><status id="0" name="NOT_STARTED" start="0"/><score t1="0" t2="0" type="current"/><tournament id="3422" name="2nd Division East"/><category id="8" name="Denmark"/><sport id="1" name="Soccer"/>
</match> 
</matchlist>

XML Full feed changed into partial/paginated feed (ID 176)

This config enables new type of feed update - "partial". When the message of the full feed is big the server will chop the message into smaller chunks. Feed will be split into pages. See atributes page, totalpages and feedtype=partial.

<match matchid='123822270'/>
<match t1namenatural="Arsenal FC" t2namenatural="Crystal Palace" t2name="CRYSTAL PALACE" t2id="342002" t1name="ARSENAL FC" t1id="4871" t1abbr="ARS" t2abbr="CRY" start="1717581780000" matchid="123822270" feedtype="full_paginated" extrainfo="0" distance="18" betstatus="BETSTOP" connectionstatus="1" dc="1" device="3" coveredfrom="venue" var="0" st1id="42" st2id="7" matchtime="90:00" sportid="1" stime="1717582172601" uuid="2574368d-2e50-4a97-a684-a67f1869a713" page="0" totalpages="3">
<status start="1717582165836" name="ENDED" id="100"/>
<score type="current" t1="0" t2="0"/>
<score type="period1" t1="0" t2="0"/>
<score type="period2" t1="0" t2="0"/>
<red t2="0" t1="0"/>
<yellow t2="0" t1="0"/>
<corners t2="0" t1="0"/>
<dangerousattacks t2="0" t1="0"/>
<attacks t2="7" t1="0"/>
<penalties t2="0" t1="0"/>
<weatherconditions name="UNKNOWN" id="0"/>
<pitchconditions name="UNKNOWN" id="0"/>
<kickoffteam team="1"/>
<throwins t2="0" t1="0"/>
<goalkicks t2="0" t1="0"/>
<freekicks t2="0" t1="0"/>
<shotsofftarget t2="0" t1="0"/>
<shotsontarget t2="0" t1="0"/>
<shotsblocked t2="0" t1="0"/>
<goalkeepersaves t2="0" t1="0"/>
<offsides t2="0" t1="0"/>
<injuries t2="0" t1="0"/>
<possession t2="55" t1="45"/>
<tournament name="Premier League" id="1"/>
<category name="England" id="1"/>
<sport name="Soccer" id="1"/>
<jerseys>
<jersey side="1" jersey_type="0" base="CC0000" outline="FFFFFF" number="FFFFFF" sleeve="FFFFFF"/>
<jersey side="1" jersey_type="3" base="6666FF" outline="6666FF" number="666648"/>
<jersey side="2" jersey_type="0" base="0033FF" outline="B90D2B" number="FFFFFF" sleeve="B90D2B"/>
<jersey side="2" jersey_type="3" base="FF3300" outline="FF3300" number="FFFFFF"/>
</jerseys>
<events>
<event type="1010" stime="1717582008831" side="none" mtime="00:00" info="Betstart" id="2203344002" uuid="5fb662d7-3ec2-4777-be2d-ef78d07450bd" matchscore="0:0" matchstatus="NOT_STARTED"/>
<event type="1024" stime="1717582010831" side="none" mtime="00:00" info="Match about to start" id="2203344003" uuid="8c697045-5c00-4750-82dd-961e44785551" matchscore="0:0" matchstatus="NOT_STARTED"/>
<event type="1012" stime="1717582011831" side="home" mtime="00:00" info="Kick off [T1]" id="2203344004" uuid="bd5b9d3c-e225-472b-9d42-5f5364d95ace" matchscore="0:0" matchstatus="NOT_STARTED"/>
<event type="1013" stime="1717582011831" side="none" mtime="00:00" info="FIRST_HALF" id="2203344005" uuid="7f536135-050b-482b-812a-07310780923e" extrainfo="6" matchscore="0:0" matchstatus="FIRST_HALF"/>
<event type="110" stime="1717582011831" side="home" mtime="00:00" info="[T1] have possession" id="2203344006" uuid="cc4cc5ee-5c35-41b5-bcda-802d6cdcbe5a" matchscore="0:0" matchstatus="FIRST_HALF"/>
<event type="1030" stime="1717582011831" side="home" mtime="00:00" info="Ball safe [T1]" id="2203344007" uuid="6cd81ab0-9a22-42ad-922b-ea6f771e5a57" posx="50" posy="50" matchscore="0:0" ballspotting="true" matchstatus="FIRST_HALF"/>
<event type="110" stime="1717582013831" side="away" mtime="00:02" info="[T2] have possession" id="2203344008" uuid="5a11401f-cecf-4fa4-bc4d-1497f33955c9" matchscore="0:0" matchstatus="FIRST_HALF"/></events></match>