List the games counted or exempt this period (free to read again), newest read first.

GET

/v1/me/games

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

Every game recorded in the current period, with when and through which dataset it was first read. Both counted and exempt games are free to read again, in every dataset, until the period resets. date_from and date_to bound the date in the game id, inclusive. Counts nothing, and answers 503 instead of an empty list when the usage ledger is unreachable.

Authorizations

• bearerAuth

Parameters

Query Parameters

league

League code (case-insensitive).

string

Allowed values: MLB NBA NHL NFL NCAAM NCAAF

League code (case-insensitive).

date_from

Inclusive lower bound on the date in the game id (YYYY-MM-DD).

string

Inclusive lower bound on the date in the game id (YYYY-MM-DD).

date_to

Inclusive upper bound on the date in the game id (YYYY-MM-DD).

string

Inclusive upper bound on the date in the game id (YYYY-MM-DD).

limit

Page size, default 200.

integer

>= 1 <= 1000

Page size, default 200.

cursor

Opaque cursor from the previous page’s next_cursor.

string

Opaque cursor from the previous page’s next_cursor.

Responses

200

A page of the period’s games.

Media typeapplication/json

object

data

required

Array<object>

object

game_id

required

Public game id.

string

first_read_at

required

ISO instant (UTC) of the read that recorded the game this period.

string

first_dataset

required

The dataset that first read came through.

string

cost

required

counted against the allowance, or exempt under the recent-game window. Both are free to read again all period.

string

Allowed values: counted exempt

next_cursor

required

string | null

Example

{
  "data": [
    {
      "cost": "counted"
    }
  ]
}

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"
}

503

The usage ledger did not answer (problem type internal-error, title Usage ledger unavailable). Retry shortly.

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"
}