Results archive (1968–2022)
search_archive_matchesSearch the results archive: completed-match RESULTS from 1968 through 2022. ATP and WTA, main draws, qualifying and the ITF/futures tiers. Each record has winner and loser, final score, and seeds and ranks AT THE TIME of the match. Use this for historical questions ("Borg's Wimbledon finals"). The archive ends 2022-12-31, where the current results (get_recent_results) begin. Requires the BASIC plan or any History plan.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_archive_matches"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Latest tournament START date, YYYY-MM-DD. | |
| from | No | Earliest tournament START date, YYYY-MM-DD. | |
| tour | No | atp or wta. | |
| level | No | Tier code: G=grand slam, M=masters, A=tour, F=finals, D=davis cup, C=challenger, O=olympics. Or a futures category code (e.g. 15). | |
| limit | No | Maximum results to return (1-200). | |
| round | No | Round code, e.g. F for finals. | |
| player_name | No | Case-insensitive fragment of EITHER player's name, min 3 chars, e.g. "borg". |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | True when the request succeeded, including when the answer is an empty list. False for a missing or rejected key, a plan that does not include this data, an unknown id, a rate limit or a network error. The message then says what to do. check_api_status is the exception: it is true whenever the API answered, and reports API key problems in the message. | |
| message | Yes | Human-readable summary of the result, safe to relay to the user verbatim. | |
| results | No | Archive results, newest tournament first. |