Account and data
Usage
GET
https://api.tennisdatabaseapi.com/v1/usageEvery planYour plan, calls used and limits (does not count).
Free key does not countLive does not countArchive does not countComplete does not count
Try itRuns against the live API with your key. Your key stays in this browser.API
GEThttps://api.tennisdatabaseapi.com/v1/usage
1Parameters
None. Anything in the address answers 422 unknown_parameter.
2Request
curl -H "Authorization: Bearer $TDA_KEY" \ "https://api.tennisdatabaseapi.com/v1/usage"
$ch = curl_init('https://api.tennisdatabaseapi.com/v1/usage'); 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/usage", headers={"Authorization": f"Bearer {os.environ['TDA_KEY']}"}, ) print(r.json()["data"])
const r = await fetch("https://api.tennisdatabaseapi.com/v1/usage", { 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": {
"plan": "Complete",
"key": "tda_7Hq2Lm9X",
"calls": { "today": 0, "this_month": 0 },
"limits": { "per_minute": 300, "per_day": null, "per_month": 1000000 },
"resets": { "day": "2026-11-19 00:00:00Z", "month": "2026-12-01 00:00:00Z" },
"reads": { "from": null, "to": "2026-11-18", "odds": true, "stats": true }
},
"meta": {}
}{
"data": {
"plan": "Free key",
"key": "tda_7Hq2Lm9X",
"calls": { "today": 0, "this_month": 0 },
"limits": { "per_minute": 10, "per_day": 50, "per_month": null },
"resets": { "day": "2026-11-19 00:00:00Z", "month": "2026-12-01 00:00:00Z" },
"reads": { "from": "2026-11-17", "to": "2026-11-18", "odds": "played", "stats": "played" }
},
"meta": {}
}{
"error": {
"code": "unknown_parameter",
"message": "Unknown parameter: plan. This endpoint takes: no parameters.",
"docs": "https://tennisdatabaseapi.com/documentation/errors"
}
}Real answers from the API, made 2026-11-18. Long lists are cut to three items here.
4Fields
| Field | What it holds |
|---|---|
plan, key | Your plan and the start of the key that asked |
calls | today and this_month |
limits | per_minute, per_day, per_month; null means no limit |
resets | When the day and the month start again, UTC |
reads | The dates your plan reads, and whether it has prices and statistics |
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). |