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 delivered by our V3 integration service using HTTP POST. Details of the V3 integration service can be found in Integration schema section. As well as the push service, we also offer an AMQP queue for match state updates. This may be suitable for you if:
You are using the legacy 2009/07 schema (which did not support a full match state service),
You are not able to use the V3 schema because your trading platform requires a proprietary instruction format (for example OpenBet's Feed Handler API), or
You already have an AMQP solution in place that is receiving match state updates.
In all other cases, delivery via the V3 integration service is the recommended option.
For customers consuming a V3 service for fixture and other information, the simplest integration will be via their existing push service, to which match state messages can be added with quickly via a reconfiguration of the publisher.
In this solution, match state updates are published within anUpdategramwhere they will appear as separate commands, for example FootballMatchSummary. Updates are pushed to your client application, typically viaHTTP POST.
For sports for which a full match state is provided, the match state is split into Summary and Details messages. The Summary messages contain period scores, current match phase, foul counts etc. and other information necessary to power a scoreboard or similar application. The Details messages provide a full match history for every match event type so that, for example, a complete match action history can be assembled.
Summary and Detail messages are both available via the Push Service. You are free to choose to use either or both, depending on your requirements however Summary message type is the default match state message and Details are enabled on request.
As a V3 customer, you will also be able to look up every match state message that you received from Genius Sports for up to twenty eight days after the occurrence using the Graylog application on Production and for some fewer days on the UAT environment. Please contact the Customers Integrations team for details 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.