GET
https://api.tennisdatabaseapi.com/v1/doublesPaid plansEvery doubles match of one day, with both pairs, seeds, the score and closing prices.
Free key not 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/doubles?date=2026-11-17&per_page=2
1Parameters
| Name | What it is |
|---|---|
date | YYYY-MM-DD (default yesterday). |
tour | Men or women: men, women. |
tier | The level of the event: slam, tour, challenger, itf, utr, team, other. |
page, per_page | Paging: 50 a page unless you ask, at most 50. See Paging. |
cursor | The meta.next_cursor of the page before, to walk a long list. |
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/doubles?date=2026-11-17&per_page=2"
$ch = curl_init('https://api.tennisdatabaseapi.com/v1/doubles?date=2026-11-17&per_page=2'); 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/doubles?date=2026-11-17&per_page=2", headers={"Authorization": f"Bearer {os.environ['TDA_KEY']}"}, ) print(r.json()["data"])
const r = await fetch("https://api.tennisdatabaseapi.com/v1/doubles?date=2026-11-17&per_page=2", { 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": [
{
"id": "dm_axzm844k",
"date": "2026-11-17",
"tour": "men",
"event_type": "doubles",
"has_statistics": true,
"has_point_by_point": true,
"tournament": {
"id": "tn_ttxe4jq0",
"name": "Champaign challenger",
"tier": "challenger",
"season": 2026,
"surface": "hard_indoor"
},
"round": null,
"winners": {
"id": "dp_rc0bxcn7",
"players": [
{ "id": "pl_sd2d4ar9", "name": "Ingildsen J.", "country": "Denmark" },
{ "id": "pl_hzfm43gd", "name": "Barry C.", "country": "Ireland" }
],
"seed": "3"
},
"losers": {
"id": "dp_1dk68sfk",
"players": [
{ "id": "pl_yxnnvta0", "name": "Planinsek F.", "country": "Slovenia" },
{ "id": "pl_mv254fky", "name": "Dominko S.", "country": "Slovenia" }
],
"seed": null
},
"score": "3-6 6-2 10-7",
"status": "completed",
"odds": {
"closing": { "winners": 1.7, "losers": 2.03 }
}
},
{
"id": "dm_36ne56cs",
"date": "2026-11-17",
"tour": "men",
"event_type": "doubles",
"has_statistics": true,
"has_point_by_point": true,
"tournament": {
"id": "tn_y3fw1d0m",
"name": "Drummondville challenger",
"tier": "challenger",
"season": 2026,
"surface": "hard_indoor"
},
"round": null,
"winners": {
"id": "dp_v7p64vy3",
"players": [
{ "id": "pl_pdgx6fgx", "name": "Zamora N.", "country": "USA" },
{ "id": "pl_y5sdayfc", "name": "Gogineni V.", "country": "USA" }
],
"seed": null
},
"losers": {
"id": "dp_mx0d3mcg",
"players": [
{ "id": "pl_3z5rjd6s", "name": "Jones B.", "country": "United Kingdom" },
{ "id": "pl_skp1n75v", "name": "Charlton J.", "country": "Australia" }
],
"seed": "3"
},
"score": "5-7 7-6(5) 12-10",
"status": "completed",
"odds": {
"closing": { "winners": 2.47, "losers": 1.44 }
}
}
],
"meta": {
"count": 2,
"next_cursor": "eyJvIjoyLCJwIjoyfQ",
"page": 1,
"per_page": 2,
"total": 120,
"total_pages": 60,
"next_page": 2,
"prev_page": null
}
}{
"error": {
"code": "upgrade_required",
"message": "This endpoint is on the Live plan and above.",
"plan": "Live",
"upgrade": "https://tennisdatabaseapi.com/pricing",
"docs": "https://tennisdatabaseapi.com/documentation/errors"
}
}{
"error": {
"code": "bad_request",
"message": "date must be a date as YYYY-MM-DD (or today, yesterday).",
"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 |
|---|---|
id, date, tour, tournament, round | The match, dm_ and 8 characters |
winners, losers | The pair, dp_ and 8 characters, its two players and seed |
score, status | From the winners' side |
odds.closing | Closing prices for the winners and the losers, where known |
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 | The free key: this endpoint is on the Live plan and above. |
unknown_parameter | A parameter this endpoint does not take. |
rate_limited | Too many calls this minute, or the allowance used (quota_exceeded). |