Rotation

Basketball-only endpoint for nba and kbl. Returns the per-game rotation entity keyed by canonical game id. Other sports 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}/rotations/{id}Try it

GETGet a basketball rotation card

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

Send

Get a basketball rotation card

Expand optional fieldsCollapse optional fields

Basketball-only endpoint for nba and kbl. Returns the per-game rotation entity keyed by canonical game id. Other sports 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

idstringrequired

Query

Get a basketball rotation cardcURL

200Example

Reference context: WKBL.

Overview · Response conventions

Get a basketball rotation card

curl --request GET \
  --url 'https://api.sportquanta.com/v1/wkbl/rotations/{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",
    "game_id": "<string>",
    "home": {
      "teamId": "<string>",
      "players": [
        {
          "playerId": "<string>",
          "position": "<string>",
          "starter": true,
          "minutes": "<string>"
        }
      ],
      "substitutions": [
        {
          "period": 0,
          "clock": "<string>",
          "teamId": "<string>",
          "playerInId": "<string>",
          "playerOutId": "<string>",
          "playerInEventNum": 0,
          "playerOutEventNum": 0,
          "source": "<string>"
        }
      ],
      "periodLineups": [
        {
          "period": 0,
          "playerIds": [
            "<string>"
          ],
          "source": "<string>"
        }
      ],
      "stints": [
        {
          "playerId": "<string>",
          "period": 0,
          "startClock": "<string>",
          "endClock": "<string>",
          "startEventNum": 0,
          "endEventNum": 0,
          "durationSeconds": 0,
          "source": "<string>"
        }
      ],
      "reconciliation": [
        {
          "playerId": "<string>",
          "boxScoreSeconds": 0,
          "stintSeconds": 0,
          "deltaSeconds": 0,
          "withinTolerance": true
        }
      ],
      "availability": "available",
      "issues": [
        "<string>"
      ],
      "provenance": {
        "source": "<string>",
        "method": "starting_lineup_and_explicit_substitutions",
        "minuteToleranceSeconds": 0
      },
      "confirmed": true
    },
    "away": {
      "teamId": "<string>",
      "players": [
        {
          "playerId": "<string>",
          "position": "<string>",
          "starter": true,
          "minutes": "<string>"
        }
      ],
      "substitutions": [
        {
          "period": 0,
          "clock": "<string>",
          "teamId": "<string>",
          "playerInId": "<string>",
          "playerOutId": "<string>",
          "playerInEventNum": 0,
          "playerOutEventNum": 0,
          "source": "<string>"
        }
      ],
      "periodLineups": [
        {
          "period": 0,
          "playerIds": [
            "<string>"
          ],
          "source": "<string>"
        }
      ],
      "stints": [
        {
          "playerId": "<string>",
          "period": 0,
          "startClock": "<string>",
          "endClock": "<string>",
          "startEventNum": 0,
          "endEventNum": 0,
          "durationSeconds": 0,
          "source": "<string>"
        }
      ],
      "reconciliation": [
        {
          "playerId": "<string>",
          "boxScoreSeconds": 0,
          "stintSeconds": 0,
          "deltaSeconds": 0,
          "withinTolerance": true
        }
      ],
      "availability": "available",
      "issues": [
        "<string>"
      ],
      "provenance": {
        "source": "<string>",
        "method": "starting_lineup_and_explicit_substitutions",
        "minuteToleranceSeconds": 0
      },
      "confirmed": 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

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

200400401403404429500502503application/json

Rotation document.

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

data.homeobject

data.home.teamIdstring

Canonical team ID for this side.

data.home.playersobject[]

Player rotation/box-score entries, with starter flags and source-reported minutes.

data.home.players.playerIdstring | null

data.home.players.positionstring | null

data.home.players.starterboolean

Whether this source entry identifies the player as a starter.

data.home.players.minutesstring | null

Source box-score playing-time string, when available. The reconciler accepts M:SS, ISO-8601 PT durations, or numeric minutes; use reconciliation.boxScoreSeconds for parsed seconds.

data.home.substitutionsobject[]

Explicit substitution events with player-in/player-out IDs and remaining period clock, when available.

data.home.substitutions.periodnumber | null

data.home.substitutions.clockstring | null

data.home.substitutions.teamIdstring | null

data.home.substitutions.playerInIdstring | null

data.home.substitutions.playerOutIdstring | null

data.home.substitutions.playerInEventNumnumber | null

data.home.substitutions.playerOutEventNumnumber | null

data.home.substitutions.sourcestring | null

data.home.periodLineupsobject[]

Player IDs used to establish the lineup for a period, with the source/method of that lineup.

data.home.periodLineups.periodnumber

data.home.periodLineups.playerIdsstring[]

data.home.periodLineups.sourcestring

data.home.stintsobject[]

Reconstructed on-court intervals per player and period. Read availability, issues, and reconciliation before treating them as complete.

data.home.stints.playerIdstring

data.home.stints.periodnumber

data.home.stints.startClockstring

Remaining period clock at stint start, formatted M:SS (counts down).

data.home.stints.endClockstring

Remaining period clock at stint end, formatted M:SS (counts down).

data.home.stints.startEventNumnumber | null

Source event number at the interval start, or null when the boundary has no event number.

data.home.stints.endEventNumnumber | null

Source event number at the interval end, or null when the boundary has no event number.

data.home.stints.durationSecondsnumber

Nonnegative seconds in this on-court interval: start-clock seconds minus end-clock seconds.

data.home.stints.sourcestring

data.home.reconciliationobject[]

Per-player comparison of reconstructed stint seconds against parsed box-score minutes.

data.home.reconciliation.playerIdstring

data.home.reconciliation.boxScoreSecondsnumber | null

Box-score minutes parsed into seconds; null when unavailable or unparseable.

data.home.reconciliation.stintSecondsnumber

Total reconstructed on-court seconds across this player's stints.

data.home.reconciliation.deltaSecondsnumber | null

stintSeconds minus boxScoreSeconds; positive means the reconstructed timeline assigns more time. Null when box-score minutes are unavailable.

data.home.reconciliation.withinToleranceboolean | null

Whether absolute deltaSeconds is within provenance.minuteToleranceSeconds. Null when box-score minutes cannot be compared.

data.home.availabilityenum<string>

Available options: available, partial, provider_unavailable

data.home.issuesstring[]

Machine-readable explanations of incomplete or inconsistent rotation reconstruction, when present.

data.home.provenanceobject

data.home.provenance.sourcestring

data.home.provenance.method"starting_lineup_and_explicit_substitutions"

Reconstruction uses starting lineups and explicit substitution events.

data.home.provenance.minuteToleranceSecondsnumber

Maximum allowed absolute difference between reconstructed and box-score seconds for a player.

data.home.confirmedboolean

Side-level rotation/lineup confirmation. Derived timelines set this false when reconstruction issues remain; inspect availability and reconciliation as well.

data.awayobject

data.away.teamIdstring

Canonical team ID for this side.

data.away.playersobject[]

Player rotation/box-score entries, with starter flags and source-reported minutes.

data.away.players.playerIdstring | null

data.away.players.positionstring | null

data.away.players.starterboolean

Whether this source entry identifies the player as a starter.

data.away.players.minutesstring | null

Source box-score playing-time string, when available. The reconciler accepts M:SS, ISO-8601 PT durations, or numeric minutes; use reconciliation.boxScoreSeconds for parsed seconds.

data.away.substitutionsobject[]

Explicit substitution events with player-in/player-out IDs and remaining period clock, when available.

data.away.substitutions.periodnumber | null

data.away.substitutions.clockstring | null

data.away.substitutions.teamIdstring | null

data.away.substitutions.playerInIdstring | null

data.away.substitutions.playerOutIdstring | null

data.away.substitutions.playerInEventNumnumber | null

data.away.substitutions.playerOutEventNumnumber | null

data.away.substitutions.sourcestring | null

data.away.periodLineupsobject[]

Player IDs used to establish the lineup for a period, with the source/method of that lineup.

data.away.periodLineups.periodnumber

data.away.periodLineups.playerIdsstring[]

data.away.periodLineups.sourcestring

data.away.stintsobject[]

Reconstructed on-court intervals per player and period. Read availability, issues, and reconciliation before treating them as complete.

data.away.stints.playerIdstring

data.away.stints.periodnumber

data.away.stints.startClockstring

Remaining period clock at stint start, formatted M:SS (counts down).

data.away.stints.endClockstring

Remaining period clock at stint end, formatted M:SS (counts down).

data.away.stints.startEventNumnumber | null

Source event number at the interval start, or null when the boundary has no event number.

data.away.stints.endEventNumnumber | null

Source event number at the interval end, or null when the boundary has no event number.

data.away.stints.durationSecondsnumber

Nonnegative seconds in this on-court interval: start-clock seconds minus end-clock seconds.

data.away.stints.sourcestring

data.away.reconciliationobject[]

Per-player comparison of reconstructed stint seconds against parsed box-score minutes.

data.away.reconciliation.playerIdstring

data.away.reconciliation.boxScoreSecondsnumber | null

Box-score minutes parsed into seconds; null when unavailable or unparseable.

data.away.reconciliation.stintSecondsnumber

Total reconstructed on-court seconds across this player's stints.

data.away.reconciliation.deltaSecondsnumber | null

stintSeconds minus boxScoreSeconds; positive means the reconstructed timeline assigns more time. Null when box-score minutes are unavailable.

data.away.reconciliation.withinToleranceboolean | null

Whether absolute deltaSeconds is within provenance.minuteToleranceSeconds. Null when box-score minutes cannot be compared.

data.away.availabilityenum<string>

Available options: available, partial, provider_unavailable

data.away.issuesstring[]

Machine-readable explanations of incomplete or inconsistent rotation reconstruction, when present.

data.away.provenanceobject

data.away.provenance.sourcestring

data.away.provenance.method"starting_lineup_and_explicit_substitutions"

Reconstruction uses starting lineups and explicit substitution events.

data.away.provenance.minuteToleranceSecondsnumber

Maximum allowed absolute difference between reconstructed and box-score seconds for a player.

data.away.confirmedboolean

Side-level rotation/lineup confirmation. Derived timelines set this false when reconstruction issues remain; inspect availability and reconciliation as well.

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