Volleyball (Indoor, Beach and Snow) - MatchEvents

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:

{
  "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.

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

Feed Match Action

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

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

Element	Type	Description
`setNumber`	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

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

Challenge

Element	Type	Description

CoinToss

"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

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

"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)

Sports.Volleyball.Contracts.Common.Team

[ Home, Away]

Used to identify the team on the left.

Injury

Element	Type	Description

Libero

Element	Type	Description

LineUp

Element	Type	Description

MatchEnd

Element	Type	Description

MatchScore

Element	Type	Description

MatchStart

Element	Type	Description

Point

Element	Type	Description

Protest

Element	Type	Description

Recovery

Element	Type	Description

RefereeMindChange

Element	Type	Description

Replay

Element	Type	Description

Sanction

Element	Type	Description

Serve

Element	Type	Description

SetEnd

Element	Type	Description

SetScore

Element	Type	Description

SetStart

Element	Type	Description

Substitution

Element	Type	Description

TimeOut

Element	Type	Description

Other Match Events

Reliability

"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