Tennis

Query Match Archive

Retrieves paginated match history with flexible filters.

get/tennis/matches

Request

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

Query parameters

player_idstring

Matches involving this player

opponent_idstring

Matches against this opponent

tourstring

Tour: ATP or WTA

yearinteger

Calendar year

date_startstring date

Start date (YYYY-MM-DD)

date_endstring date

End date (YYYY-MM-DD)

datestring date

Single day (YYYY-MM-DD); same as date_start=date_end

fromstring date

Alias for date_start

tostring date

Alias for date_end

surfacestring

Surface: Hard, Clay, Grass, Carpet

tournament_idstring

Specific tournament ID

roundstring

Round code: F, SF, QF, R16, R32, R64, R128, RR, Q, Q1, Q2, Q3, BR, ER. Prose forms ('Final', 'Round of 32') are accepted too

levelstring

Level: G, M, A, F, D, C, itf, junior, or an ITF prize level (15, 25, M25, W100)

pageinteger

Page number (1-indexed)

page_sizeinteger

Items per page

limitinteger

Alias for page_size

Response

Successful Response

totalinteger required

Total count of items matching filter criteria

pageinteger required

Current page number (1-indexed)

page_sizeinteger required

Number of items per page

total_pagesinteger required

Total number of available pages

has_nextboolean required

Whether there is a subsequent page

has_prevboolean required

Whether there is a preceding page

Changes

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