Versions Compared

Version Old Version 14 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

Code Block
 "action": {
    "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.Challenge, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
    "requestor": "Referee",
    "reason": "Point",
    "outcome": "Successful",
    "pointOutcome": "ReversDecision",
    "setNumber": 1,
    "isConfirmed": true,
    "utcTimestamp": "2024-11-20T14:01:07.391Z"
  },

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

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

  • Applicable to: Indoor, Beach, Snow

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

[TODO] Code Blocklanguage

json

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.LineUpInjury, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
      "homePlayersteam": ["Home",
    "playerId": 12345678,
  {  "setNumber": 1,
       "idisConfirmed": 90047127true,
          "roles": [],
          "courtPosition": "Zone1"utcTimestamp": "2024-11-20T14:11:34.14Z"
        },
        {
     },

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": {
      "id$type": 90047129,
          "roles": ["Captain"]"GeniusSports.MatchState.Platform.MatchEvents.Volleyball.LineUp, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
          "courtPositionhomePlayers": "Zone2"
    [
   },         {
          "id": 9004744790047127,
          "roles": [],
          "courtPosition": "Zone3Zone1"
        },
      ],  {
    "awayPlayers": [
        {           "id": 9004712890047129,
          "roles": ["Captain"],
          "courtPosition": "Zone1Zone2"
        },
        {
          "id": 9004712690047447,
          "roles": [],
          "courtPosition": "Zone2Zone3"
        }
      ],
      "awayPlayers": [
        {
          "id": 9004712090047128,
          "roles": ["Captain"],
          "courtPosition": "Zone3Zone1"
        }
,
     ],   {
   "setNumber": 1,       "isConfirmedid": false90047126,
          "utcTimestamproles": [],
"2024-11-08T12:35:00.557Z          "courtPosition": "Zone2"
    },

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": "        "courtPosition": "Zone3"
}

Element

Type

Description

id

integer($int32)

The ID for the player.

roles

string($x-extensible-enum)

nullable: true

        }
      ],
      "setNumber": 1,
      "isConfirmed": false,
      "utcTimestamp": "2024-11-08T12:35:00.557Z"
    },

Element

Type

Description

homePlayers

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

PlayerRole

[ Captain, Libero ]

Represents the possible roles that a player can have in the

Player

Collection of lineup players for the home team.

courtPosition

awayPlayers

string($x-extensible-enum)

Sports.Volleyball.Contracts.Common.

CourtPosition

Team

[

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

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

MatchEnd

Applicable to: Indoor, Beach, Snow

Home, Away ]

Collection of lineup players for the away team.

Player

Code Block
languagejson
{
  "actionid": {90047120,
  "roles": [],
  "$typecourtPosition": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.MatchEnd, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
      "endTime": "2024-11-18T17:54:01Z",
      "endOutcome": "WinnerAway",
      "setNumber": 4,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": {
      "isConfirmed$type": true "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.MatchEnd, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
      "utcTimestampendTime": "2024-11-18T17:54:01Z",
      "endOutcome": "WinnerAway",
      "setNumber": 4,
      "isConfirmed": true,
      "utcTimestamp": "2024-11-18T17:54:01Z"
    },

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.

MatchScore [TODO]

Code Block

Element

Type

Description

MatchStart

Applicable

MatchStart

  • Applicable to: Indoor, Beach, Snow

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

Element

Type

Description

startTime

string($date-time)

Represents the start time of the match.

Point

Element

Type

Description

startTime

string($date-time)

Represents the start time of the match.

Point

  • Applicable to: Indoor, Beach, Snow

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

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

Code Block
languagejson
"action": {
      "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.PointProtest, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
      "linkedActionId": 13Volleyball",
      "winnerTeamteam": "Home",
      "typepointOutcome": null,
      "reason": 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

RefereeMindChange

  • Applicable to: Indoor, Beach, Snow

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

Element

Type

Description

pointOutcome

string($x-extensible-enum)

Sports.Volleyball.Contracts.Common.ProtestPointOutcome

[ ReversDecision, Resume, ReplayRally ]

Represents

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

protest.

Recovery [TODO]

Code Block
languagejson

Element

Type

Description

RefereeMindChange

Referee decision.

Replay

  • Applicable to: Indoor

Code Block
languagejson
"action": {
 
    "$type": "GeniusSports.MatchState.Platform.MatchEvents.Volleyball.RefereeMindChangeReplay, GeniusSports.MatchState.Platform.MatchEvents.Volleyball",
      "pointOutcome": "ReplayRallyResume",
      "setNumber": 31,
 
    "isConfirmed": falsetrue,
      "utcTimestamp": "2024-11-18T1720T14:1218:07Z59.905Z"
    },

Element

Type

Description

pointOutcome

string($x-extensible-enum)

Sports.Volleyball.Contracts.Common.

ProtestPointOutcome

ReplayPointOutcome

[

ReversDecision,

Resume, ReplayRally ]

Represents the outcome of the

protest.

Replay [TODO]

Code Block
languagejson
Description

Element

Type

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.

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