# Timeline end point

This end point provides information related to the match while the match is ongoing. Apart from the general information related to the match it provides info related for example to score changes, yellow cards, corner kicks etc.

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:

/v1/sports/{language}/sport\_events/sr:match:14704749/timeline.xml

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

* match\_summary
* sport\_event
  * tournament\_round
  * season
  * tournament
    * competitor
      * reference\_ids
        * reference\_id
    * venue
    * sport\_event\_conditions
      * referee
      * venue
      * weather\_info
    * sport\_event\_status
      * period\_scores
        * period\_score competitors
        * coverage\_info
        * timeline
          * event

<br>

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

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

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

Information related to the tournament element is available here: Tournament

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

Information related to the Season element is available here: Season

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

Information related to the competitors element is available here: Competitor

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

Information related to the competitors element is available here: Venue

### **Sport event status** <a href="#uoftimelineendpoint-sporteventstatus" id="uoftimelineendpoint-sporteventstatus"></a>

Information related to the competitors element is available here: Sport event status

### **Sport event conditions** <a href="#uoftimelineendpoint-sporteventconditions" id="uoftimelineendpoint-sporteventconditions"></a>

For more detailed info related to the Venue element, please, check the following page: Sport\_event\_condition

For more detailed info related to the **Venue** element, please, check the following page: Venue&#x20;

For more detailed info related to the **Pitcher and Pitcher history**, please, check the following page: Pitcher and Pitcher history

### **Sport event status** <a href="#uoftimelineendpoint-sporteventstatus.1" id="uoftimelineendpoint-sporteventstatus.1"></a>

For detailed information about the sport event status element please check: Sport event status

### **Period Scores** <a href="#uoftimelineendpoint-periodscores" id="uoftimelineendpoint-periodscores"></a>

For detailed information about the sport event status element please check: Period scores

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

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

### **Timeline** <a href="#uoftimelineendpoint-timeline" id="uoftimelineendpoint-timeline"></a>

The  main difference between the summary end point and the timeline end point is the list of event elements in the timeline  which provides info related to the ongoing match.

Here below follows the list of the possible types of events reported in the timeline end point.

* match\_started
* period\_start
* yellow\_card
* red\_card
* &#x20;red\_yellow\_card
* period\_score
* break\_start
* score\_change
* corner\_kick
* match\_ended

#### match\_started <a href="#uoftimelineendpoint-match_started" id="uoftimelineendpoint-match_started"></a>

Each event has an id to be identified.

This event type provides info about the timing match start as shown in example below.

![](/files/t202CxGRnCXA8TqB98Ab)

#### yellow\_and red card <a href="#uoftimelineendpoint-yellow_andredcard" id="uoftimelineendpoint-yellow_andredcard"></a>

This event type provides info about a yellow card given to a player.

Information provided is:

* id of the event
* time of the event
* time in the match
* the team the player belongs in
* if the player is on the bench&#x20;

The sub element \<player> is added with id and name of the player as shown in the 2 examples below

![](/files/iHJRZ7wSTdAkWGxExGUz)

![](/files/uGqUSRWe10nckoiPCaS1)

#### red\_yellow\_card <a href="#uoftimelineendpoint-red_yellow_card" id="uoftimelineendpoint-red_yellow_card"></a>

This event type provides info about a player who got first the yellow card given to a player and the player is sent off.

Info about the player is provided as well.

![](/files/fwBbUuzyanJUZrFyw2mu)

#### period\_score <a href="#uoftimelineendpoint-period_score" id="uoftimelineendpoint-period_score"></a>

This event type provides info about a period score with time, period number, home\_score, away\_score and match\_status\_code.

![](/files/lylhby7ve87glrFYjpwL)

#### break\_start <a href="#uoftimelineendpoint-break_start" id="uoftimelineendpoint-break_start"></a>

This event type provides info about a break during the match with time, period name and match\_status\_code.

![](/files/J0IzTyddakWcXy4GKq5U)

#### score\_change <a href="#uoftimelineendpoint-score_change" id="uoftimelineendpoint-score_change"></a>

This event type provides info about a break during the match with time, period name and match\_status\_code.

Apart from that also information related  to the&#x20;

![](/files/aXOs5FWH4y1aiDLbIVBw)

#### corner\_kick <a href="#uoftimelineendpoint-corner_kick" id="uoftimelineendpoint-corner_kick"></a>

This event type provides info about a corner kick during the match with time, match\_time period name and match\_status\_code.

![](/files/C7bk0rffxDfi1TRdbj8V)

#### match\_ended <a href="#uoftimelineendpoint-match_ended" id="uoftimelineendpoint-match_ended"></a>

This event type provides info about the end of the match.

![](/files/L6SR9993m5IZMozAa7Mv)

#### period\_start <a href="#uoftimelineendpoint-period_start" id="uoftimelineendpoint-period_start"></a>

This event type provides info about the start of the period and the period itself.

![](/files/Gzbs3VQXEIRXLGt6rC4Y)


---

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