Games & Live Scores

V-League Men games by ID player stats

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/games/{id}/player-stats

Reference context: V-League Men.

Overview · Response conventions

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

{
  "data": {
    "items": [
      {
        "canonicalId": "<string>",
        "externalIds": {
          "SOURCE_KEY": "SOURCE_ENTITY_ID"
        },
        "gameId": "<string>",
        "season": "<string>",
        "phase": "regular",
        "teamId": "<string>",
        "playerId": "<string>",
        "playerName": "<string>",
        "position": "<string>",
        "stats": {
          "point": 17,
          "attackSuccess": 12,
          "receiveSuccessRate": -28.6
        },
        "metricNamespace": "naver",
        "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.

Path Parameters

idstringrequired

Opaque canonical entity ID returned by this competition's reader.

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.

Response

application/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.gameIdstring

data.items.seasonstring

data.items.phaseenum<string>

Available options: regular, postseason, cup

data.items.teamIdstring | null

data.items.playerIdstring

data.items.playerNamestring | null

data.items.positionstring | null

data.items.statsobject

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.stats.{key}number | null

data.items.metricNamespace"naver"

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.