Teams, Players & Rosters

V-League Women sets

V-League Women: 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/vleaguewomen/sets

Reference context: V-League Women.

Overview · Response conventions

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

{
  "data": {
    "items": [
      {
        "canonicalId": "<string>",
        "externalIds": {
          "SOURCE_KEY": "SOURCE_ENTITY_ID"
        },
        "gameId": "<string>",
        "season": "<string>",
        "phase": "regular",
        "setNumber": 0,
        "homePoints": 0,
        "awayPoints": 0,
        "completed": true,
        "durationMinutes": 0,
        "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.

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.

setNumberinteger

Optional set number. Sets have rally points and no elapsed match clock.

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

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

data.items.homePointsnumber | null

data.items.awayPointsnumber | null

data.items.completedboolean

data.items.durationMinutesnumber | null

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.