Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Endpoint

Method

Input URL

Sample Request Body

/api/v1/fixtures/{productid}/{eventid}

GET

  • Event ID

  • Product ID

/api/v1/fixtures/4/{131718}

Response Attributes

NAME

DESCRIPTION

product_id

The ID of the product (In this case ID 5 for Motorsports)

timestamp

The date & time of when the message was created (UTC)

event_id

The ID of the event (Match or Outright)

expiry_date

The next expiration date of the event (Only for specific EventsNot always available)

scheduled_date

The date of when the event will take place

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

market id

The ID of the market

market name

The name of the market (only for outright)

outcome id

The ID of the outcome (only for outright)

outcome name

The name of the outcome (only for outright)

competitor id

The ID of the competitor (only for match)

competitor name

The name of the competitor (only for match)

competitor type

The position of the competitor (this should be used to determine home and away for h2h markets)

reference id

The mapping id for a particular feed providerFeedProvider/bookmakerBookmaker

reference name

The name of the feedproviderFeedProvider/bookmaker Bookmaker mapping id

reference type

The entity of the feed providerFeedProvider/bookmaker Bookmaker mapping id

Response Examples

One Competitor Match Fixture

Code Block
<?xml version="1.0" encoding="UTF-8"?>
<fixtures_fixture product_id="5" timestamp="16668649430531695889437000">
	<fixture event_id="match:131719" expiry_date="2023-01-05T11:00:00.000Z" scheduled_date="2023-01-08T11:00:00.000Z">
		<sport id="10040" name="Formula 1"/>
		<category id="20" name="Brazil"/>
		<tournament id="19" name="Classified/Not Classified"/>
		<competitors>
			<competitor id="40000000" name="Verstappen, Max"/>
		</competitors>
	</fixture>
</fixtures_fixture>

Two Competitor Match Fixture

Code Block
<?xml version="1.0" encoding="UTF-8"?>
<fixtures_fixture product_id="31" timestamp="16668649430531695889437000">
	<fixture event_id="match:150926" scheduled_date="2023-02-15T19:30:00.000Z">
		<sport id="10100" name="Soccer"/>
		<category id="1" name="England"/>
		<tournament id="1" name="Premier League"/>
		<competitors>
			<competitor id="42" name="Arsenal FC" type="1"/>
			<reference_ids>
				<reference_id name="betradar" id="25039095"/>
			</reference_ids>
			<competitor id="17" name="Manchester City" type="2"/>
			<reference_ids>
				<reference_id name="betradar" id="25039093"/>
			</reference_ids>
		</competitors>
		<reference_ids>
			<referece_id name="betradar" id="1" type="Sport"/>
			<referece_id name="betradar" id="1" type="Category"/>
			<referece_id name="betradar" id="1" type="Tournament"/>
			<referece_id name="betradar" id="37776205" type="Match"/>
		</reference_ids>
	</fixture>
</fixtures_fixture>

Outright Fixture

Code Block
<?xml version="1.0" encoding="UTF-8"?>
<fixtures_fixture product_id="5" timestamp="16672181803861695889437000">
	<fixture event_id="outright:131728" name="Group 1 Winner" expiry_date="2023-01-05T11:00:00.000Z" scheduled_date="2023-01-08T11:00:00.000Z">
		<sport id="10040" name="Formula 1"/>
		<category id="20" name="Brazil"/>
		<tournament id="17" name="Group 1 Winner"/>
		<market id="101" name="Short Term Winner">
		 	<outcomes>
				<outcome id="40000000" name="Verstappen, Max"/>
				<outcome id="40000001" name="Leclerc, Charles"/>
				<outcome id="40000002" name="Perez, Sergio"/>
				<outcome id="40000004" name="Sainz Jr, Carlos"/>
			</outcomes>
		</market>
	</fixture>
</fixtures_fixture>

...