Tennis

Get Detailed Live Match State

Retrieves real-time score, point history, and server for an active match.

get/tennis/matches/live/{match_id}

Request

  • Base URL: https://api.citoapi.com/api/v1
  • URL: https://api.citoapi.com/api/v1/tennis/matches/live/{match_id}
  • Auth: API key in header x-api-key

Path parameters

match_idstring required

Response

Successful Response

idstring required

Canonical match identifier (same value as match_id)

match_idstring required

Unique live match ID

started_atstring

When the match went in-play (ISO 8601)

round_namestring

Human label for the round code

tourstring

ATP or WTA

tournament_idstring

Tournament id once this match is reconciled to a tournament; null while it is still on the live feed

tournament_namestring required

Tournament name

courtstring

Court name

best_ofinteger

Best of 3 or 5

roundstring required

Round

surfacestring

Surface

statusstring

Status

winner_sideinteger

1 or 2 once decided; null while in progress

current_setinteger

Current set number

game_scorestring

Current game point score

serverinteger

Current server index (1 or 2)

tiebreak_scorestring

Active tiebreak score

point_historyobject[]

Recent point timeline

statsobject[]

Per-side match statistics

Changes

No recorded changes to this operation across all 1 revision of this API.