Skip to content
Product Documentation

List canonical teams.

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

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
league
string
Allowed values: MLB NBA NHL NFL NCAAM
limit
integer
>= 1 <= 10000
cursor
string

Responses

Section titled “Responses”

200

Section titled “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
Examplegenerated
{
  "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

Section titled “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
Examplegenerated
{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example"
}

401

Section titled “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
Examplegenerated
{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example"
}

402

Section titled “402”

The key has no entitled tier — subscription lapsed or absent (problem type subscription-required; the body carries an 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
Examplegenerated
{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example"
}

403

Section titled “403”

API key revoked or suspended (problem type key-disabled), or the requested range exceeds the tier’s history window (history-restricted).

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
Examplegenerated
{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example"
}

429

Section titled “429”

Rate limit, monthly row quota, or ops throttle — the problem type distinguishes rate-limited, quota-exhausted, and throttled.

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
Examplegenerated
{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example"
}