Skip to main content
GET
List schedules
Use filter=live or filter=upcoming (default upcoming). When a schedule has a linked opponent (teamTwoId), list items look up that team the same way as teamOneId (object with _id, name, and related team fields), instead of returning only a bare id string.

Scores on each list item

Same as Get schedule:
  • teamOneScore / teamTwoScore — finals (or live totals)
  • scoreBreakdown — period arrays sized by matchupFormat (quarters → 4, halves → 2, runningClock → [])
Use scoreBreakdown.teamOne.final / scoreBreakdown.teamTwo.final (or the top-level score fields) for the game total; period columns can under-count when OT or untagged plays exist.

Authorizations

Authorization
string
header
required

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

Query Parameters

filter
enum<string>
default:upcoming

upcoming (default) = future not live; live = in progress

Available options:
live,
upcoming
Example:

"upcoming"

pageNo
integer
default:1
Required range: x >= 1
Example:

1

size
integer
default:10
Required range: x >= 1
Example:

10

searchTerm
string

Search by event title or team name

tournamentId
string

Filter by tournament id. Repeat for multiple values.

Example:

"507f1f77bcf86cd799439011"

Response

Schedules listed

data
object[]
total
integer
Example:

1