# Snooker

## Match statuses for snooker <a href="#ldsnooker-matchstatusesforsnooker" id="ldsnooker-matchstatusesforsnooker"></a>

<table data-full-width="true"><thead><tr><th width="67.22393798828125">Id</th><th width="164.53558349609375">Match status</th><th width="435.7882080078125">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>21</td><td>IN_PROGRESS</td><td>The match is in progress</td><td>-</td></tr><tr><td>30</td><td>PAUSE</td><td>The match is paused</td><td>-</td></tr><tr><td>445</td><td>SESSION_BREAK</td><td>Session break</td><td>-</td></tr><tr><td>100</td><td>ENDED</td><td>The match has ended</td><td>-</td></tr><tr><td>93</td><td>WALKOVER1</td><td>The home team won the match by walkover</td><td>-</td></tr><tr><td>94</td><td>WALKOVER2</td><td>The away team won the match by walkover</td><td>-</td></tr><tr><td>95</td><td>RETIRED1</td><td>The away team won because the home team retired</td><td>-</td></tr><tr><td>96</td><td>RETIRED2</td><td>The home team won because the away team retired</td><td>-</td></tr><tr><td>97</td><td>DEFAULTED1</td><td>The away team won because the home team defaulted</td><td>This match status is only sent if the corresponding XML configuration is enabled.</td></tr><tr><td>98</td><td>DEFAULTED2</td><td>The home team won because the away team defaulted</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>

<br>

## Events in snooker <a href="#ldsnooker-eventsinsnooker" id="ldsnooker-eventsinsnooker"></a>

<table data-full-width="true"><thead><tr><th width="67.615478515625">ID</th><th width="134.3984375">Event</th><th width="373.5001220703125">Description</th><th width="96.3194580078125">Coverage</th><th width="198.4296875">extrainfo</th><th>extrainfosnooker</th></tr></thead><tbody><tr><td> 110</td><td>Player at table</td><td>Information about which player is at the table.</td><td>XSA (DC)</td><td>-</td><td>-</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>XSA (DC)</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>XSA (DC)</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>XSA (DC)</td><td>See the above table for available match statuses in snooker</td><td>-</td></tr><tr><td>1015</td><td>Free text</td><td>Used for any kind of additional information during the match. Example: "Match interrupted due to flood light break down", etc..</td><td>XSA (DC)</td><td>-</td><td>-</td></tr><tr><td> 1022</td><td>Who will strike first</td><td>Information about what player has the first strike.</td><td>XSA (DC)</td><td>-</td><td>-</td></tr><tr><td>1036</td><td>Time start / stop</td><td>Triggered when the clock is started or stopped.</td><td>XSA (DC)</td><td><p>Possible values:</p><ul><li>1 = Time started</li><li>0 = Time stopped</li></ul></td><td>-</td></tr><tr><td>1044</td><td>Deleted event alert</td><td><p>Manual removal of an event.</p><p><br></p></td><td>XSA (DC)</td><td>Id of event that was deleted</td><td>-</td></tr><tr><td>1102</td><td>Coverage status</td><td> Sent when the coverage status for the match changes</td><td>XSA (DC)</td><td><p>Possible values:</p><ul><li>0 = Covered</li><li>1 = Coverage abandoned</li><li>2 = Match will not be covered</li></ul></td><td>-</td></tr><tr><td>1136</td><td>Best of frames</td><td>Best of frames</td><td>XSA (DC)</td><td>Number of frames</td><td>Number of red balls.</td></tr><tr><td>1137</td><td>Snooker score change</td><td>Sent when the score in the snooker match changes</td><td>XSA (DC)</td><td><p>Snooker score change type. Possible values:</p><ul><li>0 = Standard</li><li>1 = Break</li><li>2 = Frame</li><li>3 = Session</li><li>4 = Match</li></ul></td><td><p>Type of frame win (this attribute is only relevant for score change frame). Possible values:</p><ul><li>0 = Standard</li><li>1 = Late opponent</li><li>2 = Technical problem</li><li>3 = Three fouls missed</li><li>4 = Opponent concedes</li><li>5 = Ungentlemanly conduct</li><li>6 = Other</li></ul></td></tr><tr><td>1139</td><td>Unscheduled break</td><td>Sent when an unscheduled break happens.</td><td>XSA (DC)</td><td><p>Reason for break. Possible values:</p><ul><li>0 = Other reason</li><li>1 = Technical problem</li><li>2 = Player injury</li><li>3 = Match pulled off</li></ul></td><td>-</td></tr><tr><td>1169</td><td>Ball pot</td><td>Ball pot</td><td>XSA (DC)</td><td>Points scored</td><td>Number of red balls on the table.</td></tr><tr><td>1170</td><td>Free ball</td><td><p>Free ball event</p><p><br></p></td><td>XSA (DC)</td><td>Points scored</td><td>-</td></tr><tr><td>1171</td><td>Snooker foul</td><td><p>Snooker foul event occurs</p><p><br></p></td><td>XSA (DC)</td><td>Points scored</td><td>-</td></tr><tr><td>1173</td><td>Rerack</td><td><p>Used when the balls on the table are being reracked</p><p><br></p></td><td>XSA (DC)</td><td>-</td><td>-</td></tr><tr><td>1174</td><td>Remove ball</td><td><p>Ball removed in snooker<br></p><p><br></p></td><td>XSA (DC)</td><td>Number of red balls left on the table.</td><td>Least valuable color left on table.</td></tr><tr><td>1175  </td><td>Add ball</td><td><p>Ball added in snooker<br></p><p><br></p></td><td>XSA (DC)</td><td>Number of red balls left on the table.</td><td>Least valuable color left on table.</td></tr><tr><td>1186</td><td>Table ready</td><td>Snooker table is ready</td><td>XSA (DC)</td><td>-</td><td>-</td></tr><tr><td> 1187</td><td>Play about to start</td><td>Sent when the play will (re)start in a couple of minutes.</td><td>XSA (DC)</td><td>-</td><td>-</td></tr><tr><td>1203</td><td>Free ball awarded</td><td>Free ball has been awarded to player</td><td>XSA (DC)</td><td>-</td><td>-</td></tr><tr><td>2349</td><td>Shot Taken</td><td>Information that the player has taken a shot and the balls are in motion.</td><td>XSA (DC)</td><td><ul><li>description: equipment in use</li><li><p>values:</p><ul><li>0 = none</li><li>1 = equipment in use</li></ul></li></ul></td><td>-</td></tr><tr><td>2350</td><td>Shot Ended</td><td>Sent after Shot Taken, indicates that all the balls have stopped.</td><td>XSA (DC)</td><td>-</td><td>-</td></tr><tr><td>2351</td><td>Shot To Be Retaken</td><td>Information that shot needs to be retaken by the player after a foul and a miss. The '2357 Snooker' event is sent afterwards.<br></td><td>XSA (DC)</td><td>-</td><td>-</td></tr><tr><td>2354</td><td>Warning</td><td>Information about a verbal warning form the referee.<br></td><td>XSA (DC)</td><td><ul><li>description: warning reason</li><li><p>values:</p><ul><li>0 = unknown</li><li>1 = second miss with a clear sight of the ball</li><li>2 = disciplinary</li></ul></li></ul></td><td>-</td></tr><tr><td>2355</td><td>Re-spotted Black</td><td>Information about the re-spotted black event to resolve a tie in a frame.</td><td>XSA (DC)</td><td>-</td><td>-</td></tr><tr><td>2356</td><td>Possible Snooker</td><td>Information about a possible snooker in the current position.<br></td><td>XSA (DC)</td><td><p>-</p><p><strong>side</strong></p><ul><li>description: snookered player</li><li>values:</li><li><p></p><ul><li>home</li><li>away</li></ul></li></ul></td><td>-</td></tr><tr><td>2357</td><td>Snooker</td><td>Information about a snooker. Per official definition: "The cue-ball is snookered when a direct stroke in a straight line to every ball on is wholly or partially obstructed by a ball or balls not on. If one or more balls on can be hit at both extreme edges free of obstruction by any ball not on, the cue-ball is not snookered."<br>Player can be considered to be snookered until the next '<em>2359 Shot Taken</em>' event is sent.</td><td>XSA (DC)</td><td><p>-</p><p><strong>side</strong></p><ul><li>description: snookered player</li><li>values:</li><li><p></p><ul><li>home</li><li>away</li></ul></li></ul></td><td>-</td></tr><tr><td>2358</td><td>Snooker Not Confirmed</td><td>Possible snooker not confirmed. <br></td><td>XSA (DC)</td><td><p>-</p><p><strong>side</strong></p><ul><li>description: snookered player</li><li>values:</li><li><p></p><ul><li>home</li><li>away</li></ul></li></ul></td><td>-</td></tr></tbody></table>

<br>

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

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

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

{% code overflow="wrap" %}

```xml
<match betstatus="BETSTOP" connectionstatus="0" device="3" extrainfo="0" feedtype="full" matchid="10115538" matchtime="0:00:00" st1id="
25061" st2id="22433" start="1464869040000" t1id="1308930" t1name="TRUMP, JUDD" t2id="1308934" t2name="BINGHAM, STUART"
timerunning="0">
...
</match>
```

{% endcode %}

**XML elements and attributes definition**

<table data-full-width="true"><thead><tr><th width="137.5364990234375">Element</th><th width="185.56329345703125">Attributes</th><th width="490.875732421875">Description</th><th>Possible values</th></tr></thead><tbody><tr><td>Match</td><td><em>firstserve</em></td><td>Which player has first serve of match.</td><td>Integer</td></tr><tr><td></td><td><em>numberofsets</em></td><td>How many sets are being played in the match.</td><td>Integer</td></tr></tbody></table>

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

{% code overflow="wrap" %}

```xml
<match betstatus="BETSTOP" connectionstatus="0" device="3" extrainfo="0" feedtype="full" matchid="10115538" matchtime="0:00:00" st1id="
25061" st2id="22433" start="1464869040000" t1id="1308930" t1name="TRUMP, JUDD" t2id="1308934" t2name="BINGHAM, STUART"
timerunning="0">
<status id="0" name="NOT_STARTED" start="0"/>
<score t1="0" t2="0" type="match"/>
<score t1="0" t2="0" type="frame"/>
<score t1="0" t2="0" type="break"/>
<possession team="home"/>
<tournament id="11830" name="Premier Snooker League, Final round"/>
<category id="193" name="England"/>
<sport id="19" name="Snooker"/>
<events/>
</match>
```

{% endcode %}

**XML elements and attributes definition**

<table data-full-width="true"><thead><tr><th width="110.8914794921875">Element</th><th width="260.2882080078125">Attributes</th><th width="723.6129760742188">Description</th><th>Possible values</th></tr></thead><tbody><tr><td>score</td><td></td><td><p>Multiple occurrences possible, each occurrence describes the amount of points for the specified period in the match. This element always gets included in full feed, and in the delta feed for the following events:</p><p>Ball pot (1169), Free ball (1170), Snooker foul (1171), Snooker score change (1137), Rerack (1173)</p></td><td></td></tr><tr><td></td><td><em>t1</em></td><td>Amount of points home team.</td><td>Integer</td></tr><tr><td></td><td><em>t2</em></td><td>Amount of points away team.</td><td>Integer</td></tr><tr><td></td><td><em>type</em></td><td>For what period in the match the points were scored.</td><td><p>String. Possible values:</p><ul><li>match</li><li>frame</li><li>frame1</li><li>frame2</li><li>...</li><li>frame 34</li><li>frame35</li><li>break</li></ul></td></tr><tr><td>possession</td><td><p></p><p><br></p></td><td>This element always gets included in full feed (DC matches only), and in the delta feed (DC matches only) for the following events: Possession (110)</td><td></td></tr><tr><td></td><td><em>team</em></td><td>Which team has possession.</td><td><p>String. Possible values:</p><ul><li>"home"</li><li>"away"</li></ul></td></tr></tbody></table>

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

{% code overflow="wrap" %}

```xml
<match matchid="9474387" ... >
<events>
<event breakscore="0:57" extrainfo="7" extrainfosnooker="7" framenumber="7" framescore="0:61" id="644572117" info="7 points (Black)"
matchscore="3:3" mtime="2:17:32" side="away" stime="1464953573333" type="1169"/>
</events>
</match>
```

{% endcode %}

**XML attributes definition**

{% code overflow="wrap" %}

```xml
<match matchid="9474387" ... >
<events>
<event breakscore="0:57" extrainfo="7" extrainfosnooker="7" framenumber="7" framescore="0:61" id="644572117" info="7 points (Black)"
matchscore="3:3" mtime="2:17:32" side="away" stime="1464953573333" type="1169"/>
</events>
</match>
```

{% endcode %}

<table data-full-width="true"><thead><tr><th width="153.05987548828125">Element</th><th width="165.5833740234375">Attributes</th><th width="575.236083984375">Description</th><th width="693.654541015625">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>extrainfosnooker</em></td><td>Attribute containing additional information about the event.</td><td>String</td></tr><tr><td></td><td><em>matchscore</em></td><td>Score for current match.</td><td>String. Format: "[home]:[away]" Example: "1:0"</td></tr><tr><td></td><td><em>framenumber</em></td><td>Frame number in the match.</td><td>Integer</td></tr><tr><td></td><td><em>framescore</em></td><td>Frame score.</td><td>String. Format: "[home]:[away]" Example: "1:0"</td></tr><tr><td></td><td><em>breakscore</em></td><td>Break score.</td><td>String. Format: "[home]:[away]" Example: "1:0"</td></tr><tr><td></td><td><em>maxbreakframe</em></td><td>Highest break in the current frame.</td><td>Integer</td></tr><tr><td></td><td><em>maxbreakmatch</em></td><td>Highest break in the current match.</td><td>Integer</td></tr><tr><td></td><td><em>reds</em></td><td>Number of Reds remaining on the table.</td><td>Integer</td></tr><tr><td></td><td><em>pointsremaining</em></td><td>Points remaining on the table.</td><td>Integer</td></tr><tr><td></td><td><em>pointsuntilsnookerneeded</em></td><td>Points until snooker is needed to win the frame.</td><td>Integer</td></tr><tr><td></td><td><em>possiblebreak</em></td><td>Highest possible break in the current situation.</td><td>Integer</td></tr></tbody></table>

## **XML configurations for snooker** <a href="#ldsnooker-xmlconfigurationsforsnooker" id="ldsnooker-xmlconfigurationsforsnooker"></a>

### **(ID: 121) Include match status defaulted in snooker**

Enabling this setting will allow the system to send match statuses DEFAULTED1 and DEFAULTED2.


---

# 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/snooker.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.