Player Match History

Get match history for a specific tennis player

GET /athletes/games

Player Match History

cURL

curl --request GET \
  --url https://v1.tennis.sportsapipro.com/athletes/games \
  --header 'x-api-key: <api-key>'

Overview

Returns the match-by-match history for a specific tennis player, including scores, opponents, and match statistics.

Code Examples

cURL

# Get recent matches for a player
curl -X GET "https://v1.tennis.sportsapipro.com/athletes/games?athleteId=874&numOfGames=10" \
  -H "x-api-key: YOUR_API_KEY"

Parameters

athleteId · integer · required

The player ID

numOfGames · integer

Number of matches to return (default: 10)

Response Structure

games · array

Array of match records with scores and statistics

Combine with /athletes/top to get player IDs, then fetch their match history.

Authorizations

x-api-key · string · header · required

Your SportsAPI Pro API key

Query Parameters

athleteId · integer · required

Player ID

Example:

874

numOfGames · integer · default: 10

Number of matches to return

Example:

10

Response

200

Player match history retrieved successfully