Live Tennis API · Schema

Tournament

One tournament of the catalogue — the stable id space `Match.tournament_id` joins, one row per tournament × event type, stable across seasons.

CompanySportsDataReal-TimeTennis

Properties

Name Type Description
id string The stable id `Match.tournament_id` joins.
name stringnull
tour stringnull
surface stringnull Court surface, null where the catalogue holds none — 61 of 10,287 tournaments on 2026-09-20. 35 of those are team competitions (Davis Cup, Billie Jean King Cup, Laver Cup), which have no tournament-le
indoor boolean
city stringnull Host city, from a curated table — null where not curated.
country stringnull Host country, ISO-3166 alpha-2 — null where not curated. (NOTE this differs from `player.country` and the `?country=` filter, which use IOC-style lowercase 3-letter codes.)
category stringnull Tournament category where our catalogues agree unambiguously on an exact-name join — null otherwise, never derived from the name. Unchanged by `tier` (2026-09-22) and remains the coarse class; read `t
tier stringnull The level this tournament is played at in the CURRENT season (added 2026-09-22) — the same closed vocabulary as `tier` on a match (`grand_slam`, `atp_1000` … `atp_250`, `wta_1000` … `wta_125`, `challe
tier_source stringnull How `tier` was established (added 2026-09-22): `calendar` = the official per-season tour calendar named the level (ATP tour and Challenger calendars, the WTA tournament list); `name` = an unambiguous
View JSON Schema on GitHub

JSON Schema

livetennisapi-com-tournament-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/livetennisapi-com/json-schema/livetennisapi-com-tournament-schema.json",
  "title": "Tournament",
  "description": "One tournament of the catalogue — the stable id space `Match.tournament_id` joins, one row per tournament × event type, stable across seasons.",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/livetennisapi-com-tournaments-api-openapi.yml#/components/schemas/Tournament",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The stable id `Match.tournament_id` joins."
    },
    "name": {
      "type": [
        "string",
        "null"
      ]
    },
    "tour": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "atp",
        "wta",
        "challenger",
        "itf",
        "juniors",
        null
      ]
    },
    "surface": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "hard",
        "clay",
        "grass",
        null
      ],
      "description": "Court surface, null where the catalogue holds none — 61 of 10,287 tournaments on 2026-09-20. 35 of those are team competitions (Davis Cup, Billie Jean King Cup, Laver Cup), which have no tournament-level surface to hold: each tie is played on the host nation's choice, and that surface is published on each MATCH of the tie instead. A surface value that is not one of hard/clay/grass is rejected rather than published. 3 are the exhibition catch-all and 23 are ordinary events with no stated surface."
    },
    "indoor": {
      "type": "boolean"
    },
    "city": {
      "type": [
        "string",
        "null"
      ],
      "description": "Host city, from a curated table — null where not curated."
    },
    "country": {
      "type": [
        "string",
        "null"
      ],
      "description": "Host country, ISO-3166 alpha-2 — null where not curated. (NOTE this differs from `player.country` and the `?country=` filter, which use IOC-style lowercase 3-letter codes.)"
    },
    "category": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "grand_slam",
        "masters_1000",
        "tour_finals",
        "atp_500",
        "atp_250",
        "wta_1000",
        "wta_500",
        "wta_250",
        "wta_125",
        "challenger",
        "itf",
        "juniors",
        null
      ],
      "description": "Tournament category where our catalogues agree unambiguously on an exact-name join — null otherwise, never derived from the name. Unchanged by `tier` (2026-09-22) and remains the coarse class; read `tier` for the level."
    },
    "tier": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "grand_slam",
        "atp_finals",
        "atp_1000",
        "atp_500",
        "atp_250",
        "next_gen_finals",
        "united_cup",
        "davis_cup",
        "olympics",
        "laver_cup",
        "wta_finals",
        "wta_elite_trophy",
        "wta_1000",
        "wta_500",
        "wta_250",
        "wta_125",
        "bjk_cup",
        "challenger_175",
        "challenger_125",
        "challenger_100",
        "challenger_75",
        "challenger_50",
        "itf_m15",
        "itf_m25",
        "itf_w15",
        "itf_w25",
        "itf_w35",
        "itf_w40",
        "itf_w50",
        "itf_w60",
        "itf_w75",
        "itf_w80",
        "itf_w100",
        "juniors",
        "utr",
        "exhibition",
        null
      ],
      "description": "The level this tournament is played at in the CURRENT season (added 2026-09-22) — the same closed vocabulary as `tier` on a match (`grand_slam`, `atp_1000` … `atp_250`, `wta_1000` … `wta_125`, `challenger_175` … `challenger_50`, `itf_m15` / `itf_m25`, `itf_w15` … `itf_w100`, the team events, `juniors`, `utr`, `exhibition`). A catalogue row has no season of its own; a match does: the tier is PER SEASON and it moves under one id — Dallas was `atp_250` in 2023 and 2024 and `atp_500` from 2025; Estoril `atp_250`, then `challenger_175` in 2025, then `atp_250` again in 2026; Eastbourne `wta_500` through 2024 and `wta_250` from 2025 — so read the tier off each MATCH for its season, never copy this value onto a match. Null when this season's calendar does not list the event — never guessed."
    },
    "tier_source": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "calendar",
        "name",
        "wikipedia",
        "resolver",
        null
      ],
      "description": "How `tier` was established (added 2026-09-22): `calendar` = the official per-season tour calendar named the level (ATP tour and Challenger calendars, the WTA tournament list); `name` = an unambiguous name rule (the ITF category is in the event's official name — `M25 …`, `W35 …` — team and UTR events are named as such, and the Slam junior draws and exhibitions are their own event type); `wikipedia` = a published season schedule, used only where the official calendar could not state the level for that season (Eastbourne 2023–2025); `resolver` = resolved after the seed dataset, by the same rules, from the event's name, tour and dates in that season. Null exactly when `tier` is null."
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/livetennisapi-com-tournament"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.