Tennis year statistics
GET
/
View as MarkdownTry in Playground →
A tennis player’s calendar year by surface, one row each: matches and wins, tournaments entered and won, aces and double faults, break points, tie-breaks, serve and return points, winners and unforced errors.
Derived fields: servicePoints = firstServesIn + secondServes and secondServesIn = secondServes − doubleFaults. Team sports, and years in which the player had no matches, return an empty list.
Parameters
idpathrequired
DataSportsAPI team id, a positive integer
yearqueryrequired
calendar year such as 2026
Response
- data
TennisYearStatistics[]- meta
- year, count
- errors
- 400
bad_request— year is absent or malformed403history_not_in_plan— the year finished before your plan’s history window begins
Any /v2 call can also come back with one of the common errors.
curl -H "Authorization: Bearer sk_live_…" \
"https://api.datasportsapi.com/v2/teams/{id}/year-statistics?year=…"Example
{ "data": [ { "surface": { "type": "grass", "indoor": null, "name": "Grass" }, "matches": 7, "wins": 7, "tournamentsPlayed": 1, "tournamentsWon": 1,
"aces": 128, "doubleFaults": 18, "servicePoints": 723, "firstServesIn": 474, "firstServePointsWon": 400, "secondServes": 249, "secondServesIn": 231,
"secondServePointsWon": 144, "breakPointsConverted": 25, "breakPointChances": 69, "breakPointsFaced": 22, "breakPointsLost": 6,
"tiebreaksWon": 5, "tiebreaksLost": 2, "winners": 319, "unforcedErrors": 188 }, … ],
"meta": { "year": 2026, "count": 3 } }