Get schedule player statistics
All player stat rows for one schedule (no pagination). Each row includes nested player, teamId / teamName, and category metric fields as returned on the wire. Omit categories to fetch all five; unrequested keys are [].
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 plusteamId, 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):
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
specialTeams array. Interception-return touchdowns are defensiveStat.interceptionReturnTouchDown, not returnStat.
Shared row fields
Every non-empty row includes: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
[].
Optional teamId filter
- Omit
teamId→ both teams (when both have plays) - Provide home
teamOneIdor linked awayteamTwoId→ that team only - A
teamIdthat is not on this schedule →400(teamId must be teamOneId or teamTwoId on this schedule)
teamTwoName (no teamTwoId) do not get a separate away bucket.
Categories query
quarterbackStat, offensiveStat, defensiveStat, puntStat, returnStat.
Optional: searchTerm (matches player.name or player.jerseyNumber).Authorizations
Public integration API key (bb_live_...). Not a login JWT.
Path Parameters
"66f0a1b2c3d4e5f678901234"
Query Parameters
Optional. Limit rows to one team on this schedule (home teamOneId or linked teamTwoId). Omit to include both teams when both have plays.
"6917707a0e8f6ee5171235c2"
Stat categories to include. Repeat for multiple values.
Player stat list category. Use as repeated categories query values.
quarterbackStat, offensiveStat, defensiveStat, puntStat, returnStat Filter by player display name or jersey number (partial match).
Response
Player statistics by category
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).
