Discover tracked singles matches across admitted tours

GET

https://api.datafortennis.com/v2/live/matches

GET

/v2/live/matches

const url = 'https://api.datafortennis.com/v2/live/matches';
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",
      "player_ids": [
        "string"
      ],
      "player_names": [
        "string"
      ],
      "tournament_id": "string",
      "edition_id": "string",
      "draw_id": "string",
      "tournament_name": "string",
      "tour": "atp",
      "gender": "men",
      "discipline": "singles",
      "category": "string",
      "prediction_eligible": true,
      "best_of": 3,
      "round": "string",
      "scheduled_start": "string",
      "status": "scheduled",
      "interruption_reason": "rain",
      "score_revision": "string",
      "prediction_input_revision": "string",
      "score": {
        "sets": [
          {
            "set": 1,
            "side1_games": 1,
            "side2_games": 1
          }
        ],
        "points": {
          "side1": "string",
          "side2": "string"
        },
        "server_side": 1,
        "points_kind": "normal"
      },
      "score_observed_at": "string",
      "source_last_observed_at": "string",
      "score_received_at": "string",
      "enrichment_deadline_at": "string",
      "point_id": "string",
      "point_sequence": 1,
      "point_revision": 1,
      "statistics": [
        {
          "code": "string",
          "side_no": 1,
          "period": "string",
          "numerator": 1.1,
          "denominator": 1.1,
          "value": 1.1,
          "unit": "ratio",
          "basis": "verified_point_prefix",
          "point_sequence": 1
        }
      ],
      "availability": "observed",
      "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.

Query parameters

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

cursorstringOptional<=800 characters

statusenumOptional

tourenumOptional

Allowed values:

genderenumOptional

Allowed values:

categorystringOptional1-40 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