teams

One row per canonical team. The id is the UUID the datasets carry in home_team_id and away_team_id; the name is the value the team filter on /v1/games and betflux get matches (home or away).

Fetching

curl -s "https://api.betflux.ai/v1/teams?league=NBA" \
  -H "Authorization: Bearer $BETFLUX_API_KEY"

betflux teams --league NBA

teams = bf.teams(league="NBA")

Parameter	Meaning
league	Restrict to one league code
limit, cursor	Pagination

Sorted by league, then name. Teams are current state: is_active is false for defunct or relocated franchises, whose ids still appear on historical games.

Columns

Column	Type	Nullable	Description
id	string	no	Canonical team UUID — stable across seasons.
league	string	no	League code the team plays in.
name	string	no	Canonical full team name, e.g. Miami Heat (the value `team` filters match).
short_name	string	no	Short display name, e.g. Heat.
abbreviation	string	no	League abbreviation, e.g. MIA.
city	string	yes	Home city; null when not tracked.
conference	string	yes	Conference, e.g. Eastern; null where the league has none.
division	string	yes	Division, e.g. Southeast; null where the league has none.
is_active	boolean	no	False for defunct or relocated franchises.