Account and data
Coverage
GET
https://api.tennisdatabaseapi.com/v1/meta/coverageEvery planWhat the database holds, season by season, counted from the data.
Free key includedLive includedArchive includedComplete included
Try itRuns against the live API with your key. Your key stays in this browser.API
GEThttps://api.tennisdatabaseapi.com/v1/meta/coverage
1Parameters
None. Anything in the address answers 422 unknown_parameter.
2Request
curl -H "Authorization: Bearer $TDA_KEY" \ "https://api.tennisdatabaseapi.com/v1/meta/coverage"
$ch = curl_init('https://api.tennisdatabaseapi.com/v1/meta/coverage'); curl_setopt_array($ch, [ CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('TDA_KEY')], CURLOPT_RETURNTRANSFER => true, ]); $answer = json_decode(curl_exec($ch), true); print_r($answer['data']);
import os, requests r = requests.get( "https://api.tennisdatabaseapi.com/v1/meta/coverage", headers={"Authorization": f"Bearer {os.environ['TDA_KEY']}"}, ) print(r.json()["data"])
const r = await fetch("https://api.tennisdatabaseapi.com/v1/meta/coverage", { headers: { Authorization: `Bearer ${process.env.TDA_KEY}` }, }); const { data } = await r.json(); console.log(data);
The code follows the form in Try it, with your key in it once you have entered one. Without a key it reads $TDA_KEY.
3Answer
{
"data": {
"seasons": {
"2026": {
"men": { "matches": 64437, "with_odds": 44905, "with_markets": 29625, "with_stats": 28411 },
"women": { "matches": 46101, "with_odds": 34018, "with_markets": 20496, "with_stats": 22941 }
},
"2025": {
"men": { "matches": 70676, "with_odds": 46955, "with_markets": 30081, "with_stats": 29386 },
"women": { "matches": 52961, "with_odds": 36303, "with_markets": 21919, "with_stats": 25194 }
},
"2024": {
"men": { "matches": 59948, "with_odds": 39966, "with_markets": 30481, "with_stats": 21617 },
"women": { "matches": 45209, "with_odds": 32775, "with_markets": 22796, "with_stats": 16807 }
},
"...": "..."
},
"totals": {
"matches": 2344851,
"players": 103674,
"tournaments": 16440,
"with_odds": 939079,
"with_markets": 461173,
"with_stats": 291719,
"price_moves": 61320228,
"first_day": "1877-07-09",
"last_day": "2026-11-18"
}
},
"meta": { "counted_at": "2026-11-18 04:23:48" }
}Real answers from the API, made 2026-11-18. Long lists are cut to three items here.
4Fields
| Field | What it holds |
|---|---|
seasons | Each season, for men and women: matches, with_odds, with_markets, with_stats |
totals | Matches, players, tournaments, priced matches, markets, statistics and price moves, with the first and last day |
5Errors
unauthorized | No key, or a key that is unknown or revoked. |
unknown_parameter | A parameter this endpoint does not take. |
rate_limited | Too many calls this minute, or the allowance used (quota_exceeded). |