Versions Compared

Version Old Version 12 New Version Current
Changes made by

Dinyo Dyankov

Dimitar Atanasov

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, Resume,

Receive

ReplayRally,

LeftSide

PointHome,

RightSide

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

winnerChoice

integer($int32)

nullable: true

string($x-extensible-enum)

Sports.Volleyball.Contracts.Common.CoinTossChoice

[ Serve, Receive, LeftSide, RightSide ]

Used to identify the

serving player

coin-toss winner team choice.

teamOnLeft

loserChoice

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]

coin-toss loser team choice.

CourtState

  • Applicable to: Indoor, Beach, Snow

Code Block
languagejson

Element

Type

Description

Libero [TODO]

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,
             "roles"isConfirmed": []true,
             "courtPosition"utcTimestamp": "Zone12024-11-18T15:52:19Z"
        },
        {
          "id": 90047129,
          "roles": ["Captain"],
         },

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

Code Block
languagejson
"action": {
    "courtPosition$type": "Zone2"GeniusSports.MatchState.Platform.MatchEvents.Volleyball.Injury, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
        }"team": "Home",
        {"playerId": 12345678,
           "id"setNumber": 900474471,
          "roles"isConfirmed": []true,
 
        "courtPositionutcTimestamp": "Zone32024-11-20T14:11:34.14Z"
        }
      ],
      "awayPlayers": [
        {
          "id": 90047128,
,

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

Code Block
languagejson
"action": {
         "roles$type": ["Captain"],
 "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.LineUp, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
        "courtPositionhomePlayers": "Zone1"[
        },
        {
          "id": 9004712690047127,
          "roles": [],
          "courtPosition": "Zone2Zone1"
        },
        {
          "id": 9004712090047129,
          "roles": ["Captain"],
          "courtPosition": "Zone3Zone2"
        },
      ],    {
  "setNumber": 1,       "isConfirmedid": false90047447,
        "utcTimestamp": "2024-11-08T12:35:00.557Z  "roles": [],
          "courtPosition": "Zone3"
        },

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
{
  
      ],
      "awayPlayers": [
        {
          "id": 9004712090047128,
          "roles": ["Captain"],
          "courtPosition": "Zone3Zone1"
   }

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

Code Block
languagejson
"action": {     },
        {
          "id": 90047126,
          "roles": [],
          "courtPosition": "Zone2"
        "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.MatchEnd, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",},
        "endTime": "2024-11-18T17:54:01Z",{
          "endOutcomeid": "WinnerAway"90047120,
          "setNumberroles": 4[],
          "isConfirmedcourtPosition": true,"Zone3"
        }
"utcTimestamp": "2024-11-18T17:54:01Z"     },],
      "setNumber": 1,
      "isConfirmed": false,
      "utcTimestamp": "2024-11-08T12:35:00.557Z"
    },

Element

Type

Description

endTime

string($date-time)

Represents the end time of the match.

endOutcome

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.

MatchEndOutcome

Team

[

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

Represent the outcome of the match.

MatchScore [TODO]

Code Block

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" },

Home, Away ]

Collection of lineup players for the away team.

Player

Code Block
languagejson
{
  "id": 90047120,
  "roles": [],
  "courtPosition": "Zone3"
}

Element

Type

Description

startTime

id

string

integer(

$date-time

$int32)

Represents the start time of the match

The ID for the player.

Point

Code Block
languagejson
"action": { "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.Point, GeniusSports.MatchState.Platform.MatchEvents.Volleyball", "linkedActionId": 13, "winnerTeam": "Home",

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$type": null"GeniusSports.MatchState.Platform.MatchEvents.Volleyball.MatchEnd, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
      "reasonendTime": null"2024-11-18T17:54:01Z",
      "endOutcome": "WinnerAway",
      "setNumber": 14,
      "isConfirmed": falsetrue,
      "utcTimestamp": "2024-11-18T1618T17:0154:41Z01Z"
    },

Element

Type

Description

linkedActionId

endTime

integer

string(

$int32

$date-time)

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

Represents the end time of the match.

endOutcome

string($x-extensible-enum)

Sports.Volleyball.Contracts.Common.

Team

MatchEndOutcome

[

Home, Away]Represents the start time

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

Represent the outcome 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.

Protest

MatchStart

  • Applicable to: Indoor, Beach, Snow

Code Block
languagejson
"action": {
      "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.ProtestMatchStart, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
      "teamstartTime": "Home",
      "pointOutcome": null2024-11-18T16:01:21Z",
      "setNumber": 21,
      "isConfirmed": falsetrue,
      "utcTimestamp": "2024-11-13T1118T16:2701:47.555Z21Z"
    },

Element

Type

Description

team

startTime

string(

$x

$date-

extensible-enum

time)

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

Replay [TODO]

Code Block
languagejson

Element

Type

Description

Sanction

Code Block
languagejson
"action": { "

Represents the start time of the match.

Point

  • Applicable to: Indoor, Beach, Snow

Code Block
languagejson
"action": {
      "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.SanctionPoint, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
      "teamlinkedActionId": "Home"13,
      "playerIdwinnerTeam": 7465848"Home",
      "type": "Warning"null,
      "reason": null,
      "setNumber": 41,
      "isConfirmed": false,
      "utcTimestamp": "2024-11-18T1718T16:3201:30Z41Z"
    },

Element

Type

Description

team

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

sanctioned team.

playerId

integer($int32)

nullable: true

The ID of the player that is sanctioned

winner of the point.

type

string($x-extensible-enum)

Array[] of Sports.Volleyball.Contracts.Common.

SanctionType

PointType

[

ImproperRequest

Block, Kill,

DelayWarning

Out,

DelaySanction

BlockOut,

Warning

Ace,

Penalty

Error,

Expulsion

ServeError,

Disqualification ]

Penalty ]

Represents

the type of sanction

method of winning the point.

Serve

Code Block
languagejson

Element

Type

Description

SetEnd

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

Code Block
languagejson

Element

Type

Description

SetScore

Code Block
languagejson

Element

Type

Description

SetStart

Code Block
languagejson

Element

Type

Description

Substitution

Code Block
languagejson

Element

Type

Description

TimeOut

Code Block
languagejson

Element

Type

Description

Other Match Events

Reliability
"action": {
      "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.Protest, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
      "team": "Home",
      "pointOutcome": null,
      "setNumber": 2,
      "isConfirmed": false,
      "utcTimestamp": "2024-11-13T11:27:47.555Z"
    },

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

Code Block
languagejson
"action": {
      "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.RefereeMindChange, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
      "pointOutcome": "ReplayRally",
      "setNumber": 3,
      "isConfirmed": false,
      "utcTimestamp": "2024-11-18T17:12:07Z"
    },

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

Code Block
languagejson
"action": {
    "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.Replay, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
    "pointOutcome": "Resume",
    "setNumber": 1,
    "isConfirmed": true,
    "utcTimestamp": "2024-11-20T14:18:59.905Z"
  },

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

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.

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