Tennis

Get Player Biographical Profile

Retrieves full biographical profile and career summary for a specific player.

get/tennis/players/{player_id}

Request

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

Path parameters

player_idstring required

Response

Successful Response

idstring required

Unique player identifier

tourstring required

Tour federation: ATP or WTA

first_namestring required

Given name

last_namestring required

Surname

full_namestring required

Canonical display name

iocstring

3-letter country code

country_codestring

Same 3-letter code as ioc, under the key most client integrations read

portrait_urlstring

Player portrait image URL, hosted by Cito; null when we hold no photo

portrait_attributionstring

Who to credit for the portrait; display it with the image

portrait_licensestring

Licence the portrait is published under, as stated by its source

portrait_source_urlstring

Page the portrait came from, for attribution and licence checks

country_namestring

Country name derived from the IOC/ISO code; null when the code is unmapped

nationalitystring

Same value as country_name, under the key most client integrations read

handstring

Playing hand

backhandstring

Backhand style (1H/2H) where known; not held for most players

dobstring

Date of birth

ageinteger

Current age in years

height_cminteger

Height in cm

weight_kginteger

Weight in kg

turned_prointeger

Year turned pro

career_high_rankinteger

Career peak ranking

career_high_datestring

Date peak ranking was attained

weeks_at_no_1integer

Total weeks ranked at world No. 1

current_rankinteger

Current ranking

current_rank_pointsinteger

Current ranking points

is_activeboolean

Active status

Changes

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