# Fixture end point

The fixture end point provides a set of information related to a match/fixture.

In order to call the end point for a specific match, the id of the match must be inserted in the call as per following example:

[api.betradar.com/v1/sports/en/sport\_events/sr:match:19096428/fixture.xml](http://api.betradar.com/v1/sports/en/sport_events/sr:match:19096428/fixture.xml)

Main elements  and sub elements provided by the Fixture end points are the ones shown in list below:

* fixture
* tournament\_round
* season
* tournament
  * sport
  * category 
* competitors
  * competitor
    * reference\_ids
      * reference\_id
* venue
* tv\_channels
  * tv\_channel
* extra\_info
  * info
* coverage\_info
  * coverage
* product\_info
  * is\_in\_live\_score
  * is\_in\_hosted\_statistics
  * links
* scheduled\_start\_time\_changes
  * scheduled\_start\_time\_change

**Fixture element (fixture)**

Here follow some examples of the Fixture elements in the Fixture end point for different sports:

\<fixture id="sr:match:19096428" scheduled="2019-10-23T00:00:00+00:00" start\_time\_tbd="false"\
status="closed" next\_live\_time="2019-10-23T00:00:00+00:00" liveodds="not\_available"\
start\_time="2019-10-23T00:00:00+00:00" start\_time\_confirmed="true">

\<fixture id="sr:match:20521207" scheduled="2021-06-11T19:00:00+00:00" start\_time\_tbd="false"\
status="not\_started" next\_live\_time="2021-06-11T19:00:00+00:00" liveodds="not\_available"\
start\_time="2021-06-11T19:00:00+00:00" start\_time\_confirmed="true">

\<fixture id="sr:match:22440133" scheduled="2020-06-25T08:30:00+00:00" start\_time\_tbd="false"\
status="closed" next\_live\_time="2020-06-25T08:30:00+00:00" liveodds="not\_available"\
start\_time="2020-06-25T08:30:00+00:00" start\_time\_confirmed="true">

Table below shows the list and meaning of attributes in the Fixture element (in red in the first example above):&#x20;

| Attribute              | Meaning                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Possible values                                                                                                                                                                                                        |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id                     | Unique identifier of the event                                                                                                                                                                                                                                                                                                                                                                                                                                | <p>Numeric string</p><p>Example:</p><ul><li>id = "sr:match:19096428"</li></ul>                                                                                                                                         |
| scheduled              | When the specific match will start                                                                                                                                                                                                                                                                                                                                                                                                                            | <p>Date </p><p>Example:</p><ul><li>scheduled ="2019-10-23T00:00:00+00:00"</li></ul>                                                                                                                                    |
| start\_time\_tbd       | Specifies if the starting time is confirmed or not                                                                                                                                                                                                                                                                                                                                                                                                            | <ul><li>True</li><li>False</li></ul>                                                                                                                                                                                   |
| status                 | <p>Indicates whether this match is not started yet, live, or finished When it is ended, the results may not have been fully confirmed yet. When it is closed Betradar has confirmed the results.</p><p><strong>Note</strong>: The event "match\_about\_to\_start" in an indication that a given match/game will start shortly (within 5 minutes). This is sent manually by scouts. It does not trigger a betstop or has any special parameters per sport.</p> | <ul><li>"not\_started"</li><li>"live"</li><li>"ended"</li><li>"closed"</li><li>“cancelled"</li><li>“postponed”</li><li>“suspended”</li><li>“interrupted”</li><li>“delayed”</li><li>"match\_about\_to\_start"</li></ul> |
| next\_live\_time       | <p>When live odds should be offered next time i.e. start of the match or when a match will start again after suspension.</p><p><em>Please note that this attribute is only sent when next\_live\_time is different from start\_time.</em></p><p>At this point the customer will typically receive an Odds Change message with \<sport\_event\_status reporting="1"></p>                                                                                       | <p>Date </p><p>Example:</p><ul><li>scheduled ="2019-10-23T00:00:00+00:00"</li></ul><p><br></p>                                                                                                                         |
| liveodds               | <p>Indicates whether this match is booked by the customer for livecoverage.</p><p><br></p>                                                                                                                                                                                                                                                                                                                                                                    | <ul><li>“booked”</li><li>“bookable”</li><li>“buyable”</li><li>“not\_available”</li></ul>                                                                                                                               |
| start\_time            | When the specific match will start.                                                                                                                                                                                                                                                                                                                                                                                                                           | <p>Date </p><p>Example:</p><ul><li>scheduled ="2019-10-23T00:00:00+00:00"</li></ul><p><br></p>                                                                                                                         |
| start\_time\_confirmed | If true, the start time is scheduled and confirmed (the event can still become delayed) otherwise, it could be a best guess.                                                                                                                                                                                                                                                                                                                                  | <ul><li>True</li><li>False</li></ul>                                                                                                                                                                                   |

### **Tournament\_round element (tournament\_round)** <a href="#uoffixtureendpoint-tournament_roundelement-tournament_round" id="uoffixtureendpoint-tournament_roundelement-tournament_round"></a>

Information related to the tournament round element is available here: Tournament\_round

### **Tournament element** <a href="#uoffixtureendpoint-tournamentelement" id="uoffixtureendpoint-tournamentelement"></a>

Information related to the tournament element is available here: Tournament

### **Season Element (season)** <a href="#uoffixtureendpoint-seasonelement-season" id="uoffixtureendpoint-seasonelement-season"></a>

Information related to the Season element is available here: Season

### **Competitors element** <a href="#uoffixtureendpoint-competitorselement" id="uoffixtureendpoint-competitorselement"></a>

Information related to the competitors element is available here: Competitor

### **Venue element** <a href="#uoffixtureendpoint-venueelement" id="uoffixtureendpoint-venueelement"></a>

Information related to the competitors element is available here: Venue

### **TV channels** <a href="#uoffixtureendpoint-tvchannels" id="uoffixtureendpoint-tvchannels"></a>

\<tv\_channels>\
&#x20;       \<tv\_channel name="Sky Sports Main Event - Astra 2A/2B/2D (28.2E)"/>\
&#x20;       \<tv\_channel name="Sky Sport Uno HD - Hot Bird 1/2/3/4/6 (13.0E)"/>\
&#x20;       \<tv\_channel name="Sky Sports Arena - Astra 2A/2B/2D (28.2E)"/>\
&#x20;       \<tv\_channel name="Sportkanalen HD - Sirius 2/3 (5.0E)"/>\
&#x20;       \<tv\_channel name="beIN Sports 1 HD France - Astra 1C-1H / 2C (19.2E)"/>\
&#x20;       \<tv\_channel name="CANAL+ SPORT HD PL - Hot Bird 1/2/3/4/6 (13.0E)"/>\
&#x20;       \<tv\_channel name="S SPORT HD - Eutelsat W3A (7.0E)"/>\
&#x20;       \<tv\_channel name="#Vamos ES - Astra 1C-1H / 2C (19.2E)"/>\
&#x20;   \</tv\_channels>

### **Extra\_info element** <a href="#uoffixtureendpoint-extra_infoelement" id="uoffixtureendpoint-extra_infoelement"></a>

Within this element, sport-specific key-value pairs are added to provide sport-specific details about the event.

\<extra\_info>\
&#x20;       \<info key="neutral\_ground" value="false"/>\
&#x20;       \<info key="period\_length" value="12"/>\
&#x20;       \<info key="overtime\_length" value="5"/>\
&#x20;       \<info key="coverage\_source" value="venue"/>\
&#x20;       \<info key="extended\_live\_markets\_offered" value="false"/>&#x20;

\</extra\_info>

All the specific info are actually contained in the info element.

### **Info element**  <a href="#uoffixtureendpoint-infoelement" id="uoffixtureendpoint-infoelement"></a>

In the info element there 2 attributes which are "Key" and "Value".

The Key attribute specifies which kind of info is provided.

The "Value" attribute provides the actual value or info related to the "key" attribute.

Table below shows all the keys and the values which can be shown for each key.&#x20;

<br>

| Key                              | Meaning of key                                                                                                                                                                                                                                                            | Value                   |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- |
| neutral\_ground                  | Set to true if one of the competitors is playing on their home venue, otherwise set to false.                                                                                                                                                                             | boolean                 |
| auto\_traded                     | Set to true if the match is auto-traded. For auto-traded matches odds are solely generated by a mathematical odds model and live scoring. Any market monitoring and trader interaction is not considered.                                                                 | boolean                 |
| draw\_possible                   | Set if a draw is possible.                                                                                                                                                                                                                                                | boolean                 |
| no\_advantage\_scoring           | Only present and set to true if no advantage scoring is used. In this tennis rule mode, the first player to get 4 points wins the game.                                                                                                                                   | boolean                 |
| best\_of                         | The number of sets (or equivalent) that the match maximum will have. Typically the winner needs best\_of/2 + 1 sets to win.                                                                                                                                               | integer                 |
| set\_limit                       | Number of points in a set (max).                                                                                                                                                                                                                                          | integer                 |
| period\_length                   | Number of minutes in a period                                                                                                                                                                                                                                             | integer                 |
| overtime\_length                 | Number of minutes for each overtime period.                                                                                                                                                                                                                               | integer                 |
| super\_tie\_break                | Number of points required to win match deciding tiebreak.                                                                                                                                                                                                                 | integer                 |
| coverage\_source                 | How are the live results obtained (directly from venue, from TV).                                                                                                                                                                                                         | enumeration (venue, tv) |
| extended\_live\_markets\_offered | What live markets will be offered; either the normal ones or an extended offering, depending on coverage type (basic or deeper coverage).                                                                                                                                 | boolean                 |
| surface                          | Possible values: hard\_court, grass, sand, red\_clay, green\_clay, hardcourt\_outdoor, carpet\_indoor, synthetic\_indoor,                                                                                                                                                 | enumeration             |
| best\_of\_legs                   | <p>Number of legs. In darts a single game is called a leg. You win a match by winning a number of legs. In some competitions a</p><p>match consists of sets where each set consists of legs (in such cases both best\_of and best\_of\_legs are typically available).</p> | integer                 |

### **Coverage info** <a href="#uoffixtureendpoint-coverageinfo" id="uoffixtureendpoint-coverageinfo"></a>

For more detailed info related to Coverage info please, refer to page: Coverage\_info

### **Product Info** <a href="#uoffixtureendpoint-productinfo" id="uoffixtureendpoint-productinfo"></a>

Product info provides information on which other sportradar products are being active for the match.

In this case elements work differently from all the others as these do not have "true"/"false" values: they are just added if the product in question is available for the match.

Here follows an example:

\<product\_info>

\<is\_auto\_traded/>\
\<is\_in\_live\_score/> \
\<is\_in\_hosted\_statistics/> \
\<is\_in\_live\_center\_soccer/> \
\<is\_in\_live\_match\_tracker/> \
\<links> \
\<link name="live\_match\_tracker" ref="[https://widgets.sir.sportradar.com/sportradar/en/standalone/match.lmtPlus#matchId=27751122"/>\\](https://widgets.sir.sportradar.com/sportradar/en/standalone/match.lmtPlus#matchId=27751122"/>\\)
&#x20;\</links>&#x20;

<br>

\<product\_info/><br>

<br>

| Element                          | meaning                                                    |
| -------------------------------- | ---------------------------------------------------------- |
| \<is\_auto\_traded/>             | If present the match is autotraded                         |
| \<is\_in\_live\_score/>          | If present, live score is available for the match          |
| \<is\_in\_hosted\_statistics/>   | If present, statistics are available for the match         |
| \<is\_in\_live\_center\_soccer/> | If  present, live center soccer is available for the match |
| \<is\_in\_live\_match\_tracker/> | If present, live match tracker is available for the match  |

In case of live match\_tracker available for the match  and hard-coded widget link is provided with the id of the match:

&#x20;<https://widgets.sir.sportradar.com/sportradar/en/standalone/match.lmtPlus#matchId=>"matchid"

The link redirects to the match tracker for the match&#x20;

<br>

scheduled\_start\_time\_changes

* * scheduled\_start\_time\_change


---

# 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/support-and-history/archived/deprecated-uof-endpoints/fixture-end-point.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.