GET
https://api.tennisdatabaseapi.com/v1/results/yesterdayEvery planYesterday's results.
Free key yesterday on, no pricesLive 45 daysArchive every seasonComplete everything
Try itRuns against the live API with your key. Your key stays in this browser.API
GEThttps://api.tennisdatabaseapi.com/v1/results/yesterday?tour=women&per_page=2
1Parameters
| Name | What it is |
|---|---|
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/results/yesterday?tour=women&per_page=2"
$ch = curl_init('https://api.tennisdatabaseapi.com/v1/results/yesterday?tour=women&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/results/yesterday?tour=women&per_page=2", headers={"Authorization": f"Bearer {os.environ['TDA_KEY']}"}, ) print(r.json()["data"])
const r = await fetch("https://api.tennisdatabaseapi.com/v1/results/yesterday?tour=women&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": "mt_64st2j26",
"date": "2026-11-17",
"start_time": null,
"tour": "women",
"event_type": "singles",
"tournament": {
"id": "tn_7xh4qdg6",
"name": "Alcala de Henares ITF",
"event_known": true,
"tier": "itf",
"season": 2026,
"surface": "hard"
},
"round": "qualifying",
"winner": { "id": "pl_280s09jj", "name": "Teixido Garcia A.", "country": "Spain" },
"loser": { "id": "pl_rvsa9ee4", "name": "Marentes Melnikova N.", "country": "Spain" },
"score": "6-1 6-1",
"sets": { "winner": 2, "loser": 0 },
"status": "completed",
"best_of": null,
"ranks": null,
"ranking_points": null,
"odds": null
},
{
"id": "mt_m2xsyana",
"date": "2026-11-17",
"start_time": null,
"tour": "women",
"event_type": "singles",
"tournament": {
"id": "tn_7xh4qdg6",
"name": "Alcala de Henares ITF",
"event_known": true,
"tier": "itf",
"season": 2026,
"surface": "hard"
},
"round": null,
"winner": { "id": "pl_c314gkfz", "name": "Natal Gomez L.", "country": "Spain" },
"loser": { "id": "pl_xw4dxf7k", "name": "Mulet Bouza C.", "country": "Spain" },
"score": "6-0 6-2",
"sets": { "winner": 2, "loser": 0 },
"status": "completed",
"best_of": null,
"ranks": null,
"ranking_points": null,
"odds": null
}
],
"meta": {
"count": 2,
"next_cursor": "eyJvIjoyLCJwIjoyfQ",
"page": 1,
"per_page": 2,
"total": 134,
"total_pages": 67,
"next_page": 2,
"prev_page": null
}
}{
"data": [
{
"id": "mt_64st2j26",
"date": "2026-11-17",
"start_time": null,
"tour": "women",
"event_type": "singles",
"tournament": {
"id": "tn_7xh4qdg6",
"name": "Alcala de Henares ITF",
"event_known": true,
"tier": "itf",
"season": 2026,
"surface": "hard"
},
"round": "qualifying",
"winner": { "id": "pl_280s09jj", "name": "Teixido Garcia A.", "country": "Spain" },
"loser": { "id": "pl_rvsa9ee4", "name": "Marentes Melnikova N.", "country": "Spain" },
"score": "6-1 6-1",
"sets": { "winner": 2, "loser": 0 },
"status": "completed",
"best_of": null,
"ranks": null,
"ranking_points": null,
"odds": null
},
{
"id": "mt_m2xsyana",
"date": "2026-11-17",
"start_time": null,
"tour": "women",
"event_type": "singles",
"tournament": {
"id": "tn_7xh4qdg6",
"name": "Alcala de Henares ITF",
"event_known": true,
"tier": "itf",
"season": 2026,
"surface": "hard"
},
"round": null,
"winner": { "id": "pl_c314gkfz", "name": "Natal Gomez L.", "country": "Spain" },
"loser": { "id": "pl_xw4dxf7k", "name": "Mulet Bouza C.", "country": "Spain" },
"score": "6-0 6-2",
"sets": { "winner": 2, "loser": 0 },
"status": "completed",
"best_of": null,
"ranks": null,
"ranking_points": null,
"odds": null
}
],
"meta": {
"count": 2,
"next_cursor": "eyJvIjoyLCJwIjoyfQ",
"page": 1,
"per_page": 2,
"total": 134,
"total_pages": 67,
"next_page": 2,
"prev_page": null
}
}{
"error": {
"code": "bad_request",
"message": "tier is one of: slam, tour, challenger, itf, utr, team, other.",
"docs": "https://tennisdatabaseapi.com/documentation/errors"
}
}Real answers from the API, made 2026-11-18. Long lists are cut to three items here.
A field your plan does not include is still there, as
null, so code written on the free key keeps working after an upgrade. meta.held_back names what was held back and meta.note the plan that adds it.4Fields
| Field | What it holds |
|---|---|
id | The match id, mt_ and 8 characters |
date | The day it was played, UTC |
start_time | When play began (or is set to begin) on the match's date, UTC, as listed for that day; for a match finished on a later day, the time it resumed that day; null where not known |
tournament | id, name, event_known, tier, season, surface |
round | final, semi_final, quarter_final, round_of_16, round_1, qualifying and so on |
winner, loser | id, name, country |
score | The score from the winner's side, tie-breaks in brackets |
sets | Sets won by the winner and the loser |
status | completed, retired, walkover or defaulted |
best_of | 3 or 5 |
ranks | Each player's ranking on the day, where known |
ranking_points | Each player's ranking points on the day, where known (from the same weekly list as the ranking) |
odds.closing | The market's closing prices for the winner and the loser, decimal |
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 date outside your plan's window; the error names the plan that reads it. |
unknown_parameter | A parameter this endpoint does not take. |
rate_limited | Too many calls this minute, or the allowance used (quota_exceeded). |