Quality, context and versions

Warnings and quality metadata used to filter less exploitable rows, plus traceability fields.

Fields

Field	Type	Description
`quality.warnings`	`array`	Data-quality warnings. An empty list does not guarantee correctness.
`quality.historical_class`	`string`	future for scheduled matches and past for verified historical matches.
`quality.versions`	`object`	Feature, flags, model, and calibration versions used for this row.
`context`	`object`	Structural competition context. The canonical phase is exposed as stage; compatibility flags include friendly, knockout, group_stage, first_leg, second_leg, final and neutral_venue. Unknown or unproven values remain false/null.
`versions`	`object`	Current top-level feature, flags, model, and calibration versions.
`provenance`	`object`	Public release provenance, without proprietary model logic.
`as_of`	`string`	UTC timestamp of the data the payload was built from, always before kickoff.

Example

Real values, taken from the same published payload the API returns (GET /v1/matches/{match_id}):

{
  "quality": {
    "warnings": [
      "example_recent_lineup_data_incomplete"
    ],
    "historical_class": "future",
    "versions": {
      "feature": "features-v1",
      "flags": "flags-v1",
      "model": "model-v1",
      "calibration": "calibration-v1"
    }
  },
  "context": {
    "friendly": false,
    "knockout": false,
    "group_stage": false,
    "first_leg": false,
    "second_leg": false,
    "final": false,
    "neutral_venue": false,
    "stage": "Regular season"
  },
  "versions": {
    "feature": "features-v1",
    "flags": "flags-v1",
    "model": "model-v1",
    "calibration": "calibration-v1"
  },
  "provenance": {
    "temporal_class": "published_pre_match_verified",
    "source_kind": "analytics_published_release",
    "source_match_id": "example-source-match-001",
    "source_release_id": "dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
    "source_snapshot_id": null,
    "source_data_cutoff_utc": "2026-10-16T11:59:59Z",
    "source_payload_sha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
    "source_promotion_receipt_sha256": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
    "publication_policy_version": "starter-publication-policy-v1",
    "transformation_version": "analytics-to-starter-transform-v2"
  },
  "as_of": "2026-10-16T12:00:00Z"
}

How to read it. This row carries a warning, so down-weight or filter it when training. Use as_of to prove no post-kickoff information leaked in, and the versions block to keep your features reproducible across releases.

Returned by GET /v1/matches/{match_id} and POST /v1/matches/bulk. Optional values can be missing — see Data quality.

↑ Back to top Back to contents

Quality, context and versions

Fields

Example

Related