Read retained immutable prediction history

GET

https://api.datafortennis.com/v1/matches/:matchId/predictions

GET

/v1/matches/:matchId/predictions

const url = 'https://api.datafortennis.com/v1/matches/matchId/predictions';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

{
  "data": [
    {
      "prediction_id": "string",
      "match_id": "string",
      "player_ids": [
        "string"
      ],
      "state_revision": "string",
      "score_revision": "string",
      "point_id": "string",
      "point_sequence": 1,
      "history_sequence": "string",
      "model_version": "string",
      "model_generation": "string",
      "probabilities": [
        0.5
      ],
      "quality": {
        "features_used": 1,
        "features_total": 77,
        "qualification": "shadow",
        "enrichment": "legacy"
      },
      "score_observed_at": "string",
      "score_received_at": "string",
      "enrichment_received_at": "string",
      "prediction_requested_at": "string",
      "computed_at": "string",
      "point_revision": "string",
      "source_observed_at": "string",
      "source_last_observed_at": "string",
      "expires_at": "string",
      "supersedes_prediction_id": "string"
    }
  ],
  "meta": {
    "scope": "observed_live",
    "pagination": "dynamic",
    "retention_days": 180
  },
  "page": {
    "limit": 1,
    "next_cursor": "string"
  },
  "error": {}
}

Limited engineering preview. Canonical own IDs; raw commentary and provider endpoints are private. No statistical quality or live SLA claim.

Authentication

AuthorizationBearer

Private development credential: keyId.secret; rotate/revoke through the offline operations CLI.

Path parameters

matchIdstringRequiredformat: "^mat_[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$"

Query parameters

limitstringOptionalformat: "^(?:[1-9]|[1-9][0-9]|100)$"

cursorstringOptional<=800 characters

point_idstringOptionalformat: "^pnt_[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$"

score_revisionstringOptionalformat: "^[1-9][0-9]{0,17}$"

Response

Canonical observed data

datalist of objects

metaobject

pageobject

errorobject or null

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

503

Service Unavailable Error