GET - Timeline

When you receive an event inside bet_settlement message you should use that data to request the Timeline of the match using the following GET API data:

Endpoint	Method	Input Data	Sample Request Body

Endpoint	Method	Input Data	Sample Request Body
/api/live/v1/timeline/{eventid}	GET	Event ID	/api/v1/timeline/{3535142}

Response Attributes

NAME	DESCRIPTION

NAME	DESCRIPTION
timestamp	The date & time of when the message was created (UTC)
event_id	The ID of the event
sport id	The ID of the sport
sport name	The name of the sport
category id	The ID of the category
category name	The name of the category
tournament id	The ID of the tournament
tournament name	The name of the tournament
competitor id	The ID of the competitor
competitor name	The name of the competitor
competitor type	The position of the competitor (this should be used to determine home and away)
reference id	The mapping id for a particular FeedProvider/Bookmaker
reference name	The name of the FeedProvider/Bookmaker mapping id
reference type	The entity of the FeedProvider/Bookmaker mapping id
1_score	The score of the home/type1 team
2_score	The score of the away/type2 team
match_status_id	The id for the status of the match
score_status_id	The id for the type of Score

Response Examples

Timeline

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<match_timeline timestamp="1701966942002">
  <fixture event_id="match:3535142">
    <sport id="1001" name="Soccer"/>
    <category id="49" name="Spain"/>
    <tournament id="184" name="La Liga"/>
    <competitors>
      <competitor id="2345" name="Girona" type="1">
        <reference_ids>
          <reference id="3427" name="betradar"/>
        </reference_ids>
      </competitor>
      <competitor id="2243" name="Villarreal" type="2">
        <reference_ids>
          <reference id="5539" name="betradar"/>
        </reference_ids>
      </competitor>
    </competitors>
    <reference_ids>
      <reference id="45979419" name="betradar" type="Match"/>
      <reference id="132" name="betradar" type="Tournament"/>
      <reference id="2" name="betradar" type="Sport"/>
      <reference id="15" name="betradar" type="Category"/>
    </reference_ids>
  </fixture>
  <sport_event_status match_status_id="100">
      <scores>
        <score score_status_id="200" score_1="0" score_2="1"/>
        <score score_status_id="6" score_1="0" score_2="0"/>
        <score score_status_id="7" score_1="0" score_2="1"/>
        <score score_status_id="31" score_1="0" score_2="0"/>
      </scores>
  </sport_event_status>
</match_timeline>