Change Log
This page contains the most important changes for our Live Data documentation.
17 Nov 2025
Added a new betstop reason for Ice Hockey - Fighting (ID 114) in Betstop
13 Nov 2025
Added Best Practice Guide
Updated NBA contracts for the season
Removed 1163 Event from Rugby - Wind conditions
10 Sep 2025
Removed "Hardphone BC" Coverage in Tennis
20 Jul 2025
24 Jul 2025
Removed ITF Scorer info and config from - Tennis
Added config info 209 & 213 in Basketball
16 Jul 2025
Updated American Football documentation with updated feed behavior
10 Apr 2025
Updated XSD Schema XML Schema definition (XSD)
10 Mar 2025
Added Basketball MLB External Feed (DC) Player & Team Match statistics data points in Baseball
04 Mar 2025
Added new Suspension (43) type "15 seconds" in Waterpolo
03 Feb 2025
Added information about Kabaddi - Kabaddi
06 Jan 2025
Added Empty Net events (1050,1051,1052,1053) in Waterpolo
18 Dec 2024
Added information about Beach Soccer - Beach Soccer
Added a new config for Handball - ID 212 Include GoalkeeperId in HBL matches
27 Nov 2024
Added UTR Scorer (BC) coverage in the Tennis
16 Sep 2024
Added Config ID 190 for Early betstatus in Tennis for ATP feed in Tennis
Changed the event ID 1120 "Who won Coin Toss" (available only in NFL matches) in American Football
03 Sep 2024
Added new config to Rugby ID 210 Include Try Count
Added information about 4-pointer in Basketball - Event ID 1037
13 Mar 2024
Added changes to American Football (UFL League) - 1 point conversion events , new attribute for Defensive return event (ID: 1737) and new config for UFL format ID:196 in American Football
23 Feb 2024
Added 2388 and 2389 events (Possible End of Period/Not confirmed) in Badminton Beach volleyball Padel Table tennis Volleyball
14 Feb 2024
Added new config ID:193 (Enable kickoff mode events) in American Football
01 Dec 2023
Added new "Ball Mark Inspection" event in Tennis
25 Aug 2023
Added "External feed (ATP)" indicator to coverage column in Tennis
14 Jul 2023
Added new mobile data points and one more Early Betstart case in American Football
Reactivated Play Over event Driveinfostatus value 1 in American Football
12 Jul 2023
03 Jul 2023
13 Jun 2023
Added new XML config ID:170 Include 'teamsreversed' attribute in LD - XML configuration
12 May 2023
Added new betstop reasons for Rugby in Betstart and Betstop
02 May 2023
Added information about matchtime config ID 21 in XML configuration
25 Apr 2023
Added new events and attributes to the event element in Snooker
15 Feb 2023
Added new attributes and extrainfo values to several events to Baseball
01 Feb 2023
Added info about BC coverage in LD - Darts
15 Dec 2022
Added External Feed (DC) to LD - Soccer
Added info about new match list reply attributes (vbpclassification and division) in LD - Match list
Added info about new element for Tennis Doubles in LD - Tennis
Updated event info for LD - Rugby
08 Dec 2022
Added info about uuid and sequencing in LD - Events
23 Nov 2022
Added info about betstop id 1073741822 in LD - Events
11 Oct 2022
Added spot, penaltyreason, freekickreason attributes in LD - Soccer
11 Oct 2022
Added Powerplay, player positions & more mobile data points to LD - Ice hockey
06 Oct 2022
Corrected lineups in LD - Cricket and updated Cricket betstop reasons in LD - Betstart and Betstop
07 Sep 2022
Added Players lining (ID 2219) up and Turnover on downs (ID 2335) to LD - American football
15 Jul 2022
Added Basketball NBA NGSS External Feed (DC) data points to LD - Basketball
14 Jul 2022
Added new betstop reason ID 107 "Possible pitcher substitution to LD - Betstart and Betstop
Added timeout and timeout over event to LD - Baseball
16 Jun 2022
Added new event elam ending with ID 2332 and match element extrainfo 81 to LD - Basketball
28 Mar 2022
Added new USFL 3 point conversion events and ruleset 3 to LD - American football
28 Feb 2022
Added new event Pitch Release and several new attributes to LD - Baseball
Added new sport LD - Padel
31 Jan 2022
Added Basketball NBA NGSS data points: Players Time on Court, Player Match Stats and Team Match Stats: LD - Basketball
06 Jan 2022
Added Ice Hockey match element extrainfo 56 to support IHS (International Short Hockey) and added card events to support international short hockey matches: LD - Ice hockey
21 Oct 2021
Added External Feed (BC) coverage to LD - Soccer
27 Sep 2021
Added new data points 2233, 2234 & 2235 as well as new LD Config ID 154 to LD - Ice hockey
08 Sep 2021
Added documentation for LD - Basketball 3x3 and updated LD - Information per sport and LD - Betstart and Betstop accordingly
19 Jul 2021
Updated LD - American football ahead of 2021/2022 season
20 May 2021
Added substitution event to LD - Counter-strike:GO
01 Mar 2021
Added Baseball betstop reason timeout to LD - Betstart and Betstop
Added additional attributes to Baseball play over event in LD - Baseball
25 Jan 2021
Added documentation for LD - Field hockey
Added matchproperties match element to LD - Table tennis, LD - Squash and LD - Field hockey
16 Dec 2020
Added documentation for LD - eSoccer, LD - eIce Hockey and LD - eBasketBall and related pages: LD - Information per sport & LD - Betstart and Betstop
23 Nov 2020
Added driveinfostatus attribute to play over event in NFL American Football
Added Live Data XML Feed config 152 "Include driveinfostatus in American Football"
10 Aug 2020
Added matchformat "regularinnings" and matchstatus "BREAK_TOPEI_BOTTOM7" to Baseball
24 Jun 2020
Added teams element with nationaity attribute to Squash
Added Baseball error event 2112
10 Jun 2020
Added RefUUID attribute to events of event type 1044
Added Live Data XML Feed config 141 "Include UUID of deleted events"
Added FAQ about usage of UUID
08 Jun 2020
Updated event information in American Football to include the NFL Live Data Service
Added betstop reasons 90-95
12 May 2020
Added Basketball match element extrainfo values 68 and 70 in order to support Basketball Electronic Leagues
Added Soccer match element extrainfo values 61, 62, 63 and 69
Added additional extrainfo values to the Strike and Ball events in Baseball / MLB
21 Apr 2020
Added the missing event 1418 to Ice hockey
09 Apr 2020
Added Ice Hockey match element extrainfo 65 and 67 in order to support Ice Hockey Electronic Leagues
03 Apr 2020
Added Soccer match element extrainfo 66 in order to support another Soccer Electronic Leagues format
01 Apr 2020
Added Basketball match element extrainfo 64 in order to support Basketball Electronic Leagues
27 Mar 2020
Added event 1039 and event 1036 as well as match element extrainfo 55, 57 and 58 to Soccer in order to support Soccer Electronic Leagues formats
Added Ice Hockey match element extrainfo 56 in order to support a shorter format
20 Mar 2020
scout_client_xml.xsd is once again available for download
16 Mar 2020
Information about F1 has been added to the documentation
06 Mar 2020
Updated some additional information about certain match statuses in Ice Hockey
21 Feb 2020
Sport specific documentation about Field hockey has been added
19 Feb 2020
Made some adjustments to the wording of when event 1002 in Soccer is available
07 Feb 2020
Updated event information in baseball to include the MLB Live Data Service
10 Nov 2020
Several even info attributes have been changed in ice hockey
Added ITF ball in play event
08 Oct 2020
Added information about basketball NBA data extension
07 Aug 2019
Added a new XML configuration to baseball: "Include player positions in lineup"
Updated information about video assisted referee events in soccer
Added additional betstop reasons associated with video assisted referee
19 Jul 2019
Added information about a new global XML configuration (ID: 140) "Include UUID attribute to all events"
18 Jun 2019
The betstop reason "Disconnection" (ID/number 24) is no longer in use
28 May 2019
Updated the surface type "sand" to "clay" for tennis
21 Mar 2019
Updated the attribute substitute inside of the <player../> element to show "true" or "false" instead of "0" and "1" consistently in all XML examples and definitions
Updated event 30 (Goal) in Ice hockey to reflect that iScout can send extrainfo 11 (empty net)
A new configuration (ID 174) for adding the "var" attribute (video assisted referee) has been added to soccer
Some changes have been made to device availability for certain events in soccer
Checked runner (1718) has been removed from the pcount attribute used in baseball
07 Mar 2019
Added events 60 (Substitution), 2143 (Current pitcher baseball) and 2144 (current batter baseball) to baseball
31 Jan 2019
Added 2 new XML configurations for Baseball: 1) Inclide player Ids in baseball events and 2) Send lineups for baseball matches
Added information about player lineups in baseball (player1ID)
Added information about the new Australian open format in tennis
Added information about two new XML configurations in LiveData. "Add current period in delta and full feeds" and "Add sportID in delta feed"
Updated matchformat ruleset for american football (1 = NFL or AAF)
30 Nov 2018
Added a new event 1043 to ice hockey (Cancelled penalty).
Added an image to illustrate event 1771 in ice hockey
Added iScout as a coverage device for event 1732 in basketball.
Corrected some typo mistakes.
Corrected the allowed integer values for event 1771 in ice hockey "extrainfoicehockey".
Event 1458 and 1459 (VAR) has been added to handball.
Event 2137 (Service tiebreak deciding point) has been added to tennis.
Removed event 155 (throw on goal) in handball.
Removed XML config "included coveredfrom" (ID: 96) from the documentation.
Updated tennis documentation with support for the new tennis format.
Updated the coverage types for event 1002 in soccer
Updated the goal type information available from hardphone and iScout in ice hockey (Goal event).
Version number increased.
05 Oct 2018
Added additional information to the Match list chapter (filtering by sport or match).
Corrected the XML example in chapter 7.17
Updated version number to 2018.5
18 Sep 2018
Updated match status "Awaiting_golden_set" to id 37 and "after_golden_set" to id 130 for volleyball
04 Sep 2018
Added events 1021 and 1023 in tennis
Added match statuses 18 and 19 (Awaiting_golden_set and after_golden_set) to volleyball
Added some missing text
All events are now sorted by ID
Corrected card information in badminton (red card was used twice instead of red and black)
Corrected match status table for aussie rules
Corrected some missplaced information boxes in sport specific information chapters
Sorted some events in soccer
Typo and correcting layout errors
Updated core functions document
25 Jul 2018
Added iScout (BC + DC) as coverage device to event 1002 in Ice hockey (Penalty Shootout Event).
Added iScout (BC) to multiple events in american football
Corrected a bug with information boxes showing incorrectly
Corrected some missing text and wording errors for event 172 in soccer and handball
Corrected the description of event 1773 in volleyball (was the same as event 1058).
Removed events that are only for RTS matches (soccer, basketball, ice hockey, volleyball and handball).
Removed the use of event 1550 as XML examples. This event is only used for RTS matches.
Version number increased
09 Jul 2018
Added a new section under "Information per sport" explaining the relationship between event types and coverage types in sporting events
Added a note informing clients that they may recieve multiple full match messages, and this should be considered normal behavior
Added 3 additional options for the tennis event 1115 Code violation (id 12, 13 and 14)
Added the allowed values in the "jersey_type" attribute when the corresponding XML configuration has been enabled
Corrected event 1084 to reflect yellow cards and not red cards
Corrected the wording of event 1024 for some sports
22 May 2018
Added a link to the corresponding XML configuration for overtime matches in basketball (under match statuses table).
Added events 164 and 1014 to american football
Added sport ID 13 (Aussie rules) to the "Information per sport" Sport ID list
Corrected some XML examples illustrating wrong code
Corrected the Ids for the configuration "Send periodx score types for <sport>". Done for american football, futsal, handball, ice hockey, rugby and soccer
Removed Hardphone as a coverage type for all events in Aussie rules
Removed the event 1550 Manual score adjustment from all sports
Version changed to 2018.3
12 Apr 2018
Removed QCI from the coverage/device column in event tables
Updated Aussie rules event table with all relevant devices
Updated event tables for Soccer, IceHockey and Rugby with showing iScout as both (BC) and (DC)
Version changed to v2018.2.2
22 Mar 2018
Added a new border style to all XML snippets to distinguish them from tables
Added a new event for baseball: 2112 Baseball error (Describes a baseball error made by a player while interacting with either the ball or players on the field)
Added a NOTE icon for Betstop reasons informing clients that some Betstop reasons use the same ID, but have different strings describing the betstop. E.g. ID 20 means "Dangerous goal position [T1]", but in rugby this event means "possible score".
Added a short description to all missing events except for events where event name = event description
Added all IDs to XML configurations for each individual sport
Added Aussie rules in the information per sport section
Added bold text to subsections in the table of content
Added description and xml example to the new attributes in the event element for aussie rules, goals and behinds
Added description and xml example to the new elements goals and behinds for aussie rules
Added event descriptions for event 2064, 2065 and 2066 for soccer
Added source type hScout for all soccer matches with DTMF alerts (Device ID 6 was added for this source type)
Added event 2061 (Possible drop kick) and 2062 (Cancled drop kick) to the american football event table
Added events 43 (SUSPENSION)and 1049 (SUSPENSION_OVER) to soccer where matches/tournaments use the sinbin rule
Added events to aussie rules
Added match_statuses for assuie rules
Added missing values to all sport event tables
Added multiple missing values to XML attribute definition tables
Added sport specific XML attributes and elements to aussie rules
Additional lists sorted alphabetically
Adjusted all page margins to fit the new layout
Adjusted the font size of all XML snippets
Changed the layout of the "Betstop Reason" table (changed into a 4 colum table from 2) to make it smaller
Changed the table of content to no longer be included as pages
Changed the table of content to no longer include the header or footer
Coverage type "Hardphone" added to event 90 in Soccer
Created a document structure section under "introduction" chapter
Created and added a new XML example in section 3.1.7 Lineups to illustrate that the lineup player id attribute matches the event player1 attribute in the feed
Event 1854 Dota first barrack added to dota2 event table
Fixed a bug causing the table of content and page numbering to display incorrectly
Fixed a page breaking error with the figure wrapping in chapter 6.8.4 in cricket (example of pos X and pos Y)
Fixed some typos in chapter.4
General XML settings chapter renamed to XML configuration to match the LiveOdds documentation chapter
Improved the look of the event and match_status tables (had some missing lines, lines with odd colord, etc.)
Increased the size of the header image (betradar logo), and removed the thin black line under it
Made additional format changes (unusual use of \newpage and line spacing)
Made section text larger in the table of content
New layout has cleared up multiple bad box errors, making the document render faster
Removed large white spacing used in several listings
Removed several old references from the Events tables in the "information per sport" section
Removed some overuse of spacing and \newpage in some XML examples in the last chapter
Removed the "Events" chapter, it is already included in the "information per sport" chapter
Removed the "Match Status" chapter, it is already included in the "information per sport" chapter
Removed the extrainfo in event 1013 match status for all sports, and replaced it with: "See the above table for all values"
Removed the old footer and replaced it with the new betradar template one
Updated the extrainfo attribute to the event element for betstop reasons for all sports with xml example
Updated the lineups section with all relevant sports (before only 3 were listed), and a link to an XML example of how the lineups look in the feed
Version number changed to v2018.2.1
XML configuration options chapter removed. This information wasa copypasted from the "Information per sport section".
XML messages chapter renamed to "System Communication"
XML settings chapter renamed to "General XML settings"
31 Jan 2018
General changes
Added descriptions for several sections to avoid sections and subsections overlapping
Adjusted all XML example boxes to fit page margins
All Latex errors removed
All Latex warnings removed
Changed color of the sections and subsections
Changed event table for Soccer to reflect that event 1064 is enabled by default
Changed system for headings (Section, Subsection, SubSubsection, Paragraph (new)).
Corrected all missing indocument references between chapters
Improvements to the Table of Contents
Replaced "Live Scout" with "Live Data" in certain chapters and frontpage
Sorted several chapters, lists and tables alphabetically
Version of the documentation has been streamlined to fit current release (2018.1.x)
Chapter specific
3 Events Added the definition of an Event
3.5 and 7.6 Events Beach volleyball Removed External Feed (BC) from Coverage types
3.5 and 7.6 Events Beach volleyball Removed the event 1773 (First serve golden set)
3.5 and 7.6 Events Beach volleyball Removed the event 1550 (Manual score adjustment)
4 XML configuration options: Corrected typo
5.6 Match statuses and 7.6.1 Added match status up to the 5th set, and for pauses
5.6 Match statuses and 7.6.1 The status GOLDEN_SET has been removed
5.6 Match statuses and 7.6.1 The status DELAYED has been removed
7.12 Events: Removed event 1080 from handball
7.3 Events: Added the event 129 (Foul)
04 Dec 2017
Chapter 2
2.1.5 adding Betstop reason 84 Feed interruption
Chapter 3
3.5 Handball adding iScout(BC) as source for Handball events
3.7 Badminton adding iScout(BC) as source for Badminton events
3.18 adding extrainfomoba attribute column
adding extrainfomoba attribute for event 1844
adding new event 2058
3.19 correct id of events 2058 and 2059
adding extrainfomoba attribute for event 2058
Chapter 4
4.1 General settings
4.1.21 Adding xml config Send Jersey Color information
4.1.22 adding Include naturally capitalised team names XML config
4.1.23 Add attribute extrainfomoba XML config
21 Nov 2017
Futsal: Removed possible values player1/player2, as this was most likely copied wrong from soccer.
13 Nov 2017
Updated description of chapter "4.15.2 Enable Gold Element for League Of Legends" included XML example.
31 Oct 2017
Removed outcome "Incomplete" from event "Rush" in American football
28 Sep 2017
Fixed typo in chapter 7.1.3.
25 Sep 2017
Added RTS as source to ice hockey, see event list for full overview.
New event added to ice hockey: 1550.
20 Sep 2017
Added player1 information to the following event in rugby: 1155
Added new XML configuration to rugby: Enable lineups
18 Sep 2017
Added iScout (BC) to the following events in soccer: 2067
15 Sep 2017
Added iScout (BC) to the following events in soccer: 2064, 2065 and 2066
30 Aug 2017
Sport specific XML soccer and rugby:
Added description about injury time to mtime attribute (in <event>element)
30 Aug 2017
Sport specific XML Tennis:
Added a note about nesting of <score>elements when match goes in a tiebreak.
09 Aug 2017
Volleyball match statuses:
Added missing match status "golden set".
Removed wrong match statuses "defaulted1" and "defaulted2".
03 Aug 2017
Chapter 2
2.1.5 added new betstop reason id 83
Chapter 3
3.1 added new events 2064,2065,2066,2067
3.3 Fixed extrainfo attribute in the feed for basketball fouls (129)
Removed event 1602 not in use anymore
3.5 Renamed events 1413,1414,1703
3.10 Added player1 and player2 column to events table. Adding player information to events: 1444, 1423, 1457, 1426, 1421
3.19 added new events: 2058,2059
3.20 added new event 2063
Chapter 4
4.1 Added configuration "Include matchid in bookmatch reply"
4.2.8 Added new xml config: Restart Match clock for Extra Time (Soccer)
4.2.5 Removed configuration "Include matchid in bookmatch reply"
4.10.4 Added XML config Add conversion type attribute for American Football
4.10.5 Added XML config Add touchdown type attribute for American Football
4.10.6 Added XML config Add player data to American Football scoring events
Chapter 7
7.1.6 added new extrainfo value: 2 x 45 minutes with ABBA shootout format
7.3.3 Fixed The description of the "wonjumpball" attribute
7.6.3 Added extrainfo value 44 = Best of 7 sets 15 point limit
7.11.3 Added conversiontype to Attributes in <event> element
7.11.3 Added touchdowntypeto Attributes in <event> element
7.20.3 added new element gold
30 May 2017
Chapter 3
Tennis
Adding missing tennis documentation: missing External feed as source for some events
Adding XSA and External feed as source to Tennis Challenge events (1656,1657, 1659)
Volleyball/Beach Volleyball
Adding iScout as source
Chapter 4
Device id table: Explanation of what Mobile App is.
American football
Missing XML configuration "Include matchformat elements for American football matches".
Baseball
corret type for attributes firstbaseloaded, secondbaseloaded and thirdbaseloaded
Dota2
Adding xml config Enable net worth
Chapter 7
Baseball
corret type for attributes firstbaseloaded, secondbaseloaded and thirdbaseloaded
Soccer
adding "matchscore" attribute to soccer events
Dota2
adding element "networth" to Elements in <match>element
Chapter 8
Soccer
add ""matchscore" attribute to soccer events
28 Mar 2017
Chapter 3
Baseball
Added iScout as source for event 1044
New Ball type value (5) Enforced ball for Event 1723
New Batter advancement type (12) Intentional walk for event 1727
Tennis
Added missing event 1024
Table Tennis
Added iScout as source
New values for Point type (4) 1 point penalty and (5) 2 points penalty for event 1161
Added Violation type (0) Illegal service, (2) Yellow card/warning, (3) yellowred card/penalty and (4) red card/disqualification to event 1177
Added new event 2052 Yellowred card same hand
Added missing event 1047
Cricket
Added Hardphone as source for Event 1342
Chapter 4
Added new XML configuration:Enable Coverage status in matchlist
Chapter 5
Correct matchstatus (21) id for IN_PROGRESS for Snooker and Darts
Chapter 7
Description of tiebreaklastset attibute in Tennis <match> element
Section 7.17.3
Added 1314, 1303,1304 to events that include innings element.
Back to top
Last updated
Was this helpful?