Betgenius Genius Sports provides a Booking API to allow you to book fixtures programmatically. Fixtures can be booked through either the API or the InPlay UI and bookings in either service will be reflected in the other.

Anchor
_Toc427073880 _Toc427073880

Test API and Online Documentation

You can access a test version of the Booking API in the Betgenius Genius Sports test environment using the following URL (Please contact Genius Sports Integrations team for credentials):

Anchor
_Toc427073881 _Toc427073881

Access to the Booking API

To access the Booking API you will need to use a username and password supplied by BetgeniusGenius Sports. Please contact your integration manager for further details. 

Anchor
_Toc427073883 _Toc427073883

API Key

To access the Booking API, our Support team will provide you with the exclusive Username and Password, which then form the key in the following format:

{UserName}:{Password}

Example: BookingAPI:x67sjxBookingAPI:X659Zy1OOP

We will use this example account on the subsequent calls below. Please note that the example is meant for demonstration purposes only and does not retrieve the content. Please contact either the Client Integrations team or our Support to receive your personalised credentials.

Book Fixture

Use this method to submit a booking request for an individual fixture.

To book a fixture you submit the Betgenius Genius Sports fixture ID. For example, to book 3217106 (Club Friendlies, Balikesirspor v Elazigspor) you would use the following request

URL: https://dataservices.uat.betgenius.com:443/BookingSystem/api/v2/booking/Book?fixtureId=3217106&api_key=bookingapi%3AbookingapiBookingAPI%3AX659Zy1OOP

cURL request using Basic Authentication (recommended):

curl -X POST --header 'Accept: application/json' 'https://dataservices.uat.betgenius.com/BookingSystem/api/v2/booking/Book?fixtureId=3217106' --user bookingapiBookingAPI:bookingapiX659Zy1OOP

The following response would be expected:

{
"Message": "Booked."
} 

Method BehavioursBehaviors:

Anchor
_Toc427073884 _Toc427073884

Unbook Fixture

Use this method to cancel a booking for an individual fixture.

To cancel a booking you submit the Betgenius the Genius Sports fixture ID:

URL: https://dataservices.uat.betgenius.com:443/BookingSystem/api/v2/booking/UnBook?fixtureId=3217106&api_key=bookingapi%3AbookingapiBookingAPI%3AX659Zy1OOP

cURL request:

curl -X POST --header 'Accept: application/json' 'https://dataservices.uat.betgenius.com:443/BookingSystem/api/v2/booking/UnBook?fixtureId=3217106&api_key=bookingapi%3AbookingapiBookingAPI%3AX659Zy1OOP'

cURL request using Basic Authentication (recommended):

curl -X POST --header 'Accept: application/json' 'https://dataservices.uat.betgenius.com:443/BookingSystem/api/v2/booking/UnBook?fixtureId=3217106' --user bookingapiBookingAPI:bookingapiX659Zy1OOP

The following response would be expected:

{
"Message": "Not booked."
} 

Method Behaviours:

Anchor
_Toc427073885 _Toc427073885

Fixtures

Use this method to obtain a list of upcoming fixtures with their current book and feed service statuses. The fixture list will include all fixtures from the specified sport and date range. However, you can only retrieve a maximum of 7 days worth of fixtures with one call. The Fixtures method can be used to discover which fixtures are available and which have been booked. The list of available feeds can change so it is recommended that the Fixtures method be called at regular intervals. 

To retrieve a list of upcoming football fixtures:

URL: https://dataservices.uat.betgenius.com:443/BookingSystem/api/v2/booking/Fixtures?sportId=10&api_key=bookingapi%3AbookingapiBookingAPI%3AX659Zy1OOP

cURL request:

curl -X POSTGET --header 'Accept: application/json' 'https://dataservices.uat.betgenius.com:443/BookingSystem/api/v2/booking/Fixtures?sportId=10&api_key=bookingapi%3AbookingapiBookingAPI%3AX659Zy1OOP'

cURL request using Basic Authentication (recommended):

curl -X POSTGET --header 'Accept: application/json' 'https://dataservices.uat.betgenius.com:443/BookingSystem/api/v2/booking/Fixtures?sportId=10' --user bookingapiBookingAPI:bookingapiX659Zy1OOP

The expected response is a JSON array of fixture information matching the specified date range and sport ID:

{
    "FixtureId": 5242621,
    "CompetitionId": 198,
    "CompetitionName": "Uruguay Primera División",
    "SportId": 10,
    "Name": "CA Cerro v CA Peñarol",
    "Date": "2018-03-21T19:00:00Z",
    "CustomerFixtureId": "14124225",
    "IsBooked": true,
    "AvailableFeeds": [
      {
        "Name": null,
        "Type": "MatchState",
        "IsLicensed": true,
        "Metadata": {
          "Origin": "Venue",
          "Lineups": "False",
          "Multisport": "False"
        }
      },
      {
        "Name": null,
        "Type": "TradingState",
        "IsLicensed": true,
        "Metadata": null
      }
    ],
    "ExternalIds": [
      {
        "Source": "1000",
        "Id": "14124225"
      },
      {
        "Source": "1001",
        "Id": "2747471"
      }
    ]
  }

Please be noted that some browsers like Mozilla Firefox and Chrome may convert the JSON array to XML.
Method Behaviours:

• If the From and Until arguments are omitted the Fixtures method will return fixtures starting in the next twenty four hours

  Element	Type	Description
  FixtureId	Integer	The unique identifier assigned to the fixture

  by Betgenius

  by Genius Sports
  CompetitionId	Integer	The unique identifier assigned to a competition

  by Betgenius

  by Genius Sports
  CompetitionName	String	The name of the competition
  SportId	Integer	The unique identifier assigned to a sport

  by Betgenius

  by Genius Sports
  Name	String	The name of the fixture
  Date

  Datetime

  String	The scheduled start date and time for the fixture in UTC
  CustomerFixtureId	String	Your fixture ID, if available
  IsBooked	Boolean	True if the fixture has been booked,

  false

  False otherwise
  AvailableFeeds	Array	An array of Feed

   

  (see below)
  Feed	inline_model {}	Name/Type/IsLicensed/Metadata
  Name	N/A	This field is not used and will always be

  null 

  NULL.
  Type	String	Describes the type of feed available. Possible values are: MatchState – score, phase change, danger state etc. TradingState – the trading controls
  IsLicensed	Boolean	True if you are licensed to use the feed, false otherwise
  Metadata

  Metadata

  inline_model {}	Origin/Lineups/Multisport
  Origin	String	Describes the feed origin
  Lineups

  Boolean

  String	"True" if fixture has Line-up information
  Multisport

  Boolean

  String

  "True" if fixture is

  fixture is

  managed by Multisport service, "False" otherwise
  ExternalIds	Array	An array of ExternalId (see below)
  ExternalId	inline_model {}	Source/Id
  Source	String	Your fixture name (if available)
  Id	String	Your

  multiple

  fixture ID's

  ,

  (if available)

  
  CustomerFixtureId and ExternalIds are populated only if:

More information about how External Fixture feeds can be integrated can be found on the following Confluence page.

Sport ID's