Skip to main content
GET
/
athletes
/
games
Player Match History
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

# 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