tennisdatabaseAPI

Tennis API documentation

Ctrl K
DocsDoublesDoubles on a day
Doubles

Doubles on a day

MCP tool doubles_on_day
GEThttps://api.tennisdatabaseapi.com/v1/doubles

Every 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

NameInTypeWhat it is
datequerydateYYYY-MM-DD (default yesterday).
tourquerystringMen or women: men, women.
tierquerystringThe level of the event: slam, tour, challenger, itf, utr, team, other.
page, per_pagequeryintegerPaging: 50 a page unless you ask, at most 50. See Paging.
cursorquerystringThe 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"

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
  }
}

Real answers from the API, made 2026-11-18. Long lists are cut to three items here.

4Fields

FieldTypeWhat it holds
id, date, tour, tournament, roundmixedThe match, dm_ and 8 characters
winners, losersobjectThe pair, dp_ and 8 characters, its two players and seed
score, statusstringFrom the winners' side
odds.closingobjectClosing prices for the winners and the losers, where known

5Errors

400bad_requestA value out of range, such as a date or a tier that is not one of the list.
401unauthorizedNo key, or a key that is unknown or revoked.
403upgrade_requiredThe free key: this endpoint is on the Live plan and above.
422unknown_parameterA parameter this endpoint does not take.
429rate_limitedToo many calls this minute, or the allowance used (quota_exceeded).