GoSportsAPIDocs
Sign InGet API Key
Tennis / Matches

Get Matches

Retrieve singles and doubles matches — scheduled, live and finished — with round, court time and set scores.

GET/v1/tennis/matches

Parameters

NameTypeRequiredDescription
x-api-keystringRequiredYour API key, sent as a header.
tournament_idintegerOptionalFilter by tournament ID.
datedateOptionalFilter by date (YYYY-MM-DD, UTC).
player_idintegerOptionalFilter by player ID.
statusstringOptionalNS, LIVE, HT, FT, PST or CANC.
pageintegerOptionalPage number. Default 1, 50 per page.

Response

  • dataarray<Match>
    Matches matching your filters.
  • 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.
  • metaobject
    page, per_page and total.

Status codes

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