Volleyball (Indoor, Beach and Snow) Match Events V1

1 Feed Match Event
2 Feed Match Action
3 Actions
- 3.1 Challenge
- 3.2 CoinToss
- 3.3 CourtState
- 3.4 Injury
- 3.5 LineUp
  - 3.5.1 Player
- 3.6 MatchEnd
- 3.7 MatchStart
- 3.8 Point
- 3.9 Protest
- 3.10 RefereeMindChange
- 3.11 Replay
- 3.12 Sanction
- 3.13 Serve
- 3.14 SetEnd
- 3.15 SetStart
- 3.16 Substitution
- 3.17 TimeOut
4 Other Match Events
- 4.1 Reliability

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

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. An example of Point is 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

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

Applicable to: Indoor, Beach

Element	Type	Description

Element	Type	Description
`requestor`	string($x-extensible-enum) Sports.Volleyball.Contracts.Common.Requestor [ Referee, Home, Away ]	Represents the requestor of the challenge.
`reason`	string nullable: true	The reason for the challenge
`outcome`	string($x-extensible-enum) Sports.Volleyball.Contracts.Common.ChallengeOutcome [ Successful, Unsuccessful, PictureUnavailable ]	Represents the outcome of the challenge.
`pointOutcome`	string($x-extensible-enum) Sports.Volleyball.Contracts.Common.ChallengePointOutcome [ ReversDecision, Resume, ReplayRally, PointHome, PointAway ]	Represents the point outcome of the challenge.

CoinToss

Applicable to: Indoor, Beach, Snow

Element	Type	Description

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

Applicable to: Indoor, Beach, Snow

Element	Type	Description

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

Applicable to: Indoor, Beach, Snow

Element	Type	Description

Element

Type

Description

team

string($x-extensible-enum)

Sports.Volleyball.Contracts.Common.Team

[ Home, Away ]

Represents the team with injured player.

playerId

integer($int32)

nullable: true

The ID of the injured player.

LineUp

Applicable to: Indoor, Beach, Snow

Element	Type	Description

Element

Type

Description

homePlayers

array[] of Sports.Volleyball.Contracts.Common.Player

Collection of lineup players for the home team.

awayPlayers

string($x-extensible-enum)

Sports.Volleyball.Contracts.Common.Team

[ Home, Away ]

Collection of lineup players for the away team.

Player

Element	Type	Description

Element

Type

Description

id

integer($int32)

The ID for the player.

roles

string($x-extensible-enum)

nullable: true

Sports.Volleyball.Contracts.Common.PlayerRole

[ Captain, Libero ]

Represents the possible roles that a player can have in the team.

courtPosition

string($x-extensible-enum)

Sports.Volleyball.Contracts.Common.CourtPosition

[ Zone1, Zone2, Zone3, Zone4, Zone5, Zone6 ]

Represents the court position that the player has in the team.

MatchEnd

Applicable to: Indoor, Beach, Snow

Element	Type	Description

Element

Type

Description

endTime

string($date-time)

Represents the end time of the match.

endOutcome

string($x-extensible-enum)

Sports.Volleyball.Contracts.Common.MatchEndOutcome

[ WinnerHomeByRetirementOrDefault, WinnerAwayByRetirementOrDefault, NoWinnerDueToRetirementOrDefault, WinnerHome, WinnerAway, Abandoned, Cancelled, Postponed ]

Represent the outcome of the match.

MatchStart

Applicable to: Indoor, Beach, Snow

Element	Type	Description

Element	Type	Description
`startTime`	string($date-time)	Represents the start time of the match.

Point

Applicable to: Indoor, Beach, Snow

Element	Type	Description

Element	Type	Description
`linkedActionId`	integer($int32) nullable: true	The ID of the action that is the reason for or affects this point. For example, the ID of a `Serve` action that triggered this point.
`winnerTeam`	string($x-extensible-enum) Sports.Volleyball.Contracts.Common.Team [ Home, Away ]	Represents the winner of the point.
`type`	Array[] of Sports.Volleyball.Contracts.Common.PointType [ Block, Kill, Out, BlockOut, Ace, Error, ServeError, Penalty ]	Represents method of winning the point.
`reason`	Array[] of Sports.Volleyball.Contracts.Common.PointReason [ Rally, Sanction, Challenge, MindChange, Replay, Protest ]	Represents the reason time of winning the point.

Protest

Applicable to: Indoor, Beach, Snow

Element	Type	Description

Element

Type

Description

team

string($x-extensible-enum)

Sports.Volleyball.Contracts.Common.Team

[ Home, Away ]

Represents the team requesting the protest.

pointOutcome

string($x-extensible-enum)

Sports.Volleyball.Contracts.Common.ProtestPointOutcome

[ ReversDecision, Resume, ReplayRally ]

Represents the outcome of the protest.

RefereeMindChange

Applicable to: Indoor

Element	Type	Description

Element

Type

Description

pointOutcome

string($x-extensible-enum)

Sports.Volleyball.Contracts.Common.ProtestPointOutcome

[ ReversDecision, Resume, ReplayRally ]

The referee may decide to repeat the rally or to check the awarding of the last point. This represents the outcome of the Referee decision.

Replay

Applicable to: Indoor

Element	Type	Description

Element

Type

Description

pointOutcome

string($x-extensible-enum)

Sports.Volleyball.Contracts.Common.ReplayPointOutcome

[ Resume, ReplayRally ]

Represents the outcome of the replay request.

Sanction

Applicable to: Indoor, Beach, Snow

Element	Type	Description

Element

Type

Description

team

string($x-extensible-enum)

Sports.Volleyball.Contracts.Common.Team

[ Home, Away ]

Represents the sanctioned team.

playerId

integer($int32)

nullable: true

The ID of the player that is sanctioned.

type

string($x-extensible-enum)

Sports.Volleyball.Contracts.Common.SanctionType

[ ImproperRequest, DelayWarning, DelaySanction, Warning, Penalty, Expulsion, Disqualification ]

Represents the type of sanction.

Serve

Applicable to: Indoor, Beach, Snow

Element	Type	Description

Element

Type

Description

team

string($x-extensible-enum)

Sports.Volleyball.Contracts.Common.Team

[ Home, Away ]

Represents the serving team.

playerId

integer($int32)

nullable: true

The ID of the player that is serving.

SetEnd

Applicable to: Indoor, Beach, Snow

Element	Type	Description

Element

Type

Description

endType

string($x-extensible-enum)

Sports.Volleyball.Contracts.Common.SetEndType

[ WinnerHome, WinnerHomeByRetirementOrDefault, WinnerAway, WinnerAwayByRetirementOrDefault, Draw ]

Represent how the set ended.

endTime

string($date-time)

nullable: true

Represents the end time for the set.

setEndConfirmed

boolean

Indicates if the set end event is confirmed.

SetStart

Applicable to: Indoor, Beach, Snow

Element	Type	Description

Element

Type

Description

startTime

string($date-time)

nullable: true

Represents the start time for the set.

isGoldenSet

boolean

Indicates if is a golden set.

Substitution

Applicable to: Indoor, Beach, Snow

Element	Type	Description

Element	Type	Description
`linkedActionId`	integer($int32) nullable: true	The ID of the action that is the reason for or affects this substitution.
`team`	string($x-extensible-enum) Sports.Volleyball.Contracts.Common.Team [ Home, Away ]	Represents the substituting team.
`playerOutId`	integer($int32) nullable: true	The ID of the outgoing player or substituted player.
`playerInId`	integer($int32) nullable: true	The ID of the incoming player or substitute player.
`type`	string($x-extensible-enum) Sports.Volleyball.Contracts.Common.SubstitutionType [ Regular, Exceptional, Libero ]	Represents the type of substitution.

TimeOut

Applicable to: Indoor, Beach, Snow

Element	Type	Description

Element	Type	Description
`team`	string($x-extensible-enum) Sports.Volleyball.Contracts.Common.Team [ Home, Away ]	Represents the substituting team.
`startTime`	string($date-time) nullable: true	Represents the start time of the timeout.
`endTime`	string($date-time) nullable: true	Represents the end time of the timeout.
`type`	string($x-extensible-enum) Sports.Volleyball.Contracts.Common.SubstitutionType [ Regular, Exceptional, Libero ]	Represents the type of substitution.

Other Match Events

Reliability

Applicable to: Indoor, Beach, Snow

Element	Type	Description

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