# Basketball

## Match statuses in basketball <a href="#ldbasketball-matchstatusesinbasketball" id="ldbasketball-matchstatusesinbasketball"></a>

<table><thead><tr><th width="129.02862548828125">ID</th><th width="280.15966796875">Match status</th><th width="255.8133544921875">Description</th><th>Additional information</th></tr></thead><tbody><tr><td>0</td><td>NOT_STARTED</td><td>Not started yet</td><td>-</td></tr><tr><td>1</td><td>FIRST_PERIOD</td><td>1st halftime</td><td>This match status is only sent for NCAA men matches.</td></tr><tr><td>13</td><td>FIRST_QUARTER</td><td>1st quarter</td><td>-</td></tr><tr><td>301</td><td>FIRST_PAUSE</td><td>1st pause</td><td>-</td></tr><tr><td>14</td><td>SECOND_QUARTER</td><td>2nd quarter</td><td>-</td></tr><tr><td>302</td><td>SECOND_PAUSE</td><td>2nd pause</td><td>-</td></tr><tr><td>31</td><td>HALFTIME</td><td>Halftime break</td><td>This match status is only sent for NCAA men matches.</td></tr><tr><td>2</td><td>SECOND_PERIOD</td><td>2nd halftime</td><td>This match status is only sent for NCAA men matches.</td></tr><tr><td>15</td><td>THIRD_QUARTER</td><td>3rd quarter</td><td>-</td></tr><tr><td>303</td><td>THIRD_PAUSE</td><td>3rd pause</td><td>-</td></tr><tr><td>16</td><td>FORTH_QUARTER</td><td>4th quarter</td><td>-</td></tr><tr><td>100</td><td>ENDED</td><td>The match has ended</td><td>-</td></tr><tr><td>32</td><td>AWAITING_OT</td><td>Waiting for overtime to start</td><td>This match status is only sent if the corresponding XML configuration is enabled.</td></tr><tr><td>40</td><td>OVERTIME</td><td>Overtime (in case match goes to extra time)</td><td>-</td></tr><tr><td>110</td><td>AFTER_OT</td><td>Match finished after overtime</td><td>This match status is only sent if the corresponding XML configuration is enabled.</td></tr><tr><td>61</td><td>DELAYED</td><td>The match start is delayed</td><td>-</td></tr><tr><td>80</td><td>INTERRUPTED</td><td>The match has been interrupted</td><td>-</td></tr><tr><td>90</td><td>ABANDONED</td><td>The match has been abandoned</td><td>This match status is only sent if the corresponding XML configuration is enabled.</td></tr></tbody></table>

\
&#x20; &#x20;

## Events in Basketball <a href="#ldbasketball-eventsinbasketball" id="ldbasketball-eventsinbasketball"></a>

**Blue text** = NBA & WNBA unique data points if covered by device ID 5 (External Feed) in deeper coverage (dc = 1). This is based on official NBA NGSS data feeds.

<table><thead><tr><th width="63.864532470703125">ID</th><th width="103.6414794921875">Event</th><th width="158.44268798828125">Description</th><th width="110.58502197265625">Coverage</th><th width="358.243896484375">Special XML Attributes</th><th width="100">Player1</th><th width="93.4375">Player2</th></tr></thead><tbody><tr><td>60</td><td>Substitution</td><td>Used when a substitution of players occurs</td><td>iScout (DC), XSA (DC), External Feed (DC)</td><td><strong>Happenedat:</strong> UNIX timestamp indicating when the event actually happened. Available only if the event had to be added after the fact. </td><td>Id of player going out</td><td>Id of player going in</td></tr><tr><td>110</td><td>Possession</td><td>Indicates which team is currently in possession of the ball.</td><td>Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)</td><td>-</td><td>-</td><td>-</td></tr><tr><td>129</td><td>Foul</td><td>Used when a foul is committed.<br>Entries are assigned to teams.</td><td>Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)</td><td><p><strong>Extrainfo:</strong> Possible values:</p><ul><li>-1 = Unknown</li><li>1 = Other Personal Foul</li><li>2 = Shooting Foul</li><li>3 = Offensive Foul</li><li>4 = Technical Foul</li><li>5 = Flagrant Foul</li></ul><p><strong>Foultypedescriptor:</strong> Description of the foul. Possible values:</p><ul><li>1 = charge<br></li><li>2 = off the ball<br></li><li>3 = take<br></li><li>4 = double<br></li><li>5 = shooting<br></li><li>6 = clear path<br></li><li>7 = loose ball<br></li><li>8 = blocking<br></li><li>9 = player control<br></li><li>10 = shooting block<br></li><li>11 = elbow<br></li><li>12 = punching<br></li><li>13 = flagrant type 1<br></li><li>14 = flagrant type 2<br></li><li>15 = away from play<br></li><li>16 = inbound<br></li><li>17 = non-unsportsmanlike<br></li><li>18 = rim hanging<br></li><li>19 = delay<br></li><li>20 = taunting<br></li><li>21 = indirect<br></li><li>22 = excess timeout<br></li><li>23 = too many players<br></li><li>24 = defensive 3 second<br></li><li>25 = flopping<br></li><li>26 = bench</li></ul><p><strong>Foultypequalifier</strong>: Additional classification of the foul type. One event can have more than one foultypequalifier. Possible values:</p><ul><li>1 = 1 free throw</li><li>2 = 2 free throw</li><li>3 = 3 free throw</li><li>4 = in penalty</li><li>5 = team</li></ul><p><strong>Posx:</strong> Approximated horizontal foul location on court, posx being a number from 0 to 100. The reference point 0 is at home teams baseline. Only if present.</p><p><strong>Posy:</strong> Approximated vertical foul location on court, posy being a number from 0 to 100. The reference point 0 is on top of court when home teams baseline is on the left hand side.</p></td><td>Id of fouling player. Only if present.</td><td>Id of fouled player. Only if present.</td></tr><tr><td>1010</td><td>Betstart</td><td>Betstart indicates that betting markets can be activated. Betstart is not only a pre match event but is also used during the match.</td><td>Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)</td><td>-</td><td>-</td><td>-</td></tr><tr><td>1011</td><td>Betstop</td><td>Betstop indicates that all betting markets are closed due to strong possibility of a goal, penalty, red card, or there is any unclear situation on the field. Betstop is also used whenever there is the need to establish direct communication between the scout and the match Supervisor, or in case of call disconnection.</td><td>Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)</td><td>-</td><td>-</td><td>-</td></tr><tr><td>1013</td><td>Match status</td><td>Sent when the status of the match changes.</td><td>Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)</td><td><strong>Extrainfo:</strong> See above table for match statuses available for Basketball.</td><td>-</td><td>-</td></tr><tr><td>1015</td><td>Free comment</td><td>Free text message. Free comment is used for any kind of additional information during the match. For example: "players on court" and "players are warming up".</td><td>Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)</td><td>-</td><td>-</td><td>-</td></tr><tr><td>1024</td><td>Match about to start</td><td>Match is about to start</td><td>Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)</td><td>-</td><td>-</td><td>-</td></tr><tr><td>1033</td><td>Won jump ball team</td><td>Information about which team won the jump ball. Jump ball is used to begin play and sometimes to resume play.</td><td>Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)</td><td><strong>Tippedto:</strong> Id of player who got the ball. Only if present.</td><td>ID of player who won the jump ball. Only if present.</td><td>ID of player who lost the jump ball. Only if present.</td></tr><tr><td>1034</td><td>Rebound</td><td>Rebound awarded to a player who retrieves the ball after a missed field goal or free throw.</td><td>iScout (BC+DC), XSA (DC), External Feed (DC)</td><td><p><strong>Extrainfo:</strong> Rebound type. Possible values:</p><ul><li>0 = Defensive</li><li>1 = Offensive</li><li>-1 = Unknown</li></ul><p><strong>Posx:</strong> Approximated horizontal rebound location on court, posx being a number from 0 to 100. The reference point 0 is at home teams baseline. Only if present.</p><p><strong>Posy:</strong> Approximated vertical rebound location on court, posy being a number from 0 to 100. The reference point 0 is on top of court when home teams baseline is on the left hand side.</p></td><td>ID of rebounding player. Only if present.</td><td>-</td></tr><tr><td>1035</td><td>Timeout</td><td>A team calls a timeout. Entries can be assigned to teams, but neutral timeouts are possible too.</td><td>Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)</td><td>-</td><td>-</td><td>-</td></tr><tr><td>1036</td><td>Time start stop</td><td>Match clock is stopped or started.</td><td>Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)</td><td><p><strong>Extrainfo:</strong> Possible values:</p><ul><li>1 = Time started</li><li>0 = Time stopped</li></ul></td><td>-</td><td>-</td></tr><tr><td>1037</td><td>Score change</td><td>Used when a team scores points. Entries are assigned to teams.</td><td>Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)</td><td><p><strong>Extrainfo:</strong> Possible values:</p><ul><li>1 = Free throw (1 point)</li><li>2 = 2-pointer</li><li>3 = 3-pointer</li><li>4 = 4-pointer</li></ul><p><strong>Extrainfobasketball:</strong> Score type. Enabled by LD XML config ID 28. Possible values:</p><ul><li>-1 = Unknown</li><li>0 = Free Throw</li><li>1 = Invalid (only used in cases where free throw is made, but some kind of violation occurs like player steps over the line or similar)</li><li>2 = Fast break (provided via scoretypequalifier instead)</li><li>3 = Dunk</li><li>4 = Layup</li><li>5 = Putback (provided via secondscoretype instead)</li><li>6 = Tip-in (provided via secondscoretype instead)</li><li>7 = Alley-Oop (provided via secondscoretype instead)</li><li>8 = Jump Shot</li><li>9 = Hook</li></ul><p><strong>Secondscoretype:</strong> Additional score type. Enabled by LD XML config ID 46. Possible values:</p><ul><li>-1 = Unknown</li><li>1 = Invalid (provided via extrainfobasketball)</li><li>2 = Fast break (provided via scoretypequalifier)</li><li>3 = Dunk (provided via extrainfobasketball)</li><li>4 = Layup (provided via extrainfobasketball)</li><li>5 = Putback</li><li>6 = Tip-in</li><li>7 = Alley-Oop</li><li>10 = Bank</li><li>11 = Cutting (including cutting finger roll)</li><li>12 = Driving (including driving bank, driving finger roll, driving floating, driving floating bank &#x26; driving reverse)</li><li>13 = Fadeaway (including fadeaway bank)</li><li>14 = Finger roll</li><li>15 = Floating</li><li>16 = Pullup (including pullup bank)</li><li>17 = Reverse</li><li>18 = Running (including running alley oop, running finger roll, running pullup &#x26; running reverse, </li><li>19 = Step back (including step back bank)</li><li>20 = Turnaround (including turnaround bank, turnaround fadeaway &#x26; turnaround fadeaway bank)</li></ul><p><strong>Scoretypequalifier:</strong> Additional score type qualifier. One event can have more than one scoretypequalifier. Enabled by LD XML config ID 46. Possible values:</p><ul><li>1 = 2nd chance</li><li>2 = Fast break</li><li>3 = From turnover</li><li>4 = Defensive goal tending</li><li>5 = Points in the paint</li></ul><p><strong>Happenedat:</strong> UNIX timestamp indicating when the event actually happened. Available only if the event had to be added after the fact. </p><p><strong>Posx:</strong> Approximated horizontal shot location on court, posx being a number from 0 to 100. The reference point 0 is at home teams baseline. Only if present.</p><p><strong>Posy:</strong> Approximated vertical shot location on court, posy being a number from 0 to 100. The reference point 0 is on top of court when home teams baseline is on the left hand side.</p></td><td>Id of scoring player. Only if present.</td><td>Id of assisting player. Only if present.</td></tr><tr><td>1038</td><td>Score miss</td><td>Used when a point attempt missed.</td><td>Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)</td><td><p><strong>Extrainfo:</strong> Possible values:</p><ul><li>1 = Free throw (1 point)</li><li>2 = 2-pointer</li><li>3 = 3-pointer</li><li>4 = 4-pointer</li></ul><p><strong>Extrainfobasketball:</strong> Score type. Enabled by LD XML config ID 28. Possible values:</p><ul><li>-1 = Unknown</li><li>0 = Free Throw</li><li>1 = Invalid (only used for free throws. I.e. if player misses but defender steps into the lane too early so the shooter gets a new try)</li><li>3 = Dunk</li><li>4 = Layup</li><li>8 = Jump Shot</li><li>9 = Hook</li></ul><p><strong>Secondscoretype:</strong> Additional score type. Enabled by LD XML config ID 46. Possible values:</p><ul><li>-1 = Unknown</li><li>5 = Putback</li><li>6 = Tip-in</li><li>7 = Alley-Oop</li><li>10 = Bank</li><li>11 = Cutting (including cutting finger roll)</li><li>12 = Driving (including driving bank, driving finger roll, driving floating, driving floating bank &#x26; driving reverse)</li><li>13 = Fadeaway (including fadeaway bank)</li><li>14 = Finger roll</li><li>15 = Floating</li><li>16 = Pullup (including pullup bank)</li><li>17 = Reverse</li><li>18 = Running (including running alley oop, running finger roll, running pullup &#x26; running reverse, </li><li>19 = Step back (including step back bank)</li><li>20 = Turnaround (including turnaround bank, turnaround fadeaway &#x26; turnaround fadeaway bank)</li></ul><p><strong>Scoretypequalifier:</strong> Additional score type qualifier. One event can have more than one scoretypequalifier. Enabled by LD XML config ID 46. Possible values:</p><ul><li>1 = 2nd chance</li><li>2 = Fast break</li><li>3 = From turnover</li><li>4 = Defensive goal tending</li><li>5 = Points in the paint</li></ul><p><strong>Posx:</strong> Approximated horizontal shot location on court, posx being a number from 0 to 100. The reference point 0 is at home teams baseline. Only if present.</p><p><strong>Posy:</strong> Approximated vertical shot location on court, posy being a number from 0 to 100. The reference point 0 is on top of court when home teams baseline is on the left hand side.</p></td><td>Id of shooting player. Only if present.</td><td>-</td></tr><tr><td>1039</td><td>Manual time adjustment</td><td>Manual adjustment of time.</td><td>Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)</td><td><strong>Extrainfo:</strong> Number of seconds adjusted. Either a positive or a negative integer.</td><td>-</td><td>-</td></tr><tr><td>1044</td><td>Delete event alert</td><td>Manual removal of an event.</td><td>Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)</td><td><strong>Extrainfo:</strong> Id of event that was deleted.</td><td>-</td><td>-</td></tr><tr><td>1047</td><td>Timeout over</td><td>Used when timeout is over.</td><td>Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)</td><td>-</td><td>-</td><td>-</td></tr><tr><td>1056</td><td>Number  of free throws</td><td>Free throws awarded to a player.</td><td>Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)</td><td><p><strong>Extrainfo:</strong> Number of free throws. (1 - 4)</p><p><strong>Extrainfobasketball:</strong> Possible values:</p><ul><li>1 = If it is a 1+1 free throw. (NCAA only)<br><br></li></ul><p>New attribute <strong>ftvalue (under Config - see below)  for "Basketball Unrivaled".</strong> </p><ul><li><strong>1 = Free Throw is worth  1 point</strong> </li><li><strong>2 = Free Throw is worth 2 points</strong></li><li><strong>3 = Free Throw is worth 3 points</strong></li><li><strong>Missing attribute - assume that FT is worth 1 point (normal basketball rules)</strong><br></li></ul></td><td>ID of player who is likely to throw the free throw(s)</td><td>-</td></tr><tr><td>1062</td><td>Ball position</td><td>Position of the ball on the court in x/y coordinates.</td><td>iScout (BC+DC), XSA (DC)</td><td>-</td><td>-</td><td>-</td></tr><tr><td>1102</td><td>Coverage status</td><td>Scout match coverage status. Coverage abandoned status means that coverage is stopped after it had already been started. Match will not be covered status means that match was supposed to be covered but coverage has been cancelled before.</td><td>Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)</td><td><strong>Extrainfo:</strong> Possible values:<br>0 = Covered<br>1 = Coverage abandoned<br>2 = Match will not be<br>covered</td><td>-</td><td>-</td></tr><tr><td>1437</td><td>TV timeout start</td><td>Start of a break in the game to allow television advertisements to be show. Can be attributed to home team, away team or no team ("official's timeout"), but side attribute is always set to "none".</td><td>iScout (BC+DC), XSA (DC)</td><td>-</td><td>-</td><td>-</td></tr><tr><td>1438</td><td>TV timeout over</td><td>End of a break in the game to allow television advertisements to be show. Can be attributed to home team, away team or no team ("official's timeout"), but side attribute is always set to "none".</td><td>iScout (BC+DC), XSA (DC)</td><td>-</td><td>-</td><td><br></td></tr><tr><td>1458</td><td>Video review</td><td>Used when a video review of a referee call occurs</td><td>iScout (BC+DC), XSA (DC), External Feed (DC)</td><td>-</td><td>-</td><td>-</td></tr><tr><td>1459</td><td>Video review over</td><td>Used when a video review of a referee call is over</td><td>iScout (BC+DC), XSA (DC), External Feed (DC)</td><td><p><strong>Extrainfo:</strong> Possible values:</p><ul><li>0 = call stands</li><li>1 = call overturned</li></ul></td><td>-</td><td>-</td></tr><tr><td>1550</td><td>Score adjustment</td><td>Manual period score adjustment in RTS</td><td>External Feed (BC)</td><td><p><strong>Extrainfo:</strong> Number of period being adjusted</p><p><strong>Extrainfobasketball:</strong> Updated period score (the one that was adjusted) and full score. Possible Values:</p><ul><li>&#x3C;home_period_score>:&#x3C;away_period_score></li><li>&#x3C;home_full_score>:&#x3C;away_full_score></li></ul></td><td>-</td><td>-</td></tr><tr><td>1603</td><td>Basketball play start</td><td>Indication that a free throw will be thrown shortly (player on the free throw line)</td><td>XSA (DC)</td><td>-</td><td>-</td><td>-</td></tr><tr><td>1604</td><td>Basketball play over</td><td>Indication that the free throw sequence is over</td><td>XSA (DC)</td><td>-</td><td>-</td><td>-</td></tr><tr><td>1605</td><td>Basketball play cancelled</td><td>If scout enters a "play start" by mistake, he/she can cancel it with "play cancelled"</td><td>XSA (DC)</td><td>-</td><td>-</td><td>-</td></tr><tr><td>1714</td><td>Player match stats</td><td>Accumulated Player match statistics sent in real-time based on NBA NGSS data.<br>It includes a total count and one count for each quarter or overtime. <br>Event will not be available in case of failover.</td><td>External Feed (DC)</td><td><p>Statistics format: Total stats will always be present. Accumulated period stats will only be present for the affected period stats.</p><ul><li><strong>homeplayerstatstotal</strong>=PLAYERSTATS|PLAYERSTATS|...</li><li><strong>awayplayerstatstotal</strong>=PLAYERSTATS|PLAYERSTATS|...</li><li><strong>homeplayerstatsp1</strong>=PLAYERSTATS|PLAYERSTATS|...</li><li><strong>awayplayerstatsp1</strong>=PLAYERSTATS|PLAYERSTATS|...</li><li><strong>homeplayerstatsp2</strong>=PLAYERSTATS|PLAYERSTATS|...</li><li><strong>awayplayerstatsp2</strong>=PLAYERSTATS|PLAYERSTATS|...</li><li><strong>homeplayerstatsp3</strong>=PLAYERSTATS|PLAYERSTATS|...</li><li><strong>awayplayerstatsp3</strong>=PLAYERSTATS|PLAYERSTATS|...</li><li><strong>homeplayerstatsp4</strong>=PLAYERSTATS|PLAYERSTATS|...</li><li><strong>awayplayerstatsp4</strong>=PLAYERSTATS|PLAYERSTATS|...</li><li><strong>homeplayerstatsot</strong>=PLAYERSTATS|PLAYERSTATS|...</li><li><strong>awayplayerstatsot</strong>=PLAYERSTATS|PLAYERSTATS|...</li></ul><p><br></p><p>PLAYERSTATS -> PID=NNNNNN;...(attributes below)</p><ul><li><p></p><ul><li><strong>PID</strong> -> playerId (int) is a basic value (present on all attributes)</li><li><strong>2PM</strong> → Two Pointer Made: Numeric value.</li><li><strong>2PA</strong> → Two Pointer Attempted: Numeric value.</li><li><strong>2PP</strong> → Two Pointer Percentage: decimal values from 0.0 to 100.0</li><li><strong>3PM</strong> → Three Pointer Made: Numeric value.</li><li><strong>3PA</strong> → Three Pointer Attempted: Numeric value.</li><li><strong>3PP</strong> → Three Pointer Percentage: decimal values from 0.0 to 100.0</li><li><strong>FTM</strong> → Free Throw Made: Numeric value.</li><li><strong>FTA</strong> → Free Throw Attempted: Numeric value.</li><li><strong>FTP</strong> → Free Throw Percentage: decimal values from 0.0 to 100.0</li><li><strong>OREB</strong> → Offensive Rebounds: Numeric value.</li><li><strong>DREB</strong> → Defensive Rebounds: Numeric value.</li><li><strong>REB</strong> → Rebounds: Numeric value.</li><li><strong>AST</strong> → Assists: Numeric value.</li><li><strong>STL</strong> → Steals: Numeric value.</li><li><strong>BLK</strong> → Blocks: Numeric value.</li><li><strong>TO</strong> → Turnovers: Numeric value.</li><li><strong>PF</strong> → Personal Fouls: Numeric value.</li><li><strong>PTS</strong> → Points: Numeric value.</li></ul></li></ul></td><td>-</td><td>-</td></tr><tr><td>1732</td><td>Player disqualified</td><td>Player is disqualified and must leave the court. Also called "ejection".</td><td>iScout (DC), XSA (DC), External Feed (DC)</td><td><p><strong>Extrainfo</strong>: Disqualification reason. Possible values:</p><ul><li>1 = technical</li><li>2 = second technical</li><li>3 = second flagrant type 1</li><li>4 = flagrant type 2</li><li>5 = other</li></ul><p><strong>Happenedat:</strong> UNIX timestamp indicating when the event actually happened. Available only if the event had to be added after the fact. </p></td><td>Id of disqualified player. Only if present.</td><td>-</td></tr><tr><td>1733</td><td>Steal basketball</td><td>A steal occurs when a defensive player legally causes a turnover </td><td>XSA (DC), External Feed (DC)</td><td><p><strong>Posx:</strong> Approximated horizontal location on court, posx being a number from 0 to 100. The reference point 0 is at home teams baseline. Only if present.</p><p><strong>Posy:</strong> Approximated vertical location on court, posy being a number from 0 to 100. The reference point 0 is on top of court when home teams baseline is on the left hand side.</p></td><td>Id of player who stole the ball. Only if present.</td><td>Id of player who lost the ball. Only if present.</td></tr><tr><td>1734</td><td>Turnover basketball</td><td>Turnover occurs when a team loses possession of the ball to the opposing team before a player takes a shot at his team's basket</td><td>XSA (DC), External Feed (DC)</td><td><p><strong>Extrainfo:</strong> Turnover type. Possible values:</p><ul><li>-1 = unknown</li><li>1 = travelling</li><li>2 = bad pass</li><li>3 = lost ball</li><li>4 = double dribble</li><li>5 = out of bounds</li><li>6 = palming</li><li>7 = shot clock violation</li><li>8 = back court violation</li><li>9 = three second violation</li><li>10 = five seconds violation</li><li>11 = eight seconds violation</li><li>12 = offensive foul</li><li>13 = too many players</li><li>14 = excess timeout</li><li>15 = basket from below</li><li>16 = swingingel bows</li><li>17 = punched ball</li><li>18 = opposite basket</li><li>19 = jump ball violation</li><li>20 = lane violation</li><li>21 = inbound</li><li>22 = discontinue dribble</li><li>23 = offensive goaltending</li><li>24 = 5 sec in bound violation</li><li>25 = offensive kicked ball</li><li>26 = illegal assist</li><li>27 = illegal out of bounds screen</li><li>28 = 5 second back to the basket</li><li>29 = 10 second free throw shooter</li></ul><p><strong>Posx:</strong> Approximated horizontal location on court, posx being a number from 0 to 100. The reference point 0 is at home teams baseline. Only if present.</p><p><strong>Posy:</strong> Approximated vertical location on court, posy being a number from 0 to 100. The reference point 0 is on top of court when home teams baseline is on the left hand side.</p></td><td>Id of player who turned over the ball</td><td>-</td></tr><tr><td>1735</td><td>Block basketball</td><td>A block or occurs when a defensive player legally deflects a field goal attempt from an offensive player</td><td>XSA (DC), External Feed (DC)</td><td><p><strong>Posx:</strong> Approximated horizontal location on court, posx being a number from 0 to 100. The reference point 0 is at home teams baseline. Only if present.</p><p><strong>Posy:</strong> Approximated vertical location on court, posy being a number from 0 to 100. The reference point 0 is on top of court when home teams baseline is on the left hand side.</p></td><td>Id of blocking player. Only if present.</td><td>Id of blocked player. Only if present.</td></tr><tr><td>1742</td><td>Score event correction</td><td>Used to convert two-pointers into three-pointers and vice versa</td><td>XSA (DC), External Feed (DC)</td><td><strong>Extrainfo:</strong> Id of corrected score change event</td><td>-</td><td>-</td></tr><tr><td>1743</td><td>Team match stats</td><td>Accumulated Team match statistics sent in real-time based on NBA NGSS data.<br>It includes a total count and one count for each quarter or overtime.<br>Event will not be available in case of failover. </td><td>External Feed (DC)</td><td><p>Statistics format: Total stats will always be present. Accumulated period stats will only be present for the affected period stats.</p><ul><li><strong>hometeamstatstotal</strong>=TEAMSTATS</li><li><strong>awayteamstatstotal</strong>=TEAMSTATS</li><li><strong>hometeamstatsp1</strong>=TEAMSTATS</li><li><strong>awayteamstatsp1</strong>=TEAMSTATS</li><li><strong>hometeamstatsp2</strong>=TEAMSTATS</li><li><strong>awayteamstatsp2</strong>=TEAMSTATS</li><li><strong>hometeamstatsp3</strong>=TEAMSTATS</li><li><strong>awayteamstatsp3</strong>=TEAMSTATS</li><li><strong>hometeamstatsp4</strong>=TEAMSTATS</li><li><strong>awayteamstatsp4</strong>=TEAMSTATS</li><li><strong>hometeamstatsot</strong>=TEAMSTATS</li><li><strong>awayteamstatsot</strong>=TEAMSTATS</li></ul><p><br></p><p>TEAMSTATS -> 2PM=NNNNNN;...(attributes below)</p><ul><li><p></p><ul><li><strong>2PM</strong> → Two Pointer Made: Numeric value.</li><li><strong>2PA</strong> → Two Pointer Attempted: Numeric value.</li><li><strong>2PP</strong> → Two Pointer Percentage: decimal values from 0.0 to 100.0</li><li><strong>3PM</strong> → Three Pointer Made: Numeric value.</li><li><strong>3PA</strong> → Three Pointer Attempted: Numeric value.</li><li><strong>3PP</strong> → Three Pointer Percentage: decimal values from 0.0 to 100.0</li><li><strong>FTM</strong> → Free Throw Made: Numeric value.</li><li><strong>FTA</strong> → Free Throw Attempted: Numeric value.</li><li><strong>FTP</strong> → Free Throw Percentage: decimal values from 0.0 to 100.0</li><li><strong>OREB</strong> → Offensive Rebounds: Numeric value.</li><li><strong>DREB</strong> → Defensive Rebounds: Numeric value.</li><li><strong>REB</strong> → Rebounds Total = Rebounds offensive + Rebounds defensive + Team Rebounds (i.e. ball out of bounce after missed shot): Numeric value.</li><li><strong>AST</strong> → Assists: Numeric value.</li><li><strong>STL</strong> → Steals: Numeric value.</li><li><strong>BLK</strong> → Blocks: Numeric value.</li><li><strong>TO</strong> → Turnovers: Numeric value.</li><li><strong>TF</strong> → Team Fouls: Numeric value.</li><li><strong>FTG</strong> → Fouls To Give: Numeric value.</li><li><strong>PTS</strong> → Points: Numeric value.</li></ul></li></ul></td><td>-</td><td>-</td></tr><tr><td>2233</td><td>Players time on court</td><td>Time spent on court by each player based on  NBA NGSS data.<br>Event will be updated every 8-10 seconds.<br>Event will not be available in case of failover. </td><td>External Feed (DC)</td><td><ul><li><strong>Hometimeoncourt:</strong> Time on court spent by home team players.<br>Format: "PID=ss;PID=ss;PID=ss" - List of key=value pairs separated by semicolon (";"), where key is player ID and value is time spent on court in seconds</li><li><strong>Awaytimeoncourt:</strong> Time on court spent by away team players<br>Format: "PID=ss;PID=ss;PID=ss" - List of key=value pairs separated by semicolon (";"), where key is player ID and value is time spent on court in seconds </li></ul></td><td>-</td><td>-</td></tr><tr><td>2237</td><td>Players on court</td><td>Sent at the beginning of every period and updated whenever a player leaves or enters the court.</td><td>External Feed (DC)</td><td><p><strong>homeplayers:</strong> List of home player IDs which are currently on court. Format: "PID;PID;PID" (list of players ids split by semicolon)</p><p><strong>awayplayers:</strong> List of away player IDs which are currently on court. Format: "PID;PID;PID" (list of players ids split by semicolon)</p><p><strong>Happenedat:</strong> UNIX timestamp indicating when the event actually happened. Available only if the event had to be added after the fact. </p></td><td>-</td><td>-</td></tr><tr><td>2332</td><td>Elam Ending</td><td>Indicates an Elam Ending start in TBT.<br><br>Elam Ending: At the first stoppage at or under 4:00 of the 4th quarter, the game clock stops and timed play ends. At this juncture, a target score is set, equal to the leading team's score plus eight (8). After returning from the media timeout, play will resume without a game clock but with the shot clock, until one team matches or exceeds the target score. During the untimed portion (the Elam Ending), any foul on the floor (i.e., any non-offensive, non-shooting foul) while in the bonus shall result in one free throw and the fouled team’s continued possession of the ball.<br>Example: Team A leads Team B 70-63 at the first stoppage under 4:00. The game clock is turned off while the shot clock remains on. The target score is set to 78. The first team that reaches 78 wins the game.<br></td><td>iScout (BC+DC), XSA (DC)</td><td><strong>Extrainfo:</strong> Integer containing the Target Score.</td><td>-</td><td>-</td></tr><tr><td>2396</td><td>Possible free throws awarded</td><td>Occurs during Bonus time at the exact moment there is a foul resulting in possible free throws for one of the teams.</td><td>External Feed (DC)</td><td><p>Extrainfo:  </p><p>Number of free throws. (1 - 4) </p></td><td>ID of player who is likely to throw the free throw(s)</td><td></td></tr><tr><td>2397</td><td>Free throws not confirmed</td><td>Used when possible free throws are not confirmed.</td><td>External Feed (DC)</td><td></td><td></td><td></td></tr></tbody></table>

\
&#x20;

## Sport specific XML elements and attributes <a href="#ldbasketball-sportspecificxmlelementsandattributes" id="ldbasketball-sportspecificxmlelementsandattributes"></a>

This section explains what elements / attributes one can expect for Basketball matches in addition to the standard elements and attributes, and what the meaning of those elements and attributes is.

### **Attributes in \<match>-element**

**XML example**

{% code overflow="wrap" %}

```xml
<match t1namenatural="Charlotte Hornets" t2namenatural="Toronto Raptors" t2name="TORONTO RAPTORS" t2id="19389" t1name="CHARLOTTE HORNETS" t1id="236032" t1abbr="CHA" t2abbr="TOR" start="1607990400000" matchid="24699292" feedtype="full" extrainfo="7" distance="946" betstatus="BETSTOP" connectionstatus="0" dc="1" device="3" coveredfrom="venue" timerunning="0" wonjumpball="away" st1id="3430" st2id="3433" matchtime="48:00" sportid="2" stime="1608117496346"> 
...
</match>
```

{% endcode %}

***XML elements and attributes definition***

| Element | Attributes    | Description                                           | Possible values                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ------- | ------------- | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Match   | *extrainfo*   | Integer specifying special information for the match. | <p>Integer. Possible values:</p><ul><li>0 = Default (4x10 minutes)</li><li>7 = 4 x 12 minutes</li><li>17 = 2 x 20 minutes</li><li>60 = 2 x 10 minutes</li><li>64 = 4 x 6 minutes</li><li>68 = 4 x 5 minutes</li><li>70 = 4 x 4 minutes</li><li>81 = 4 x 9 minutes & Elam Ending (event ID 2332)</li><li>82 = 4 x 12 minutes, 4-pointer possible</li><li>86 = 4 x 7 minutes & Elam Ending (event ID 2332) for Basketball Unrivaled</li></ul> |
|         | *wonjumpball* | Which team won the jump ball.                         | <p>String.<br>"home"<br>"away".</p>                                                                                                                                                                                                                                                                                                                                                                                                         |
|         | *timerunning* | Whether the time is running.                          | <p>Integer.<br>1 = Time is running<br>0 = Time is not running</p>                                                                                                                                                                                                                                                                                                                                                                           |

### **Elements in \<match> element**

**XML example**

```xml
<match t1namenatural="Charlotte Hornets" t2namenatural="Toronto Raptors" t2name="TORONTO RAPTORS" t2id="19389" t1name="CHARLOTTE HORNETS" t1id="236032" t1abbr="CHA" t2abbr="TOR" start="1607990400000" matchid="24699292" feedtype="full" extrainfo="7" distance="946" betstatus="BETSTOP" connectionstatus="0" dc="1" device="3" coveredfrom="venue" timerunning="0" wonjumpball="away" st1id="3430" st2id="3433" matchtime="48:00" sportid="2" stime="1608117496346">
<status start="1607999474587" name="ENDED" id="100"/>
<score type="current" t2="112" t1="109"/>
<score type="period4" t2="27" t1="22"/>
<score type="period1" t2="22" t1="30"/>
<score type="period2" t2="35" t1="30"/>
<score type="period3" t2="28" t1="27"/>
<events> 
...
</events>
<tournament name="NBA Preseason" id="9154"/>
<category name="USA" id="15"/>
<sport name="Basketball" id="2"/>
<jerseys>
<jersey side="1" jersey_type="0" base="FFFFFF" outline="00CACA" number="800080"/>
<jersey side="2" jersey_type="1" base="CC0000" outline="000000" number="FFFFFF"/>
</jerseys>
</match> 
```

***XML elements and attributes definition***

| Element    | Attributes | Description                                                                                                                                                                                                                                                                                            | Possible values                                                                                                          |
| ---------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| score      |            | <p>Multiple occurrences possible, each occurrence describes the amount of points for the specified period<br>in the match. This element always gets included in full feed, and in the delta feed for the following events:</p><p>Basketball score change (1037), and Score event correction (1742)</p> |                                                                                                                          |
|            | *t1*       | Amount of points home team                                                                                                                                                                                                                                                                             | Integer                                                                                                                  |
|            | *t2*       | Amount of points away team                                                                                                                                                                                                                                                                             | Integer                                                                                                                  |
|            | *type*     | For what period in the match the points were scored.                                                                                                                                                                                                                                                   | <p>String. Possible values:</p><ul><li>current</li><li>period1</li><li>period2</li><li>period3</li><li>period4</li></ul> |
| possession |            | <p>This element always gets included in full feed (DC matches only), and in the delta feed (DC matches only) for the following events:</p><p>Possession (110)</p>                                                                                                                                      |                                                                                                                          |
|            | *t1*       | Possession percentage home team                                                                                                                                                                                                                                                                        | Integer                                                                                                                  |
|            | *t2*       | Possession percentage away team                                                                                                                                                                                                                                                                        | Integer                                                                                                                  |
|            | *type*     | Team currently in possession                                                                                                                                                                                                                                                                           | <p></p><p>String. Possible values:</p><ul><li>"home"</li><li>"away"</li></ul>                                            |

### **Attributes in \<event> element**

**XML example**

{% code overflow="wrap" %}

```xml
<!-- Example 1 -->
<match matchid="24699292" feedtype="delta" betstatus="STARTED" connectionstatus="1" timerunning="1" wonjumpball="away">
<possession team="home"/>
<events>
<event type="1038" stime="1607991048876" side="away" mtime="00:30" info="3 points missed [T2]" id="2565321759" uuid="662eccb5-4898-4b93-b59e-0e9bafbf511d" extrainfo="3" posx="34" posy="71" matchscore="0:0" remainingtimeperiod="11:30" periodnumber="1" matchstatus="FIRST_QUARTER"/> 
</events>
</match>

<match matchid="24699292" feedtype="delta" betstatus="STARTED" connectionstatus="1" timerunning="1" wonjumpball="away">
<possession team="home"/>
<events>
<event type="1742" stime="1607999468638" side="home" mtime="48:00" info="Points scored corrected from 3 to 2 [T1]" id="2565400617" uuid="738521f5-d69d-49fc-abaf-1f3aa7e59c95" extrainfo="2565400553" matchscore="109:112" remainingtimeperiod="00:00" periodnumber="4" correctedfrom="3" correctedto="2" matchstatus="FOURTH_QUARTER"/> 
</events>
</match>
```

{% endcode %}

***XML attributes definition***

<table><thead><tr><th width="166.973876953125">Element</th><th width="179.9339599609375">Attributes</th><th>Description</th><th>Possible values</th></tr></thead><tbody><tr><td>event</td><td><em>extrainfo</em></td><td>Attribute containing additional information about the event.</td><td>Long</td></tr><tr><td></td><td><em>posx</em></td><td>Horizontal position on court, posx being a number from 0 to 100. The reference point 0 is at home teams baseline.</td><td>Number</td></tr><tr><td></td><td><em>posy</em></td><td>Vertical position on court, posy being a number from 0 to 100. The reference point 0 is on top of court when home teams baseline is on the left hand side.</td><td>Number</td></tr><tr><td></td><td><em>player1</em></td><td>Sportradar player id for player 1 connected to this event.</td><td><br></td></tr><tr><td></td><td><em>player2</em></td><td>Sportradar player id for player 2 connected to this event.</td><td><br></td></tr><tr><td></td><td><em>matchscore</em></td><td>Score for current match.</td><td>String. Format: "[home]:[away]"<br>Example: "1:0"</td></tr><tr><td></td><td><em>remainingtimeperiod</em></td><td>Remaining time of the period.</td><td>String. Format: "MM:SS"</td></tr><tr><td></td><td><em>periodnumber</em></td><td>Number of current period in match.</td><td>Integer</td></tr><tr><td></td><td><em>extrainfobasketball</em></td><td>Attribute containing additional information about the event.</td><td>String</td></tr><tr><td></td><td><em>correctedfrom</em></td><td>previous points value of the corrected score change event (event ID 1742)</td><td>Integer</td></tr><tr><td></td><td><em>correctedto</em></td><td>new points value of the corrected score change event (event ID 1742)</td><td>Integer</td></tr></tbody></table>

<br>

## XML configurations for Basketball <a href="#ldbasketball-xmlconfigurationsforbasketball" id="ldbasketball-xmlconfigurationsforbasketball"></a>

This section explains what XML configurations one can expect for this sport in addition to the standard XML configurations, and what the meaning of these configurations is.

### **(ID: 10) Basketball OT matchstatuses**

Enabling this setting will add the following possible match statuses for basketball matches:

•  AWAITING\_OT

•  AFTER\_OT

### **(ID: 28) Include extrainfobasketball attribute**

Enabling this setting will add an additional attribute **extrainfobasketball** to the \<event> element. The value of this attribute is explained in the event list.

**XML example**

```xml
<event type="1550" extrainfo ="2" extrainfobasketball="5:6,23:15" id="422510698" info="Score adjusted for 2nd Period. New matchscore: 23:15"
matchscore="23:15" mtime="14:09" periodnumber="2" remainingtimeperiod="05:51" side="none" stime="1435190811853"/>
<!-- Remaining message truncated -->
</match>
```

### **(ID: 32) Include Periodx score type**<br>

Enabling this setting will add an attribute type in the \<score> element, the attribute type can have one of the following values in addition to the regular values for Basketball matches:

• period1

• period2

• period3

• period4

**XML example**

```xml
<match matchid="7440630" ... >
<score t1="14" t2="20"type="period1"/>
<!−−Remaining message truncated−−>
</match>
```

### **(ID: 36) Include Lineups**<br>

Enabling this settings will allow the lineups event to be sent. Lineups are sent when subscribing to a match or when the lineup change.

**XML example**

```xml
<lineups matchid="6856980">
<player id="215634" name="Clark, Ian" shirtnumber="5" substitute="0" team="1"/>
<player id="801224" name="Ingles, Joe" shirtnumber="7" substitute="0" team="1"/>
<!−−Remaining message truncated−−>
</lineups>
```

### **(ID: 37) Include Basketball v2 upgrades**<br>

Enabling this setting will add the event 1742 (Score event correction): **correctedfrom** and **correctedto** as additional attributes to the \<event> element. Those attributes contain respectively the old value of the score event, and the new updated value.

**XML example**

{% code overflow="wrap" %}

```xml
<event correctedfrom ="3" correctedto ="2"  extrainfo ="435180082" id="435180084" info="Points scored corrected from 3 to 2 [T1]" matchscore="5:7" mtime="10:00" periodnumber="1" remainingtimeperiod="00:00" side="home" stime="1438860996364" type="1742"/>
```

{% endcode %}

### **(ID: 46) Include Attribute secondscoretype**<br>

Enabling this setting will add the attributes secondscoretype and scoretypequalifier to event ID 1037 (score change) and event ID 1038 (score miss) to the \<event> element. These attributes give more detailed information about the score change event.

**XML example**

{% code overflow="wrap" %}

```xml
<event type="1037" stime="1654909677800" side="home" mtime="00:10" info="2 points (layup,driving) [T1] -M.Smart" id="2170664751" uuid="92664b0f-959a-44f1-8ef0-903ff3f69461" extrainfo="2" posx="88" posy="46" player1="607636" player2="1141196" matchscore="2:0" remainingtimeperiod="11:50" periodnumber="1" extrainfobasketball="4" secondscoretype="12" scoretypequalifier="5" matchstatus="FIRST_QUARTER"/> 
```

{% endcode %}

### **(ID: 75) Include Ball spotting**<br>

Enabling this setting will enable the ball position event (1062).

### **(ID: 156) Include time on court in Basketball**

Enabling this setting will add the event 2233 (Players Time on Court) to the Live Data XML Feed for matches covered with NBA NGSS data.

**XML example**

{% code overflow="wrap" %}

```xml
<match matchid="10115268" ... >
...  
<event type="2233" stime="1642731245775" side="none" mtime="32:59" id="2165963005" uuid="aea91253-3928-4b1c-a691-b511506875ea" matchscore="55:79" remainingtimeperiod="03:01" periodnumber="3" matchstatus="THIRD_QUARTER" hometimeoncourt="1491414=482;1315510=303;1770168=1572;607850=1270;608108=1662;608288=1508;1491436=515;608034=708;1478984=1257;607750=547" awaytimeoncourt="1296160=1572;1497683=1271;1770174=654;1307780=657;607970=1401;1497693=303;608210=303;996321=1418;1142606=1552;1304668=694"/>
 </events>
</match>
```

{% endcode %}

### **(ID: 157) Include player match statistics Basketball**

Enabling this setting will add the event 1714 (Player match stats) to the Live Data XML Feed for matches covered with NBA NGSS data.

**XML example**

{% code overflow="wrap" %}

```xml
<event type="1714" stime="1643716141987" side="none" mtime="19:57" info="Player Statistics Update" id="2166185793" uuid="79302c09-7d52-44d6-98fa-5bce1eda6060" matchscore="38:38" remainingtimeperiod="04:03" periodnumber="2" matchstatus="SECOND_QUARTER" homeplayerstatstotal="PID=607440;2PM=2;2PA=3;2PP=66.7;3PM=1;3PA=3;3PP=33.3;FTM=0;FTA=0;FTP=0.0;OREB=0;DREB=0;REB=0;AST=3;STL=0;BLK=1;TO=1;PF=0;PTS=7" homeplayerstatsp1="PID=607440;2PM=2;2PA=3;2PP=66.7;3PM=1;3PA=3;3PP=33.3;FTM=0;FTA=0;FTP=0.0;OREB=0;DREB=0;REB=0;AST=3;STL=0;BLK=1;TO=1;PF=0;PTS=7"/>

<event type="1714" stime="1643716146968" side="none" mtime="19:57" info="Player Statistics Update" id="2166185812" uuid="1788442c-d886-4864-aaf6-239030ff5bb8" matchscore="38:38" remainingtimeperiod="04:03" periodnumber="2" matchstatus="SECOND_QUARTER" awayplayerstatstotal="PID=1491410;2PM=0;2PA=1;2PP=0.0;3PM=0;3PA=0;3PP=0.0;FTM=0;FTA=0;FTP=0.0;OREB=0;DREB=1;REB=1;AST=0;STL=0;BLK=0;TO=0;PF=0;PTS=0" awayplayerstatsp1="PID=1491410;2PM=0;2PA=1;2PP=0.0;3PM=0;3PA=0;3PP=0.0;FTM=0;FTA=0;FTP=0.0;OREB=0;DREB=1;REB=1;AST=0;STL=0;BLK=0;TO=0;PF=0;PTS=0"/>
```

{% endcode %}

### **(ID: 158) Include team match statistics Basketball**

Enabling this setting will add the event 1743 (Team match stats) to the Live Data XML Feed for matches covered with NBA NGSS data.

**XML example**

{% code overflow="wrap" %}

```xml
<event type="1743" stime="1643716138966" side="none" mtime="19:57" info="Team Statistics Update" id="2166185790" uuid="7be328cc-f195-4943-955a-83f6cbd89996" matchscore="38:38" remainingtimeperiod="04:03" periodnumber="2" matchstatus="SECOND_QUARTER" hometeamstatstotal="2PM=5;2PA=8;2PP=62.5;3PM=3;3PA=7;3PP=42.9;FTM=4;FTA=4;FTP=100.0;OREB=1;DREB=5;REB=7;AST=5;STL=2;BLK=3;TO=3;TF=2;FTG=2;PTS=23" hometeamstatsp1="2PM=5;2PA=8;2PP=62.5;3PM=3;3PA=7;3PP=42.9;FTM=4;FTA=4;FTP=100.0;OREB=1;DREB=5;REB=7;AST=5;STL=2;BLK=3;TO=3;TF=2;PTS=23"/>


<event type="1743" stime="1643716146968" side="none" mtime="19:57" info="Team Statistics Update" id="2166185813" uuid="790a943e-1fb1-4d12-9ae8-18393313c1a5" matchscore="38:38" remainingtimeperiod="04:03" periodnumber="2" matchstatus="SECOND_QUARTER" awayteamstatstotal="2PM=5;2PA=11;2PP=45.5;3PM=1;3PA=3;3PP=33.3;FTM=2;FTA=2;FTP=100.0;OREB=1;DREB=6;REB=8;AST=2;STL=2;BLK=0;TO=6;TF=2;FTG=2;PTS=15" awayteamstatsp1="2PM=5;2PA=11;2PP=45.5;3PM=1;3PA=3;3PP=33.3;FTM=2;FTA=2;FTP=100.0;OREB=1;DREB=6;REB=8;AST=2;STL=2;BLK=0;TO=6;TF=2;PTS=15"/>
```

{% endcode %}

### **(ID: 162) Include player positions in lineups Basketball**

Enabling this setting will add player positions to the Live Data XML Feed lineups for Basketball matches if available

<table><thead><tr><th width="285.078125">Attribute</th><th>Description</th><th>Possible values</th></tr></thead><tbody><tr><td>position</td><td>Where the player is typically playing in the field based on the season.</td><td><ul><li>G = Guard</li><li>F = Forward</li><li>C = Center</li><li>G-F = Guard-Forward</li><li>F-G = Forward-Guard</li><li>F-C = Forward-Center</li><li>C-F = Center-Forward</li></ul></td></tr></tbody></table>

**XML example**

```xml
<lineups matchid="6856980">
<player id="215634" name="Clean, Ian" shirtnumber="5" substitute="0" position="G" team="1"/>
<player id="801224" name="Inges, Joe" shirtnumber="7" substitute="0" position="C-F" team="1"/>
<!−−Remaining message truncated−−>
</lineups>
```

### **(ID: 163) Include players on court Basketball**

Enabling this setting will add players on court event 2237 to the Live Data XML Feed for Basketball matches if available

**XML example**

{% code overflow="wrap" %}

```xml
<event type="2237" stime="1657877049267" side="home" mtime="00:00" info="Players on court - J.Tatum, A.Horford, R.Williams, J.Brown, M.Smart" id="2170664577" uuid="bd97f3c2-3769-4051-a6b1-150328ea74d1" matchscore="0:0" remainingtimeperiod="12:00" periodnumber="1" matchstatus="NOT_STARTED" homeplayers="1141196;607754;1433761;996297;607636"/> 
```

{% endcode %}

### **(ID: 209 ) Include Substitution In/Out events in the feed**

Enabling this config will display events 2393 and 2394 - Substitution In and Substitution Out&#x20;

### **(ID: 213) Include specific contracts for basketball lineup players in the feed**&#x20;

Enabling this config will show specific contracts for players in the lineups (2-way contract an 10-day contract)

**XML example**

```xml
<lineups matchid="124210546">
<player id="607922" name="Bogdanovic, Bogdan" shirtnumber="13" substitute="false" team="1">
<specificcontracts>
<specificcontract value="2-way-contract"/>
</specificcontracts>
</player>
<player id="608170" name="Bazemore, Kent" shirtnumber="24" substitute="false" team="1">
<specificcontracts>
<specificcontract value="2-way-contract"/>
</specificcontracts>
</player>
<player id="1593946" name="Bey, Saddiq" shirtnumber="41" substitute="false" team="1">
<specificcontracts>
<specificcontract value="2-way-contract"/>
</specificcontracts>
</player>
<player id="1322540" name="Brown, Charles" shirtnumber="76" substitute="false" team="1">
<specificcontracts>
<specificcontract value="2-way-contract"/>
</specificcontracts>
</player>
<player id="996293" name="Bembry, DeAndre'" shirtnumber="95" substitute="false" team="1">
<specificcontracts>
<specificcontract value="2-way-contract"/>
</specificcontracts>
</player>
<player id="607898" name="Capela, Clint" shirtnumber="15" substitute="true" team="1"/>
<player id="1316758" name="Brown, Chaundee" shirtnumber="45" substitute="true" team="1"/>
<player id="607560" name="Carter, Vince" shirtnumber="56" substitute="true" team="1"/>
<player id="996297" name="Brown, Jaylen" shirtnumber="7" substitute="false" team="2"/>
<player id="1930078" name="Brissett, Oshae" shirtnumber="12" substitute="false" team="2"/>
<player id="996319" name="Brogdon, Malcolm" shirtnumber="13" substitute="false" team="2"/>
<player id="2218516" name="Davison, JD" shirtnumber="20" substitute="false" team="2"/>
<player id="1595370" name="Banton, Dalano" shirtnumber="45" substitute="false" team="2"/>
<player id="1169046" name="Edwards, Carsen" shirtnumber="4" substitute="true" team="2"/>
<player id="1286462" name="Fernando, Bruno" shirtnumber="28" substitute="true" team="2"/>
<player id="608288" name="Fournier, Evan" shirtnumber="94" substitute="true" team="2"/>
<player id="1829084" name="Fall, Tacko" shirtnumber="99" substitute="true" team="2"/>
</lineups>
```

### (ID: 239) Include basketball bonus attribute

Enabling this setting allows a new dynamic Bonus attribute to be sent with each event for NBA matches covered by the External Feed. This Boolean parameter is activated when one of the teams commits the 5th foul in a given quarter, triggering a bonus situation for the opposing team.

**XML example**

{% code overflow="wrap" %}

```xml
<event type="110" stime="1739328213300" side="home" mtime="34:12" info="[T1] have possession" id="2238439004" uuid="07525db7-9e76-4b32-9d42-0f6b71b5df50" matchscore="59:104" remainingtimeperiod="00:00" periodnumber="3" bonushome="1" bonusaway="0" matchstatus="THIRD_QUARTER"/> 
```

{% endcode %}

### (ID: 240) Include possible free throw events

Enabling this setting allows events 2396 (Possible free throws) and 2397 (Free throws not confirmed) to be sent for NBA matches covered by the External Feed.

### (ID: 245) Include ftvalue attribute for event 1056 Number of Free Throws

Enabling this setting allows events 1056 Number of Free Throws to be sent with a new **ftvalue attribute** for Unrivaled matches.\
New attribute **ftvalue for "Basketball Unrivaled".:**

* **1 = Free Throw is worth  1 point**&#x20;
* **2 = Free Throw is worth 2 points**
* **3 = Free Throw is worth 3 points**
* **Missing attribute - assume that FT is worth 1 point (normal basketball rules)**

<br>

In Unrivaled Basketball, the free-throw system is designed to keep the game fast-paced and simple:

* Only one free throw is awarded for shooting fouls, regardless of whether the foul occurred on a 2-point or 3-point attempt.
* The value of that single free throw depends on the shot:
  * Fouled on a 2-point attempt → 1 free throw worth 2 points
  * Fouled on a 3-point attempt → 1 free throw worth 3 points
* And-ones (when a basket is made and fouled) add 1 point.
* There are no multiple free throws like in traditional basketball; this rule is meant to keep the game flowing and avoid long stoppages.

Points in Unrivaled can be scored as:

* Inside the arc: 2 points
* Beyond the arc (three-point line): 3 points
* Free throws:
  * Fouled on a 2-point attempt → 1 free throw worth 2 points
  * Fouled on a 3-point attempt → 1 free throw worth 3 points
  * And-ones (basket made + foul) → extra 1 point


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sportradar.com/live-data/introduction/information-per-sport/basketball.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.