Volleyball (Indoor, Beach and Snow) Match State V1

1 Volleyball Match State V1
- 1.1 Introduction
- 1.2 Volleyball Match State example:
2 Section Explanations
- 2.1 match
  - 2.1.1 sets
    - 2.1.1.1 setNumber
    - 2.1.1.2 points
      - 2.1.1.2.1 point
    - 2.1.1.3 scoreInPoints
    - 2.1.1.4 requestedTimeOuts
    - 2.1.1.5 setWinner
    - 2.1.1.6 isGoldenSet
    - 2.1.1.7 startedAtUtc
    - 2.1.1.8 finishedAtUtc
    - 2.1.1.9 isConfirmedComplete
  - 2.1.2 scoreInSets
  - 2.1.3 kills
  - 2.1.4 blocks
  - 2.1.5 outs
  - 2.1.6 aces
  - 2.1.7 errors
  - 2.1.8 serviceErrors
  - 2.1.9 penalties
  - 2.1.10 blockOuts
  - 2.1.11 expulsions
    - 2.1.11.1 explulsion
  - 2.1.12 disqualifications
    - 2.1.12.1 disqualification
- 2.2 matchWinner
- 2.3 startedAtUtc
- 2.4 finishedAtUtc
- 2.5 isConfirmedComplete
- 2.6 matchStatus
- 2.7 sanctionStatus
- 2.8 other
  - 2.8.1 source
  - 2.8.2 fixtureId
  - 2.8.3 sequence
  - 2.8.4 messageTimestampUtc
  - 2.8.5 isReliable
  - 2.8.6 isCoverageCancelled
  - 2.8.7 reliabilityReasons

Volleyball Match State V1

Introduction

The document describes the Volleyball Match state V1 contract and provides examples of using it.

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 State example:

Section Explanations

match

An object that describes events within the match.

sets

A collection of objects detailing actions in a set.

{
  "SetNumber": 1,
  "Points": [],
  "scoreInPoints": {
    "teamA": 0,
    "teamB": 0
  },
  "requestedTimeOuts": {
    "teamA": 0,
    "teamB": 0
  },
  "setWinner": "TeamA",
  "isGoldenSet": false,
  "startedAtUtc": "2024-11-13T19:31:57Z",
  "finishedAtUtc": "2024-11-13T19:58:37Z",
  "isConfirmedComplete": true
}

setNumber

The set described this Set object.

points

Collection of point objects detailing the points played so far in this set.

"points": [
  {
    "pointNumber": 1,
    "server": "TeamB",
    "winner": "TeamA",
    "startedAt": "00:00:00",
    "wonAt": "00:00:07",
    "scoreWhenPointStarted": {
      "scoreInSets": {
        "teamA": 0,
        "teamB": 0
      },
      "scoreInPoints": {
        "teamA": 0,
        "teamB": 0
      }
    },
    "startedAtUtc": "2024-11-13T19:31:57Z",
    "finishedAtUtc": "2024-11-13T19:32:04Z",
    "isConfirmedComplete": true,
    "pointType": "Unknown"
  },
  {
    "pointNumber": 2,
    "server": "TeamA",
    "winner": "TeamA",
    "startedAt": "00:00:21",
    "wonAt": "00:00:36",
    "scoreWhenPointStarted": {
      "scoreInSets": {
        "teamA": 0,
        "teamB": 0
      },
      "scoreInPoints": {
        "teamA": 1,
        "teamB": 0
      }
    },
    "startedAtUtc": "2024-11-13T19:32:18Z",
    "finishedAtUtc": "2024-11-13T19:32:33Z",
    "isConfirmedComplete": true,
    "pointType": "Unknown"
  }
]

point

Set of fields describing a point.

`pointNumber`	The number of the point being described.
`server`	The team that is currently serving.
`winner`	The team that won the point if the point is complete, Null otherwise.
`StartedAt`	The timer at which the point was started if the point is complete and the information is available, Null otherwise.
`WonAt`	The time at which the point was won if the point is complete and the information is available, Null otherwise.
`ScoreWhenPointStarted`	The match score at the time that the point began. `"scoreWhenPointStarted": { "scoreInSets": { "teamA": 0, "teamB": 0 }, "scoreInPoints": { "teamA": 1, "teamB": 0 } },`
`StartedAtUtc`	The time at which the point started. Null if this information is not available.
`isConfirmedComplete`	True if the point has been confirmed, false otherwise.
`PointType`	An enum that describes the point type, and possible values:

scoreInPoints

An object that describes the score of the current set in points.

requestedTimeOuts

An object that describes the number of timeouts requested by each team.

setWinner

Indicates which team won the set if the set is complete, Null otherwise.

isGoldenSet

True if this set is a golden set, False otherwise (Not currently covered, always sent false).

startedAtUtc

The time that the match started if the match has started, Null otherwise.

finishedAtUtc

The time that the match finished if the match has finished, Null otherwise

isConfirmedComplete

True if the set is complete, false otherwise

scoreInSets

The current score in sets

kills

The number of kills by each team

blocks

The number of blocks by each team.

outs

The number of outs by each team.

aces

The number of aces by each team.

errors

The number of errors by each team.

serviceErrors

The number of points won due to the opponent's service errors for each team.

penalties

The number of penalties by each team.

blockOuts

The number of blockouts by each team.

expulsions

An array of objects describing expulsions.

explulsion

disqualifications

An object that describes disqualification events

disqualification

matchWinner

The team that won the match if the match has ended.

startedAtUtc

The time that the match started if the match has started, Null otherwise.

finishedAtUtc

The time that the match finished if the match has finished, Null otherwise.

isConfirmedComplete

True if the match is complete, False otherwise.

matchStatus

An enum that describes the current state of the match.

sanctionStatus

An enum describing the current sanction status.

other

source

The source property describes the source that is providing the feed for Match State.

fixtureId

The fixtureId property indicates the ID of the mapped source fixture to the Genius Sports fixture.

Use case: Id of this fixture (match).

sequence

The sequence property indicates the sequence number of the match state feed messages

Use case: Current sequence of the latest match state feed message is 189

messageTimestampUtc

The messageTimestampUtc property indicates the exact time of this match state message.

Use case: Time when the match state was last updated.

isReliable

The isReliable property is used to note whether the given match state data is reliable or not. This property is a result of the reliability reasons statuses.

Reliability is used to indicate that some of the information within the match state message may be inaccurate and it should not be relied on for purposes where data accuracy is critical.

Use case: The current match state is reliable.

isCoverageCancelled

The isCoverageCancelled property is used to note whether the coverage of this match has been canceled or not.

Use case: Coverage for this match has not been canceled.

reliabilityReasons

The reliabilityReasons section contains a list of items considered to make an automatic decision about whether the match state is reliable or not.

Use case: The heartbeat for the current match state has been lost, the feed is considered reliable and the coverage is unknown.

`coverageCancelledAt`	The time that coverage was cancelled
`source`	Indicates the source of this match state.
`fixtureId`	Indicates the unique Genius Sports fixture ID
`sequence`	Indicates the sequence number of the feed match state messages
`messageTimestampUtc`	Timestamp of the latest update to match state (UTC)
`isReliable`	Indicates whether the current match state is reliable or not
`isCoverageCancelled`	Indicates whether the coverage for this particular match has been cancelled or not
`reliabilityReasons`	`Heartbeat` : Short description of heartbeat status `FeedReliability` : Short description of feed reliability status Score unreliable - there is a discrepancy between data collection score and score in match state messages or other issue with score accuracy `Coverage` : Short description of the coverage for this match