Archive player bios — hand, DOB, country, height, career-high (BASIC)

People of the results archive (1968–2022), in their own id space — id is the corpus person id that archive match rows carry as winner.player_id / loser.player_id, scoped per tour; never a roster id. Career-high rank and the earliest week it was reached are computed offline from the corpus's own weekly ranking tables. Null fields are the era's silence, never guessed. Requires BASIC, or any Historical Data API plan.

get/history/archive/players

Request

  • Base URL: https://api.livetennisapi.com/api/public/v1
  • URL: https://api.livetennisapi.com/api/public/v1/history/archive/players
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Query parameters

idinteger

Look a person up BY the corpus person id — the value archive match rows publish as winner.player_id / loser.player_id. This is the only place that reads the PERSON by that id; the one other surface taking it, /rankings?archive_player=, is ULTRA, requires system=elo, and answers with ratings rather than a bio. Corpus ids and roster ids are disjoint id spaces, so the same value on /players/{playerId} returns 404 (that 404 now points here). Returns every person wearing the id — the tours number independently and some ids are live in both — so add tour to narrow it to exactly one, the same rule archive_player= applies.

player_idinteger

Alias of id, under the name the same value carries on an archive match row. Sending both with different values is a 400.

namestring

Case-insensitive substring filter (min 3 chars).

tour'atp' | 'wta'
limitinteger
offsetinteger

Response

Archive people, ordered by name

Changes

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