GET - Fixture

When you receive a new event inside fixture_change message you should use that data to request the Fixture using the following GET API data:

Endpoint	Method	Input Data	Sample Request Body
/api/v1/fixtures/{eventid}	GET	Event ID	/api/v1/fixtures/{131718}

Response Attributes

NAME	DESCRIPTION
timestamp	The date & time of when the message was created (UTC)
event_id	The ID of the event (Match or Outright)
event_name	The name of the event (only for Outright)
expiry_date	The next expiration date of the event (Not 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)
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

Response Examples

One Competitor Match Fixture

<?xml version="1.0" encoding="UTF-8"?>
<fixtures_fixture timestamp="1695889437000">
	<fixture event_id="match:131719" expiry_date="2023-10-03T13:00:00+00:00" scheduled_date="2023-10-05T13:00:00+00:00">
		<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

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<fixtures_fixture timestamp="1701966942002">
  <fixture scheduled_date="2023-12-08T02:00:00.000+00:00" event_id="match:353514">
    <sport id="1002" name="Basketball"/>
    <category id="79" name="USA"/>
    <tournament id="167" name="NBA"/>
    <competitors>
      <competitor id="1394" name="Los Angeles Lakers" type="1">
        <reference_ids>
          <reference id="3427" name="betradar"/>
        </reference_ids>
      </competitor>
      <competitor id="1527" name="New Orleans Pelicans" 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>
</fixtures_fixture>

Outright Fixture

<?xml version="1.0" encoding="UTF-8"?>
<fixtures_fixture product_id="5" timestamp="1695889437000">
	<fixture event_id="outright:131728" event_name="Group 1 Winner" expiry_date="2023-10-03T13:00:00+00:00" scheduled_date="2023-10-05T13:00:00+00:00">
		<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>