Page Comparison

Table of Contents

style	none

Feed Match Event

Ably LiveAccess can be obtained via:

AccessControl API

Pull APIs:

IMPORTANT: All enums should be considered extensible, meaning any additional values beyond the ones explicitly defined should be accepted.

Volleyball Match Events example:

View file

name	matchevents-v1-GeniusSportsItaly-11629093.json

Code Block

language	json

{
  "sportId": 91189,
  "fixtureId": "123456789",
  "source": "SourceName",
  "sequenceId": 1,
  "actionId": 0,
  "insertedBeforeActionId": null,
  "isCancelled": false,
  "isConfirmed": true,
  "isModified": false,
  "action": {},
  "messageTimestampUtc": "2024-11-18T10:52:29.0262167Z"
}

Element	Type	Description
`sportId`	integer($int32)	Sport identifier
`fixtureId`	string	Fixture identifier
`source`	string	Feed provider identifier
`sequenceId`	integer($int32)	Fixture-specific sequence identifier of the match event
`insertedBeforeActionId`	integer($int32)	Specify the action ID that this action was inserted before.
`actionId`	integer($int32)	Match action identifier
`isCancelled`	boolean	Indicates whether the action is canceled
`isConfirmed`	boolean	Indicates whether the action is confirmed
`isModified`	boolean	Indicates whether the action is modified
`action`	{}	Consists of Match Action data properties
`messageTimestampUtc`	string($date-time)	Timestamp of the message

Every Match Event has a type inside the “action” field, named after the respective Action. Example for Point below, where Point is replaced for different Actions.

Code Block

language	json

"action": {
    "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.Point, GeniusSports.MatchState.Platform.MatchEvents.Volleyball"
}

Feed Match Action

Info
NOTE: Most actions include the following additional fields (hence they are not included in the description of every action).

Code Block

language	json

"action": {
  "setNumber": 1,
  "isConfirmed": true,
  "utcTimestamp": "2024-11-14T18:02:46Z"
}

Element	Type	Description
`teamsetNumber`	string($x-extensible-enum) [ None, Home, Away ]	Team data.
`playerId`	integer	The ID of the player.
`setNumber`	integer	The integer($int32)	The set number, where the action occurred.
`isConfirmed`	boolean	Indicates whether the action is confirmed.
`utcTimestamp`	string($date-time)	Timestamp of the message.

Actions

Info
NOTE: Feed Match Actions consist of Feed Match Event + Feed Match Action + Action data properties.

Challenge

Code Block

Element	Type	Description

CoinToss

Code Block

language	json

"action": {
      "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.CoinToss, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
      "winnerTeam": "Home",
      "winnerChoice": null,
      "loserChoice": null,
      "setNumber": 1,
      "isConfirmed": false,
      "utcTimestamp": "2024-11-08T12:34:39.527Z"
    },

Element

Type

Description

type

Element	Type

CourtState

Injury

Libero

TODO: find an example

Description

winnerTeam

string($x-extensible-enum)

Sports.Volleyball.Contracts.Common.Team

[ Home, Away]

Used to identify the coin-toss winner team.

winnerChoice

string($x-extensible-enum)

Sports.Volleyball.Contracts.Common.CoinTossChoice

[ Serve, Receive, LeftSide, RightSide ]

Used to identify the coin-toss winner team choice.

loserChoice

string($x-extensible-enum)

Sports.Volleyball.Contracts.Common.CoinTossChoice

[ Serve, Receive, LeftSide, RightSide ]

Used to identify the coin-toss loser team choice.

CourtState

Code Block

"action": {
      "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.CourtState, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
      "servingTeam": "Away",
      "servingPlayerId": 7554900,
      "teamOnLeft": "Home",
      "setNumber": 1,
      "isConfirmed": true,
      "utcTimestamp": "2024-11-18T15:52:19Z"
    },

Element

Type

Description

servingTeam

string($x-extensible-enum)

Sports.Volleyball.Contracts.Common.Team

[ Home, Away]

Used to identify the serving team.

servingPlayerId

integer($int32)

nullable: true

Used to identify the serving player.

teamOnLeft

string($x-extensible-enum)

LiberoActionType

Sports.Volleyball.Contracts.Common.Team

[

UnableToPlay

Home,

ReDesignate ]

Test

LineUp

MatchEnd

MatchScore

MatchStart

Point

Protest

Recovery

RefereeMindChange

Replay

Sanction

Serve

SetEnd

SetScore

SetStart

Substitution

TimeOut

Away]

Used to identify the team on the left.

Injury

Code Block

Element	Type	Description

Libero

Code Block

Element	Type	Description

LineUp

Code Block

Element	Type	Description

MatchEnd

Code Block

Element	Type	Description

MatchScore

Code Block

Element	Type	Description

MatchStart

Code Block

Element	Type	Description

Point

Code Block

Element	Type	Description

Protest

Code Block

Element	Type	Description

Recovery

Code Block

Element	Type	Description

RefereeMindChange

Code Block

Element	Type	Description

Replay

Code Block

Element	Type	Description

Sanction

Code Block

Element	Type	Description

Serve

Code Block

Element	Type	Description

SetEnd

Code Block

Element	Type	Description

SetScore

Code Block

Element	Type	Description

SetStart

Code Block

Element	Type	Description

Substitution

Code Block

Element	Type	Description

TimeOut

Code Block

Element	Type	Description

Other Match Events

Reliability

Code Block

language	json

"action": {
  "$type": "Betgenius.Sports.Contracts.Common.MatchEvents.Reliability, Betgenius.Sports.Contracts.Common.MatchEvents",
  "utcTimestamp": "2024-11-18T10:52:29.0039281Z",
  "isReliable": false,
  "reason": "Heartbeat Lost"
}

Element	Type	Description
`isReliable`	boolean	Indicates whether the feed data is considered reliable
`reason`	string	Reason for reliable/unreliable feed state

Version	Old Version 8	New Version 9
Changes made by	Dinyo Dyankov	Dinyo Dyankov
Saved on	Nov 18, 2024	Nov 20, 2024

Versions Compared

Key

Feed Match Event

Feed Match Action

Actions

Other Match Events

Reliability