Volleyball

Volleyball uses four competition IDs. Every request requires an exact season; the regular season, postseason and Cup are separate data partitions. The schemas describe the implemented readers. Operator controls and collected evidence determine runtime availability; registration is not a claim of production coverage.

Competition ID	Accepted season	Default phase	Other phase
vleaguemen	2025-26, 2026-27	regular	postseason
vleaguewomen	2025-26, 2026-27	regular	postseason
kovocupmen	2025, 2026	cup	None
kovocupwomen	2025, 2026	cup	None

Cup stage can be group, semifinal or final. V-League postseason stages are semi-playoff, playoff and championship. A stage must agree with the phase. Wrong or missing season labels return 400; they never select a nearby season.

Read a match

curl -H "Authorization: Bearer $SPORTQUANTA_API_TOKEN" \
  'https://api.sportquanta.com/v1/vleaguemen/games?season=2025-26&phase=postseason'

Use the returned canonicalId for related resources. Canonical payload fields retain camelCase, including externalIds, scheduleDate, homeSetsWon and awaySetsWon. The public response envelope retains its established data and _meta structure.

Route below /v1/{competition}	Contents
/games, /games/{id}	Status, Korea schedule date, set wins and per-set rally points
/games/by-external-id/{source}/{externalId}	Source game lookup in the same season and phase
/games/{id}/sets	Played or observed set rows from the latest basic-game snapshot
/games/{id}/events, /games/{id}/play-by-play	Ordered relay events with snapshot-aware cursor pagination
/games/{id}/lineups	Provider lineup slots for each set; court rotations are unverified
/games/{id}/box-score, /games/{id}/team-stats	Provider game-level team statistics
/games/{id}/player-stats	Player appearance and box-score rows from the latest record snapshot
/games/{id}/extended	Canonical game, category coverage, evidence and unavailable capabilities
/teams, /players, /venues	Identity directories, not historical membership snapshots
/teams/{id}/roster	Membership evidenced by scoped season stats or game appearances
/standings	V-League regular standings or official Cup group standings
/team-season-stats, /player-season-stats, /leaders	Published phase-specific aggregates and numeric leaders
/statistic-definitions	Metric namespaces, units, denominators and verification limits

The same season and phase apply to every related request. Lists default to limit=100, maximum 1000. Only event reads expose a cursor; other lists can be truncated by their limit and do not assert completeness. /sets, /lineups and /box-scores also support scoped collection reads.

Scores, relay order and corrections

homeSetsWon and awaySetsWon count sets won. sets[].homePoints and sets[].awayPoints are rally points. A 3–1 match can contain a 25–18 set; these numbers have different meanings. Fifth sets can continue past 15, such as 18–16. Scheduled 0–0 placeholders are not played sets.

Events retain sourcePage, sourceIndex, eventType, textType, description and source score state. ET ends a set and does not independently finalize a match. Actor jersey/text may be available while playerId remains null. videoOffsetSeconds is a media offset; occurredAt remains null when no event timestamp is published.

Read hasMore and pass nextCursor back with the same scope and setNumber filter. A 409 with snapshot_changed_restart_pagination means the provider corrected content or membership; discard the cursor and restart. Invalid cursors return 400. Incomplete relay refreshes retain the previous valid snapshot and expose the failed category in coverage.

Profiles and metric meaning

Player detail can include birth date, height in centimetres, weight in kilograms, schools, source-text career entries, honors, official history and career season records. Current profile/roster membership can differ from the team on an older season-stat row. Career text and honors are not normalized transfer transactions or verified coach biographies.

Naver statistic keys remain in metricNamespace: "naver". Player point, team totalPoint and table points are distinct. Signed receive-efficiency values are retained. Rates are provider reported; missing values are not zero and formulas are not independently recomputed. Leaders use a registered numeric season key, default point, descending value and canonical ID for ties.

official contains verified KOVO game metadata such as attendance, officials and playing time when available. Playing time excludes some breaks and is not wall-clock elapsed time. officialRecords.namespace is kovo; its abbreviated team/player metrics and set-appearance flags remain source-native with unverified scaling. Read the statistic definitions before comparing them with Naver metrics. These fields can already appear on base game detail; /extended adds the explicit coverage envelope.

Add provenance=true for raw _prov entries with source, run ID and ingestion time. evidence and fieldObservedAt describe source age; updatedAt is a canonical write time, not a guarantee that every measurement was refreshed. A fresh unrelated profile or identity field must not make an old score look fresh.

Only mirrored logoAssetKey and headshotAssetKey values are eligible for display through SportQuanta asset resolution. Missing assets use a UI placeholder. Never construct or serve an upstream image URL from an external ID.

Source availability

Naver is primary. Verified KOVO supplements use their own source controls and provenance. Source routes are prepared behind disabled competition master controls; no deployment or activation is implied by this change.

Dataset	Source-supported scope	Limitation
Schedule and basic game	All eight competition-season scopes	Conditional upcoming fixtures remain scheduled observations
Relay, lineup slots and box score	Published game records	Category failures preserve prior valid data and expose retry/availability evidence
Season team/player stats	V-League regular season	2026-27 may be unpublished; Cup/postseason totals are not substituted
Cup standings	Official group stage	Rally points are not table points; knockouts are not a group table
Current roster and profile	Verified official/current or primary identities	Does not establish a complete historical roster
Coaches, full officials directory, sideout/rotation efficiency, odds	Unverified or unavailable	No inferred measurements or unverified bookmaker mapping

Source reconnaissance on 2026-10-17 observed 126 regular fixtures plus 8 men’s or 6 women’s postseason games for 2025-26, and 126 regular plus 9 conditional postseason fixtures per gender for 2026-27. Each 2025/2026 Cup edition had 12 schedule fixtures per gender. Regular player-stat observations were 149 men and 134 women for 2025-26. These are source inventory counts, not collected production counts or roster-completeness guarantees.