Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Teams

Tennis year statistics

GET

/v2/teams/{id}/year-statistics

All plans

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

id

pathrequired

DataSportsAPI team id, a positive integer

year

queryrequired

calendar year such as 2026

Response

meta
year, count
errors
400 bad_request — year is absent or malformed403 history_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 } }