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 |
|---|---|---|---|
/api/live/v1/timeline/{eventid} | GET |
| /api/v1/timeline/{3535142} |
Response Attributes
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" 1_score="0" 2_score="1"/>
<score score_status_id="6" 1_score="0" 2_score="0"/>
<score score_status_id="7" 1_score="0" 2_score="1"/>
<score score_status_id="31" 1_score="0" 2_score="0"/>
</scores>
</sport_event_status>
</match_timeline>