Team season statistics

Returns the league-wide NBA team season aggregate set for the requested season, including offense/defense ranks computed at read time. Other leagues return 404 endpoint_not_for_sport.

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

GEThttps://api.sportquanta.com/v1/{league}/team-statsTry it

GETGet team season stats (NBA only)

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

Send

Get team season stats (NBA only)

Returns the league-wide NBA team season aggregate set for the requested season, including offense/defense ranks computed at read time. Other leagues return 404 endpoint_not_for_sport.

Requires the stats 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

Query

seasonintegerrequired

Get team season stats (NBA only)cURL

200Example

Reference context: WKBL.

Overview · Response conventions

Get team season stats (NBA only)

curl --request GET \
  --url 'https://api.sportquanta.com/v1/wkbl/team-stats?season=1946' \
  --header 'Authorization: Bearer <token>'

200 · Example

{
  "data": {
    "season": 0,
    "teams": [
      {
        "teamId": "<string>",
        "gamesPlayed": 0,
        "stats": {
          "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",
          "team_id": "<string>",
          "season": 0,
          "games_played": 0,
          "off_rating": 0,
          "def_rating": 0,
          "net_rating": 0,
          "pace": 0,
          "points_for": 0,
          "three_pointers_made": 0,
          "three_pointers_attempted": 0,
          "free_throws_made": 0,
          "free_throws_attempted": 0,
          "rebounds_offensive": 0,
          "rebounds_defensive": 0,
          "rebounds": 0,
          "points_in_paint": 0,
          "opp_points_in_paint": 0,
          "points_against": 0,
          "opp_three_pointers_made": 0,
          "opp_three_pointers_attempted": 0,
          "opp_free_throws_made": 0,
          "opp_free_throws_attempted": 0,
          "opp_rebounds_offensive": 0,
          "opp_rebounds_defensive": 0,
          "opp_rebounds": 0,
          "field_goals_made": 0,
          "field_goals_attempted": 0,
          "field_goal_pct": 0,
          "three_point_pct": 0,
          "free_throw_pct": 0,
          "assists": 0,
          "turnovers": 0,
          "steals": 0,
          "blocks": 0,
          "personal_fouls": 0,
          "plus_minus": 0,
          "true_shooting_pct": 0,
          "effective_field_goal_pct": 0,
          "turnover_pct": 0,
          "offensive_rebound_pct": 0,
          "defensive_rebound_pct": 0,
          "rebound_pct": 0,
          "assist_pct": 0,
          "assist_to_turnover": 0,
          "assist_ratio": 0,
          "pie": 0,
          "free_throw_attempt_rate": 0,
          "opp_effective_field_goal_pct": 0,
          "opp_free_throw_attempt_rate": 0,
          "opp_turnover_pct": 0,
          "opp_offensive_rebound_pct": 0
        },
        "offenseRanks": {
          "rating": 0,
          "pace": 0,
          "paintScoring": 0,
          "threePtScoring": 0,
          "freeThrows": 0,
          "rebounding": 0
        },
        "defenseRanks": {
          "rating": 0,
          "pace": 0,
          "paintScoring": 0,
          "threePtScoring": 0,
          "freeThrows": 0,
          "rebounding": 0
        }
      }
    ]
  },
  "_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

seasonintegerrequired

Required range: 1946 <= x, x <= 2100

Response

200400401403404429500502503application/json

Team season stats response for the requested NBA season.

dataobjectrequired

data.seasonintegerrequired

data.teamsobject[] | nullrequired

data.teams.teamIdstringrequired

data.teams.gamesPlayedinteger

data.teams.statsobjectrequired

data.teams.stats.idstring

data.teams.stats.canonical_idstring

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

data.teams.stats.created_atstring<date-time>

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

data.teams.stats.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.teams.stats.team_idstring

data.teams.stats.seasonintegerrequired

data.teams.stats.games_playedinteger

data.teams.stats.off_ratingnumber

data.teams.stats.def_ratingnumber

data.teams.stats.net_ratingnumber

data.teams.stats.pacenumber

data.teams.stats.points_fornumber

data.teams.stats.three_pointers_madenumber

data.teams.stats.three_pointers_attemptednumber

data.teams.stats.free_throws_madenumber

data.teams.stats.free_throws_attemptednumber

data.teams.stats.rebounds_offensivenumber

data.teams.stats.rebounds_defensivenumber

data.teams.stats.reboundsnumber

data.teams.stats.points_in_paintnumber

data.teams.stats.opp_points_in_paintnumber

data.teams.stats.points_againstnumber

data.teams.stats.opp_three_pointers_madenumber

data.teams.stats.opp_three_pointers_attemptednumber

data.teams.stats.opp_free_throws_madenumber

data.teams.stats.opp_free_throws_attemptednumber

data.teams.stats.opp_rebounds_offensivenumber

data.teams.stats.opp_rebounds_defensivenumber

data.teams.stats.opp_reboundsnumber

data.teams.stats.field_goals_madenumber

data.teams.stats.field_goals_attemptednumber

data.teams.stats.field_goal_pctnumber

data.teams.stats.three_point_pctnumber

data.teams.stats.free_throw_pctnumber

data.teams.stats.assistsnumber

data.teams.stats.turnoversnumber

data.teams.stats.stealsnumber

data.teams.stats.blocksnumber

data.teams.stats.personal_foulsnumber

data.teams.stats.plus_minusnumber

data.teams.stats.true_shooting_pctnumber

data.teams.stats.effective_field_goal_pctnumber

data.teams.stats.turnover_pctnumber

data.teams.stats.offensive_rebound_pctnumber

data.teams.stats.defensive_rebound_pctnumber

data.teams.stats.rebound_pctnumber

data.teams.stats.assist_pctnumber

data.teams.stats.assist_to_turnovernumber

data.teams.stats.assist_rationumber

data.teams.stats.pienumber

data.teams.stats.free_throw_attempt_ratenumber

data.teams.stats.opp_effective_field_goal_pctnumber

data.teams.stats.opp_free_throw_attempt_ratenumber

data.teams.stats.opp_turnover_pctnumber

data.teams.stats.opp_offensive_rebound_pctnumber

data.teams.offenseRanksobjectrequired

data.teams.offenseRanks.ratinginteger

data.teams.offenseRanks.paceinteger

data.teams.offenseRanks.paintScoringinteger

data.teams.offenseRanks.threePtScoringinteger

data.teams.offenseRanks.freeThrowsinteger

data.teams.offenseRanks.reboundinginteger

data.teams.defenseRanksobjectrequired

data.teams.defenseRanks.ratinginteger

data.teams.defenseRanks.paceinteger

data.teams.defenseRanks.paintScoringinteger

data.teams.defenseRanks.threePtScoringinteger

data.teams.defenseRanks.freeThrowsinteger

data.teams.defenseRanks.reboundinginteger

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