Versions Compared

Version Old Version 13 New Version 14
Changes made by

Dinyo Dyankov

Dinyo Dyankov

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
stylenone

Feed Match Event

Ably LiveAccess can be obtained via:

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
namematchevents-v1-GeniusSportsItaly-11629093.json

Code Block
languagejson
{
  "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. An example of Point is below, where Point is replaced for different Actions.

Code Block
languagejson
"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
languagejson
"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 

Info

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

Challenge

  • Applicable to: Indoor, Beach, Snow

Code Block

Element

Type

Description

CoinToss

Code Block
languagejson
 "action": {
 
    "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.CoinTossChallenge, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
    "requestor": "Referee",
    "winnerTeamreason": "HomePoint",
      "winnerChoiceoutcome": null"Successful",

     "loserChoicepointOutcome": null"ReversDecision",
      "setNumber": 1,
      "isConfirmed": falsetrue,
      "utcTimestamp": "2024-11-08T1220T14:3401:3907.527Z391Z"

   },

Element

Type

Description

winnerTeam

requestor

string($x-extensible-enum)

Sports.Volleyball.Contracts.Common.

Team

Requestor

[ Referee, Home, Away ]

Used to identify the coin-toss winner team.

winnerChoice

Represents the requestor of the challenge.

reason

string

nullable: true

The reason for the challenge

outcome

string($x-extensible-enum)

Sports.Volleyball.Contracts.Common.

CoinTossChoice

ChallengeOutcome

[

Serve

Successful,

Receive

Unsuccessful,

LeftSide, RightSide

PictureUnavailable ]

Used to identify the coin-toss winner team choice.

loserChoice

Represents the outcome of the challenge.

pointOutcome

string($x-extensible-enum)

Sports.Volleyball.Contracts.Common.

CoinTossChoice

ChallengePointOutcome

[

Serve

ReversDecision,

Receive

Resume,

LeftSide

ReplayRally,

RightSide

PointHome, PointAway ]

Used to identify the coin-toss loser team choice.

CourtState

Represents the point outcome of the challenge.

CoinToss

  • Applicable to: Indoor, Beach, Snow

Code Block
languagejson
"action": {
         "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.CourtStateCoinToss, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
         "servingTeamwinnerTeam": "AwayHome",
         "servingPlayerIdwinnerChoice": 7554900null,
         "teamOnLeftloserChoice": "Home"null,
         "setNumber": 1,
         "isConfirmed": truefalse,
         "utcTimestamp": "2024-11-18T1508T12:5234:19Z39.527Z"
      },

Element

Type

Description

servingTeam

winnerTeam

string($x-extensible-enum)

Sports.Volleyball.Contracts.Common.Team

[ Home, Away ]

Used to identify the

serving

coin-toss winner team.

servingPlayerId

integer($int32)

nullable: true

Used to identify the serving player.

teamOnLeft

winnerChoice

string($x-extensible-enum)

Sports.Volleyball.Contracts.Common.

Team

CoinTossChoice

[

Home, Away

Serve, Receive, LeftSide, RightSide ]

Used to identify the

team on the left.

Injury [TODO]

Code Block
languagejson

Element

Type

Description

Libero [TODO]

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

Code Block
languagejson

Element

Type

Description

LineUp

Code Block
languagejson
"action""action": {
         "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.LineUpCourtState, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
         "homePlayersservingTeam": ["Away",
      "servingPlayerId": 7554900,
      {
          "id"teamOnLeft": "Home",
      "setNumber": 900471271,
              "rolesisConfirmed": []true,
            "courtPosition  "utcTimestamp": "Zone12024-11-18T15:52:19Z"
          },
        {
          "id": 90047129},

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 [TODO]

Code Block
languagejson
Element
Type
Description
Libero [TODO]
 Code Block
languagejson
Element
Type
Description
LineUp
  • Applicable to: Indoor, Beach, Snow
 Code Block
languagejson
"action": {
      "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.LineUp, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
      "homePlayers": [
        {
          "id": 90047127,
          "roles": [],
          "courtPosition": "Zone1"
        },
        {
          "id": 90047129,
          "roles": ["Captain"],
          "courtPosition": "Zone2"
        },
        {
          "id": 90047447,
          "roles": [],
          "courtPosition": "Zone3"
        }
      ],
      "awayPlayers": [
        {
          "id": 90047128,
          "roles": ["Captain"],
          "courtPosition": "Zone1"
        },
        {
          "id": 90047126,
          "roles": ["Captain"],
          "courtPosition": "Zone2"
        },
        {
          "id": 9004744790047120,
          "roles": [],
          "courtPosition": "Zone3"
        }
      ],
      "awayPlayerssetNumber": [1,
        {
          "id": 90047128,
   "isConfirmed": false,
      "rolesutcTimestamp": ["Captain"],
          "courtPosition": "Zone1"
        },
        {
          "id": 90047126,
          "roles": [],
          "courtPosition": "Zone2"
        },
        {
          "id": 90047120,
          "roles": [],
          "courtPosition": "Zone3"
        }
      ],
      "setNumber": 1,
      "isConfirmed": false"2024-11-08T12:35:00.557Z"
    },
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
 Code Block
languagejson
{
  "id": 90047120,
  "roles": [],
  "courtPosition": "Zone3"
}
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
 Code Block
languagejson
"action": {
      "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.MatchEnd, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
      "utcTimestampendTime": "2024-11-08T1218T17:3554:00.557Z01Z",
    },
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
 Code Block
languagejson
{  "endOutcome": "WinnerAway",
      "idsetNumber": 900471204,
      "rolesisConfirmed": []true,
      "courtPositionutcTimestamp": "Zone3"
} "2024-11-18T17:54:01Z"
    },
Element
Type
Description
id
integer($int32)
The ID for the player.
roles
endTime
string(
$x
$date-
extensible-enum)
nullable: true
Sports.Volleyball.Contracts.Common.PlayerRole
[ Captain, Libero ]
Represents the possible roles that a player can have in the team.
courtPosition
time)
Represents the end time of the match.
endOutcome
string($x-extensible-enum)
Sports.Volleyball.Contracts.Common.
CourtPosition
MatchEndOutcome
[ 
 Zone1, Zone2, Zone3, Zone4, Zone5, Zone6 ]
Represents the court position that the player has in the team.
MatchEnd
WinnerHomeByRetirementOrDefault, WinnerAwayByRetirementOrDefault, NoWinnerDueToRetirementOrDefault, WinnerHome, WinnerAway, Abandoned, Cancelled, Postponed ]
Represent the outcome of the match. 
MatchScore [TODO]
 Code Block
Element
Type
Description
MatchStart
  • Applicable to: Indoor, Beach, Snow
 Code Block
languagejson
"action": {
      "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.MatchEndMatchStart, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
      "endTime": "2024-11-18T17:54:01Z",
      "endOutcomestartTime": "WinnerAway2024-11-18T16:01:21Z",
      "setNumber": 41,
      "isConfirmed": true,
      "utcTimestamp": "2024-11-18T1718T16:5401:01Z21Z"
    },
Element
Type
Description
endTime
startTime
string($date-time)
Represents the 
 end 
start time of the match.
Point
 Code Block
endOutcome
string($x-extensible-enum)
Sports.Volleyball.Contracts.Common.MatchEndOutcome
[ WinnerHomeByRetirementOrDefault, WinnerAwayByRetirementOrDefault, NoWinnerDueToRetirementOrDefault, WinnerHome, WinnerAway, Abandoned, Cancelled, Postponed ]
Represent the outcome of the match. 
MatchScore [TODO]
 Code Block
languagejson
"action": {
      "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.Point, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
      "linkedActionId": 13,
      "winnerTeam": "Home",
      "type": null,
      "reason": null,
      "setNumber": 1,
      "isConfirmed": false,
      "utcTimestamp": "2024-11-18T16:01:41Z"
    },
Element
Type
Description
startTime
string($date-time)
Element
Type
Description
MatchStart
 Code Block
languagejson
"action": {
      "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.MatchStart, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
      "startTime": "2024-11-18T16:01:21Z",
      "setNumber": 1,
      "isConfirmed": true,
      "utcTimestamp": "2024-11-18T16:01:21Z"
    },
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 start time of the match.
type
Array[] of Sports.Volleyball.Contracts.Common.PointType
[ Block, Kill, Out, BlockOut, Ace, Error, ServeError, Penalty ]
Represents the start time of the match.
reason
Array[] of Sports.Volleyball.Contracts.Common.PointReason
[ Rally, Sanction, Challenge, MindChange, Replay, Protest ]
Represents the start time of the match.
Point
Protest
  • Applicable to: Indoor, Beach, Snow
 Code Block
languagejson
"action": {
      "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.PointProtest, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
      "linkedActionId": 13,
      "winnerTeamteam": "Home",
      "type": null,
      "reason"pointOutcome": null,
      "setNumber": 12,
      "isConfirmed": false,
      "utcTimestamp": "2024-11-18T1613T11:0127:41Z47.555Z"
    },
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
Type
Description
team
string($x-extensible-enum) 
Sports.Volleyball.Contracts.Common.Team
[ Home, Away ]
Represents the 
 start time of the match
team requesting the protest.
type
Array[] of Sports.Volleyball.Contracts.Common.PointType
[ Block, Kill, Out, BlockOut, Ace, Error, ServeError, Penalty ]
Represents the start time of the match.
reason
Array[] of 
pointOutcome
string($x-extensible-enum) 
Sports.Volleyball.Contracts.Common.
PointReason
ProtestPointOutcome
[ 
 Rally
ReversDecision, 
 Sanction, Challenge, MindChange, Replay, Protest 
Resume, ReplayRally ]
Represents the 
 start time 
outcome of the 
 match.
Protest
protest.
Recovery [TODO]
 Code Block
languagejson
Element
Type
Description
RefereeMindChange
  • Applicable to: Indoor
 Code Block
languagejson
"action": {
      "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.ProtestRefereeMindChange, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
      "teampointOutcome": "HomeReplayRally",
      "pointOutcome": null,
      "setNumber": 23,
      "isConfirmed": false,
      "utcTimestamp": "2024-11-13T1118T17:2712:47.555Z07Z"
    },
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.
Recovery [TODO]
 Code Block
languagejson
Element
Type
Description
RefereeMindChange [TODO]
 Code Block
languagejson
Element
Type
Description
the protest.
Replay [TODO]
 Code Block
languagejson
Element
Type
Description
Sanction
  • Applicable to: Indoor, Beach, Snow
 Code Block
languagejson
 "action": {
      "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.Sanction, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
      "team": "Home",
      "playerId": 7465848,
      "type": "Warning",
      "setNumber": 4,
      "isConfirmed": false,
      "utcTimestamp": "2024-11-18T17:32:30Z"
    },
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
 Code Block
languagejson
"action": {
      "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.Serve, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
      "team": "Away",
      "playerId": 7556825,
      "setNumber": 4,
      "isConfirmed": true,
      "utcTimestamp": "2024-11-18T17:32:36Z"
    },
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
 Code Block
languagejson
"action": {
      "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.SetEnd, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
      "endType": "WinnerAway",
      "endTime": "2024-11-18T17:51:14Z",
      "setEndConfirmed": true,
      "setNumber": 4,
      "isConfirmed": true,
      "utcTimestamp": "2024-11-18T17:51:14Z"
    },
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.
SetScore [TODO]
 Code Block
languagejson
Element
Type
Description
SetStart
  • Applicable to: Indoor, Beach, Snow
 Code Block
languagejson
"action": {
      "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.SetStart, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
      "startTime": "2024-11-18T16:01:21Z",
      "isGoldenSet": false,
      "setNumber": 1,
      "isConfirmed": true,
      "utcTimestamp": "2024-11-18T16:01:21Z"
    },
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
 Code Block
languagejson
"action": {
      "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.Substitution, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
      "linkedActionId": null,
      "team": "Home",
      "playerOutId": 7471100,
      "playerInId": 7465828,
      "type": "Libero",
      "setNumber": 1,
      "isConfirmed": false,
      "utcTimestamp": "2024-11-18T16:01:41Z"
    },
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
 Code Block
languagejson
"action": {
      "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.TimeOut, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
      "team": "Away",
      "startTime": "2024-11-18T16:10:45Z",
      "endTime": "2024-11-18T16:11:16Z",
      "type": "Facultative",
      "setNumber": 1,
      "isConfirmed": true,
      "utcTimestamp": "2024-11-18T16:11:16Z"
    },
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
 Code Block
languagejson
"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