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 aggregation and no pagination — each requested category returns its full list. When both sides have recorded plays (home teamOneId and a linked teamTwoId), rows from both teams are included. Each row has teamId and teamName so you can tell which side the player belongs to. The schedule’s home team (teamOneId) must belong to the API key organization.

Response shape

On each row: Unrequested categories (via categories filter) are [].

Optional teamId filter

Limit rows to one side of the game:
  • 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 (player display name or jersey number).

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 all five keys as arrays. Unrequested categories are []. Each row includes teamId and teamName when attributable.