Skip to content

Volleyball data reference

← All sports

Generated from GET /v2/sports/2. Not hand-maintained - if the API adds a status or renames a statistic, this page follows on the next build.

Sport id
2
Participants
2
Match clock
no
Incident positions
no

Statuses 20

Every value event.status_id can take for this sport. Map onto this list rather than parsing status_type: ids are stable, labels are localized, and postponed matches keep status_type: scheduled.

idNameShortTypeNotes
1Not startedSched.scheduledclock stoppedset by incident 427
6Start delayedDelay.scheduledclock stoppedset by incident 438
5PostponedPost.scheduledclock stoppedset by incident 440TRAP: status_type is scheduled, exactly like a normal upcoming match. A postponed match is indistinguishable from a scheduled one unless you look at status_id. Never branch only on status_type.
1341st set1st setliveclock running
155Break after 1st set1st set breaklivebreakclock stopped
652nd set2nd setliveclock running
156Break after 2nd set2nd set breaklivebreakclock stopped
1353rd set3rd setliveclock running
157Break after 3rd set3rd set breaklivebreakclock stopped
1364th set4th setliveclock running
158Break after 4th set4th set breaklivebreakclock stopped
1375th set5th setliveclock running
159Break after 5th set5th set breaklivebreakclock stopped
154Golden setGolden setliveclock runningDeciding set played when a golden-set rule applies. Not part of the normal set sequence.
2InterruptedInterr.interruptedclock stoppedset by incident 441Play stopped and may resume. Incident 1001 (Match resumed) brings it back. Distinct from Abandoned (7), which may never resume.
7AbandonedAbd.interruptedclock stoppedset by incident 442Play stopped and may never resume. Same status_type as Interrupted (2), so tell them apart by status_id.
11FinishedFin.finishedclock stoppedset by incident 437One of FIVE terminal statuses (11, 12, 13, 14, 140). Treat every status_type: finished as terminal - checking for 11 alone misses matches decided in extra time, on penalties or in overtime.
12Finished awarded winAWfinishedclock stoppedset by incident 436Walkover: the result was awarded, not played out. Statistics and the timeline may be empty or not reflect play.
3CancelledCanc.cancelledclock stoppedset by incident 439
152To finishTo fin.scheduledclock stoppedset by incident 451TRAP: status_type is scheduled, but the match already started and was stopped - it is waiting to be finished on another date. Do not present it as an upcoming fixture.

Results 15

Entries that can appear in participants[].results[], keyed by id. There is no score field - you select the result you need.

idNameCodeTypeData type
411Winnerwinnerteambinary
412Progressprogressteambinary
2Resultresultteaminteger
43First setfirst_setpersoninteger
44Second setsecond_setpersoninteger
45Third setthird_setpersoninteger
46Fourth setfourth_setpersoninteger
43First setfirst_setteaminteger
47Fifth setfifth_setpersoninteger
44Second setsecond_setteaminteger
410Golden setgolden_setpersoninteger
45Third setthird_setteaminteger
46Fourth setfourth_setteaminteger
47Fifth setfifth_setteaminteger
410Golden setgolden_setteaminteger

Event details 14

Per-match metadata in the event's details, with the input type and allowed values.

idNameCodeInputData type
205Has lineupshas_lineupsselect-
141Attendanceattendancenumber-
61Possible golden setpossible_golden_setselect-
7Sets numbersets_numberselect-
158Scoring systemscoring_system_volleyballnumber-
231Serves firstserves_firstselect-
232Serves first in Tiebreakserves_first_in_tiebreakselect-
1First set start datefirst_set_start_datedatetime-
2Second set start datesecond_set_start_datedatetime-
3Third set start datethird_set_start_datedatetime-
4Fourth set start datefourth_set_start_datedatetime-
5Fifth set start datefifth_set_start_datedatetime-
60Golden set start dategolden_set_start_datedatetime-
233Serves first in Golden setserves_first_in_golden_setselect-

Incidents 91

Incident types that can appear in this sport's events_incidents. category: emergency marks operational notices, not match events - never render them on a timeline.

idNameCodeTypeTraderCategoryNotes
318Not startednot-startedeventyesstandardeventstatuses: sets status Not started
2846The match will not be coveredthe-match-will-not-be-coveredeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The match will not be covered at all. The attribute gives the reason. Nothing further will arrive.
Other: Scout's technical issues, Change of venue, Change of match date, Problems with TV transmission source
327Start delayedstart-delayedeventyesstandardeventSets game_break.statuses: sets status Start delayed
2712Match about to startmatch-about-to-starteventyesstandardinformingServe is imminent. Useful for switching a UI into live mode before the first set incident.
2847Problems with the source of the broadcastproblems-with-the-source-of-the-broadcaseventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The broadcast source has a problem. Paired with 2848 when it is solved.
3201st set startedfirst-seteventyesstandardeventVolleyball has no match clock, so the source table has no Affect on time column at all.statuses: sets status 1st setresults: Result = 0, First set = 0
2848Problem with the source of the broadcast has been solvedproblem-with-the-source-of-the-broadcasteventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The broadcast source problem is solved.
3212nd set startedsecond-seteventyesstandardeventstatuses: sets status 2nd setresults: Second set = 0
2849Change of coverage from venue to TVchange-of-coverage-from-venue-to-tveventyesemergencyemergencyOperational notice, not a match event - category: emergency. It tells you the coverage SOURCE changed, which usually changes latency and can change how complete the statistics are. Never render it on a timeline. Before kick-off (group: prematch): moved from venue to TV.
3223rd set startedthird-seteventyesstandardeventstatuses: sets status 3rd setresults: Third set = 0
2850Change of coverage from TV to venuechange-of-coverage-from-tv-to-venueeventyesemergencyemergencyOperational notice, not a match event - category: emergency. It tells you the coverage SOURCE changed, which usually changes latency and can change how complete the statistics are. Never render it on a timeline. Before kick-off (group: prematch): moved from TV to venue.
3234th set startedfourth-seteventyesstandardeventstatuses: sets status 4th setresults: Fourth set = 0
2851Change of coverage latencychange-of-coverage-latencyeventyesemergencyemergencyOperational notice, not a match event - category: emergency. It tells you the coverage SOURCE changed, which usually changes latency and can change how complete the statistics are. Never render it on a timeline. Latency of the coverage changed. Relevant if you gate markets on feed delay.
Other: from 3-6 to 7-15, from 7-15 to 3-6
3245th set startedfifth-seteventyesstandardeventstatuses: sets status 5th setresults: Fifth set = 0
2852Scouting coverage can start with a delay ofscouting-coverage-can-start-with-a-delayeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Scouting coverage will start late. The attribute gives the size (under 3, 3-5 or 5-10 minutes).
Other: < 3min, 3-5 min, 5-10 min
2001Golden set startedgolden-set-startedeventyesstandardeventDeciding set under a golden-set rule. Not part of the normal set sequence.statuses: sets status Golden setresults: Golden set = 0
2853Expected delay in the start of the matchexpected-delay-in-the-start-of-the-matcheventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The match will start late. The attribute gives the reason - a team arriving late, problems in the stands and so on.
Other: Delayed arrival of a team, Problems in the stands, Referee problems, Infrastructure problems, Weather conditions
2854Team line-ups will not be availableteam-line-ups-will-not-be-availableeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Line-ups will not be available for this match. Do not wait for lineups[] to fill.
2002Break afterbreak-aftereventyesstandardeventGeneric break marker: sets NO status. The specific break incidents (2003-2007) are the ones that move the match.
2855Source of the coverage is delayedsource-of-the-coverage-is-delayedeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The coverage source is delayed. The attribute gives the size of the delay (about 5 to 20 seconds).
Other: ~5sec, ~10sec, ~15sec, ~20sec, ~25sec, ~30sec, >30sec
2003Break after 1st setbreak-after-1st-seteventyesstandardeventstatuses: sets status Break after 1st set
2856The current part of the game has started with a delaythe-current-part-of-the-game-has-startedeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The current period started late.
2004Break after 2nd setbreak-after-2nd-seteventyesstandardeventstatuses: sets status Break after 2nd set
2857Verification of result in progressverification-of-result-in-progresseventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. A verification started. Whatever it covers may still change - hold off on caching it.
2005Break after 3rd setbreak-after-3rd-seteventyesstandardeventstatuses: sets status Break after 3rd set
2858Verification of result completed and correctverification-of-result-completed-and-coreventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Verification of the result finished. Values are confirmed.
2006Break after 4th setbreak-after-4th-seteventyesstandardeventstatuses: sets status Break after 4th set
2859Verification of key statistics is in progressverification-of-key-statistics-is-in-proeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. A verification started. Whatever it covers may still change - hold off on caching it.
2007Break after 5th setbreak-after-5th-seteventyesstandardeventstatuses: sets status Break after 5th set
2860Verification of key statistics completed and correctverification-of-key-statistics-completedeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Verification of key statistics finished. Values are confirmed.
2861Verification of game clock is in progressverification-of-game-clock-is-in-progreseventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. A verification started. Whatever it covers may still change - hold off on caching it.
314Technical timeouttechnical-timeouteventyesstandardteamTechnical timeout starts. Paired with 2713.
2862Verification of game clock completed and correctverification-of-game-clock-completed-andeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Verification of the game clock finished. Values are confirmed.
2713Techn. timeout overtechn-timeout-overeventyesstandardteamTechnical timeout ends.
2863Match coverage interrupted due to technical issuesmatch-coverage-interrupted-due-to-technieventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Coverage stopped because of technical issues. 2864 or 2865 says whether it comes back.
2864Match coverage will continuematch-coverage-will-continueeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Coverage will continue after the interruption.
2865Match coverage will not continuematch-coverage-will-not-continueeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Coverage will NOT continue. Expect no further incidents for this match.
326Finishedfinishedeventyesstandardeventstatuses: sets status Finishedbetstatus: bet_status = inactive
2866The match is abandonedthe-match-is-abandonedeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The match was abandoned. The attribute gives the reason.
Other: Problems in the stands, Referee problems, Infrastructure problems, Serious player injury, Weather conditions
2867Waiting for official decision regarding match resumptionwaiting-for-official-decision-regarding-eventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Waiting for an official decision on whether the match resumes. 2868 or 2869 follows.
2868Match will resume shortlymatch-will-resume-shortlyeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The match resumes shortly.
325Finished awarded winfinished-aweventyesstandardeventWalkover: the result was awarded, not played out.statuses: sets status Finished awarded winbetstatus: bet_status = inactive
2869Match will not resumematch-will-not-resumeeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The match will not resume.
329Interruptedinterruptedeventyesstandardeventstatuses: sets status Interrupted
2870Expected delay in the start of the next part of the gameexpected-delay-in-the-start-of-the-next-eventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The next period will start late. The attribute gives the reason.
Other: Problems in the stands, Referee problems, Infrastructure problems, Weather conditions
328PostponedpostponedeventyesstandardeventThe resulting status keeps status_type: scheduled.statuses: sets status Postponed
2871Change of coverage from venue to TVchange-of-coverage-from-venue-to-tv-liveeventyesemergencyemergencyOperational notice, not a match event - category: emergency. It tells you the coverage SOURCE changed, which usually changes latency and can change how complete the statistics are. Never render it on a timeline. During play (group: live): moved from venue to TV.
330AbandonedabandonedeventyesstandardeventMay never resume.statuses: sets status Abandoned
2872Change of coverage from TV to venuechange-of-coverage-from-tv-to-venue-liveeventyesemergencyemergencyOperational notice, not a match event - category: emergency. It tells you the coverage SOURCE changed, which usually changes latency and can change how complete the statistics are. Never render it on a timeline. During play (group: live): moved from TV to venue.
339Cancelledcancelledeventyesstandardeventstatuses: sets status Cancelled
2873Change of coverage latencychange-of-coverage-latency-liveeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Coverage latency changed. The attribute gives the direction, for example from 3-6 to 7-15 seconds. Relevant if you gate markets on feed delay.
Other: from 3-6 to 7-15, from 7-15 to 3-6
342To finishto-finisheventyesstandardinformingMatch will be finished on another date.
2874Expected delay in the start of the match - safety reasonsexpected-delay-in-the-start-of-the-matcheventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The match will start late for safety reasons.
2875Verification of key statistics is in progressverification-of-key-statistics-is-in-proeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. A verification started. Whatever it covers may still change - hold off on caching it.
2876Verification of key statistics completed and correctverification-of-key-statistics-completedeventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Verification of key statistics, after the match finished. Values are confirmed.
2877Verification of player names for key incidents in progressverification-of-names-for-key-incidents-eventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. A verification started. Whatever it covers may still change - hold off on caching it.
2878Verification of player names for key incidents completed and correctverification-of-names-for-key-incidents-eventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Verification of player names on key incidents finished. Values are confirmed.
2879Verification of result is in progressverification-of-result-is-in-progresseventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. A verification started. Whatever it covers may still change - hold off on caching it.
2880Verification of result completed and correctverification-of-result-completed-and-coreventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Verification of the result, after the match finished. Values are confirmed.
2881Problems with the low latency source of the coverageproblems-with-the-low-latency-source-of-eventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The low-latency source has a problem. Paired with 2882.
2882Problems with the low latency source of coverage has been solvedproblems-with-the-low-latency-source-of-eventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The low-latency source problem is solved.
2883Player name verification is in progress - substitutionplayer-name-verification-is-in-progress-eventyesemergencyemergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. A verification started. Whatever it covers may still change - hold off on caching it.
1000BetstartbetstarteventyesstandardmarketBetting markets may be activated.
Other: Master
1010BetstopbetstopeventyesstandardmarketAll betting markets are closed: a goal, penalty or red card looks likely, or the situation on the pitch is unclear.
Other: Master
1001Match resumedmatch-resumedeventyesstandardinformingUsed when an interrupted match resumes.
2008Player change sidesplayer-change-sideseventyesstandardinforming
2009Break during the gamebreak-during-the-gameeventyesstandardinformingSets game_break.
302Repeat actionrepeat-actioneventnostandardinformingRally replayed - no point awarded to either side.
297In Progressin-possesioneventnostandardeventRally in progress.
2610Referee challengereferee-challengeeventyesstandardmarketReferee challenge. The attribute says whether the call stood or was overturned.
Other: Call stands, Call overturned
1200Technical problemstechnical-problemseventyesstandardmarketTechnical problems during coverage. Closes all match markets automatically.
2013In possessionin-possessionteamnostandardteamWhich side holds the ball.
294PointpointteamyesstandardteamAdds a point to the team.
295Attack Pointattack-pointteamyesstandardteamAdds a point to the team. Attributes give the attack zone (1-6).
Other: Zone 1, Zone 2, Zone 3, Zone 4, Zone 5, Zone 6
296Block pointblock-pointteamyesstandardteamAdds a point to the team.
Other: Zone 1, Zone 2, Zone 3, Zone 4, Zone 5, Zone 6
298Service aceservice-aceteamyesstandardteamService ace. Adds a point to the team.
2051Attack Errorattack-errorteamyesstandardteamAdds a point to the OPPOSITE team. Do not credit it to the team the incident is attached to. Attributes give the error type and the attack zone.
Other: Out attack, Antenna attack, Net attack, Zone 1, Zone 2, Zone 3, Zone 4, Zone 5, Zone 6, Illegal touch
2609Neutral attackneutral-attackteamnostandardteamAttack that neither scored nor errored. Attributes give the zone; Blocked back marks a block that returned the ball.
Other: Zone 1, Zone 2, Zone 3, Zone 4, Zone 5, Zone 6, Blocked back
301ServeserveteamnostandardteamServe. Group Serve links it to the resulting point or error.
304Service errorservice-errorteamnostandardteamAdds a point to the OPPOSITE team. Do not credit it to the team the incident is attached to.
2053Technical errorstechnical-errorsteamyesstandardteamAdds a point to the OPPOSITE team. Do not credit it to the team the incident is attached to. Covers rotation errors, foot faults, net touches and illegal touches.
Other: Rotation error, Illegal touch, Foot fault, Net touch
306ChallengechallengeteamyesstandardteamTeam challenge. The attribute says whether it was correct.
Other: Challenge correct, Challenge incorrect
308TimeouttimeoutteamyesstandardteamTeam timeout starts. Paired with 2719.
310Set ballset-ballteamyesstandardinformingSet point: the serving side can win the set with this rally.
311Set wonset-wonteamyesstandardteamSet decided. The set score is in the set-specific result, not in Result.
312Match ballmatch-ballteamyesstandardinformingMatch point: the serving side can win the match with this rally.
2719Timeout overTimeout overteamyesstandardteamTeam timeout ends.
2720CardscardsteamyesstandardteamAttributes separate yellow card, red card, expulsion and disqualification.
Other: Yellow card, Red card, Player expulsion, Player disqualification
2924ReceptionreceptionteamnostandardteamReception quality, from Perfect to Error, in the attribute.
Other: Perfect, Plus, Negative, Error
2925DigdigteamnostandardteamDefensive dig. Attributes mark spectacular digs and free balls.
Other: Spectacular, Free ball
2926SetsetteamnostandardteamSetting the ball for an attack. Not the same as a set of play - that is incident 311.

Standings types 13

Values for type_name on /v2/standings. Pick the one you need and match its columns by code, not by position.

idName
62Away standings
179Best receivers
19Form table
61Home standings
63League standings
36Most popular results
53Overall stats
269Second place standings
35Streaks
98Team overall stats
274Third place standings
178Top scorers
28Wide standings

Statistics 79

Split into team statistics (in participants[].stats) and person statistics (in sub_participants[].stats). Match by code, not by position.

Team 35

idNameCodeData type
48Acesservice_acesinteger
49Service errorsservice_errorsinteger
125Attack pointsattack_pointsinteger
128Attack errorsattack_errorsinteger
124Block pointsblock_pointsinteger
1171Attacks Blockedattacks_blockedinteger
595Points scoredpoints_scoredinteger
814Opponent errorsopponent_errorsinteger
594Team errorsteam_errorsinteger
801Attack attemptsattack_attemptsinteger
802Service attemptsservice_attemptsinteger
807Reception attemptsreception_attemptsinteger
811Error receptionserror_receptionsinteger
403Is server sideservicebinary_text
718Skinskin_idinteger
8Yellow cardsyellow_cardsinteger
9Red cardsred_cardsinteger
109Challengeschallengesinteger
110Challenges correctchallenges_correctinteger
416Challenges incorrectchallenges_incorrectinteger
812Points in a rowpoints_in_a_rowinteger
813Maximum points in a rowmaximum_points_in_a_rowinteger
1497Setssetstext
1498Digsdigstext
803Attack efficiency %attack_efficiencydecimal
1494Attack effectiveness %attack_effectiveness_pcttext
804Neutral attacksneutral_attacksinteger
1493Service efficiency %service_efficiency_pcttext
806Perfect receptionsperfect_receptionsinteger
805Perfect reception efficiency %perfect_reception_efficiencydecimal
1495Positive receptionspositive_receptionstext
1496Positive reception efficiency %positive_reception_efficiency_pcttext
809Plus receptionsplus_receptionsinteger
808Plus reception efficiency %plus_reception_efficiencydecimal
810Negative receptionsnegative_receptionsinteger

Person 44

idNameCodeData type
35Appearanceappearancebinary
595Points scoredpoints_scoredinteger
48Acesservice_acesinteger
49Service errorsservice_errorsinteger
125Attack pointsattack_pointsinteger
128Attack errorsattack_errorsinteger
124Block pointsblock_pointsinteger
1171Attacks Blockedattacks_blockedtext
801Attack attemptsattack_attemptsinteger
802Service attemptsservice_attemptsinteger
807Reception attemptsreception_attemptsinteger
811Error receptionserror_receptionsinteger
1497Setssetstext
1498Digsdigstext
9Red cardsred_cardsinteger
8Yellow cardsyellow_cardsinteger
803Attack efficiency %attack_efficiencydecimal
1494Attack effectiveness %attack_effectiveness_pcttext
804Neutral attacksneutral_attacksinteger
1493Service efficiency %service_efficiency_pcttext
806Perfect receptionsperfect_receptionsinteger
805Perfect reception efficiency %perfect_reception_efficiencydecimal
1495Positive receptionspositive_receptionstext
1496Positive reception efficiency %positive_reception_efficiency_pcttext
809Plus receptionsplus_receptionsinteger
808Plus reception efficiency %plus_reception_efficiencydecimal
810Negative receptionsnegative_receptionsinteger
800Player errorsplayer_errorsinteger
831Points ratiopoints_ratiointeger
838Starting lineupstarting_lineupbinary
1240Substituteis_substitutebinary
1239Will not playwill_not_playbinary
8151st set 1st squad appearancefirst_set_first_squad_appearancebinary
8161st appearancefirst_appearancebinary
8172nd set 1st squad appearancesecond_set_first_squad_appearancebinary
8182nd appearancesecond_appearancebinary
8193rd set 1st squad appearancethird_set_first_squad_appearancebinary
8203rd appearancethird_appearancebinary
8214th set 1st squad appearancefourth_set_first_squad_appearancebinary
8224th appearancefourth_appearancebinary
8235th set 1st squad appearancefifth_set_first_squad_appearancebinary
8245th appearancefifth_appearancebinary
1172Golden set appearanceis_golden_set_appearancebinary
1173Golden set 1st squad appearanceis_golden_set_1st_squad_appearancebinary