# eSoccer

## Match statuses in eSoccer <a href="#ldesoccer-matchstatusesinesoccer" id="ldesoccer-matchstatusesinesoccer"></a>

<table><thead><tr><th width="77.53128051757812">ID</th><th width="233.427978515625">Match status</th><th>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>6</td><td>FIRST_HALF</td><td>1st period of the match</td><td>-</td></tr><tr><td>31</td><td>HALFTIME</td><td>Match pause</td><td>-</td></tr><tr><td>7</td><td>SECOND_HALF</td><td>2nd period of the match</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>-</td></tr><tr><td>41</td><td>FIRST_HALF_OT</td><td>1st overtime period</td><td>-</td></tr><tr><td>33</td><td>OT_HALFTIME</td><td>Pause between 1st and 2nd overtime period</td><td>-</td></tr><tr><td>42</td><td>SECOND_HALF_OT</td><td>2nd overtime period</td><td>-</td></tr><tr><td>110</td><td>AFTER_OT</td><td>Match finished after overtime</td><td>-</td></tr><tr><td>34</td><td>AWAITING_PENALTIES</td><td>Wating for penalty shoot-out to start</td><td>-</td></tr><tr><td>50</td><td>PENALTY_SHOOTING</td><td>Penalty shoot-out</td><td>-</td></tr><tr><td>120</td><td>AFTER_PENALTIES</td><td>Match finished after penalty shoot-out</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>

\
Events in eSoccer
-----------------

<table><thead><tr><th width="78.28298950195312">ID</th><th width="147.420166015625">Event</th><th width="490.421875">Description</th><th width="139.1171875">Coverage</th><th>Coverage</th></tr></thead><tbody><tr><td>30</td><td>Goal</td><td>The score has changed</td><td>iScout (BC)</td><td><p>Possible values:</p><ul><li>0 = Unknown</li><li>-1 = Not specified</li><li>1 = Penalty</li><li>2 = Own goal</li><li>3 = Header</li><li>-100 = Shot</li><li>-200 = Free Kick</li></ul></td></tr><tr><td>40</td><td>Yellow card</td><td>A yellow card has been given</td><td>iScout (BC)</td><td>-</td></tr><tr><td>45</td><td>YellowRed card</td><td>A red card has been given after two yellow cards</td><td>iScout (BC)</td><td>Player who got the card</td></tr><tr><td>50</td><td>Red card</td><td>A red card has been given</td><td>iScout (BC)</td><td>-</td></tr><tr><td>60</td><td>Substitution</td><td>A player has been substituted</td><td>iScout (BC)</td><td>-</td></tr><tr><td>90</td><td>Injury time</td><td>Information about expected length of injury time.</td><td>iScout (BC)</td><td>Number of minutes injury time added</td></tr><tr><td>110</td><td>Possession</td><td>Possession change to the given team. This event needs to be enabled before it gets sent.</td><td>iScout (BC)</td><td>-</td></tr><tr><td>150</td><td>Free kick</td><td>Used when a free kick is awarded to a team. Entries are assigned to teams.</td><td>iScout (BC)</td><td><p>Possible values:</p><ul><li>0 = Not in a dangerous position</li><li>1 = Dangerous position</li></ul></td></tr><tr><td>151</td><td>Goal kick</td><td>A goal kick has been taken</td><td>iScout (BC)</td><td>-</td></tr><tr><td>152</td><td>Throw-in</td><td>A throw-in has been taken</td><td>iScout (BC)</td><td>-</td></tr><tr><td>153</td><td>Offside</td><td>An offside has been committed</td><td>iScout (BC)</td><td>-</td></tr><tr><td>154</td><td>Corner kick</td><td>A corner kick has been taken</td><td>iScout (BC)</td><td><p>What side the corner is taken from,<br>if this information is available. Possible values:</p><ul><li>0 = Corner is taken from left side of the goal</li><li>1 = Corner is taken from right side of the goal</li><li>-1 = Information is not available</li></ul></td></tr><tr><td>155</td><td>Shot on target</td><td>A shot on target</td><td>iScout (BC)</td><td>-</td></tr><tr><td>156</td><td>Shot off target</td><td>A shot off target</td><td>iScout (BC)</td><td>-</td></tr><tr><td>157</td><td>Goal keeper save</td><td>A goalkeeper has made a save</td><td>iScout (BC)</td><td>-</td></tr><tr><td>158</td><td>Injury</td><td>Injured player</td><td>iScout (BC)</td><td><p>Whether the player is still injured.<br>Possible values:</p><ul><li>1 = Player still injured</li><li>0 = Player not injured any longer</li></ul></td></tr><tr><td>161</td><td>Penalty kick</td><td>A penalty kick has been awarded</td><td>iScout (BC)</td><td>-</td></tr><tr><td>164</td><td>Weather conditions</td><td>The weather conditions at an event</td><td>iScout (BC)</td><td><p>Possible values:</p><ul><li>0 = Unknown</li><li>1 = Good</li><li>2 = Medium</li><li>3 = Bad</li><li>4 = Indoor</li><li>5 = Extreme</li></ul></td></tr><tr><td>168</td><td>Player back from injury</td><td>A player rejoins the match after receiving treatment for an injury</td><td>iScout (BC)</td><td>-</td></tr><tr><td>172</td><td>Shot blocked</td><td>Happens whenever the shot is blocked. Entries are assigned to teams.</td><td>iScout (BC)</td><td>-</td></tr><tr><td>666</td><td>Penalty missed</td><td>Used when the penalty shot is missed.</td><td>iScout (BC)</td><td>-</td></tr><tr><td>1010</td><td>Betstart</td><td>Betstart indicates that betting markets<br>can be activated. Betstart is not only a<br>pre match event but is also used during the match.</td><td>iScout (BC)</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>iScout (BC)</td><td><p>Possible values:</p><p>See betstop reason list at <a href="/pages/0kTWcyJNcKQjBeEz8hjF">LD - Betstart and Betstop</a></p></td></tr><tr><td>1012</td><td>Kick-off team</td><td>Which team will have the kick off in the match.</td><td>iScout (BC)</td><td>-</td></tr><tr><td>1013</td><td>Match status</td><td>Sent when the status of the match changes.</td><td>iScout (BC)</td><td>See the above table for all available match statuses for eSoccer.</td></tr><tr><td>1014</td><td>Pitch condition</td><td>Conditions of the pitch for the match. This event can be changed during the match if needed.</td><td>iScout (BC)</td><td><p>Possible values:</p><ul><li>0 = Unknown</li><li>1 = Good</li><li>2 = Medium</li><li>3 = Bad</li></ul></td></tr><tr><td>1015</td><td>Free text</td><td>Used for any kind of additional information during the match. Example: "<em>Match interrupted due to flood light, break downs, etc.</em>".</td><td>iScout (BC)</td><td>-</td></tr><tr><td>1016</td><td>Possible corner</td><td>Happens at the exact moment there is a corner. Entries are assigned to teams.</td><td>iScout (BC)</td><td><p>What side the corner is taken from, if this information is available. Possible values:</p><ul><li>0 = Corner is taken from left side of the goal</li><li>1 = Corner is taken from right side of the goal</li></ul></td></tr><tr><td>1017</td><td>Corner canceled</td><td>Used when possible corner is not confirmed.</td><td>iScout (BC)</td><td>-</td></tr><tr><td>1018</td><td>Possible goal</td><td>Sent either at the moment when the goal is scored, or right before the goal is scored when probability for goal is high.</td><td>iScout (BC)</td><td>-</td></tr><tr><td>1019</td><td>Goal canceled</td><td>Possible goal has been canceled</td><td>iScout (BC)</td><td><p>Possible values:</p><ul><li>0 = Unknown</li><li>-1 = Not specified</li><li>1 = Off side</li><li>2 = Foul</li><li>3 = Incorrect entry</li></ul></td></tr><tr><td>1024</td><td>Match about to start</td><td>This event is sent when both captains together with the referee are selecting which team will start the match.</td><td>iScout (BC)</td><td>-</td></tr><tr><td>1029</td><td>Dangerous attack</td><td>Dangerous attack means one team enters the "dangerous attack" zone in the opponents half.</td><td>iScout (BC)</td><td>-</td></tr><tr><td>1030</td><td>Ball safe</td><td>Used when a team has possession in their own half. Ball safe entries are assigned to teams.</td><td>iScout (BC)</td><td>-</td></tr><tr><td>1036</td><td>Time start/stop</td><td>Time is stopped or started</td><td>iScout (BC)</td><td><p>Possible value:</p><ul><li>1 = Time started</li><li>0 = Time stopped</li></ul></td></tr><tr><td>1039</td><td>Manual time adjustment</td><td>Add or remove seconds from period time, used if current time is incorrect</td><td>iScout (BC)</td><td>Number of seconds adjusted. Either a positive or a negative integer.</td></tr><tr><td>1040</td><td>Possible red card</td><td>Used when there is a strong possibility<br>of a red card. Entries are assigned to teams. Note that the possible red card could also be a possible yellow/ red card.</td><td>iScout (BC)</td><td>-</td></tr><tr><td>1041</td><td>Red card canceled</td><td>Used when possible red card is not being confirmed. Note that the canceled red card could also be a canceled yellow/ red card.</td><td>iScout (BC)</td><td>-</td></tr><tr><td>1042</td><td>Possible penalty</td><td>High chance of a penalty</td><td>iScout (BC)</td><td>-</td></tr><tr><td>1043</td><td>Canceled penalty</td><td>Used when a possible penalty is not confirmed.</td><td>iScout (BC)</td><td>-</td></tr><tr><td>1044</td><td>Delete alert</td><td>Manual removal of an event.</td><td>iScout (BC)</td><td>Id of event that was deleted.</td></tr><tr><td>1064</td><td>Play resumes after goal</td><td>Used to confirm the match has kicked off after the scored goal.</td><td>iScout (BC)</td><td>-</td></tr><tr><td>1084</td><td>Possible yellow card</td><td>Possible yellow card</td><td>iScout (BC)</td><td>-</td></tr><tr><td>1085</td><td>Canceled yellow card</td><td>Possible yellow card canceled</td><td>iScout (BC)</td><td>-</td></tr><tr><td>1091</td><td>Early betstatus</td><td>Similar to normal betstart and betstop,<br>but instead of waiting until the next kick off, the early betstarts already starts right after the goal was confirmed. This event needs to be enabled before it gets sent out.</td><td>iScout (BC)</td><td><p>Possible values:</p><ul><li>1 = Early betstart</li><li>0 = Early betstart ended</li></ul></td></tr><tr><td>1102</td><td>Coverage status</td><td>Sent when the coverage status for the match changes.</td><td>iScout (BC)</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></tr><tr><td>1126</td><td>Attack</td><td>Attack</td><td>iScout (BC)</td><td>-</td></tr></tbody></table>

<br>

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

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

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

**XML example**

{% code overflow="wrap" %}

```xml
<match t2name="FINN HARPS" t2id="14296755" t1name="COVENTRY CITY" t1id="14296723" start="1607947860000" matchid="24699454" feedtype="full" extrainfo="0" betstatus="BETSTOP" connectionstatus="0" device="4" coveredfrom="venue">
...
</match>
```

{% endcode %}

***XML elements and attributes definition***

<table><thead><tr><th width="90.157958984375">Element</th><th width="123.6649169921875">Attributes</th><th width="228.385498046875">Description</th><th>Possible values</th></tr></thead><tbody><tr><td>Match</td><td><em>extrainfo</em></td><td>Integer specifying special information for the match.</td><td><p>For consistency reasons with eSports time logic, we project usual real life playing time to game period length as follows:</p><p>Integer. Possible <strong>extrainfo</strong> values:<br><br></p></td></tr></tbody></table>

| **Format**  | **Extrainfo 0 (2 x 4 min)** | **Extrainfo 71 (2 x 6 min)** | **Extrainfo 72 (2 x 9 min)** | **Extrainfo 75 (2 x 5 min)** |
| ----------- | --------------------------- | ---------------------------- | ---------------------------- | ---------------------------- |
| 1st half    | 4 min 30 secs to 45 min     | 6 min 40 secs to 45 min      | 10 min to 45 min             | 5 min 45 sec to 45 min       |
| 2nd half    | 4 min 35 secs to 45 min     | 6 min 50 secs to 45 min      | 10 min 15 sec to 45 min      | 5 min 45 sec to 45 min       |
| 1st half OT | 1 min 55 sec to 15 min      | 3 min to 15 min              | 4 min 30 sec to 15 min       | 2 min 30 sec to 15 min       |
| 2nd half OT | 1 min 55 sec to 15 min      | 3 min to 15 min              | 4 min 30 sec to 15 min       | 2 min 30 sec to 15 min       |

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

**XML example**

```xml
<match t2name="TEAM SOCCER 2" t2id="16188780" t1name="TEAM SOCCER 1" t1id="16188778" start="1607934840000" matchid="24886486" feedtype="full" extrainfo="75" betstatus="BETSTOP" connectionstatus="0" device="4" coveredfrom="venue" var="0" st1id="759390" st2id="759392" matchtime="00:00" sportid="137" stime="1607948619335">
<status start="0" name="NOT_STARTED" id="0"/>
<score type="current" t2="0" t1="0"/>
<red t2="0" t1="0"/>
<yellow t2="0" t1="0"/>
<corners t2="0" t1="0"/>
<dangerousattacks t2="0" t1="0"/>
<attacks t2="0" t1="0"/>
<penalties t2="0" t1="0"/>
<weatherconditions name="UNKNOWN" id="0"/>
<pitchconditions name="UNKNOWN" id="0"/>
<kickoffteam team="0"/>
<events/>
<tournament name="eSoccer Test" id="97626"/>
<category name="Other" id="1534"/>
<sport name="eSoccer" id="137"/>
</match>
```

***XML elements and attributes definition***

<table><thead><tr><th width="157.5572509765625">Element</th><th width="444.4921875">Attributes</th><th width="294.2760009765625">Description</th><th>Possible values</th></tr></thead><tbody><tr><td>score</td><td></td><td>Multiple occurrences possible, each occurrence describes the amount of goals for the specified period in the match. This element always gets included in full feed, and in the delta feed for the following events: Score change (30)</td><td></td></tr><tr><td></td><td><em>t1</em></td><td>Amount of goals home team.</td><td>Integer</td></tr><tr><td></td><td><em>t2</em></td><td>Amount of goals away team.</td><td>Integer</td></tr><tr><td></td><td><em>type</em></td><td>For what period in the match the goals were scored.</td><td><p>String. Possible values:</p><ul><li>current</li><li>period1</li><li>period2</li><li>overtime1</li><li>overtime2</li><li>penalties</li></ul></td></tr><tr><td>red</td><td></td><td>This element always gets included in full feed, and in the delta feed for the following events: Red card (50) and Yellowred card (45)</td><td></td></tr><tr><td></td><td><em>t1</em></td><td>Amount of red cards home team.</td><td>Integer</td></tr><tr><td></td><td><em>t2</em></td><td>Amount of red cards away team.</td><td>Integer</td></tr><tr><td>yellow</td><td></td><td>This element always gets included in full feed, and in the delta feed for the following events: Yellow card (40)</td><td></td></tr><tr><td></td><td><em>t1</em></td><td>Amount of yellow cards home team.</td><td>Integer</td></tr><tr><td></td><td><em>t2</em></td><td>Amount of yellow cards away team.</td><td>Integer</td></tr><tr><td>corners</td><td></td><td>This element always gets included in full feed, and in the delta feed for the following events: Corner (154)</td><td></td></tr><tr><td></td><td><em>t1</em></td><td>Amount of corners home team.</td><td>Integer</td></tr><tr><td></td><td><em>t2</em></td><td>Amount of corners away team.</td><td>Integer</td></tr><tr><td>dangerousattack</td><td></td><td>This element always gets included in full feed, and in the delta feed for the following events: Dangerous attack (1029)</td><td></td></tr><tr><td></td><td><em>t1</em></td><td>Amount of dangerous attacks home team.</td><td>Integer</td></tr><tr><td></td><td><em>t2</em></td><td>Amount of dangerous attacks away team.</td><td>Integer</td></tr><tr><td>attacks</td><td></td><td>This element always gets included in full feed, and in the delta feed for the following events: Attack (1126)</td><td></td></tr><tr><td></td><td><em>t1</em></td><td>Amount of attacks home team.</td><td>Integer</td></tr><tr><td></td><td><em>t2</em></td><td>Amount of attacks away team.</td><td>Integer</td></tr><tr><td>penalties</td><td></td><td>This element always gets included in full feed, and in the delta feed for the following events: Penalty awarded (161)</td><td></td></tr><tr><td></td><td><em>t1</em></td><td>Amount of penalties home team.</td><td>Integer</td></tr><tr><td></td><td><em>t2</em></td><td>Amount of penalties away team.</td><td>Integer</td></tr><tr><td>weatherconditions</td><td></td><td>This element always gets included in full feed, and in the delta feed for the following events: Weather conditions (164)</td><td></td></tr><tr><td></td><td><em>id</em></td><td>Identifier of the weather conditions.</td><td>Integer</td></tr><tr><td></td><td><em>name</em></td><td>Textual representation of the weather conditions.</td><td><p>String. Possible combinations of idname<br>are:</p><ul><li>0 = Unknown</li><li>1 = Good</li><li>2 = Medium</li><li>3 = Bad</li><li>4 = Indoor</li></ul></td></tr><tr><td>pitchconditions</td><td></td><td>This element always gets included in full feed, and in the delta feed for the following events: Pitch conditions (1014)</td><td></td></tr><tr><td></td><td><em>id</em></td><td>Identifier for the pitch conditions.</td><td>Integer</td></tr><tr><td></td><td><em>name</em></td><td>Textual representation of the pitch conditions.</td><td><p>String. Possible combinations of idname<br>are:</p><ul><li>0 = Unknown</li><li>1 = Good</li><li>2 = Medium</li><li>3 = Bad</li></ul></td></tr><tr><td>kickoffteam</td><td></td><td>This element always gets included in full feed, and in the delta feed for the following events: Kickoff team (1012)</td><td></td></tr><tr><td></td><td><em>team</em></td><td>Which team kicked off.</td><td><p></p><p>Integer. Possible values:</p><ul><li>0 = Unknown</li><li>1 = Home</li><li>2 = Away</li></ul></td></tr></tbody></table>

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

{% code overflow="wrap" %}

```xml
<match matchid="24699454" feedtype="delta" betstatus="STARTED" connectionstatus="1">
<corners t2="0" t1="1"/>
<events>
<event type="154" stime="1607947912320" side="home" mtime="00:44" info="Corner kick [T1]" id="2166032625" uuid="e43009c6-0d0d-405a-af38-b3c33a781e74" extrainfo="0" matchscore="0:0" matchstatus="FIRST_HALF"/>
</events>
</match>

<match matchid="24699454" feedtype="delta" betstatus="STARTED" connectionstatus="1">
<yellow t2="1" t1="0"/>
<events>
<event type="40" stime="1607947969569" side="away" mtime="10:16" info="Yellow card [T2]" id="2166032647" uuid="d396b279-672a-4d84-89a9-94439b7f1f02" matchscore="1:0" matchstatus="FIRST_HALF"/>
</events>
</match>
```

{% endcode %}

***XML attributes definition***

<table><thead><tr><th width="132.1796875">Element</th><th width="189.56427001953125">Attributes</th><th width="361.1475830078125">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 pitch, posx being a number from 0 to 100. The reference point 0 is at home teams goal.</td><td>Number</td></tr><tr><td></td><td><em>posy</em></td><td>Vertical position on pitch , posy being a number from 0 to 100. The reference point 0 is on top of pitch when home teams goal is on the left hand side.</td><td>Number</td></tr><tr><td></td><td><em>automatic</em></td><td>Whether the booking markets were disabled automatically or manually. This attribute only gets added for "disable XXX market" events.</td><td><p>Integer. Possible values:</p><ul><li>1 = Markets got disabled automatically.</li><li>0 = Markets got disabled manually.</li></ul></td></tr><tr><td></td><td><em>matchscore</em></td><td>Score for current match.</td><td><p>String. Format: "[home]:[away]"</p><p>Example: "1:0"</p></td></tr><tr><td></td><td><em>mtime</em></td><td>The matchtime when the event happened. Note that injury time is added in case the event happened during injury time.</td><td>String. Format:<br>MM:SS +M:SS<br>Example:<br>70:12 (no injury time)<br>45:00 +1:32 (injury time)</td></tr></tbody></table>

## XML configurations <a href="#ldesoccer-xmlconfigurations" id="ldesoccer-xmlconfigurations"></a>

Please note that eSoccer uses the same Live Data XML Feed Configs as specified in [Soccer](/live-data/introduction/information-per-sport/soccer.md) (not all will have an effect on eSoccer data output).


---

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