Match timeline
get_match_eventsRetrieve a match's event timeline with breaks, games won, sets won and momentum runs to track how the scoreline developed, using a match id from live, upcoming or recent results.
Instructions
Timeline of events for a match: breaks, games won, sets won, momentum runs. Requires the PRO plan.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"match_id": "<match_id>"
},
"name": "get_match_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum events to return (1-200). | |
| match_id | Yes | Match id, as returned by get_live_matches, get_upcoming_matches or get_recent_results. |
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. | |
| events | No | Events, newest first, as the API returns them. | |
| message | Yes | Human-readable summary of the result, safe to relay to the user verbatim. |