List canonical teams.

GET

/v1/teams

curl --request GET \
  --url 'https://api.betflux.ai/v1/teams?league=MLB' \
  --header 'Authorization: Bearer <token>'

Authorizations

• bearerAuth

Parameters

Query Parameters

league

string

Allowed values: MLB NBA NHL NFL NCAAM NCAAF

limit

integer

>= 1 <= 10000

cursor

string

Responses

200

Teams.

Media typeapplication/json

object

data

required

Array<object>

object

id

required

Canonical team UUID — stable across seasons.

string

league

required

League code the team plays in.

string

name

required

Canonical full team name, e.g. Miami Heat (the value team filters match).

string

short_name

required

Short display name, e.g. Heat.

string

abbreviation

required

League abbreviation, e.g. MIA.

string

city

required

Home city; null when not tracked.

string | null

conference

required

Conference, e.g. Eastern; null where the league has none.

string | null

division

required

Division, e.g. Southeast; null where the league has none.

string | null

is_active

required

False for defunct or relocated franchises.

boolean

next_cursor

required

string | null

Example^generated

{
  "data": [
    {
      "id": "example",
      "league": "example",
      "name": "example",
      "short_name": "example",
      "abbreviation": "example",
      "city": "example",
      "conference": "example",
      "division": "example",
      "is_active": true
    }
  ],
  "next_cursor": "example"
}

400

Validation failed — unknown or invalid query parameter, or a malformed range (problem type validation-error).

Media typeapplication/problem+json

RFC 9457 problem details. Dispatch on the stable type URI (https://api.betflux.ai/problems/*), never on the English title.

object

type

required

Stable problem type URI.

string

title

required

Short human-readable summary.

string

status

required

HTTP status code.

integer

detail

Explanation specific to this occurrence.

string

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example"
}

401

Missing, malformed, or unrecognized API key (problem type invalid-key).

Media typeapplication/problem+json

RFC 9457 problem details. Dispatch on the stable type URI (https://api.betflux.ai/problems/*), never on the English title.

object

type

required

Stable problem type URI.

string

title

required

Short human-readable summary.

string

status

required

HTTP status code.

integer

detail

Explanation specific to this occurrence.

string

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example"
}

402

The key is valid, but the account has no active subscription (problem type subscription-required). The response includes upgrade_url.

Media typeapplication/problem+json

RFC 9457 problem details. Dispatch on the stable type URI (https://api.betflux.ai/problems/*), never on the English title.

object

type

required

Stable problem type URI.

string

title

required

Short human-readable summary.

string

status

required

HTTP status code.

integer

detail

Explanation specific to this occurrence.

string

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example"
}

403

API key revoked or suspended (problem type key-disabled); a feature the plan does not include (problem type plan-excludes, with feature — live for the live sportsbook-lines routes, league_datasets for league-scoped datasets — required_tiers and upgrade_url; never worth retrying on the same key); or a game outside the key’s history window (problem type history-restricted): a trial key reads only games dated the first Saturday of a month or the Sunday after it, and its 403 carries upgrade_url and sample: "first-weekend".

Media typeapplication/problem+json

RFC 9457 problem details. Dispatch on the stable type URI (https://api.betflux.ai/problems/*), never on the English title.

object

type

required

Stable problem type URI.

string

title

required

Short human-readable summary.

string

status

required

HTTP status code.

integer

detail

Explanation specific to this occurrence.

string

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example"
}

429

Rate limit, games allowance, or ops throttle — the problem type distinguishes rate-limited, quota-exhausted and throttled. quota-exhausted refuses only a new game past the period’s allowance (games already counted stay readable) and carries reset_at, upgrade_url, game_id, games_used and games_allowance.

Media typeapplication/problem+json

RFC 9457 problem details. Dispatch on the stable type URI (https://api.betflux.ai/problems/*), never on the English title.

object

type

required

Stable problem type URI.

string

title

required

Short human-readable summary.

string

status

required

HTTP status code.

integer

detail

Explanation specific to this occurrence.

string

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example"
}