Understanding Match State

Introduction

Detailed match state services are offered for the following InPlay sports described in this document. Basic match state services are also offered for sports covered under the MultiSport umbrella. The message contracts and the service features are described in this documentation and Detailed availability list can be found under Inplay sports/Contract type section. 

Technologies

Match state updates are transmitted via HTTP POST using our V3 integration service. Detailed information on this service is available in the Integration schema section.

In addition to the push service, we also offer Ably queues for match state updates. This option is recommended if you are using the legacy 2009/07 schema, if your trading platform requires a proprietary instruction format (such as OpenBet's Feed Handler API), or if you're integrating one of the newer Match State contracts with Genius Sports, which are no longer transmitted over the Integration Service.

For all other cases, we recommend delivery via the V3 integration service.


For customers using a V3 service for fixture and other information, the easiest integration is through their existing push service, which can be quickly reconfigured to add match state messages within an Updategram. These messages are published separately, for example as FootballMatchSummary, and are typically pushed to your client application via HTTP POST.

For sports that provide a full match state, the state is split into Summary and Details messages. The Summary messages include period scores, current match phase, foul counts, and other information necessary to power a scoreboard or similar application. The Details messages provide a complete match history for every match event type, allowing a complete match action history to be assembled.

Both Summary and Detail messages are available through the Push Service. You can choose to use either or both, depending on your requirements. However, the Summary message type is the default match state message, and Details are enabled upon request.

As a V3 customer, you will have access to every match state message you received from Genius Sports for up to 28 days after the occurrence using the Graylog application on Production, and for a shorter period on the UAT environment. Please contact the Customers Integrations team for more information on this feature.


Note: message snippets and examples in this document are shown in JSON but can be delivered through the V3 integration service as either JSON or XML, according to your requirements. 

Content Customization

For the V3 Integration Service, customization options are available for the Inplay Match State message types. 

The MatchDetails updategrams for Football and Basketball can be modified to suit the requirements of the customer. By default, all data points are enabled, however every sport-specific element within the messages can also be turned off. To view those elements, please navigate to the Football and Basketball sub-menus under the Understanding Match State section on the left pane.

Please contact Customer Integrations for further details after familiarising yourselves with the customisation options at IS Custom Settings