Player details

Requires the odds entitlement (a paid plan). See Responses & Errors for the success envelope and availability rules.

GEThttps://api.sportquanta.com/v1/{league}/players/{id}Try it

GETGet a player

GEThttps://api.sportquanta.comhttps://api-stage.sportquanta.comhttp://localhost:8082/v1/{league}/players/{id}

Send

Get a player

Expand optional fieldsCollapse optional fields

Requires the odds entitlement (a paid plan). See Responses & Errors for the success envelope and availability rules.

Authorization

Authorizationstringheaderrequired

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

Bearer

Path

idstringrequired

Query

Get a playercURL

200Example

Reference context: WKBL.

Overview · Response conventions

Get a player

curl --request GET \
  --url 'https://api.sportquanta.com/v1/wkbl/players/{id}' \
  --header 'Authorization: Bearer <token>'

200 · Example

{
  "data": {
    "id": "<string>",
    "canonical_id": "<string>",
    "external_ids": {
      "SOURCE_KEY": "SOURCE_ENTITY_ID"
    },
    "created_at": "2026-10-29T00:00:00Z",
    "updated_at": "2026-10-29T00:00:00Z",
    "full_name": "<string>",
    "given_name": "<string>",
    "family_name": "<string>",
    "known_as": "<string>",
    "slug": "<string>",
    "jersey_number": "<string>",
    "position": "<string>",
    "date_of_birth": "<string>",
    "country": "<string>",
    "nationality": "<string>",
    "height_cm": 0,
    "weight_kg": 0,
    "headshot_asset_key": "<string>",
    "official_headshot_url": "<string>",
    "current_team_id": "<string>",
    "active": true,
    "localized_names": {
      "en": {
        "fullName": "Example Name",
        "displayName": "Example Name"
      },
      "ko": {
        "fullName": "예시 이름",
        "displayName": "예시 이름"
      }
    },
    "headshot_url": "<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.

Path Parameters

leagueenum<string>default:wkblrequired

League for this reference section: wkbl.

Available options: wkbl

idstringrequired

Query Parameters

provenancebooleandefault:false

Opt in to per-field provenance on supported single game, match, team, player, and venue reads. Lists and composites accept the flag but generally omit provenance. It is returned under _meta.provenance only when source metadata exists.

Response

200401403404429500502503application/json

Player document with materialized headshot_url.

dataobjectrequired

data.idstring

data.canonical_idstring

data.external_idsobject

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.external_ids.{key}string

data.created_atstring<date-time>

Canonical document creation timestamp, when present; not the scheduled start or event time.

data.updated_atstring<date-time>

Canonical document update timestamp, when present. It is not a guarantee that every field was refreshed at this time; field provenance carries individual ingestion times.

data.full_namestring

data.given_namestring

data.family_namestring

data.known_asstring

data.slugstring

data.jersey_numberstring

data.positionstring

data.date_of_birthstring

data.countrystring

data.nationalitystring

data.height_cminteger

data.weight_kginteger

data.headshot_asset_keystring

Stored asset key, when available. Prefer the materialized URL field for display instead of constructing a storage URL.

data.official_headshot_urlstring

data.current_team_idstring

data.activeboolean

data.localized_namesobject

Names keyed by BCP-47 language tag, not a single translated string. Each value contains optional camelCase name fields (displayName, fullName, name, shortName, givenName, familyName), language, romanized, and nameSource; older records may use a plain string. Only populated languages appear. Common keys are en, ko, and ja; other supported keys include es, de, fr, pt, it, nl, zh-Hans, and zh-Hant. For display, try displayName → fullName → name → shortName → the entity's base name. This map can be absent or empty. See localized names.

data.localized_names.enobject | string

English name entry, when available.

data.localized_names.en.option 1object

data.localized_names.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.localized_names.en.namestring | null

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

data.localized_names.en.fullNamestring | null

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

data.localized_names.en.shortNamestring | null

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

data.localized_names.en.givenNamestring | null

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

data.localized_names.en.familyNamestring | null

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

data.localized_names.en.displayNamestring | null

Preferred UI display label for this locale.

data.localized_names.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.localized_names.en.nameSourcestring | null

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

data.localized_names.koobject | string

Korean name entry, when available.

data.localized_names.ko.option 1object

data.localized_names.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.localized_names.ko.namestring | null

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

data.localized_names.ko.fullNamestring | null

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

data.localized_names.ko.shortNamestring | null

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

data.localized_names.ko.givenNamestring | null

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

data.localized_names.ko.familyNamestring | null

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

data.localized_names.ko.displayNamestring | null

Preferred UI display label for this locale.

data.localized_names.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.localized_names.ko.nameSourcestring | null

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

data.localized_names.jaobject | string

Japanese name entry, when available.

data.localized_names.ja.option 1object

data.localized_names.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.localized_names.ja.namestring | null

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

data.localized_names.ja.fullNamestring | null

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

data.localized_names.ja.shortNamestring | null

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

data.localized_names.ja.givenNamestring | null

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

data.localized_names.ja.familyNamestring | null

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

data.localized_names.ja.displayNamestring | null

Preferred UI display label for this locale.

data.localized_names.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.localized_names.ja.nameSourcestring | null

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

data.localized_names.{key}object | string

data.localized_names.{key}.option 1object

data.localized_names.{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.localized_names.{key}.namestring | null

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

data.localized_names.{key}.fullNamestring | null

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

data.localized_names.{key}.shortNamestring | null

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

data.localized_names.{key}.givenNamestring | null

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

data.localized_names.{key}.familyNamestring | null

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

data.localized_names.{key}.displayNamestring | null

Preferred UI display label for this locale.

data.localized_names.{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.localized_names.{key}.nameSourcestring | null

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

data.headshot_urlstring

Materialized player image URL, when resolvable. Omitted when no usable image is available.

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

_meta.provenanceobject

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.

_meta.provenance.{key}object

_meta.provenance.{key}.sourcestring

_meta.provenance.{key}.run_idstring

_meta.provenance.{key}.ingested_atstring<date-time>