Tennis

List & Filter Players

Retrieves a paginated list of tennis players matching search and filter criteria.

get/tennis/players

Request

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

Query parameters

qstring

Player name search query

tourstring

Tour: ATP or WTA

iocstring

3-letter country IOC code

handstring

Hand: R, L, A, U

is_activeboolean

Active status

sort_bystring

Sort field: rank (default, ranked players first) | full_name | last_name | dob

orderstring

Sort order: asc or desc

pageinteger

Page number (1-indexed)

page_sizeinteger

Items per page (max 100)

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.