Server definition
- Hash
- sha256:cd8d086879ae15ecdd8858afb66be59a25d72a26c8dcc250d08d8a794ef87d07
- What it is
- What a remote MCP server returned when asked what it offers: 24 tools
The blob, as servednamed by its sha256
{
"instructions": null,
"tools": [
{
"description": "Check whether the Live Tennis API is reachable and which plan the configured key is on. Useful for diagnosing why other tools are refusing data.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "check_api_status",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"api_version": {
"description": "API version reported by the health check.",
"type": [
"string",
"null"
]
},
"has_key": {
"description": "Whether a key was supplied with this call.",
"type": "boolean"
},
"message": {
"description": "Human-readable summary. Identical to the text content, so either half can be used alone.",
"type": "string"
},
"ok": {
"description": "True when the call returned data. False for a tier wall, a missing or rejected key, or an empty result — all of which are normal states with a clear remedy, not failures.",
"type": "boolean"
},
"reachable": {
"description": "True when the API answered its health check.",
"type": "boolean"
},
"tier": {
"description": "Detected plan: FREE, BASIC, PRO or ULTRA. Null when no key is configured.",
"type": [
"string",
"null"
]
}
},
"required": [
"ok",
"message"
],
"type": "object"
}
},
{
"description": "One player's whole career over the results archive (1968–2022): W-L record overall and by surface/level/year, titles, and summed serve statistics with honest coverage — the corpus records serve stats from 1991 only, so matches_with_stats states how many matches the serve block covers. The name must resolve to one person; an ambiguous fragment returns the candidate list to choose from. Requires the BASIC plan or any History plan.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"name": {
"description": "Player name fragment, min 3 chars — must resolve to exactly one person.",
"minLength": 3,
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "get_archive_career",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"by_year": {
"description": "Per-season W-L.",
"items": {
"additionalProperties": false,
"properties": {
"losses": {
"type": [
"number",
"null"
]
},
"wins": {
"type": [
"number",
"null"
]
},
"year": {
"type": [
"number",
"null"
]
}
},
"required": [
"year",
"wins",
"losses"
],
"type": "object"
},
"type": "array"
},
"message": {
"description": "Human-readable summary. Identical to the text content, so either half can be used alone.",
"type": "string"
},
"ok": {
"description": "True when the call returned data. False for a tier wall, a missing or rejected key, or an empty result — all of which are normal states with a clear remedy, not failures.",
"type": "boolean"
},
"player_name": {
"description": "The resolved player.",
"type": [
"string",
"null"
]
},
"record": {
"additionalProperties": false,
"description": "The W-L record.",
"properties": {
"by_level": {
"anyOf": [
{
"additionalProperties": {
"additionalProperties": false,
"properties": {
"losses": {
"type": [
"number",
"null"
]
},
"wins": {
"type": [
"number",
"null"
]
}
},
"required": [
"wins",
"losses"
],
"type": "object"
},
"type": "object"
},
{
"type": "null"
}
],
"description": "W-L per source tier code."
},
"by_surface": {
"anyOf": [
{
"additionalProperties": {
"additionalProperties": false,
"properties": {
"losses": {
"type": [
"number",
"null"
]
},
"wins": {
"type": [
"number",
"null"
]
}
},
"required": [
"wins",
"losses"
],
"type": "object"
},
"type": "object"
},
{
"type": "null"
}
],
"description": "W-L per surface."
},
"losses": {
"description": "Career losses.",
"type": [
"number",
"null"
]
},
"titles": {
"description": "Finals won (excluding abandoned finals).",
"type": [
"number",
"null"
]
},
"wins": {
"description": "Career wins.",
"type": [
"number",
"null"
]
}
},
"required": [
"wins",
"losses",
"titles",
"by_surface",
"by_level"
],
"type": "object"
},
"serve": {
"anyOf": [
{
"additionalProperties": {
"type": [
"number",
"null"
]
},
"type": "object"
},
{
"type": "null"
}
],
"description": "Summed serve stats + derived ratios. matches_with_stats states the coverage; ratios are null where the denominator is zero."
},
"span": {
"additionalProperties": false,
"description": "Career span inside the archive.",
"properties": {
"first": {
"description": "First archive match date.",
"type": [
"string",
"null"
]
},
"last": {
"description": "Last archive match date.",
"type": [
"string",
"null"
]
}
},
"required": [
"first",
"last"
],
"type": "object"
}
},
"required": [
"ok",
"message"
],
"type": "object"
}
},
{
"description": "One result from the results archive (1968–2022), with per-match serve statistics where the era recorded them — stats are null for most rows before 1991, honestly, never synthesised. Requires the BASIC plan or any History plan.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"archive_match_id": {
"description": "Archive match id, as returned by search_archive_matches.",
"type": "integer"
}
},
"required": [
"archive_match_id"
],
"type": "object"
},
"name": "get_archive_match",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"message": {
"description": "Human-readable summary. Identical to the text content, so either half can be used alone.",
"type": "string"
},
"ok": {
"description": "True when the call returned data. False for a tier wall, a missing or rejected key, or an empty result — all of which are normal states with a clear remedy, not failures.",
"type": "boolean"
},
"result": {
"additionalProperties": false,
"description": "The archive result.",
"properties": {
"event_date": {
"description": "The tournament START date — per-match dates do not exist in this era’s records.",
"type": [
"string",
"null"
]
},
"id": {
"description": "Archive match id. Pass to get_archive_match for the detail read with stats.",
"type": [
"number",
"null"
]
},
"level": {
"description": "Source tier code: G, M, A, F, D, C, O, or a futures category code.",
"type": [
"string",
"null"
]
},
"loser": {
"additionalProperties": false,
"description": "The loser.",
"properties": {
"age": {
"$ref": "#/properties/result/properties/winner/properties/age"
},
"country": {
"$ref": "#/properties/result/properties/winner/properties/country"
},
"entry": {
"$ref": "#/properties/result/properties/winner/properties/entry"
},
"hand": {
"$ref": "#/properties/result/properties/winner/properties/hand"
},
"height_cm": {
"$ref": "#/properties/result/properties/winner/properties/height_cm"
},
"name": {
"$ref": "#/properties/result/properties/winner/properties/name"
},
"player_id": {
"$ref": "#/properties/result/properties/winner/properties/player_id"
},
"rank": {
"$ref": "#/properties/result/properties/winner/properties/rank"
},
"seed": {
"$ref": "#/properties/result/properties/winner/properties/seed"
}
},
"required": [
"name",
"country",
"rank",
"seed",
"player_id",
"hand",
"height_cm",
"age",
"entry"
],
"type": "object"
},
"outcome": {
"description": "completed, retired, walkover, default or abandoned — parsed, null when unparseable.",
"type": [
"string",
"null"
]
},
"round": {
"description": "Round code: F, SF, QF, R16 … Q1-Q4.",
"type": [
"string",
"null"
]
},
"score": {
"description": "The final score as published, e.g. \"6-4 7-6(5)\", \"6-3 RET\", \"W/O\".",
"type": [
"string",
"null"
]
},
"surface": {
"description": "Court surface.",
"type": [
"string",
"null"
]
},
"tour": {
"description": "atp or wta — the results archive covers those two tours.",
"type": [
"string",
"null"
]
},
"tournament": {
"description": "Tournament name.",
"type": [
"string",
"null"
]
},
"winner": {
"additionalProperties": false,
"description": "The winner — a stored field in the corpus, never an inference.",
"properties": {
"age": {
"description": "Age at the time of the match.",
"type": [
"number",
"null"
]
},
"country": {
"description": "3-letter country code.",
"type": [
"string",
"null"
]
},
"entry": {
"description": "Draw entry where recorded (WC, Q, LL, …) — null for direct acceptances.",
"type": [
"string",
"null"
]
},
"hand": {
"description": "\"R\" or \"L\".",
"type": [
"string",
"null"
]
},
"height_cm": {
"description": "Height in cm, where recorded.",
"type": [
"number",
"null"
]
},
"name": {
"description": "Player name as the corpus records it.",
"type": [
"string",
"null"
]
},
"player_id": {
"description": "Corpus person id — pass to search_archive_players results to join bios. NOT a roster player id.",
"type": [
"number",
"null"
]
},
"rank": {
"description": "Rank AT THE TIME of the match, as published.",
"type": [
"number",
"null"
]
},
"seed": {
"description": "Seeding, where seeded.",
"type": [
"number",
"null"
]
}
},
"required": [
"name",
"country",
"rank",
"seed",
"player_id",
"hand",
"height_cm",
"age",
"entry"
],
"type": "object"
}
},
"required": [
"id",
"tour",
"tournament",
"event_date",
"round",
"level",
"surface",
"score",
"outcome",
"winner",
"loser"
],
"type": "object"
},
"stats": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"loser": {
"anyOf": [
{
"additionalProperties": {
"type": [
"number",
"null"
]
},
"type": "object"
},
{
"type": "null"
}
],
"description": "Serve stats for the loser, where recorded."
},
"winner": {
"anyOf": [
{
"additionalProperties": {
"type": [
"number",
"null"
]
},
"type": "object"
},
{
"type": "null"
}
],
"description": "Serve stats for the winner, where recorded."
}
},
"required": [
"winner",
"loser"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Per-match serve statistics (aces, double_faults, serve_points, first_in, first_won, second_won, serve_games, bp_saved, bp_faced). Null for most pre-1991 rows."
}
},
"required": [
"ok",
"message"
],
"type": "object"
}
},
{
"description": "Every Match Charting Project stat family for ONE charted match, both players, with the per-set split (set 1, set 2, …, Total) exactly as charted. Charting ids are their own id space (1960–2026), mostly matches with no counterpart in the live tables. Requires the ULTRA plan.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"charting_match_id": {
"description": "Charting match id — its own id space, not a match_id.",
"type": "integer"
}
},
"required": [
"charting_match_id"
],
"type": "object"
},
"name": "get_charting_match",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"charting_match_id": {
"description": "The charted match.",
"type": [
"number",
"null"
]
},
"families": {
"additionalProperties": {},
"description": "Every stat family, per player, with the per-set split.",
"type": "object"
},
"gender": {
"type": [
"string",
"null"
]
},
"mcp_id": {
"description": "The Match Charting Project's own row identifier.",
"type": [
"string",
"null"
]
},
"message": {
"description": "Human-readable summary. Identical to the text content, so either half can be used alone.",
"type": "string"
},
"ok": {
"description": "True when the call returned data. False for a tier wall, a missing or rejected key, or an empty result — all of which are normal states with a clear remedy, not failures.",
"type": "boolean"
},
"players": {
"anyOf": [
{
"additionalProperties": {},
"type": "object"
},
{
"type": "null"
}
],
"description": "Both players as charted."
}
},
"required": [
"ok",
"message"
],
"type": "object"
}
},
{
"description": "Career shot-level profile from the Match Charting Project: serve placement (deuce/ad × wide/body/T), return depth and outcomes, net play, clutch break/game/set-point serving, winners and errors by wing, rally-length tendencies — summed over the player's charted matches. COVERAGE IS CURATED (11,646 charted matches back to the 1960s, concentrated on the majors), not full-slate. An ambiguous name returns the candidates to choose from. Requires the ULTRA plan.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"gender": {
"description": "Disambiguates a name charted on both tours.",
"enum": [
"men",
"women"
],
"type": "string"
},
"name": {
"description": "Player name fragment, min 3 chars — must resolve to one charted person.",
"minLength": 3,
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "get_charting_player",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"coverage": {
"description": "A reminder that charting coverage is curated, not full-slate.",
"type": [
"string",
"null"
]
},
"families": {
"additionalProperties": {},
"description": "Per-family summed numeric columns — raw sums over the player's charted Total rows.",
"type": "object"
},
"matches_charted": {
"description": "The sample every summed field covers.",
"type": [
"number",
"null"
]
},
"message": {
"description": "Human-readable summary. Identical to the text content, so either half can be used alone.",
"type": "string"
},
"ok": {
"description": "True when the call returned data. False for a tier wall, a missing or rejected key, or an empty result — all of which are normal states with a clear remedy, not failures.",
"type": "boolean"
},
"player": {
"anyOf": [
{
"additionalProperties": {},
"type": "object"
},
{
"type": "null"
}
],
"description": "The resolved charted player."
}
},
"required": [
"ok",
"message"
],
"type": "object"
}
},
{
"description": "Upcoming scheduled tennis fixtures, earliest first — the forward schedule, filterable by tour, player and date. Use this for \"what is on this week\". Works on the FREE plan (no card needed).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"default": 20,
"description": "Maximum fixtures to return (1-200).",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"tour": {
"description": "Tour filter; each name covers its doubles variants. Exhibition/team events carry no tour and are excluded whenever the filter is used.",
"enum": [
"atp",
"wta",
"challenger",
"itf",
"juniors"
],
"type": "string"
}
},
"type": "object"
},
"name": "get_fixtures",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"fixtures": {
"description": "Scheduled fixtures, earliest first.",
"items": {
"additionalProperties": false,
"properties": {
"event_date": {
"description": "Scheduled start, ISO timestamp.",
"type": [
"string",
"null"
]
},
"player1": {
"description": "Name of player 1.",
"type": [
"string",
"null"
]
},
"player2": {
"description": "Name of player 2.",
"type": [
"string",
"null"
]
},
"round": {
"description": "Round within the event.",
"type": [
"string",
"null"
]
},
"tournament": {
"description": "Event name.",
"type": [
"string",
"null"
]
}
},
"required": [
"event_date",
"tournament",
"round",
"player1",
"player2"
],
"type": "object"
},
"type": "array"
},
"message": {
"description": "Human-readable summary. Identical to the text content, so either half can be used alone.",
"type": "string"
},
"ok": {
"description": "True when the call returned data. False for a tier wall, a missing or rejected key, or an empty result — all of which are normal states with a clear remedy, not failures.",
"type": "boolean"
}
},
"required": [
"ok",
"message"
],
"type": "object"
}
},
{
"description": "The all-time record between two players, across BOTH halves of the product: the results archive (1968–2022) plus our own completed matches (2023 onward). Names are the keys — an ambiguous fragment returns the candidate list to choose from rather than guessing. Totals count only meetings with a known winner; walkovers and retirements are part of the record and each meeting carries its outcome. Requires the BASIC plan or any History plan.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"player1": {
"description": "First player name (fragment, min 3 chars), e.g. \"federer\".",
"minLength": 3,
"type": "string"
},
"player2": {
"description": "Second player name (fragment, min 3 chars), e.g. \"nadal\".",
"minLength": 3,
"type": "string"
}
},
"required": [
"player1",
"player2"
],
"type": "object"
},
"name": "get_h2h",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"by_surface": {
"additionalProperties": {
"additionalProperties": false,
"properties": {
"p1": {
"type": [
"number",
"null"
]
},
"p2": {
"type": [
"number",
"null"
]
}
},
"required": [
"p1",
"p2"
],
"type": "object"
},
"description": "Decided wins per surface; keys are surface names plus \"unknown\".",
"type": "object"
},
"meetings": {
"description": "Individual meetings, newest first, capped at 200.",
"items": {
"additionalProperties": false,
"properties": {
"date": {
"description": "Match date (current era) or tournament start date (archive era).",
"type": [
"string",
"null"
]
},
"era": {
"description": "\"archive\" (results archive, 1968-2022) or \"current\" (our own completed matches, 2023 onward).",
"type": [
"string",
"null"
]
},
"match_id": {
"description": "Our match id (current era rows) — pass to get_match.",
"type": [
"number",
"null"
]
},
"outcome": {
"description": "completed, retired, walkover, … — exclude non-completed yourself if needed.",
"type": [
"string",
"null"
]
},
"round": {
"description": "Round.",
"type": [
"string",
"null"
]
},
"score": {
"description": "Final score (archive rows only — read current rows from get_match).",
"type": [
"string",
"null"
]
},
"surface": {
"description": "Court surface.",
"type": [
"string",
"null"
]
},
"tournament": {
"description": "Tournament name.",
"type": [
"string",
"null"
]
},
"winner": {
"description": "1 or 2 OF THE REQUEST (player1/player2 as you passed them), not of the underlying match row.",
"type": [
"number",
"null"
]
}
},
"required": [
"era",
"date",
"tournament",
"round",
"surface",
"score",
"outcome",
"winner",
"match_id"
],
"type": "object"
},
"type": "array"
},
"message": {
"description": "Human-readable summary. Identical to the text content, so either half can be used alone.",
"type": "string"
},
"ok": {
"description": "True when the call returned data. False for a tier wall, a missing or rejected key, or an empty result — all of which are normal states with a clear remedy, not failures.",
"type": "boolean"
},
"players": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"p1": {
"description": "Resolved name for player1.",
"type": [
"string",
"null"
]
},
"p2": {
"description": "Resolved name for player2.",
"type": [
"string",
"null"
]
}
},
"required": [
"p1",
"p2"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "The resolved names; null when no player matches the fragments."
},
"totals": {
"additionalProperties": false,
"description": "The headline record.",
"properties": {
"meetings": {
"description": "Meetings with a known winner.",
"type": [
"number",
"null"
]
},
"p1_wins": {
"description": "Wins for player1 (of the request).",
"type": [
"number",
"null"
]
},
"p2_wins": {
"description": "Wins for player2 (of the request).",
"type": [
"number",
"null"
]
},
"undecided": {
"description": "Meetings with no derivable winner — never counted in wins.",
"type": [
"number",
"null"
]
}
},
"required": [
"p1_wins",
"p2_wins",
"meetings",
"undecided"
],
"type": "object"
}
},
"required": [
"ok",
"message"
],
"type": "object"
}
},
{
"description": "List tennis matches currently in progress, with live scores. Covers ATP, WTA, Challenger, ITF and juniors. Use this for \"what tennis is on right now\". Works on the FREE plan (no card needed).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"country": {
"description": "Either participant's country — the lowercase 3-letter IOC-style code the Player object returns (e.g. ned, sui, gre), NOT ISO-3166. Players with no recorded country never match.",
"maxLength": 3,
"minLength": 3,
"type": "string"
},
"limit": {
"default": 20,
"description": "Maximum matches to return (1-200).",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"player": {
"description": "Player ids (from search_players), max 50 — keeps matches where ANY listed player is either participant.",
"items": {
"type": "integer"
},
"maxItems": 50,
"type": "array"
},
"tour": {
"description": "Tour filter; each name covers its doubles variants. Exhibition/team events carry no tour and are excluded whenever the filter is used.",
"enum": [
"atp",
"wta",
"challenger",
"itf",
"juniors"
],
"type": "string"
}
},
"type": "object"
},
"name": "get_live_matches",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"matches": {
"description": "The live matches, most relevant first.",
"items": {
"additionalProperties": false,
"properties": {
"event_status": {
"description": "How the match ended (or paused) when it did not run its course: Retired, Cancelled, Walk Over, Postponed or Interrupted. Null means completed normally OR never resolved. Branch settlement logic here.",
"type": [
"string",
"null"
]
},
"event_status_updated_at": {
"description": "The instant the current event_status was recorded, UTC ISO-8601 (added 2026-08-19). Null while the status has never changed since the field was introduced — never backfilled.",
"type": [
"string",
"null"
]
},
"has_analysis": {
"description": "Whether a model thesis or profile exists for this match (added 2026-09-02, every tier). Filter on this before calling get_match_analysis, which reports the same absence. Null only when the server predates the field.",
"type": [
"boolean",
"null"
]
},
"has_market": {
"description": "Whether a match-winner market is mapped to this match (added 2026-09-02, every tier). Filter on this before calling get_match_odds, which reports the same absence. Null only when the server predates the field.",
"type": [
"boolean",
"null"
]
},
"id": {
"description": "Match id. Pass to get_match, get_match_score, get_match_events or get_match_odds.",
"type": [
"number",
"null"
]
},
"indoor": {
"description": "True when played indoors.",
"type": [
"boolean",
"null"
]
},
"player1": {
"description": "Name of player 1.",
"type": [
"string",
"null"
]
},
"player2": {
"description": "Name of player 2.",
"type": [
"string",
"null"
]
},
"round": {
"description": "Round within the event, e.g. \"QF\".",
"type": [
"string",
"null"
]
},
"round_code": {
"description": "Round in the normalized vocabulary (F, SF, QF, R16 … Q); null when the label is unrecognised, never guessed.",
"type": [
"string",
"null"
]
},
"score": {
"description": "Formatted score line, e.g. \"6-4 3-6 2-1\".",
"type": [
"string",
"null"
]
},
"serving": {
"description": "1 or 2 while a point is in play, otherwise null.",
"type": [
"number",
"null"
]
},
"status": {
"description": "One of live, upcoming or completed.",
"type": [
"string",
"null"
]
},
"surface": {
"description": "Court surface, e.g. hard, clay, grass.",
"type": [
"string",
"null"
]
},
"tour": {
"description": "atp, wta, challenger, itf or juniors. Null when the feed never stated one (exhibitions, team events).",
"type": [
"string",
"null"
]
},
"tournament": {
"description": "Event name, e.g. \"Wimbledon\".",
"type": [
"string",
"null"
]
},
"tournament_id": {
"description": "Stable tournament id — pass to get_tournament. Null where uncatalogued.",
"type": [
"string",
"null"
]
},
"win_probability_p1": {
"description": "Model probability that player 1 wins, 0-1. Requires the ULTRA plan; null otherwise.",
"type": [
"number",
"null"
]
},
"winner": {
"description": "1 or 2 once decided, otherwise null.",
"type": [
"number",
"null"
]
},
"withdrew": {
"description": "Completed matches only: which player retired or conceded the walkover, 1 or 2. Null means \"not a withdrawal, or no evidence\", never a guess.",
"type": [
"number",
"null"
]
}
},
"required": [
"id",
"tour",
"tournament",
"tournament_id",
"round",
"round_code",
"player1",
"player2",
"score",
"status",
"surface",
"indoor",
"serving",
"winner",
"event_status",
"event_status_updated_at",
"withdrew",
"has_analysis",
"has_market",
"win_probability_p1"
],
"type": "object"
},
"type": "array"
},
"message": {
"description": "Human-readable summary. Identical to the text content, so either half can be used alone.",
"type": "string"
},
"ok": {
"description": "True when the call returned data. False for a tier wall, a missing or rejected key, or an empty result — all of which are normal states with a clear remedy, not failures.",
"type": "boolean"
}
},
"required": [
"ok",
"message"
],
"type": "object"
}
},
{
"description": "Full detail for one match by id: players, score, surface, round and status. Includes market prices on PRO and model analysis on ULTRA. Works on the FREE plan (no card needed).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"match_id": {
"description": "Match id, as returned by get_live_matches, get_upcoming_matches or get_recent_results.",
"type": "integer"
}
},
"required": [
"match_id"
],
"type": "object"
},
"name": "get_match",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"analysis": {
"additionalProperties": false,
"description": "Model analysis. Requires the ULTRA plan; absent otherwise.",
"properties": {
"key_factors": {
"description": "Drivers behind the model view.",
"items": {
"type": "string"
},
"type": "array"
},
"win_probability_p1": {
"description": "Model probability player 1 wins, 0-1.",
"type": [
"number",
"null"
]
}
},
"required": [
"win_probability_p1",
"key_factors"
],
"type": "object"
},
"market": {
"additionalProperties": false,
"description": "Match-winner market. Requires the PRO plan; absent otherwise.",
"properties": {
"prices": {
"description": "Current prices per player.",
"items": {
"additionalProperties": false,
"properties": {
"ask": {
"description": "Best ask.",
"type": [
"number",
"null"
]
},
"bid": {
"description": "Best bid.",
"type": [
"number",
"null"
]
},
"mid": {
"description": "Mid price, 0-1, readable as implied probability.",
"type": [
"number",
"null"
]
},
"side": {
"description": "Which player this price is for, 1 or 2.",
"type": [
"number",
"null"
]
},
"timestamp": {
"description": "When the price was observed.",
"type": [
"string",
"null"
]
}
},
"required": [
"side",
"mid",
"bid",
"ask",
"timestamp"
],
"type": "object"
},
"type": "array"
},
"question": {
"description": "The market being priced.",
"type": [
"string",
"null"
]
}
},
"required": [
"question",
"prices"
],
"type": "object"
},
"match": {
"additionalProperties": false,
"description": "The match.",
"properties": {
"event_status": {
"description": "How the match ended (or paused) when it did not run its course: Retired, Cancelled, Walk Over, Postponed or Interrupted. Null means completed normally OR never resolved. Branch settlement logic here.",
"type": [
"string",
"null"
]
},
"event_status_updated_at": {
"description": "The instant the current event_status was recorded, UTC ISO-8601 (added 2026-08-19). Null while the status has never changed since the field was introduced — never backfilled.",
"type": [
"string",
"null"
]
},
"has_analysis": {
"description": "Whether a model thesis or profile exists for this match (added 2026-09-02, every tier). Filter on this before calling get_match_analysis, which reports the same absence. Null only when the server predates the field.",
"type": [
"boolean",
"null"
]
},
"has_market": {
"description": "Whether a match-winner market is mapped to this match (added 2026-09-02, every tier). Filter on this before calling get_match_odds, which reports the same absence. Null only when the server predates the field.",
"type": [
"boolean",
"null"
]
},
"id": {
"description": "Match id. Pass to get_match, get_match_score, get_match_events or get_match_odds.",
"type": [
"number",
"null"
]
},
"indoor": {
"description": "True when played indoors.",
"type": [
"boolean",
"null"
]
},
"player1": {
"description": "Name of player 1.",
"type": [
"string",
"null"
]
},
"player2": {
"description": "Name of player 2.",
"type": [
"string",
"null"
]
},
"round": {
"description": "Round within the event, e.g. \"QF\".",
"type": [
"string",
"null"
]
},
"round_code": {
"description": "Round in the normalized vocabulary (F, SF, QF, R16 … Q); null when the label is unrecognised, never guessed.",
"type": [
"string",
"null"
]
},
"score": {
"description": "Formatted score line, e.g. \"6-4 3-6 2-1\".",
"type": [
"string",
"null"
]
},
"serving": {
"description": "1 or 2 while a point is in play, otherwise null.",
"type": [
"number",
"null"
]
},
"status": {
"description": "One of live, upcoming or completed.",
"type": [
"string",
"null"
]
},
"surface": {
"description": "Court surface, e.g. hard, clay, grass.",
"type": [
"string",
"null"
]
},
"tour": {
"description": "atp, wta, challenger, itf or juniors. Null when the feed never stated one (exhibitions, team events).",
"type": [
"string",
"null"
]
},
"tournament": {
"description": "Event name, e.g. \"Wimbledon\".",
"type": [
"string",
"null"
]
},
"tournament_id": {
"description": "Stable tournament id — pass to get_tournament. Null where uncatalogued.",
"type": [
"string",
"null"
]
},
"win_probability_p1": {
"description": "Model probability that player 1 wins, 0-1. Requires the ULTRA plan; null otherwise.",
"type": [
"number",
"null"
]
},
"winner": {
"description": "1 or 2 once decided, otherwise null.",
"type": [
"number",
"null"
]
},
"withdrew": {
"description": "Completed matches only: which player retired or conceded the walkover, 1 or 2. Null means \"not a withdrawal, or no evidence\", never a guess.",
"type": [
"number",
"null"
]
}
},
"required": [
"id",
"tour",
"tournament",
"tournament_id",
"round",
"round_code",
"player1",
"player2",
"score",
"status",
"surface",
"indoor",
"serving",
"winner",
"event_status",
"event_status_updated_at",
"withdrew",
"has_analysis",
"has_market",
"win_probability_p1"
],
"type": "object"
},
"message": {
"description": "Human-readable summary. Identical to the text content, so either half can be used alone.",
"type": "string"
},
"ok": {
"description": "True when the call returned data. False for a tier wall, a missing or rejected key, or an empty result — all of which are normal states with a clear remedy, not failures.",
"type": "boolean"
}
},
"required": [
"ok",
"message"
],
"type": "object"
}
},
{
"description": "Model analysis for a match: predicted win probability, the model's thesis and the key factors behind it. Requires the ULTRA plan. Match rows carry has_analysis — check it first; a match with no thesis or profile has nothing to return.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"match_id": {
"description": "Match id, as returned by get_live_matches, get_upcoming_matches or get_recent_results.",
"type": "integer"
}
},
"required": [
"match_id"
],
"type": "object"
},
"name": "get_match_analysis",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"message": {
"description": "Human-readable summary. Identical to the text content, so either half can be used alone.",
"type": "string"
},
"ok": {
"description": "True when the call returned data. False for a tier wall, a missing or rejected key, or an empty result — all of which are normal states with a clear remedy, not failures.",
"type": "boolean"
},
"profile": {
"additionalProperties": false,
"description": "Quantitative view.",
"properties": {
"expected_closeness": {
"description": "How close the model expects the match to be.",
"type": [
"number",
"null"
]
},
"key_factors": {
"description": "Drivers behind the model view.",
"items": {
"type": "string"
},
"type": "array"
},
"volatility_rating": {
"description": "Expected swing in the match state.",
"type": [
"string",
"null"
]
},
"win_probability_p1": {
"description": "Model probability player 1 wins, 0-1.",
"type": [
"number",
"null"
]
}
},
"required": [
"win_probability_p1",
"expected_closeness",
"volatility_rating",
"key_factors"
],
"type": "object"
},
"thesis": {
"additionalProperties": false,
"description": "Narrative view.",
"properties": {
"confidence": {
"description": "Model confidence, 0-1.",
"type": [
"number",
"null"
]
},
"pick_side": {
"description": "Player the model favours, 1 or 2.",
"type": [
"number",
"null"
]
},
"reasoning": {
"description": "Narrative reasoning.",
"type": [
"string",
"null"
]
},
"state": {
"description": "Current state of the thesis.",
"type": [
"string",
"null"
]
}
},
"required": [
"pick_side",
"confidence",
"state",
"reasoning"
],
"type": "object"
}
},
"required": [
"ok",
"message"
],
"type": "object"
}
},
{
"description": "Timeline of events for a match — breaks, games won, sets won, momentum runs. Requires the PRO plan.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"default": 30,
"description": "Maximum events to return (1-200).",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"match_id": {
"description": "Match id, as returned by get_live_matches, get_upcoming_matches or get_recent_results.",
"type": "integer"
}
},
"required": [
"match_id"
],
"type": "object"
},
"name": "get_match_events",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"events": {
"description": "Events in chronological order.",
"items": {
"additionalProperties": false,
"properties": {
"player": {
"description": "Player the event belongs to, 1 or 2.",
"type": [
"number",
"null"
]
},
"timestamp": {
"description": "When the event occurred.",
"type": [
"string",
"null"
]
},
"type": {
"description": "Event type, e.g. break, game, set.",
"type": [
"string",
"null"
]
}
},
"required": [
"timestamp",
"type",
"player"
],
"type": "object"
},
"type": "array"
},
"message": {
"description": "Human-readable summary. Identical to the text content, so either half can be used alone.",
"type": "string"
},
"ok": {
"description": "True when the call returned data. False for a tier wall, a missing or rejected key, or an empty result — all of which are normal states with a clear remedy, not failures.",
"type": "boolean"
}
},
"required": [
"ok",
"message"
],
"type": "object"
}
},
{
"description": "Match-winner market prices for a match — implied probability per player, with bid, ask and mid. Requires the PRO plan. Match rows carry has_market — check it first; a match with no market mapped has no prices to return.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"default": 10,
"description": "Maximum price points to return (1-200).",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"match_id": {
"description": "Match id, as returned by get_live_matches, get_upcoming_matches or get_recent_results.",
"type": "integer"
}
},
"required": [
"match_id"
],
"type": "object"
},
"name": "get_match_odds",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"market": {
"additionalProperties": false,
"description": "The match-winner market.",
"properties": {
"liquidity": {
"description": "Resting liquidity.",
"type": [
"number",
"null"
]
},
"prices": {
"description": "Recent prices, newest first.",
"items": {
"additionalProperties": false,
"properties": {
"ask": {
"description": "Best ask.",
"type": [
"number",
"null"
]
},
"bid": {
"description": "Best bid.",
"type": [
"number",
"null"
]
},
"mid": {
"description": "Mid price, 0-1, readable as implied probability.",
"type": [
"number",
"null"
]
},
"side": {
"description": "Which player this price is for, 1 or 2.",
"type": [
"number",
"null"
]
},
"timestamp": {
"description": "When the price was observed.",
"type": [
"string",
"null"
]
}
},
"required": [
"side",
"mid",
"bid",
"ask",
"timestamp"
],
"type": "object"
},
"type": "array"
},
"question": {
"description": "The market being priced.",
"type": [
"string",
"null"
]
},
"status": {
"description": "Market status, e.g. open or resolved.",
"type": [
"string",
"null"
]
},
"volume": {
"description": "24h traded volume.",
"type": [
"number",
"null"
]
}
},
"required": [
"question",
"status",
"volume",
"liquidity",
"prices"
],
"type": "object"
},
"message": {
"description": "Human-readable summary. Identical to the text content, so either half can be used alone.",
"type": "string"
},
"ok": {
"description": "True when the call returned data. False for a tier wall, a missing or rejected key, or an empty result — all of which are normal states with a clear remedy, not failures.",
"type": "boolean"
}
},
"required": [
"ok",
"message"
],
"type": "object"
}
},
{
"description": "Current score for one match — the fastest, lowest-latency read. Use this when you only need the score and already know the match id. Works on the FREE plan (no card needed).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"match_id": {
"description": "Match id, as returned by get_live_matches, get_upcoming_matches or get_recent_results.",
"type": "integer"
}
},
"required": [
"match_id"
],
"type": "object"
},
"name": "get_match_score",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"message": {
"description": "Human-readable summary. Identical to the text content, so either half can be used alone.",
"type": "string"
},
"ok": {
"description": "True when the call returned data. False for a tier wall, a missing or rejected key, or an empty result — all of which are normal states with a clear remedy, not failures.",
"type": "boolean"
},
"score": {
"additionalProperties": false,
"description": "The current score.",
"properties": {
"formatted": {
"description": "Formatted score line.",
"type": "string"
},
"is_tiebreak": {
"description": "True during a tiebreak.",
"type": [
"boolean",
"null"
]
},
"serving": {
"description": "Which player is serving, 1 or 2.",
"type": [
"number",
"null"
]
},
"sets": {
"anyOf": [
{
"items": {
"type": "number"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Sets won per player."
},
"win_probability_p1": {
"description": "Model probability player 1 wins, 0-1. ULTRA only.",
"type": [
"number",
"null"
]
}
},
"required": [
"formatted",
"sets",
"serving",
"is_tiebreak",
"win_probability_p1"
],
"type": "object"
}
},
"required": [
"ok",
"message"
],
"type": "object"
}
},
{
"description": "In-play (or final) statistics for one match, in TWO families kept deliberately separate: DERIVED is rebuilt from the point-by-point record (holds/breaks, break points, service/return points); MEASURED is counted upstream and includes what no point record can yield — aces, double faults, the serve split, winners/unforced errors. Measured coverage varies by tour; absent fields are omitted, never zero-filled. Requires the ULTRA plan.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"match_id": {
"description": "Match id, as returned by get_live_matches, get_upcoming_matches or get_recent_results.",
"type": "integer"
}
},
"required": [
"match_id"
],
"type": "object"
},
"name": "get_match_statistics",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"message": {
"description": "Human-readable summary. Identical to the text content, so either half can be used alone.",
"type": "string"
},
"ok": {
"description": "True when the call returned data. False for a tier wall, a missing or rejected key, or an empty result — all of which are normal states with a clear remedy, not failures.",
"type": "boolean"
},
"statistics": {
"additionalProperties": false,
"description": "The statistics.",
"properties": {
"as_of": {
"description": "When the underlying record was last updated (UTC).",
"type": [
"string",
"null"
]
},
"coverage": {
"description": "live | final | stale | none | diverged — summarises the response.",
"type": [
"string",
"null"
]
},
"freshness": {
"anyOf": [
{
"additionalProperties": {},
"type": "object"
},
{
"type": "null"
}
],
"description": "Per-family coverage/as_of/age. The two ages use DIFFERENT clocks (derived: against the newest score row; measured: wall clock) and must not be compared. On diverged the measured values are withheld and measured_divergence says why."
},
"games_counted": {
"description": "Games the derived family covers (tiebreaks excluded, counted separately).",
"type": [
"number",
"null"
]
},
"players": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"p1": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"derived": {
"additionalProperties": {
"type": [
"number",
"null"
]
},
"description": "Rebuilt from the point-by-point record: service/return games and points, hold_pct, break_pct, break points faced/saved/converted. Null percentages mean a zero denominator, never 0.",
"type": "object"
},
"measured": {
"anyOf": [
{
"additionalProperties": {
"type": [
"number",
"null"
]
},
"type": "object"
},
{
"type": "null"
}
],
"description": "Counted upstream — aces, double_faults, the serve split, winners/unforced errors where covered. Absent fields are omitted, never zero-filled. Quantities named in both families are computed two different ways: a cross-check, not a duplication."
}
},
"required": [
"derived",
"measured"
],
"type": "object"
},
{
"type": "null"
}
]
},
"p2": {
"anyOf": [
{
"$ref": "#/properties/statistics/properties/players/anyOf/0/properties/p1/anyOf/0"
},
{
"type": "null"
}
]
}
},
"required": [
"p1",
"p2"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Null when coverage is none — the match exists and holding nothing is the honest answer."
}
},
"required": [
"coverage",
"as_of",
"games_counted",
"players",
"freshness"
],
"type": "object"
}
},
"required": [
"ok",
"message"
],
"type": "object"
}
},
{
"description": "One player's profile: ranking, country, handedness, date of birth and cached stats. Works on the FREE plan (no card needed).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"player_id": {
"description": "Player id, as returned by search_players.",
"type": "integer"
}
},
"required": [
"player_id"
],
"type": "object"
},
"name": "get_player",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"message": {
"description": "Human-readable summary. Identical to the text content, so either half can be used alone.",
"type": "string"
},
"ok": {
"description": "True when the call returned data. False for a tier wall, a missing or rejected key, or an empty result — all of which are normal states with a clear remedy, not failures.",
"type": "boolean"
},
"player": {
"additionalProperties": false,
"description": "The player.",
"properties": {
"birthday": {
"description": "Date of birth, ISO date.",
"type": [
"string",
"null"
]
},
"country": {
"description": "Country code.",
"type": [
"string",
"null"
]
},
"hand": {
"description": "\"R\" or \"L\".",
"type": [
"string",
"null"
]
},
"id": {
"description": "Player id. Pass to get_player.",
"type": [
"number",
"null"
]
},
"name": {
"description": "Player name.",
"type": [
"string",
"null"
]
},
"ranking": {
"description": "Current singles ranking.",
"type": [
"number",
"null"
]
},
"ranking_movement": {
"description": "Recent movement in the rankings.",
"type": [
"string",
"null"
]
},
"ranking_points": {
"description": "Ranking points.",
"type": [
"number",
"null"
]
},
"tour": {
"description": "ATP, WTA, Challenger or ITF.",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"country",
"ranking",
"ranking_points",
"ranking_movement",
"hand",
"birthday",
"tour"
],
"type": "object"
}
},
"required": [
"ok",
"message"
],
"type": "object"
}
},
{
"description": "Point-in-time ranking records for SPECIFIC players: per system, the newest record in force ON OR BEFORE as_of — never one dated after it. Every other ranking field in this API is the CURRENT value joined at read time; this is the historical answer. Systems are never collapsed: ATP/WTA and the ITF circuits carry rank+points, UTR a rating. ITF and UTR history begins 2026-07-29. Requires the ULTRA plan.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"as_of": {
"description": "YYYY-MM-DD — the record in force on this date. Omit for the latest known.",
"type": "string"
},
"player_ids": {
"description": "Roster player ids, as returned by search_players. Max 50.",
"items": {
"type": "integer"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
},
"system": {
"description": "Restrict to one system. Omit for every system held for the player.",
"enum": [
"atp",
"wta",
"itf_jt",
"itf_mt",
"itf_wt",
"utr"
],
"type": "string"
}
},
"required": [
"player_ids"
],
"type": "object"
},
"name": "get_player_rankings",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"coverage": {
"anyOf": [
{
"additionalProperties": {},
"type": "object"
},
{
"type": "null"
}
],
"description": "What resolved against what was asked (players_resolved, systems_resolved, oldest_available per system). Read before trusting an empty result."
},
"message": {
"description": "Human-readable summary. Identical to the text content, so either half can be used alone.",
"type": "string"
},
"ok": {
"description": "True when the call returned data. False for a tier wall, a missing or rejected key, or an empty result — all of which are normal states with a clear remedy, not failures.",
"type": "boolean"
},
"rankings": {
"description": "One record per player × system held.",
"items": {
"additionalProperties": false,
"properties": {
"effective_date": {
"description": "The publication week this record took effect, YYYY-MM-DD.",
"type": [
"string",
"null"
]
},
"player_id": {
"description": "Roster player id — null on listing rows for players outside our roster.",
"type": [
"number",
"null"
]
},
"player_name": {
"description": "Name as the ranking publisher printed it (listing rows).",
"type": [
"string",
"null"
]
},
"points": {
"description": "Null for UTR.",
"type": [
"number",
"null"
]
},
"previous_rank": {
"description": "Rank at the preceding snapshot week (ATP/WTA only; null elsewhere).",
"type": [
"number",
"null"
]
},
"rank": {
"description": "Null for UTR (a rating, not a ranking).",
"type": [
"number",
"null"
]
},
"rank_movement": {
"description": "The circuit's own signed weekly movement (ITF systems only).",
"type": [
"number",
"null"
]
},
"rating": {
"description": "UTR only; null elsewhere.",
"type": [
"number",
"null"
]
},
"system": {
"description": "atp, wta, itf_jt, itf_mt, itf_wt or utr. Systems are never comparable.",
"type": [
"string",
"null"
]
}
},
"required": [
"player_id",
"player_name",
"system",
"rank",
"points",
"previous_rank",
"rank_movement",
"rating",
"effective_date"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"ok",
"message"
],
"type": "object"
}
},
{
"description": "The FULL published ranking table in rank order for one system — the newest week at or before as_of. Rows carry player_name as published and a null player_id for players outside our roster, so the table has no silent holes. ATP/WTA history runs deep; the ITF circuits begin 2026-07-29. For point-in-time records of SPECIFIC players use get_player_rankings. Requires the PRO plan.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"as_of": {
"description": "YYYY-MM-DD — serves the newest published week at or before this date. Omit for latest.",
"type": "string"
},
"limit": {
"default": 20,
"description": "Maximum ranking rows to return (1-200).",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"system": {
"description": "Ranking system to list. utr has no listing — it is a rating, not a ranking.",
"enum": [
"atp",
"wta",
"itf_jt",
"itf_mt",
"itf_wt"
],
"type": "string"
}
},
"required": [
"system"
],
"type": "object"
},
"name": "get_rankings",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"message": {
"description": "Human-readable summary. Identical to the text content, so either half can be used alone.",
"type": "string"
},
"ok": {
"description": "True when the call returned data. False for a tier wall, a missing or rejected key, or an empty result — all of which are normal states with a clear remedy, not failures.",
"type": "boolean"
},
"rankings": {
"description": "The table in rank order.",
"items": {
"additionalProperties": false,
"properties": {
"effective_date": {
"description": "The publication week this record took effect, YYYY-MM-DD.",
"type": [
"string",
"null"
]
},
"player_id": {
"description": "Roster player id — null on listing rows for players outside our roster.",
"type": [
"number",
"null"
]
},
"player_name": {
"description": "Name as the ranking publisher printed it (listing rows).",
"type": [
"string",
"null"
]
},
"points": {
"description": "Null for UTR.",
"type": [
"number",
"null"
]
},
"previous_rank": {
"description": "Rank at the preceding snapshot week (ATP/WTA only; null elsewhere).",
"type": [
"number",
"null"
]
},
"rank": {
"description": "Null for UTR (a rating, not a ranking).",
"type": [
"number",
"null"
]
},
"rank_movement": {
"description": "The circuit's own signed weekly movement (ITF systems only).",
"type": [
"number",
"null"
]
},
"rating": {
"description": "UTR only; null elsewhere.",
"type": [
"number",
"null"
]
},
"system": {
"description": "atp, wta, itf_jt, itf_mt, itf_wt or utr. Systems are never comparable.",
"type": [
"string",
"null"
]
}
},
"required": [
"player_id",
"player_name",
"system",
"rank",
"points",
"previous_rank",
"rank_movement",
"rating",
"effective_date"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"ok",
"message"
],
"type": "object"
}
},
{
"description": "Recently completed tennis matches with final scores and winners. Filterable by tour, player, nationality and play date. Requires the BASIC plan or any History plan.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"country": {
"description": "Either participant's country — the lowercase 3-letter IOC-style code the Player object returns (e.g. ned, sui, gre), NOT ISO-3166. Players with no recorded country never match.",
"maxLength": 3,
"minLength": 3,
"type": "string"
},
"from": {
"description": "Earliest play date: YYYY-MM-DD (a whole UTC day) or ISO-8601 datetime.",
"type": "string"
},
"limit": {
"default": 20,
"description": "Maximum matches to return (1-200).",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"player": {
"description": "Player ids (from search_players), max 50 — keeps matches where ANY listed player is either participant.",
"items": {
"type": "integer"
},
"maxItems": 50,
"type": "array"
},
"to": {
"description": "Latest play date: YYYY-MM-DD or ISO-8601; must not precede from.",
"type": "string"
},
"tour": {
"description": "Tour filter; each name covers its doubles variants. Exhibition/team events carry no tour and are excluded whenever the filter is used.",
"enum": [
"atp",
"wta",
"challenger",
"itf",
"juniors"
],
"type": "string"
}
},
"type": "object"
},
"name": "get_recent_results",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"matches": {
"description": "Completed matches, most recent first.",
"items": {
"additionalProperties": false,
"properties": {
"event_status": {
"description": "How the match ended (or paused) when it did not run its course: Retired, Cancelled, Walk Over, Postponed or Interrupted. Null means completed normally OR never resolved. Branch settlement logic here.",
"type": [
"string",
"null"
]
},
"event_status_updated_at": {
"description": "The instant the current event_status was recorded, UTC ISO-8601 (added 2026-08-19). Null while the status has never changed since the field was introduced — never backfilled.",
"type": [
"string",
"null"
]
},
"has_analysis": {
"description": "Whether a model thesis or profile exists for this match (added 2026-09-02, every tier). Filter on this before calling get_match_analysis, which reports the same absence. Null only when the server predates the field.",
"type": [
"boolean",
"null"
]
},
"has_market": {
"description": "Whether a match-winner market is mapped to this match (added 2026-09-02, every tier). Filter on this before calling get_match_odds, which reports the same absence. Null only when the server predates the field.",
"type": [
"boolean",
"null"
]
},
"id": {
"description": "Match id. Pass to get_match, get_match_score, get_match_events or get_match_odds.",
"type": [
"number",
"null"
]
},
"indoor": {
"description": "True when played indoors.",
"type": [
"boolean",
"null"
]
},
"player1": {
"description": "Name of player 1.",
"type": [
"string",
"null"
]
},
"player2": {
"description": "Name of player 2.",
"type": [
"string",
"null"
]
},
"round": {
"description": "Round within the event, e.g. \"QF\".",
"type": [
"string",
"null"
]
},
"round_code": {
"description": "Round in the normalized vocabulary (F, SF, QF, R16 … Q); null when the label is unrecognised, never guessed.",
"type": [
"string",
"null"
]
},
"score": {
"description": "Formatted score line, e.g. \"6-4 3-6 2-1\".",
"type": [
"string",
"null"
]
},
"serving": {
"description": "1 or 2 while a point is in play, otherwise null.",
"type": [
"number",
"null"
]
},
"status": {
"description": "One of live, upcoming or completed.",
"type": [
"string",
"null"
]
},
"surface": {
"description": "Court surface, e.g. hard, clay, grass.",
"type": [
"string",
"null"
]
},
"tour": {
"description": "atp, wta, challenger, itf or juniors. Null when the feed never stated one (exhibitions, team events).",
"type": [
"string",
"null"
]
},
"tournament": {
"description": "Event name, e.g. \"Wimbledon\".",
"type": [
"string",
"null"
]
},
"tournament_id": {
"description": "Stable tournament id — pass to get_tournament. Null where uncatalogued.",
"type": [
"string",
"null"
]
},
"win_probability_p1": {
"description": "Model probability that player 1 wins, 0-1. Requires the ULTRA plan; null otherwise.",
"type": [
"number",
"null"
]
},
"winner": {
"description": "1 or 2 once decided, otherwise null.",
"type": [
"number",
"null"
]
},
"withdrew": {
"description": "Completed matches only: which player retired or conceded the walkover, 1 or 2. Null means \"not a withdrawal, or no evidence\", never a guess.",
"type": [
"number",
"null"
]
}
},
"required": [
"id",
"tour",
"tournament",
"tournament_id",
"round",
"round_code",
"player1",
"player2",
"score",
"status",
"surface",
"indoor",
"serving",
"winner",
"event_status",
"event_status_updated_at",
"withdrew",
"has_analysis",
"has_market",
"win_probability_p1"
],
"type": "object"
},
"type": "array"
},
"message": {
"description": "Human-readable summary. Identical to the text content, so either half can be used alone.",
"type": "string"
},
"ok": {
"description": "True when the call returned data. False for a tier wall, a missing or rejected key, or an empty result — all of which are normal states with a clear remedy, not failures.",
"type": "boolean"
}
},
"required": [
"ok",
"message"
],
"type": "object"
}
},
{
"description": "One tournament by its stable id — the tournament_id carried on match objects. Name, tour, surface, indoor, plus host city/country and category where curated. Works on the FREE plan (no card needed).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"tournament_id": {
"description": "Stable tournament id, as returned by search_tournaments or carried on a match as tournament_id.",
"type": "string"
}
},
"required": [
"tournament_id"
],
"type": "object"
},
"name": "get_tournament",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"message": {
"description": "Human-readable summary. Identical to the text content, so either half can be used alone.",
"type": "string"
},
"ok": {
"description": "True when the call returned data. False for a tier wall, a missing or rejected key, or an empty result — all of which are normal states with a clear remedy, not failures.",
"type": "boolean"
},
"tournament": {
"additionalProperties": false,
"description": "The tournament.",
"properties": {
"category": {
"description": "Tournament category (grand_slam, masters_1000, tour_finals, atp_500, atp_250, wta_1000, wta_500, wta_250, wta_125, challenger, itf, juniors). Set only where the catalogues agree unambiguously — null otherwise, never derived from the name.",
"type": [
"string",
"null"
]
},
"city": {
"description": "Host city, from a curated table — null where not curated.",
"type": [
"string",
"null"
]
},
"country": {
"description": "Host country, ISO-3166 alpha-2 — null where not curated.",
"type": [
"string",
"null"
]
},
"id": {
"description": "Stable tournament id — the same id match objects carry as tournament_id.",
"type": [
"string",
"null"
]
},
"indoor": {
"description": "True when played indoors.",
"type": [
"boolean",
"null"
]
},
"name": {
"description": "Tournament name.",
"type": [
"string",
"null"
]
},
"surface": {
"description": "Court surface: hard, clay or grass.",
"type": [
"string",
"null"
]
},
"tour": {
"description": "atp, wta, challenger, itf or juniors.",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"tour",
"surface",
"indoor",
"city",
"country",
"category"
],
"type": "object"
}
},
"required": [
"ok",
"message"
],
"type": "object"
}
},
{
"description": "List tennis matches scheduled to start soon, with players, tournament and start time. Use this for \"who plays next\" or to find a match id before it starts. Works on the FREE plan (no card needed).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"country": {
"description": "Either participant's country — the lowercase 3-letter IOC-style code the Player object returns (e.g. ned, sui, gre), NOT ISO-3166. Players with no recorded country never match.",
"maxLength": 3,
"minLength": 3,
"type": "string"
},
"from": {
"description": "Earliest play date: YYYY-MM-DD (a whole UTC day) or ISO-8601 datetime.",
"type": "string"
},
"limit": {
"default": 20,
"description": "Maximum matches to return (1-200).",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"player": {
"description": "Player ids (from search_players), max 50 — keeps matches where ANY listed player is either participant.",
"items": {
"type": "integer"
},
"maxItems": 50,
"type": "array"
},
"to": {
"description": "Latest play date: YYYY-MM-DD or ISO-8601; must not precede from.",
"type": "string"
},
"tour": {
"description": "Tour filter; each name covers its doubles variants. Exhibition/team events carry no tour and are excluded whenever the filter is used.",
"enum": [
"atp",
"wta",
"challenger",
"itf",
"juniors"
],
"type": "string"
}
},
"type": "object"
},
"name": "get_upcoming_matches",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"matches": {
"description": "Matches due to start, soonest first.",
"items": {
"additionalProperties": false,
"properties": {
"event_status": {
"description": "How the match ended (or paused) when it did not run its course: Retired, Cancelled, Walk Over, Postponed or Interrupted. Null means completed normally OR never resolved. Branch settlement logic here.",
"type": [
"string",
"null"
]
},
"event_status_updated_at": {
"description": "The instant the current event_status was recorded, UTC ISO-8601 (added 2026-08-19). Null while the status has never changed since the field was introduced — never backfilled.",
"type": [
"string",
"null"
]
},
"has_analysis": {
"description": "Whether a model thesis or profile exists for this match (added 2026-09-02, every tier). Filter on this before calling get_match_analysis, which reports the same absence. Null only when the server predates the field.",
"type": [
"boolean",
"null"
]
},
"has_market": {
"description": "Whether a match-winner market is mapped to this match (added 2026-09-02, every tier). Filter on this before calling get_match_odds, which reports the same absence. Null only when the server predates the field.",
"type": [
"boolean",
"null"
]
},
"id": {
"description": "Match id. Pass to get_match, get_match_score, get_match_events or get_match_odds.",
"type": [
"number",
"null"
]
},
"indoor": {
"description": "True when played indoors.",
"type": [
"boolean",
"null"
]
},
"player1": {
"description": "Name of player 1.",
"type": [
"string",
"null"
]
},
"player2": {
"description": "Name of player 2.",
"type": [
"string",
"null"
]
},
"round": {
"description": "Round within the event, e.g. \"QF\".",
"type": [
"string",
"null"
]
},
"round_code": {
"description": "Round in the normalized vocabulary (F, SF, QF, R16 … Q); null when the label is unrecognised, never guessed.",
"type": [
"string",
"null"
]
},
"score": {
"description": "Formatted score line, e.g. \"6-4 3-6 2-1\".",
"type": [
"string",
"null"
]
},
"serving": {
"description": "1 or 2 while a point is in play, otherwise null.",
"type": [
"number",
"null"
]
},
"status": {
"description": "One of live, upcoming or completed.",
"type": [
"string",
"null"
]
},
"surface": {
"description": "Court surface, e.g. hard, clay, grass.",
"type": [
"string",
"null"
]
},
"tour": {
"description": "atp, wta, challenger, itf or juniors. Null when the feed never stated one (exhibitions, team events).",
"type": [
"string",
"null"
]
},
"tournament": {
"description": "Event name, e.g. \"Wimbledon\".",
"type": [
"string",
"null"
]
},
"tournament_id": {
"description": "Stable tournament id — pass to get_tournament. Null where uncatalogued.",
"type": [
"string",
"null"
]
},
"win_probability_p1": {
"description": "Model probability that player 1 wins, 0-1. Requires the ULTRA plan; null otherwise.",
"type": [
"number",
"null"
]
},
"winner": {
"description": "1 or 2 once decided, otherwise null.",
"type": [
"number",
"null"
]
},
"withdrew": {
"description": "Completed matches only: which player retired or conceded the walkover, 1 or 2. Null means \"not a withdrawal, or no evidence\", never a guess.",
"type": [
"number",
"null"
]
}
},
"required": [
"id",
"tour",
"tournament",
"tournament_id",
"round",
"round_code",
"player1",
"player2",
"score",
"status",
"surface",
"indoor",
"serving",
"winner",
"event_status",
"event_status_updated_at",
"withdrew",
"has_analysis",
"has_market",
"win_probability_p1"
],
"type": "object"
},
"type": "array"
},
"message": {
"description": "Human-readable summary. Identical to the text content, so either half can be used alone.",
"type": "string"
},
"ok": {
"description": "True when the call returned data. False for a tier wall, a missing or rejected key, or an empty result — all of which are normal states with a clear remedy, not failures.",
"type": "boolean"
}
},
"required": [
"ok",
"message"
],
"type": "object"
}
},
{
"description": "Search the results archive — completed-match RESULTS from 1968 through 2022: ATP and WTA, main draws, qualifying and the ITF/futures tiers. Winner/loser-shaped records with final score, 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 our own results (get_recent_results) begin. Requires the BASIC plan or any History plan.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"from": {
"description": "Earliest tournament START date, YYYY-MM-DD.",
"type": "string"
},
"level": {
"description": "Source 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).",
"type": "string"
},
"limit": {
"default": 20,
"description": "Maximum results to return (1-200).",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"player_name": {
"description": "Case-insensitive fragment of EITHER player's name, min 3 chars, e.g. \"borg\".",
"minLength": 3,
"type": "string"
},
"round": {
"description": "Round code, e.g. F for finals.",
"enum": [
"F",
"SF",
"QF",
"R16",
"R32",
"R64",
"R128",
"RR",
"BR",
"Q1",
"Q2",
"Q3",
"Q4",
"ER"
],
"type": "string"
},
"to": {
"description": "Latest tournament START date, YYYY-MM-DD.",
"type": "string"
},
"tour": {
"description": "atp or wta.",
"enum": [
"atp",
"wta"
],
"type": "string"
}
},
"type": "object"
},
"name": "search_archive_matches",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"message": {
"description": "Human-readable summary. Identical to the text content, so either half can be used alone.",
"type": "string"
},
"ok": {
"description": "True when the call returned data. False for a tier wall, a missing or rejected key, or an empty result — all of which are normal states with a clear remedy, not failures.",
"type": "boolean"
},
"results": {
"description": "Archive results, newest tournament first.",
"items": {
"additionalProperties": false,
"properties": {
"event_date": {
"description": "The tournament START date — per-match dates do not exist in this era’s records.",
"type": [
"string",
"null"
]
},
"id": {
"description": "Archive match id. Pass to get_archive_match for the detail read with stats.",
"type": [
"number",
"null"
]
},
"level": {
"description": "Source tier code: G, M, A, F, D, C, O, or a futures category code.",
"type": [
"string",
"null"
]
},
"loser": {
"additionalProperties": false,
"description": "The loser.",
"properties": {
"age": {
"$ref": "#/properties/results/items/properties/winner/properties/age"
},
"country": {
"$ref": "#/properties/results/items/properties/winner/properties/country"
},
"entry": {
"$ref": "#/properties/results/items/properties/winner/properties/entry"
},
"hand": {
"$ref": "#/properties/results/items/properties/winner/properties/hand"
},
"height_cm": {
"$ref": "#/properties/results/items/properties/winner/properties/height_cm"
},
"name": {
"$ref": "#/properties/results/items/properties/winner/properties/name"
},
"player_id": {
"$ref": "#/properties/results/items/properties/winner/properties/player_id"
},
"rank": {
"$ref": "#/properties/results/items/properties/winner/properties/rank"
},
"seed": {
"$ref": "#/properties/results/items/properties/winner/properties/seed"
}
},
"required": [
"name",
"country",
"rank",
"seed",
"player_id",
"hand",
"height_cm",
"age",
"entry"
],
"type": "object"
},
"outcome": {
"description": "completed, retired, walkover, default or abandoned — parsed, null when unparseable.",
"type": [
"string",
"null"
]
},
"round": {
"description": "Round code: F, SF, QF, R16 … Q1-Q4.",
"type": [
"string",
"null"
]
},
"score": {
"description": "The final score as published, e.g. \"6-4 7-6(5)\", \"6-3 RET\", \"W/O\".",
"type": [
"string",
"null"
]
},
"surface": {
"description": "Court surface.",
"type": [
"string",
"null"
]
},
"tour": {
"description": "atp or wta — the results archive covers those two tours.",
"type": [
"string",
"null"
]
},
"tournament": {
"description": "Tournament name.",
"type": [
"string",
"null"
]
},
"winner": {
"additionalProperties": false,
"description": "The winner — a stored field in the corpus, never an inference.",
"properties": {
"age": {
"description": "Age at the time of the match.",
"type": [
"number",
"null"
]
},
"country": {
"description": "3-letter country code.",
"type": [
"string",
"null"
]
},
"entry": {
"description": "Draw entry where recorded (WC, Q, LL, …) — null for direct acceptances.",
"type": [
"string",
"null"
]
},
"hand": {
"description": "\"R\" or \"L\".",
"type": [
"string",
"null"
]
},
"height_cm": {
"description": "Height in cm, where recorded.",
"type": [
"number",
"null"
]
},
"name": {
"description": "Player name as the corpus records it.",
"type": [
"string",
"null"
]
},
"player_id": {
"description": "Corpus person id — pass to search_archive_players results to join bios. NOT a roster player id.",
"type": [
"number",
"null"
]
},
"rank": {
"description": "Rank AT THE TIME of the match, as published.",
"type": [
"number",
"null"
]
},
"seed": {
"description": "Seeding, where seeded.",
"type": [
"number",
"null"
]
}
},
"required": [
"name",
"country",
"rank",
"seed",
"player_id",
"hand",
"height_cm",
"age",
"entry"
],
"type": "object"
}
},
"required": [
"id",
"tour",
"tournament",
"event_date",
"round",
"level",
"surface",
"score",
"outcome",
"winner",
"loser"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"ok",
"message"
],
"type": "object"
}
},
{
"description": "The people of the results archive (1968–2022): hand, date of birth, country, height, and career-high rank with the week it was first reached. Their ids are corpus person ids (the winner/loser player_id on archive results), not roster ids — for current players use search_players. Requires the BASIC plan or any History plan.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"default": 10,
"description": "Maximum players to return (1-200).",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "Full or partial player name, min 3 chars, e.g. \"navratilova\".",
"minLength": 3,
"type": "string"
},
"tour": {
"description": "atp or wta.",
"enum": [
"atp",
"wta"
],
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_archive_players",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"message": {
"description": "Human-readable summary. Identical to the text content, so either half can be used alone.",
"type": "string"
},
"ok": {
"description": "True when the call returned data. False for a tier wall, a missing or rejected key, or an empty result — all of which are normal states with a clear remedy, not failures.",
"type": "boolean"
},
"players": {
"description": "Matching archive people, ordered by name.",
"items": {
"additionalProperties": false,
"properties": {
"career_high_date": {
"description": "The earliest week the career-high rank was reached.",
"type": [
"string",
"null"
]
},
"career_high_rank": {
"description": "Career-high rank, from the corpus’s own weekly tables.",
"type": [
"number",
"null"
]
},
"country": {
"description": "3-letter country code.",
"type": [
"string",
"null"
]
},
"dob": {
"description": "Date of birth, ISO date.",
"type": [
"string",
"null"
]
},
"hand": {
"description": "\"R\" or \"L\".",
"type": [
"string",
"null"
]
},
"height_cm": {
"description": "Height in cm.",
"type": [
"number",
"null"
]
},
"id": {
"description": "Corpus person id — the id archive match rows carry as winner/loser player_id. NOT a roster id.",
"type": [
"number",
"null"
]
},
"name": {
"description": "Player name.",
"type": [
"string",
"null"
]
},
"tour": {
"description": "atp or wta.",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"tour",
"name",
"hand",
"dob",
"country",
"height_cm",
"career_high_rank",
"career_high_date"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"ok",
"message"
],
"type": "object"
}
},
{
"description": "Search tennis players by name. Returns id, country, ranking and tour. Use the returned id with get_player. Works on the FREE plan (no card needed).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"default": 10,
"description": "Maximum players to return (1-200).",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "Full or partial player name, e.g. \"alcaraz\".",
"minLength": 1,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_players",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"message": {
"description": "Human-readable summary. Identical to the text content, so either half can be used alone.",
"type": "string"
},
"ok": {
"description": "True when the call returned data. False for a tier wall, a missing or rejected key, or an empty result — all of which are normal states with a clear remedy, not failures.",
"type": "boolean"
},
"players": {
"description": "Matching players, best match first.",
"items": {
"additionalProperties": false,
"properties": {
"birthday": {
"description": "Date of birth, ISO date.",
"type": [
"string",
"null"
]
},
"country": {
"description": "Country code.",
"type": [
"string",
"null"
]
},
"hand": {
"description": "\"R\" or \"L\".",
"type": [
"string",
"null"
]
},
"id": {
"description": "Player id. Pass to get_player.",
"type": [
"number",
"null"
]
},
"name": {
"description": "Player name.",
"type": [
"string",
"null"
]
},
"ranking": {
"description": "Current singles ranking.",
"type": [
"number",
"null"
]
},
"ranking_movement": {
"description": "Recent movement in the rankings.",
"type": [
"string",
"null"
]
},
"ranking_points": {
"description": "Ranking points.",
"type": [
"number",
"null"
]
},
"tour": {
"description": "ATP, WTA, Challenger or ITF.",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"country",
"ranking",
"ranking_points",
"ranking_movement",
"hand",
"birthday",
"tour"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"ok",
"message"
],
"type": "object"
}
},
{
"description": "Search the tournament catalogue — the stable id space that match objects carry as tournament_id. Returns surface, indoor, host city/country and category where curated. Works on the FREE plan (no card needed).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"default": 20,
"description": "Maximum tournaments to return (1-200).",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "Full or partial tournament name, e.g. \"wimbledon\". Omit to list all.",
"type": "string"
},
"tour": {
"description": "Restrict to one tour.",
"enum": [
"atp",
"wta",
"challenger",
"itf",
"juniors"
],
"type": "string"
}
},
"type": "object"
},
"name": "search_tournaments",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"message": {
"description": "Human-readable summary. Identical to the text content, so either half can be used alone.",
"type": "string"
},
"ok": {
"description": "True when the call returned data. False for a tier wall, a missing or rejected key, or an empty result — all of which are normal states with a clear remedy, not failures.",
"type": "boolean"
},
"tournaments": {
"description": "Matching tournaments, name order.",
"items": {
"additionalProperties": false,
"properties": {
"category": {
"description": "Tournament category (grand_slam, masters_1000, tour_finals, atp_500, atp_250, wta_1000, wta_500, wta_250, wta_125, challenger, itf, juniors). Set only where the catalogues agree unambiguously — null otherwise, never derived from the name.",
"type": [
"string",
"null"
]
},
"city": {
"description": "Host city, from a curated table — null where not curated.",
"type": [
"string",
"null"
]
},
"country": {
"description": "Host country, ISO-3166 alpha-2 — null where not curated.",
"type": [
"string",
"null"
]
},
"id": {
"description": "Stable tournament id — the same id match objects carry as tournament_id.",
"type": [
"string",
"null"
]
},
"indoor": {
"description": "True when played indoors.",
"type": [
"boolean",
"null"
]
},
"name": {
"description": "Tournament name.",
"type": [
"string",
"null"
]
},
"surface": {
"description": "Court surface: hard, clay or grass.",
"type": [
"string",
"null"
]
},
"tour": {
"description": "atp, wta, challenger, itf or juniors.",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"tour",
"surface",
"indoor",
"city",
"country",
"category"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"ok",
"message"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:cd8d086879ae15ecdd8858afb66be59a25d72a26c8dcc250d08d8a794ef87d07 | sha256sum