Read observed lifecycle transitions without private commentary

GET

https://api.datafortennis.com/v2/live/matches/:matchId/status-history

GET

/v2/live/matches/:matchId/status-history

const url = 'https://api.datafortennis.com/v2/live/matches/matchId/status-history';
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": [
    {
      "id": "string",
      "match_id": "string",
      "score_revision": "string",
      "previous_status": "scheduled",
      "status": "scheduled",
      "interruption_reason": "rain",
      "source_observed_at": "string",
      "received_at": "string",
      "winner_player_id": "string",
      "winner_basis": "provider",
      "result_reason": "normal",
      "status_updated_at": "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

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