GoSportsAPIDocs
Sign InGet API Key
Tennis / Livescores

Get Live Scores

Retrieve every match in progress right now, with set scores, the current game score and who is serving.

GET/v1/tennis/livescores

Parameters

NameTypeRequiredDescription
x-api-keystringRequiredYour API key, sent as a header.
tournament_idintegerOptionalFilter by tournament ID.
player_idintegerOptionalFilter by player ID.
pageintegerOptionalPage number. Default 1, 50 per page.

Response

  • dataarray<Match>
    Matches currently in progress.
  • idinteger
    Unique match ID.
  • tournamentobject
    id, name, category and surface.
  • roundstring
    Round of the draw, e.g. Final.
  • datestring · ISO 8601
    Scheduled start in UTC.
  • statusobject
    short, current set and game score.
  • playersarray
    Both players: id, name and seed.
  • setsarray
    Games won per set, one pair per set.
  • serverinteger
    ID of the player serving.
  • metaobject
    page, per_page and total.

Status codes

  • 200Live matches returned
  • 400Invalid parameter
  • 401Missing or invalid API key
  • 429Rate limit reached