Season Stats & Analytics

Player play types

NBA-only. synergyplaytypes with PlayerOrTeam=P: the eleven play types (isolation, transition, pnrBallHandler, pnrRollMan, postUp, spotUp, cut, handoff, offScreen, putback, misc) on offense and defense, each with possessions, points per possession, frequency (POSS_PCT), the FG line, eFG%, score / turnover / shooting-foul / and-one possession shares and Synergy's percentile. A play type Synergy publishes no row for is all-null. Written daily by statsapi:player-synergy.

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

GEThttps://api.sportquanta.com/v1/nba/players/{id}/playtypes

Reference context: NBA.

Overview · Response conventions

curl --request GET \
  --url 'https://api.sportquanta.com/v1/nba/players/{id}/playtypes?season=1946' \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "canonicalId": "<string>",
    "playerId": "<string>",
    "teamId": "<string>",
    "season": 0,
    "offense": {
      "isolation": {
        "possessions": 120,
        "pointsPerPossession": 1.05
      }
    },
    "defense": {
      "isolation": {
        "possessions": 120,
        "pointsPerPossession": 1.05
      }
    }
  },
  "_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

idstringrequired

Query Parameters

seasonintegerrequired

Season start year (2025 for the 2025-26 season).

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

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

application/json

The stored (subject, season) row.

dataobjectrequired

data.canonicalIdstring

data.playerIdstring | null

data.teamIdstring | null

data.seasonnumber

data.offenseobject

Provider season play-type statistics keyed by the stored camelCase play-type name, such as isolation or transition. Each value retains possessions, pointsPerPossession, frequency and the provider's outcome shares. Unpublished play-type rows retain null metrics; they are not zero-valued performances.

data.offense.{key}object

data.offense.{key}.possessionsnumber | null

data.offense.{key}.pointsPerPossessionnumber | null

data.offense.{key}.frequencynumber | null

data.offense.{key}.pointsnumber | null

data.offense.{key}.fieldGoalsMadenumber | null

data.offense.{key}.fieldGoalsAttemptednumber | null

data.offense.{key}.fieldGoalPctnumber | null

data.offense.{key}.effectiveFieldGoalPctnumber | null

data.offense.{key}.scorePossPctnumber | null

data.offense.{key}.turnoverPossPctnumber | null

data.offense.{key}.freeThrowPossPctnumber | null

data.offense.{key}.shootingFoulPossPctnumber | null

data.offense.{key}.plusOnePossPctnumber | null

data.offense.{key}.percentilenumber | null

data.defenseobject

data.defense.{key}object

data.defense.{key}.possessionsnumber | null

data.defense.{key}.pointsPerPossessionnumber | null

data.defense.{key}.frequencynumber | null

data.defense.{key}.pointsnumber | null

data.defense.{key}.fieldGoalsMadenumber | null

data.defense.{key}.fieldGoalsAttemptednumber | null

data.defense.{key}.fieldGoalPctnumber | null

data.defense.{key}.effectiveFieldGoalPctnumber | null

data.defense.{key}.scorePossPctnumber | null

data.defense.{key}.turnoverPossPctnumber | null

data.defense.{key}.freeThrowPossPctnumber | null

data.defense.{key}.shootingFoulPossPctnumber | null

data.defense.{key}.plusOnePossPctnumber | null

data.defense.{key}.percentilenumber | null

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