Skip to content
Product Documentation

List a bounded page of immutable MSF archives.

GET
/v1/games/{game_id}/{dataset}/archives
curl --request GET \
  --url https://api.betflux.ai/v1/games/example/example/archives \
  --header 'Authorization: Bearer <token>'

Free authenticated discovery. A cursor identifies one publisher-committed catalog page; each page contains at most 64 descriptors. Served only where MSF serving is enabled: GET /v1/datasets lists the MSF datasets available, and elsewhere every MSF route answers 404.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
game_id
required
string
dataset
required
string

Query Parameters

Section titled “Query Parameters”
cursor
string

Responses

Section titled “Responses”

200

Section titled “200”

List a bounded page of immutable MSF archives.

Media typeapplication/json
object
dataset
required
string
Allowed values: game-state plays player-stats team-stats injuries
scope
required
One of:
object
kind
required
string
Allowed values: game
game_id
required
string
>= 1 characters
schema_version
required
string
Allowed values: v1
archives
required
Array<object>
<= 64 items
object
archive_id
required
string
<= 128 characters /^[A-Za-z0-9_-]+$/
dataset
required
string
Allowed values: game-state plays player-stats team-stats injuries
scope
required
One of:
object
kind
required
string
Allowed values: game
game_id
required
string
>= 1 characters
schema_version
required
string
Allowed values: v1
stream_epoch
required
string
<= 128 characters /^[A-Za-z0-9_-]+$/
first_revision
required
integer
> 0 <= 9007199254740991
last_revision
required
integer
> 0 <= 9007199254740991
source_start
required
string format: date-time
source_end
required
string format: date-time
url
required
string
>= 1 characters
next_cursor
required
string | null
Example
{
  "dataset": "game-state",
  "scope": {
    "kind": "game"
  },
  "schema_version": "v1",
  "archives": [
    {
      "dataset": "game-state",
      "scope": {
        "kind": "game"
      },
      "schema_version": "v1"
    }
  ]
}

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

403

Section titled “403”

API key revoked or suspended (problem type key-disabled), or a game or league revision outside the key’s history window (problem type 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"
}

404

Section titled “404”

Unknown MSF dataset, unknown game, an uncovered league, nothing published yet, or a cursor naming no committed catalog page.

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

500

Section titled “500”

Committed archive metadata or files are corrupt or missing.

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

503

Section titled “503”

Temporary failure resolving the game id; 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
Examplegenerated
{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example"
}