Get a player

Cricket and tennis players matched to Wikidata (cricket by the Cricinfo id, tennis by name, country, tour and birth year) also have wikidata: birth date, height, hand (cricket batting hand, tennis playing hand), bowling style and role (cricket), country; the feed's empty birthdate, height and nationality are filled from it (filled_from_wikidata), with the attribution (Wikidata, CC0) in data and meta. Soccer players also have season: the current season in every competition we hold statistics for, summed (total) and per competition (leagues), as /soccer/players/{id}/season, and transfers: the profile's transfers normalised, latest first (fields as /soccer/transfers; moves dated after today only with planned=true, which then lists only those), and bio: the normalised profile (known_as, full_name, short_name, birth_date, age, nationality, position, number, club, market_value_eur; null when not in our data; no contract dates in the feed), as in /soccer/leagues/{id}/players. Tennis players also have rating: the Elo-style rating from our results (docs/ratings.md; list: /tennis/ratings).

Parameters

• idinteger · pathrequired

  Player ID

• plannedboolean · query

  Soccer: true lists only transfers dated after today

Response

JSON with success, the result in data, and where the endpoint pages its results meta.

• dataobject
• ageinteger
• attributionstring
• bioobject

  Bio (soccer, only on /players/{id}): the normalised profile (full and short name, birth date and age, position, number, club, market value); profile above stays the feed's sections as sent.

• ageinteger

  Age: from the birth date on today's date, else as the squad feed has it.

• birth_datestring

  YYYY-MM-DD

• clubobject
• full_namestring

  first and last name from the profile

• idinteger
• known_asstring

  the name the feeds use

• market_value_eurinteger
• nationalitystring
• numberinteger
• photo_urlstring
• positionstring

  Position: goalkeeper, defender, midfielder or forward.

• short_namestring

  ShortName: the profile's common name ("E. Haaland").

• birthdatestring

  From the soccer player profile.

• detailsobject

  Details: the feed's other attributes, as sent (season stats, height, weight, college, injured...); keys differ per sport.

• filled_from_wikidataarray of string
• heightstring
• idinteger
• market_value_eurinteger
• namestring
• nationalitystring
• numberstring
• photo_urlstring

  PhotoURL: the player's photo on this API (image licence not included).

• positionstring
• preferred_footstring
• profileobject

  Profile: as sent, only on /players/{id}. Soccer: career statistics, transfers, trophies, sidelined. Tennis: birthplace, residence, plays, career_high, earnings, recent results and tournaments.

• rankinteger
• rank_movementstring

  up, down or same since the last list

• rank_pointsinteger
• ratingobject

  Rating (tennis, only on /players/{id}): the player's Elo-style rating from our results (docs/ratings.md).

• historyarray of object

  /teams/{id}: the last 10 rated matches, latest first

• last_match_datestring
• league_idinteger
• league_namestring
• matches_ratedinteger
• ofinteger
• peaknumber
• provisionalboolean
• rankinteger
• rated_fromstring
• ratingnumber
• team_idinteger
• team_namestring
• updated_atstring
• seasonobject

  Season (soccer, only on /players/{id}): the current season in every competition we hold statistics for, summed and per competition.

• leaguesarray of object
• seasonstring
• totalobject
• sportstring
• team_idinteger
• tourstring

  Tennis singles ranking (atp or wta), when the player is in it.

• transfersarray of object

  Transfers (soccer, only on /players/{id}): the profile's transfers normalised, latest first.

• datestring

  YYYY-MM-DD

• fee_eurinteger

  only when the feed gives a number

• fee_textstring

  as sent, e.g. "EUR 30.0m"

• from_team_idinteger
• from_team_namestring
• plannedboolean

  dated after today (UTC): an agreed move to come, e.g. a loan end

• player_idinteger
• player_namestring
• seasonstring

  2026/2027: from 1 June

• sourcestring
• to_team_idinteger
• to_team_namestring
• typestring

  Type: transfer, loan, loan_return, free, promoted, swap or unknown; type_label as the feed writes it.

• type_labelstring
• updated_atstring

Errors

All errors have the shape described in Errors and limits.

Generated from the OpenAPI file, version 1.0. See it as JSON