# Sport Event Status

### **Sport\_event\_status Element** <a href="#uofsporteventstatus-sport_event_statuselement" id="uofsporteventstatus-sport_event_statuselement"></a>

The element `sport_event_status` is provided in the odds\_change message. *Status* is the only required attribute for this element, and this attribute describes the current status of the sport-event itself (not started, live, ended, closed).&#x20;

Additional attributes are live-only attributes, and only provided while the match is live; additionally, which attributes are provided depends on the sport.&#x20;

<details>

<summary>The following table lists the various attributes and their meaning:</summary>

<table><thead><tr><th valign="top">Attribute name</th><th valign="top">Description</th><th>Format/Values</th><th valign="top">Sports</th></tr></thead><tbody><tr><td valign="top">status (<mark style="color:red;"><strong>Required</strong></mark>)</td><td valign="top">High-level generic status of the match</td><td><ul><li><code>0 (not started)</code><br></li><li><code>1 (live)</code></li><li><code>2 (suspended) - </code><em><code>Used by the Premium Cricket odds producer</code></em></li><li><code>3 (ended)</code></li><li><code>4 (closed)</code></li></ul><p>Only one of the above statuses are possible in the <em>odds_change</em> message in the feed. However please note that other states are available in the API, but will not appear in the <em>odds_change</em> message. These are as following:</p><ul><li><code>5 (cancelled)</code></li><li><code>6 (delayed)</code></li><li><code>7 (interrupted)</code></li><li><code>8 (postponed)</code></li><li><code>9 (abandoned)</code></li></ul></td><td valign="top">All</td></tr><tr><td valign="top">reporting</td><td valign="top">Does Betradar have a scout watching the game</td><td><ul><li><code>active (1)</code></li><li><code>suspended (-1)</code></li><li><code>not available (0)</code> - only present when status = live or suspended</li></ul></td><td valign="top">All</td></tr><tr><td valign="top">home_score</td><td valign="top">Current score for the home team</td><td>Number</td><td valign="top">All match sports</td></tr><tr><td valign="top">away_score</td><td valign="top">Current score for the away team</td><td>Number</td><td valign="top">All match sports</td></tr><tr><td valign="top">match_status</td><td valign="top">Sports-specific integer code the represents the live match status (first period, 2nd break, etc.)</td><td>See the <a href="/pages/2RJmFp1rX8C3EOSfOQ1W">sport event information</a> section.</td><td valign="top">All </td></tr><tr><td valign="top">current_server</td><td valign="top">The player who has the serve at that moment</td><td><p>1 or 2</p><ul><li>1 for team/player 1 (home),</li><li>2 for team/player 2 (away)</li></ul></td><td valign="top">Tennis, Table Tennis</td></tr><tr><td valign="top">home_gamescore</td><td valign="top">The point score of the "home" player. The score will be 50 if the "home" player has advantage. This attribute is also used for the tiebreak score when the game is in a tiebreak.</td><td>Number (15 30 40 50)  </td><td valign="top">Tennis</td></tr><tr><td valign="top">home_penalty_score</td><td valign="top">Home team penalty score</td><td><p>Number > 0</p><p>In the event of a game being decided by a penalty shootout, then the goal will be added to the winning team’s score (and game total) for settlement purposes.</p></td><td valign="top">Ice hockey</td></tr><tr><td valign="top">away_penalty_score</td><td valign="top">Away team penalty score</td><td><p>Number > 0</p><p>In the event of a game being decided by a penalty shootout, then the goal will be added to the winning team’s score (and game total) for settlement purposes.</p></td><td valign="top">Ice hockey</td></tr><tr><td valign="top">away_gamescore</td><td valign="top">The point score of the "away" player. The score will be 50 if the "away" player has advantage. This attribute is also used for the tiebreak score when the game is in a tiebreak</td><td>Number</td><td valign="top">Tennis</td></tr><tr><td valign="top">tiebreak</td><td valign="top">Whether a match is in a tiebreak.</td><td>true (only present if tie-break)</td><td valign="top">Tennis</td></tr><tr><td valign="top">expedite_mode</td><td valign="top">Whether the expedite system is in operation or not.</td><td>true or false</td><td valign="top">Table Tennis</td></tr><tr><td valign="top">home_suspend</td><td valign="top">The amount of suspensions for the home team.</td><td>Int</td><td valign="top">Ice Hockey, Handball, Futsal</td></tr><tr><td valign="top">away_suspend</td><td valign="top">The amount of suspension for the away team</td><td>Int</td><td valign="top">Ice Hockey, Handball, Futsal</td></tr><tr><td valign="top">strikes</td><td valign="top">Number of strikes for the current batter</td><td>number 0..2</td><td valign="top">Baseball</td></tr><tr><td valign="top">balls</td><td valign="top">Number of balls for the current batter</td><td>number 0..3</td><td valign="top">Baseball</td></tr><tr><td valign="top">outs</td><td valign="top">Number of outs for the current batter</td><td>number 0..2</td><td valign="top">Baseball</td></tr><tr><td valign="top">bases</td><td valign="top">Indicates which bases are occupied</td><td>number 0 or 1</td><td valign="top">Baseball</td></tr><tr><td valign="top">home_batter</td><td valign="top">Current batter for the home team</td><td>Int</td><td valign="top">Baseball</td></tr><tr><td valign="top">away_batter</td><td valign="top">Current batter for the away team</td><td>Int</td><td valign="top">Baseball</td></tr><tr><td valign="top">possession</td><td valign="top">The team that has the ball</td><td>1 (home) or 2 (away)</td><td valign="top">American Football</td></tr><tr><td valign="top">try</td><td valign="top">Try number, it’s the current "down" until reaching the 10 yards if defined</td><td>Int</td><td valign="top">American Football</td></tr><tr><td valign="top">yards</td><td valign="top">Yards until first down. How many yards down in this drive (a series of offensive plays)</td><td>Int</td><td valign="top">American Football</td></tr><tr><td valign="top">position</td><td valign="top">Ball position will be sent as x yards to go till opponent’s end zone for the team in possession</td><td>Int</td><td valign="top">American Football</td></tr><tr><td valign="top">visit</td><td valign="top">Which player is currently visiting</td><td>1 (home) or 2 (away) (absence undefined)</td><td valign="top">Snooker</td></tr><tr><td valign="top">remaining_reds</td><td valign="top">Number of remaining red balls</td><td>number</td><td valign="top">Snooker</td></tr><tr><td valign="top">home_legscore</td><td valign="top">The home player score at any given leg whether one game or during a match</td><td>number</td><td valign="top">Darts</td></tr><tr><td valign="top">away_legscore</td><td valign="top">The away player score at any given leg whether one game or during a match</td><td>number</td><td valign="top">Darts</td></tr><tr><td valign="top">throw</td><td valign="top">The player who had the first throw for the current leg</td><td>1 (home) or 2 (away)</td><td valign="top">Darts</td></tr><tr><td valign="top">visit</td><td valign="top">The player visiting the board</td><td>1 (home) or 2 (away)</td><td valign="top">Darts</td></tr><tr><td valign="top">delivery</td><td valign="top">The player who will deliver the next bowl</td><td>1 (home) or 2 (away)</td><td valign="top">Bowls</td></tr><tr><td valign="top">home_remaining_bowls</td><td valign="top">The remaining number of bowls for the home team</td><td>number >= 0</td><td valign="top">Bowls</td></tr><tr><td valign="top">away_remaning_bowls</td><td valign="top">The remaining number of bowls for the away team</td><td>number >= 0</td><td valign="top">Bowls</td></tr><tr><td valign="top">current_end</td><td valign="top">The current end/period in a set of the game</td><td>Int</td><td valign="top">Bowls</td></tr><tr><td valign="top">home_dismissals</td><td valign="top">The number of dismissals during the current inning for the home team</td><td>Int</td><td valign="top">Cricket</td></tr><tr><td valign="top">away_dismissals</td><td valign="top">The number of dismissals during the current inning for the away team</td><td>Int</td><td valign="top">Cricket</td></tr><tr><td valign="top">home_penalty_runs</td><td valign="top">The number of penalty runs awarded to the home team during an over</td><td>Int</td><td valign="top">Cricket (not available in Premium Cricket)</td></tr><tr><td valign="top">away_penalty_runs</td><td valign="top">The number of penalty runs awarded to the away team during an over</td><td>Int</td><td valign="top">Cricket (not available in Premium Cricket)</td></tr><tr><td valign="top">innings</td><td valign="top">What innings it is</td><td><p>number > 0</p><p>Note that the second innings can also be superover.</p></td><td valign="top">Cricket</td></tr><tr><td valign="top">over</td><td valign="top">What over in the inning it is</td><td><p>number > 0</p><p>The first over will have value 1, please note this is different from the Cricket convention which would start counting at zero</p></td><td valign="top">Cricket</td></tr><tr><td valign="top">delivery</td><td valign="top">Which ball in the over it is</td><td>number 1..6</td><td valign="top">Cricket</td></tr><tr><td valign="top">current_ct_team</td><td valign="top">Which team is playing counter terrorists (1 = home, 2=away)</td><td>Number 1..2</td><td valign="top">CS:GO</td></tr><tr><td valign="top">results</td><td valign="top"><p>An XML example of how Results are displayed in the feed are available <a href="/pages/YTWqEbHq3PdsQtPXUJtr">below</a></p><p><br></p></td><td><p>Contains the &#x3C;result> element.</p><ul><li>match_status_code: Integer (i.e. "100")</li><li>home_score: Decimal indicating the home score (i.e. "2")</li><li>away_score: Decimal indicating the away score (i.e. "3")</li></ul></td><td valign="top">All</td></tr><tr><td valign="top"></td><td valign="top"></td><td></td><td valign="top"></td></tr></tbody></table>

</details>

**XML Example**

```xml
<sport_event_status away_score="0" home_score="0" match_status="13" reporting="1" status="1"> </sport_event_status>
```

**\<results> elements in the feed**

```xml
<odds_change product="1" event_id="sr:match:18233409" timestamp="1568082413409">
 <sport_event_status status="3" match_status="100" home_score="1" away_score="0">
   <period_scores>
     <period_score match_status_code="6" number="1" home_score="1" away_score="0"/>
     <period_score match_status_code="7" number="2" home_score="0" away_score="0"/>
   </period_scores>
   <results>
     <result match_status_code="100" home_score="1" away_score="0"/>
   </results>
   <statistics>
     <yellow_cards home="3" away="3"/>
     <red_cards home="0" away="0"/>
     <yellow_red_cards home="0" away="0"/>
     <corners home="1" away="2"/>
   </statistics>
 </sport_event_status>
</odds_change>
```

***

### 'Clock' element in sport\_event\_status

The sport\_event\_status may contain a clock element. This clock element includes various clock/time attributes that are sports specific. The following table lists these attributes.

| Element name                | Description                                                                                                                                                                                       | Format/example | Sports                                                                                                                                           |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| match\_time                 | <p>The playing minute of the match (or minute:second if available).</p><p><em>Also, please note that match\_time is also sent based on live coverage of the match for the selected sport</em></p> | mm:ss (42:10)  | Soccer, Basketball, Ice Hockey, Handball, Rugby, Aussie rules, Football, Field Hockey, Futsal, eSoccer, eBasketBall, Basketball 3x3, eIce Hockey |
| stoppage\_time              | How far into stoppage time is the match in minutes                                                                                                                                                | mm:ss          | Soccer                                                                                                                                           |
| stoppage\_time\_announced   | Set to what the announce stoppage time is                                                                                                                                                         | mm:ss          | Soccer                                                                                                                                           |
| remaining\_time             | How many minutes remains of the match                                                                                                                                                             | mm:ss          | Basketball, eBasketball, Handball, Hockey, e- Ice Hockey, Soccer, eSoccer, Football, Aussie Rules, Field Hockey, Futsal, Basketball 3X3          |
| remaining\_time\_in\_period | How much time remains in the current period                                                                                                                                                       | mm:ss          | Basketball, eBasketball, Handball, Hockey, e- Ice Hockey, Soccer, eSoccer, Football, Aussie Rules, Field Hockey, Futsal, Basketball 3X3          |
| stopped                     | true if the match clock is stopped otherwise false                                                                                                                                                | True or False  | Ice Hockey, Basketball, Futsal, Handball                                                                                                         |

**XML example**

```xml
<sport_event_status match_status="1st half" away_score="0" away_suspend="0" home_score="6" home_suspend="0" match_status="6" reporting="1" status="1">
         
        <clock match_time="3:56" remaining_time="56:04" remaining_time_in_period="26:04" stopped="true"/>       
         
        <period_scores>          
            <period_score away_score="0" home_score="6" match_status_code="6" number="1"/>       
        </period_scores>
</sport_event_status>
```

***

### Period\_scores' in sport\_event\_status

In the *sport\_event\_status* element you can find the *period\_scores* element that lists the individual period scores for a match. "Period" is a generic name for the sport-specific equivalent, so in soccer the 1<sup>st</sup> half, 2<sup>nd</sup> half, overtime and penalties are periods. In basketball the periods are the basketball quarters and in tennis it is the tennis sets, etc.

The period\_scores element has a variable number of period\_score sub-elements depending on how many periods this particular match had/currently has.

<figure><img src="/files/XYKqYCmRq7NYiry8Lqfp" alt=""><figcaption></figcaption></figure>

*Each period\_score has the following attributes*:

| Attribute           | Description                                                                                                                                                                                                          |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| home\_score         | The number of points/goals/games the competitor designated as "home" has scored for this period.                                                                                                                     |
| away\_score         | The number of points/goals/games the competitor designated as "away" has scored for this period.                                                                                                                     |
| number              | Indicates what regular period this is.                                                                                                                                                                               |
| match\_status\_code | Provides a match\_status\_code that can be used to find a descriptive/display friendly name for this period (see [match\_status](/uof/api-and-structure/api/betting-descriptions/match-status.md) for more details). |
| type                | Provides information about what type of period the scores were made.                                                                                                                                                 |

Period\_scores are available both in the Sports API where available, and in odds\_change messages for live odds (games that are live). Whether there is a period\_scores attribute depends on the coverage level of the match, and if we don’t have period level coverage, no period\_scores will be available.

**XML example**

```xml
<sport_event_status status="closed" match_status="ended" home_score="2" away_score="2" status_code="4" match_status_code="100">
    <period_scores>
        <period_score home_score="2" away_score="2" type="regular_period" number="1" match_status_code="6"/>
        <period_score home_score="0" away_score="0" type="regular_period" number="2" match_status_code="7"/>
    </period_scores>
</sport_event_status>
```

***

### Statistics' element in the sport\_event\_status

There is a statistics element within the sport\_event\_status that list the most common statistics as counters for both home and away team:

**XML example**

```xml
<statistics>
  <yellow_cards home="1" away="0"/>
  <red_cards home="0" away="0"/>
  <yellow_red_cards home="0" away="0"/>
  <corners home="2" away="3"/>
</statistics>
 
 
Green cards are also supported
 
 
<statistics>
  <yellow_cards away="1" home="0"/>
  <red_cards away="1" home="1"/>
  <green_cards away="1" home="0"/>
</statistics>
```

| Element Name       | Description                                                                           |
| ------------------ | ------------------------------------------------------------------------------------- |
| corners            | Number of corners for the team                                                        |
| green\_cards       | Number of green cards for the team (home or away)                                     |
| red\_cards         | Number of red cards for the team (home or away)                                       |
| yellow\_cards      | Number of yellow cards for the team (home or away)                                    |
| yellow\_red\_cards | Number of red cards as a result of a previous yellow card for the team (home or away) |

### Tries' element in the sport\_event\_status

Number of tries in regular time for rugby matches

{% hint style="info" %}
**Note:**

This is a sub-element.
{% endhint %}

**XML Example**

```
<sport_event_status status="3" match_status="100" home_score="23" away_score="11">
    <period_scores>
      <period_score match_status_code="6" number="1" home_score="6" away_score="5"/>
      <period_score match_status_code="7" number="2" home_score="17" away_score="6"/>
    </period_scores>
    <statistics>
      <tries home="2" away="1"/>
    </statistics>
  </sport_event_status>
```


---

# 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/uof/data-and-features/messages/event/odds-change/sport-event-status.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.
