Account and data
Bulk file
GET
https://api.tennisdatabaseapi.com/v1/exports/{season}/{dataset}Complete planOne season's file of one dataset (matches, prices, moves, statistics or points), gzip-compressed CSV.
Free key not includedLive not includedArchive not includedComplete included
This endpoint sends the file itself, gzip-compressed CSV. Fetch it with the request below and save it, or open it with any tool that reads CSV.
1Parameters
| Name | What it is |
|---|---|
seasonrequired | A season, such as 2024. |
datasetrequired | One of matches, prices, moves, statistics, points. |
Anything else in the address answers 422 unknown_parameter, with the list of parameters this endpoint takes.
2Request
curl -H "Authorization: Bearer $TDA_KEY" \ "https://api.tennisdatabaseapi.com/v1/exports/2026/matches"
$ch = curl_init('https://api.tennisdatabaseapi.com/v1/exports/2026/matches'); 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/exports/2026/matches", headers={"Authorization": f"Bearer {os.environ['TDA_KEY']}"}, ) print(r.json()["data"])
const r = await fetch("https://api.tennisdatabaseapi.com/v1/exports/2026/matches", { 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
{
"file": "tennis-2026-matches.csv.gz",
"content_type": "application/gzip",
"first_lines_unpacked": ["match_id,date,tour,tier,tournament_id,tournament,event_known,season,surface,round,winner_id,winner,winner_country,loser_id,loser,loser_country,score,winner_sets,loser_sets,status,best_of,winner_rank,loser_rank,winner_seed,loser_seed,winner_entry,loser_entry,duration_minutes,umpire,venue,city,closing_winner,closing_loser,start_time,winner_points,loser_points", "mt_dqsqrt89,2026-01-01,men,itf,tn_bxj2bw47,M25 Marrakech,true,2026,clay,round_of_16,pl_3e0dxmca,Jianu F.,Romania,pl_wbxapj1n,Delage P.,France,6-2 6-1,2,0,completed,3,280,684,,,,,64,,,Marrakesh,1.18,4.37,2026-01-01T12:15:00Z,190,49", "mt_8gkrjcd1,2026-01-01,men,itf,tn_bxj2bw47,M25 Marrakech,true,2026,clay,round_of_16,pl_2cxr2wac,Bennani R.,Morocco,pl_jp2w53yf,Garcia Longo N.,Argentina,6-3 6-2,2,0,completed,3,645,1164,,,,,74,,,Marrakesh,1.05,7.84,2026-01-01T12:05:00Z,54,10"]
}{
"error": {
"code": "upgrade_required",
"message": "This endpoint is on the Complete plan and above.",
"plan": "Complete",
"upgrade": "https://tennisdatabaseapi.com/pricing",
"docs": "https://tennisdatabaseapi.com/documentation/errors"
}
}{
"error": {
"code": "not_found",
"message": "No file is held for that season. /v1/exports lists every season held.",
"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 |
|---|---|
matches | One line a match: ids, date, tour, tier, tournament, season, surface, round, both players, score, sets, status, best of, ranks, seeds, entries, minutes, umpire, venue, city, the closing prices, the start time (UTC) and both players' ranking points |
prices | One line a match and bookmaker: closing and opening prices for the winner and the loser |
moves | One line a price change: bookmaker, side, time and price |
statistics | One line a match, period and figure: the winner's and the loser's value |
points | One line a game: set, game, tiebreak, server, who won it, break, games after, every point and the break points |
5Errors
bad_request | A value out of range, such as a date or a tier that is not one of the list. |
unauthorized | No key, or a key that is unknown or revoked. |
upgrade_required | A key on a lower plan: this endpoint is on the Complete plan. |
not_found | No file is held for that season. |
unknown_parameter | A parameter this endpoint does not take. |
rate_limited | Too many calls this minute, or the allowance used (quota_exceeded). |