Games

V-League Men: exact competition and season scope. Canonical payload fields retain camelCase, including provider-native statistic keys; the public envelope uses its established metadata spelling. Requires the stats entitlement. Source-dependent fields may be omitted or null. The implemented source routes are gated by operator controls; this schema does not assert that production data has been collected.

GEThttps://api.sportquanta.com/v1/vleaguemen/gamesTry it

GETGet V-League Men games

GEThttps://api.sportquanta.comhttps://api-stage.sportquanta.comhttp://localhost:8082/v1/vleaguemen/games

Send

Get V-League Men games

Expand optional fieldsCollapse optional fields

V-League Men: exact competition and season scope. Canonical payload fields retain camelCase, including provider-native statistic keys; the public envelope uses its established metadata spelling. Requires the stats entitlement. Source-dependent fields may be omitted or null. The implemented source routes are gated by operator controls; this schema does not assert that production data has been collected.

Authorization

Authorizationstringheaderrequired

Send a workspace API token in the Authorization: Bearer <token> header.

Bearer

Query

limitinteger

Maximum rows returned. Only event routes provide cursor pagination.

teamIdstring

Optional canonical identity filter, where applicable to this resource.

playerIdstring

Optional canonical identity filter, where applicable to this resource.

gameIdstring

Optional canonical identity filter, where applicable to this resource.

scheduleDatestring

Optional Korea schedule date, YYYY-MM-DD.

Get V-League Men gamescURL

200Example

Reference context: V-League Men.

Overview · Response conventions

Get V-League Men games

curl --request GET \
  --url 'https://api.sportquanta.com/v1/vleaguemen/games?season=2025-26' \
  --header 'Authorization: Bearer <token>'

200 · Example

{
  "data": {
    "items": [
      {
        "canonicalId": "<string>",
        "externalIds": {
          "SOURCE_KEY": "SOURCE_ENTITY_ID"
        },
        "season": "<string>",
        "phase": "regular",
        "stage": "regular",
        "groupName": "<string>",
        "scheduleDate": "<string>",
        "scheduledStartUtc": "<string>",
        "status": "Scheduled",
        "statusText": "<string>",
        "homeTeamId": "<string>",
        "awayTeamId": "<string>",
        "venueId": "<string>",
        "neutralSite": true,
        "gameCode": "<string>",
        "bestOfSets": 0,
        "relaySnapshots": [
          {
            "setNumber": 0,
            "playIds": [
              "<string>"
            ],
            "lineupIds": [
              "<string>"
            ],
            "payloadHash": "<string>",
            "observedAt": "<string>"
          }
        ],
        "setIds": [
          "<string>"
        ],
        "recordSnapshot": {
          "playerBoxScoreIds": [
            "<string>"
          ],
          "payloadHash": "<string>",
          "observedAt": "<string>"
        },
        "coverage": {
          "relay": {
            "availability": "available",
            "source": "naver_relay",
            "observedAt": "2026-10-17T00:00:00Z",
            "detail": null
          }
        },
        "officialRecords": {
          "namespace": "kovo",
          "observedAt": "<string>",
          "teams": [
            {
              "teamId": "<string>",
              "sourceTeamCode": "<string>",
              "metrics": {
                "point": 17,
                "attackSuccess": 12,
                "receiveSuccessRate": -28.6
              }
            }
          ],
          "players": [
            {
              "playerId": "<string>",
              "teamId": "<string>",
              "sourcePlayerCode": "<string>",
              "sourceTeamCode": "<string>",
              "playerName": "<string>",
              "position": "<string>",
              "jerseyNumber": "<string>",
              "setAppearanceFlags": {
                "ynS1": "-1",
                "ynS5": "-2"
              },
              "metrics": {
                "point": 17,
                "attackSuccess": 12,
                "receiveSuccessRate": -28.6
              }
            }
          ]
        },
        "official": {
          "sourceGameNo": "<string>",
          "attendance": 0,
          "venueName": "<string>",
          "city": "<string>",
          "officials": [
            {
              "role": "<string>",
              "name": "<string>"
            }
          ],
          "playingTimeMinutes": 0,
          "setDurations": [
            {
              "setNumber": 0,
              "minutes": 0
            }
          ]
        },
        "homeSetsWon": 0,
        "awaySetsWon": 0,
        "currentSet": 0,
        "sets": [
          {
            "setNumber": 0,
            "homePoints": 0,
            "awayPoints": 0,
            "completed": true
          }
        ],
        "createdAt": "2026-10-29T00:00:00Z",
        "updatedAt": "2026-10-29T00:00:00Z",
        "_prov": {
          "fullName": {
            "source": "SOURCE_ADAPTER_ID",
            "runId": "RUN_ID",
            "ingestedAt": "2026-10-13T00:00:00Z"
          }
        }
      }
    ],
    "partition": {
      "league": "vleaguemen",
      "season": "2025-26",
      "phase": "regular",
      "stage": "regular"
    },
    "evidence": {
      "sources": [
        "<string>"
      ],
      "observedAt": "<string>",
      "ageMs": 0,
      "fieldObservedAt": {
        "status": "2026-10-17T00:00:00Z"
      },
      "staleAfterMs": 0,
      "stale": true,
      "availability": "available"
    },
    "scope": {
      "directory": true,
      "historicalMembershipVerified": false
    }
  },
  "_meta": {
    "request_id": "REQUEST_ID",
    "served_from": "live",
    "cache_ttl_seconds": 300
  }
}

Authorizations

Authorizationstringheaderrequired

Send a workspace API token in the Authorization: Bearer <token> header.

Query Parameters

seasonenum<string>required

Exact edition/season label is required; the reader never substitutes another competition or season.

Available options: 2025-26, 2026-27

phaseenum<string>default:regular

V-League regular is the default. Postseason and Cup remain separate partitions.

Available options: regular, postseason

limitintegerdefault:100

Maximum rows returned. Only event routes provide cursor pagination.

Required range: 1 <= x, x <= 1000

provenancebooleandefault:false

Include raw per-field _prov on canonical records.

stageenum<string>

Optional stage must agree with the selected phase.

Available options: regular, semi-playoff, playoff, championship

teamIdstring

Optional canonical identity filter, where applicable to this resource.

playerIdstring

Optional canonical identity filter, where applicable to this resource.

gameIdstring

Optional canonical identity filter, where applicable to this resource.

scheduleDatestring<date>

Optional Korea schedule date, YYYY-MM-DD.

Response

200400401403404429500502503application/json

Scoped canonical response; an empty collection does not imply complete source coverage.

dataobjectrequired

data.itemsobject[]required

data.items.canonicalIdstring

data.items.externalIdsobject

Map from the exact stored source/namespace key to that provider's identifier for this entity. Keys vary by entity and league. Values are strings, even when the provider ID looks numeric. Use the exact key and value for external-ID lookups; these are distinct from the canonical ID. SOURCE_KEY below is an illustrative placeholder.

data.items.externalIds.{key}string

data.items.seasonstring

data.items.phaseenum<string>

Available options: regular, postseason, cup

data.items.stageenum<string>

Available options: regular, semi-playoff, playoff, championship, group, semifinal, final

data.items.groupNamestring | null

data.items.scheduleDatestring

data.items.scheduledStartUtcstring | null

data.items.statusenum<string>

Available options: Scheduled, In Progress, Final, Postponed, Suspended, Cancelled, Unknown

data.items.statusTextstring | null

data.items.homeTeamIdstring | null

data.items.awayTeamIdstring | null

data.items.venueIdstring | null

data.items.neutralSiteboolean | null

data.items.gameCodestring

data.items.bestOfSetsnumber

data.items.relaySnapshotsobject[]

data.items.relaySnapshots.setNumbernumber

data.items.relaySnapshots.playIdsstring[]

data.items.relaySnapshots.lineupIdsstring[]

data.items.relaySnapshots.payloadHashstring

data.items.relaySnapshots.observedAtstring

data.items.setIdsstring[]

data.items.recordSnapshotobject | null

data.items.recordSnapshot.playerBoxScoreIdsstring[]

data.items.recordSnapshot.payloadHashstring

data.items.recordSnapshot.observedAtstring

data.items.coverageobject

Category-keyed source availability with per-category observation times and failure/retry reasons. Known categories are records, relay, lineups and rotations; available does not prove inferred rotations.

data.items.coverage.{key}object

data.items.coverage.{key}.availabilityenum<string>

Available options: available, unavailable, partial

data.items.coverage.{key}.sourcestring

data.items.coverage.{key}.observedAtstring

data.items.coverage.{key}.detailstring | null

data.items.officialRecordsobject | null

data.items.officialRecords.namespace"kovo"

data.items.officialRecords.observedAtstring

data.items.officialRecords.teamsobject[]

data.items.officialRecords.teams.teamIdstring | null

data.items.officialRecords.teams.sourceTeamCodestring

data.items.officialRecords.teams.metricsobject

Provider-native numeric statistic dictionary. Interpret keys using the surrounding metric namespace and statistic definitions. Missing metrics are not zero; signed efficiency values are preserved.

data.items.officialRecords.teams.metrics.{key}number | null

data.items.officialRecords.playersobject[]

data.items.officialRecords.players.playerIdstring | null

data.items.officialRecords.players.teamIdstring | null

data.items.officialRecords.players.sourcePlayerCodestring

data.items.officialRecords.players.sourceTeamCodestring

data.items.officialRecords.players.playerNamestring | null

data.items.officialRecords.players.positionstring | null

data.items.officialRecords.players.jerseyNumberstring | null

data.items.officialRecords.players.setAppearanceFlagsobject

KOVO source set-appearance flag keys ynS1 through ynS5, retained as text. Their meanings do not establish verified starting positions or court rotations.

data.items.officialRecords.players.setAppearanceFlags.{key}string | null

data.items.officialRecords.players.metricsobject

Provider-native numeric statistic dictionary. Interpret keys using the surrounding metric namespace and statistic definitions. Missing metrics are not zero; signed efficiency values are preserved.

data.items.officialRecords.players.metrics.{key}number | null

data.items.officialobject | null

data.items.official.sourceGameNostring

data.items.official.attendancenumber | null

data.items.official.venueNamestring | null

data.items.official.citystring | null

data.items.official.officialsobject[]

data.items.official.officials.rolestring

data.items.official.officials.namestring

data.items.official.playingTimeMinutesnumber | null

data.items.official.setDurationsobject[]

data.items.official.setDurations.setNumbernumber

data.items.official.setDurations.minutesnumber | null

data.items.homeSetsWonnumber | null

data.items.awaySetsWonnumber | null

data.items.currentSetnumber | null

data.items.setsobject[]

data.items.sets.setNumbernumber

data.items.sets.homePointsnumber | null

data.items.sets.awayPointsnumber | null

data.items.sets.completedboolean

data.items.createdAtstring<date-time>

Optional canonical storage creation time.

data.items.updatedAtstring<date-time>

Canonical write time; individual field freshness is recorded under _prov.

data.items._provobject

Optional raw field provenance, returned only with provenance=true. Keys name the canonical camelCase fields; entries retain source, runId and ingestedAt. Map keyed by canonical source field name. Each value identifies the winning source, ingestion run, and ingestion timestamp for that field. Keys can use the stored camelCase field name even when the response uses snake_case.

data.items._prov.{key}object

data.items._prov.{key}.sourcestring

data.items._prov.{key}.runIdstring

data.items._prov.{key}.ingestedAtstring<date-time>

data.partitionobjectrequired

data.partition.leagueenum<string>required

Available options: vleaguemen, vleaguewomen, kovocupmen, kovocupwomen

data.partition.seasonenum<string>required

Available options: 2025-26, 2026-27, 2025, 2026

data.partition.phaseenum<string>required

Available options: regular, postseason, cup

data.partition.stageenum<string>

Available options: regular, semi-playoff, playoff, championship, group, semifinal, final

data.evidenceobjectrequired

data.evidence.sourcesstring[]

data.evidence.observedAtstring | null

data.evidence.ageMsnumber | null

data.evidence.fieldObservedAtobject

Canonical-field names mapped to source observation timestamps. Individual field age can differ from the document write time.

data.evidence.fieldObservedAt.{key}string

data.evidence.staleAfterMsnumber

data.evidence.staleboolean

data.evidence.availabilityenum<string>

Available options: available, unavailable

data.scopeobject

data.scope.directorytrue

data.scope.historicalMembershipVerifiedfalse

_metaobject

Response request/cache metadata. Optional evidence fields are specific to this handler; cache TTL does not measure source-data freshness.

_meta.request_idstring

_meta.served_fromenum<string>

Available options: live, cache

_meta.cache_ttl_secondsinteger

Response cache TTL; independent of source freshness. Omitted when zero.