Common Match State Platform APIs

Owned by Martin Kuks
Jul 05, 2022
1 min read

Overview

Common Match State Platform APIs are REST APIs that are designed and built in sport agnostic way. They expose endpoints which are applicable for all sports. Parameter sportId is available in each API endpoint to specify the corresponding sport that request is executed for.

Data Consumers

Sports data consumers would typically use GET endpoints of Common Match State Platform APIs for the following purposes:

  • Access Control API - to retrieve access to subscribe for Genius Sports Live Sports Data Push API via Ably.

  • Schedule API - to retrieve information about fixtures schedule and which sourceId would cover specific fixtures.

  • Heartbeat API - to retrieve heartbeat status for specific fixture (also available in corresponding Sport-specific API MatchState).

Data Producers

Sports data producers (also called feed providers) typically use POST endpoints of Common Match State Platform APIs for the following purposes:

  • Schedule API - to send information about specific fixture that their corresponding sourceId would cover by providing sports event data through Sport-specific Match State Platform APIs.

  • Heartbeat API - to provide heartbeat requests in specified intervals of time for fixtures that are actively covered so that data consumers are notified in case an issue occurs in the transfer of data between data producer and Match State Platform APIs.

REST APIs Open API Specification