Teams, Players & Rosters

KOVO Cup Men statistic definitions

KOVO Cup 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/kovocupmen/statistic-definitions

Reference context: KOVO Cup Men.

Overview · Response conventions

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

{
  "data": {
    "items": [
      {
        "key": "<string>",
        "namespace": "naver",
        "unit": "count",
        "denominator": "<string>",
        "calculationMode": "provider_reported",
        "description": "<string>",
        "formulaVerified": true
      }
    ],
    "partition": {
      "league": "vleaguemen",
      "season": "2025-26",
      "phase": "regular",
      "stage": "regular"
    },
    "unavailable": [
      "<string>"
    ]
  },
  "_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, 2026

phaseenum<string>default:cup

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

Available options: cup

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.

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.

Response

application/json

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

dataobjectrequired

data.itemsobject[]required

data.items.option 1object

data.items.keystring

data.items.namespace"naver"

data.items.unitenum<string>

Available options: count, points, sets, matches, percent, ratio, events_per_set, unknown

data.items.denominatorstring | null

data.items.calculationMode"provider_reported"

data.items.descriptionstring

data.items.formulaVerifiedboolean

data.items.option 2object

data.items.keystring

data.items.namespace"kovo"

data.items.scopeenum<string>

Available options: team, player

data.items.providerKeystring

data.items.unit"unknown"

data.items.denominatornull

data.items.calculationMode"provider_reported"

data.items.descriptionstring

data.items.formulaVerifiedfalse

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.unavailablestring[]required

Source-dependent capabilities that have not been verified, including court rotations, sideout/rotation efficiency, complete historical rosters and odds.

_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.