Endpoint

This endpoint provides Information about an ongoing or completed sport event. Apart from the general information related to the match it provides info related for example to score changes, yellow cards, corner kicks, etc.

The actual endpoint is event-specific and the actual attributes vary slightly between sports.

How to call the endpoint?

To call the endpoint for a specific match, the ID of the match must be inserted in the call as per the following example:

/v1/sports/{language}/sport_events/sr:match:14704749/timeline.xml

Endpoint Parameters

Parameter	Description	Possible Values
language Required	Language code for translation.	See all supported languages and their codes on language support
urn_type Required	The type of event to look up.	sr:match, sr:stage
match_id Required	The ID for the sport event to get fixture data from	e.g. 48665175

Information about an ongoing sport event

get

Detailed information (including event timeline) for a sport event. Prematch, Live or Post-match. Prematch info is very brief. Postmatch the results are there. XML schema

Authorizations

key

x-access-tokenstringRequired

Path parameters

languagestringRequired

Language code for translation.

urn_typestring · enumRequired

Displays the results for the specified id. This id could be sr:match: for a match, sr:stage: for a race, or sr:tournament: for outrights on a tournament.

Possible values:

idintegerRequired

The ID for the sport event.

Responses

200

successful operation

application/xml

401

Unauthorized

application/json

403

Access denied

application/json

500

Internal server error

application/json

get

/sports/{language}/sport_events/sr:{urn_type}:{id}/timeline.xml

HTTPcURLJavaScriptPython

GET /v1/sports/{language}/sport_events/sr:{urn_type}:{id}/timeline.xml HTTP/1.1
Host: global.api.betradar.com
x-access-token: YOUR_API_KEY
Accept: */*

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<match_timeline xmlns="http://schemas.sportradar.com/sportsapi/v1/unified" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" generated_at="2024-03-25T21:01:05+00:00" xsi:schemaLocation="http://schemas.sportradar.com/sportsapi/v1/unified http://schemas.sportradar.com/ufsportsapi/v1/endpoints/unified/ufsportsapi.xsd">
  <sport_event id="sr:match:48665175" scheduled="2024-04-20T16:15:00+00:00" start_time_tbd="false">
    <tournament_round type="cup" name="Semifinal" betradar_id="16" betradar_name="FA Cup" phase="playoffs"/>
    <season start_date="2023-11-03" end_date="2024-05-25" year="23/24" tournament_id="sr:tournament:19" id="sr:season:106225" name="FA Cup 23/24"/>
    <tournament id="sr:tournament:19" name="FA Cup">
      <sport id="sr:sport:1" name="Soccer"/>
      <category id="sr:category:1" name="England" country_code="ENG"/>
    </tournament>
    <competitors>
      <competitor qualifier="home" id="sr:competitor:17" name="Manchester City" abbreviation="MCI" short_name="Man City" country="England" country_code="ENG" gender="male">
        <reference_ids>
          <reference_id name="betradar" value="14758"/>
        </reference_ids>
      </competitor>
      <competitor qualifier="away" id="sr:competitor:38" name="Chelsea FC" abbreviation="CHE" short_name="Chelsea" country="England" country_code="ENG" gender="male">
        <reference_ids>
          <reference_id name="betradar" value="14748"/>
        </reference_ids>
      </competitor>
    </competitors>
    <venue id="sr:venue:606" name="Etihad Stadium" capacity="53400" city_name="Manchester" country_name="England" country_code="ENG" map_coordinates="53.484592,-2.202695"/>
  </sport_event>
  <sport_event_conditions>
    <venue id="sr:venue:606" name="Etihad Stadium" capacity="53400" city_name="Manchester" country_name="England" country_code="ENG" map_coordinates="53.484592,-2.202695"/>
  </sport_event_conditions>
  <sport_event_status status_code="0" match_status_code="0" status="not_started"/>
  <coverage_info level="silver" live_coverage="true" covered_from="tv">
    <coverage includes="basic_score"/>
    <coverage includes="key_events"/>
  </coverage_info>
</match_timeline>