Teams, Players & Rosters

Standings

Universal across baseball (MLB, KBO, NPB), basketball (NBA, KBL), soccer, football (NFL), and hockey (NHL). Baseball / basketball / soccer return an array of sport-specific rows sharing the base standings columns (team, wins, losses, rank): baseball rows add win percentage, games back, and streak; basketball rows add conference/division context; soccer rows add points, goal difference, and group placement. Baseball rows from MLB also carry the league's official qualification as the feed states it (clinch_indicator, clinched, division_champ, division_leader, wild_card_rank, wild_card_games_back, magic / elimination numbers); NBA rows carry the conference they are ranked in and the source's clinch code (conference, clinch_indicator, clinched). Each is absent, never empty, when the source does not state it.

Football and hockey return a { season, teams } board projected from the standings columns on the canonical team docs: NFL rows carry conference/division ranks, playoff seed, wins/losses/ties, win pct, and points for/against; NHL rows carry conference/division ranks, playoff seed, wins/losses/OT losses, standings points, points percentage, and goals for/against. season is the latest max_year across teams.

competition is required for soccer and optional for baseball and basketball, where the league id is the competition id. group applies to cup-stage soccer competitions (e.g. "Group A"). conference and division filter basketball standings. The filters are accepted and ignored for football and hockey, where the league is the competition and rows already carry conference/division context. Until the standings ingestion has run for a league, the endpoint returns an empty array (or an empty teams board) rather than 404.

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

GEThttps://api.sportquanta.com/v1/{league}/standings

Reference context: WKBL.

Overview · Response conventions

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

{
  "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",
      "sport": "<string>",
      "competition_id": "<string>",
      "season": "<string>",
      "group_code": "<string>",
      "group_name": "<string>",
      "group_name_localized": "<string>",
      "team_id": "<string>",
      "rank": 0,
      "played": 0,
      "wins": 0,
      "losses": 0,
      "pct": 0,
      "games_back": 0,
      "conference_rank": 0,
      "division_rank": 0,
      "conference_record": "<string>",
      "division_record": "<string>",
      "home_record": "<string>",
      "away_record": "<string>",
      "last10": "<string>",
      "streak": "<string>",
      "conference": "<string>",
      "clinch_indicator": "<string>",
      "clinched": true
    }
  ],
  "_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

Query Parameters

competitionstring

seasonstring

groupstring

conferencestring

divisionstring

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.

langstring

Display language for supported standings labels (en, ko, ja). Raw values remain available.

competitionIdstring

Alias for competition on soccer standings.

groupCodestring

Alias for group.

divisionCodestring

Alias for division.

leagueGroupCodestring

Baseball league-group alias used when group is absent.

Response

application/json

Standings rows ordered by rank.

dataobject[] | nullrequired

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

data.competition_idstringrequired

data.seasonstringrequired

data.group_codestring

data.group_namestring

data.group_name_localizedstring

data.team_idstringrequired

data.rankintegerrequired

data.playedintegerrequired

data.winsintegerrequired

data.lossesintegerrequired

data.pctnumberrequired

data.games_backnumberrequired

data.conference_rankintegerrequired

data.division_rankintegerrequired

data.conference_recordstringrequired

data.division_recordstringrequired

data.home_recordstringrequired

data.away_recordstringrequired

data.last10stringrequired

data.streakstringrequired

data.conferencestring

The table the row is ranked in: NBA "East" / "West". Absent on KBL rows (a single round-robin league) and on rows written before the producer carried it.

data.clinch_indicatorstring

The source's clinch code (ESPN's clincher / stats.nba.com's ClinchIndicator): z best conference record, y division, x playoff berth, xp a berth won through the play-in, pb or pi a play-in berth, e eliminated. Absent when the club has clinched nothing; see clinched.

data.clinchedboolean

Whether the source carried a clinch for the club. Present (true or false) whenever the source had a clinch column; absent when it did not.

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