Skip to content
Product Documentation

List a bounded page of immutable MSF archives.

GET
/v1/leagues/{league}/{dataset}/archives
curl --request GET \
  --url https://api.betflux.ai/v1/leagues/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”
league
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"
}