Skip to main content
GET
Get schedule player statistics

Scope

Stats are limited to the single schedule in the path. There is no season / multi-game rollup and no pagination — each requested category returns its full list. Each row includes category metrics plus teamId, teamName, and a nested player object (_id, name, jerseyNumber, and optional position / profilePicture / userId). When both sides have recorded plays (home teamOneId and a linked teamTwoId), rows from both teams are included. The schedule’s home team (teamOneId) must belong to the API key organization.

Envelope

Always:

Meta (scores + period breakdown)

data.meta is always present (same shape whether or not you filter categories / teamId): Use meta.scoreBreakdown.periods for quarter/half columns. Do not invent a period split from the final alone (e.g. 0-0-0-0 with a total of 27). Treat meta.teamOneScore / meta.teamTwoScore and scoreBreakdown.*.final as the game total.

Categories

There is no specialTeams array. Interception-return touchdowns are defensiveStat.interceptionReturnTouchDown, not returnStat.

Shared row fields

Every non-empty row includes: Do not expect flat playerName / jerseyNumber on the row root. Metric names match the wire (e.g. totalPassAttempts, flagPulls), not alternate shorthand.

Nested player

jerseyNumber may be a string or number; position, profilePicture, and userId are omitted or null when unset.

Example (all categories)

Representative response shape:

Metric fields by category

quarterbackStat

qbLongestRush, totalPassAttempts, totalCompletions, totalPassingTouchdown, totalQuarterBackRushTouchdown, totalQuarterBackGames, totalInterceptionThrown, totalIncompletePasses, totalQuarterBackPoints, longestPass, totalPassingYards, totalQuarterBackRushYards, totalQuarterBackRuns, totalSacksTaken, totalSackYardage, extraPoint1–extraPoint3, attemptedExtraPoint1–attemptedExtraPoint3, totalQuarterBackYards, completionPercentage, averageTotalPassingYardsPerGame

offensiveStat

points, targets, receptions, touchdownCatches, touchdownRun, rushingLong, receivingLong, receivingYards, rushingYards, receptionPercentage, touchdownRunPerGame, receivingYardsPerGame, rushYardPerGame, totalOffensiveYards, runs, extraPoint1–extraPoint3, attemptedExtraPoint1–attemptedExtraPoint3, games

defensiveStat

qbPressures, interceptions, deflections, sacks, flagPulls, flagPullForLoss, interceptionYards, sackYardsForced, interceptionReturnTouchDown, defensiveExtraPointsMade, defensiveTryAttempts, defensivePoints, safety, games

puntStat

numberOfGames, totalNumberOfPunts, totalPuntingYards, averagePuntYardage, longestPuntYard, puntsInside20

returnStat

numberOfGames, puntReturns, muffedPunts, touchdownReturns, puntReturnYards, longestPuntReturn, positiveReturnRate

Special teams

Response still includes all five keys; QB / offense / defense are [].

Optional teamId filter

  • Omit teamId → both teams (when both have plays)
  • Provide home teamOneId or linked away teamTwoId → that team only
  • A teamId that is not on this schedule → 400 (teamId must be teamOneId or teamTwoId on this schedule)
Guest opponents with only teamTwoName (no teamTwoId) do not get a separate away bucket.

Categories query

Allowed values: quarterbackStat, offensiveStat, defensiveStat, puntStat, returnStat. Optional: searchTerm (matches player.name or player.jerseyNumber).

Authorizations

Authorization
string
header
required

Public integration API key (bb_live_...). Not a login JWT.

Path Parameters

scheduleId
string
required
Example:

"66f0a1b2c3d4e5f678901234"

Query Parameters

teamId
string

Optional. Limit rows to one team on this schedule (home teamOneId or linked teamTwoId). Omit to include both teams when both have plays.

Example:

"6917707a0e8f6ee5171235c2"

categories
enum<string>[]

Stat categories to include. Repeat for multiple values.

Player stat list category. Use as repeated categories query values.

Available options:
quarterbackStat,
offensiveStat,
defensiveStat,
puntStat,
returnStat
searchTerm
string

Filter by player display name or jersey number (partial match).

Response

Player statistics by category

data
object
required

Always includes meta plus all five category keys as arrays. Unrequested categories are []. Each row: category metrics + nested player + teamId/teamName. Special teams = puntStat + returnStat (no specialTeams key).