Stats + aggregation

Player matches

Use for a player's matches, newest first: tournament, surface, round, opponent, result, score by set and the player's rating before and after. Filter by season, surface, opponent_id, tournament_id or draw. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 5 credits.

post/v1/get_player_matches

Request

  • Base URL: https://mcp.acesapi.com
  • URL: https://mcp.acesapi.com/v1/get_player_matches
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Request body

player_idstring required

Player id from search_players.

surface'hard' | 'clay' | 'grass' | 'carpet'
opponent_idstring

Only matches against this player.

tournament_idstring

Only this tournament edition, e.g. "188-2025".

draw'main' | 'qualifying'
limitinteger

Max matches (default 50).

offsetinteger
league'tennis' | 'wta'

League. Defaults to tennis. One of: tennis, wta.

Response

The result, wrapped in data.

Changes

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