Versions Compared

Key

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

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

Body

Data

Sample Request Body

/api/v1

/public

/fixtures/{

productid}/{

eventid}

GET

  • Event ID

  • Product ID

  • {
    "eventIds": [ 134663, 131719],
    "productId": 5
    }

    ...

    /api/v1/fixtures/{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)

    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

    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 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

    Code Block
    <?xml version="1.0" encoding="UTF-8"?>
    <fixtures_fixture product_id="5" timestamp="16668649430531695889437000">
    	<fixture event_id="match:131719" expiry_date="2023-0110-05T1103T13:00:00+00:00.000Z" scheduled_date="2023-0110-08T1105T13:00:00+00:00.000Z">
    		<sport id="10040" name="Formula 1"/>
    		<category id="20" name="Brazil"/>
    		<tournament id="19" name="Classified/Not Classified"/>
    		<market id="2" 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" standalone="yes"?>
    <fixtures_fixture product_id="5" timestamp="16668649430531701966942002">
    	  <fixture event_id="match:131718" expiry_scheduled_date="2023-0112-05T1108T02:00:00+00:00.000Z" scheduledevent_dateid="2023-01-08T11:00:00.000Zmatch:353514">
    		    <sport id="100401002" name="Formula 1Basketball"/>
    		    <category id="2079" name="BrazilUSA"/>
      		  <tournament id="18167" name="H2H RaceNBA"/>
    		<market
        <competitors>
          <competitor id="21394" name="Los Angeles Lakers" type="Head to Head"/>
    		<competitors>
    			"1">
            <reference_ids>
              <reference id="3427" name="betradar"/>
            </reference_ids>
          </competitor>
          <competitor id="400000001527" name="Verstappen, MaxNew Orleans Pelicans" type="1"/>
    			<competitor"2">
            <reference_ids>
              <reference id="5539" name="betradar"/>
            </reference_ids>
          </competitor>
        </competitors>
        <reference_ids>
          <reference id="4000000145979419" name="Leclerc, Charles"betradar" type="Match"/>
          <reference id="132" name="betradar" type="Tournament"/>
          <reference id="2" name="betradar" type="Sport"/>
          <reference id="15" name="betradar" type="Category"/>
    		    </competitors>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" event_name="Group 1 Winner" expiry_date="2023-0110-05T1103T13:00:00+00:00.000Z" scheduled_date="2023-0110-08T1105T13:00:00+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>

    ...