Tennis

Get Match Details & Box Score

Retrieves full match score, set breakdown, and match serving/return stats.

get/tennis/matches/{match_id}

Request

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

Path parameters

match_idstring required

Response

Successful Response

idstring required

Unique match identifier

tournament_idstring

Tournament ID

match_datestring required

Match date (YYYY-MM-DD)

tourstring

Tour: ATP or WTA

surfacestring required

Surface

roundstring required

Round code

best_ofinteger

Best of 3 or 5 sets

scorestring required

Official score string (or the live scoreline while in progress)

outcomestring

Match outcome

statusstring

Canonical status: SCHEDULED, IN_PROGRESS, COMPLETED, RETIREMENT, ...

duration_minutesinteger

Duration in minutes

winner_idstring

Winner ID (null while the match is in progress)

loser_idstring

Loser ID (null while the match is in progress)

winner_sets_woninteger

Sets won by the winner; null while the match is in progress, when there is no winner yet -- read sets[] for the running count

loser_sets_woninteger

Sets won by the loser; null while the match is in progress, when there is no loser yet -- read sets[] for the running count

scheduled_atstring

Full scheduled/kickoff timestamp (ISO 8601), when the source provides one

tournament_namestring

Tournament name as free text; populated even when tournament/tournament_id are not yet linked (e.g. a live match not yet reconciled to a tournament id)

round_namestring

Human-readable round name, the same label the list routes return

winner_sideinteger

Which side won: 1 (player1), 2 (player2), or null while in progress / unknown

Changes

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