Skip to content

Teams, Players & Rosters

List teams

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/teams
GETGet KOVO Cup Men teams
GET/v1/kovocupmen/teams

Get KOVO Cup Men teams

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.

Authorization
Query
Get KOVO Cup Men teamscURL
200Example

Reference context: KOVO Cup Men.

Overview · Response conventions

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.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.fullNamestring
data.items.namestring
data.items.codestring
data.items.abbreviationstring | null
data.items.localizedNamesobject | null
data.items.localizedNames.enobject | string

English name entry, when available.

data.items.localizedNames.en.option 1object
data.items.localizedNames.en.languagestring | null

BCP-47 tag echoing the map key. Retained for back-compat with the legacy baseball/basketball slot shape; new writers may omit it.

data.items.localizedNames.en.namestring | null

Short / common display form (e.g. "두산", "맨유").

data.items.localizedNames.en.fullNamestring | null

Official long form (e.g. "두산 베어스", "맨체스터 유나이티드").

data.items.localizedNames.en.shortNamestring | null

Short-name variant (legacy baseball/basketball slot field).

data.items.localizedNames.en.givenNamestring | null

Given/first name in this locale, when split out.

data.items.localizedNames.en.familyNamestring | null

Family/last name in this locale, when split out.

data.items.localizedNames.en.displayNamestring | null

Preferred UI display label for this locale.

data.items.localizedNames.en.romanizedboolean

True when this name was produced by algorithmic transliteration (Korean Revised Romanization, Japanese Hepburn) as a fallback rather than sourced from an official/native feed. Absent or false means the value came from an authoritative source. Lets consumers distinguish a machine-romanized name from an official spelling.

data.items.localizedNames.en.nameSourcestring | null

Origin of the value for auditing, e.g. 'naver', 'koreabaseball', 'npb_official', 'flashscore', 'statsapi', 'rr', 'hepburn'.

data.items.localizedNames.koobject | string

Korean name entry, when available.

data.items.localizedNames.ko.option 1object
data.items.localizedNames.ko.languagestring | null

BCP-47 tag echoing the map key. Retained for back-compat with the legacy baseball/basketball slot shape; new writers may omit it.

data.items.localizedNames.ko.namestring | null

Short / common display form (e.g. "두산", "맨유").

data.items.localizedNames.ko.fullNamestring | null

Official long form (e.g. "두산 베어스", "맨체스터 유나이티드").

data.items.localizedNames.ko.shortNamestring | null

Short-name variant (legacy baseball/basketball slot field).

data.items.localizedNames.ko.givenNamestring | null

Given/first name in this locale, when split out.

data.items.localizedNames.ko.familyNamestring | null

Family/last name in this locale, when split out.

data.items.localizedNames.ko.displayNamestring | null

Preferred UI display label for this locale.

data.items.localizedNames.ko.romanizedboolean

True when this name was produced by algorithmic transliteration (Korean Revised Romanization, Japanese Hepburn) as a fallback rather than sourced from an official/native feed. Absent or false means the value came from an authoritative source. Lets consumers distinguish a machine-romanized name from an official spelling.

data.items.localizedNames.ko.nameSourcestring | null

Origin of the value for auditing, e.g. 'naver', 'koreabaseball', 'npb_official', 'flashscore', 'statsapi', 'rr', 'hepburn'.

data.items.localizedNames.jaobject | string

Japanese name entry, when available.

data.items.localizedNames.ja.option 1object
data.items.localizedNames.ja.languagestring | null

BCP-47 tag echoing the map key. Retained for back-compat with the legacy baseball/basketball slot shape; new writers may omit it.

data.items.localizedNames.ja.namestring | null

Short / common display form (e.g. "두산", "맨유").

data.items.localizedNames.ja.fullNamestring | null

Official long form (e.g. "두산 베어스", "맨체스터 유나이티드").

data.items.localizedNames.ja.shortNamestring | null

Short-name variant (legacy baseball/basketball slot field).

data.items.localizedNames.ja.givenNamestring | null

Given/first name in this locale, when split out.

data.items.localizedNames.ja.familyNamestring | null

Family/last name in this locale, when split out.

data.items.localizedNames.ja.displayNamestring | null

Preferred UI display label for this locale.

data.items.localizedNames.ja.romanizedboolean

True when this name was produced by algorithmic transliteration (Korean Revised Romanization, Japanese Hepburn) as a fallback rather than sourced from an official/native feed. Absent or false means the value came from an authoritative source. Lets consumers distinguish a machine-romanized name from an official spelling.

data.items.localizedNames.ja.nameSourcestring | null

Origin of the value for auditing, e.g. 'naver', 'koreabaseball', 'npb_official', 'flashscore', 'statsapi', 'rr', 'hepburn'.

data.items.localizedNames.{key}object | string
data.items.localizedNames.{key}.option 1object
data.items.localizedNames.{key}.languagestring | null

BCP-47 tag echoing the map key. Retained for back-compat with the legacy baseball/basketball slot shape; new writers may omit it.

data.items.localizedNames.{key}.namestring | null

Short / common display form (e.g. "두산", "맨유").

data.items.localizedNames.{key}.fullNamestring | null

Official long form (e.g. "두산 베어스", "맨체스터 유나이티드").

data.items.localizedNames.{key}.shortNamestring | null

Short-name variant (legacy baseball/basketball slot field).

data.items.localizedNames.{key}.givenNamestring | null

Given/first name in this locale, when split out.

data.items.localizedNames.{key}.familyNamestring | null

Family/last name in this locale, when split out.

data.items.localizedNames.{key}.displayNamestring | null

Preferred UI display label for this locale.

data.items.localizedNames.{key}.romanizedboolean

True when this name was produced by algorithmic transliteration (Korean Revised Romanization, Japanese Hepburn) as a fallback rather than sourced from an official/native feed. Absent or false means the value came from an authoritative source. Lets consumers distinguish a machine-romanized name from an official spelling.

data.items.localizedNames.{key}.nameSourcestring | null

Origin of the value for auditing, e.g. 'naver', 'koreabaseball', 'npb_official', 'flashscore', 'statsapi', 'rr', 'hepburn'.

data.items.logoAssetKeystring | 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.