Live Tennis API · Schema

BroadcastObject

One flat object for a live-graphics template. EVERY key below is present on every read; a value we do not hold is `null` rather than absent, because a missing key breaks a template binding. Points and the set line are already in display form.

CompanySportsDataReal-TimeTennis

Properties

Name Type Description
match_id integer
status string `live`, `completed`, `upcoming`
event_status stringnull The terminal badge where one is stated (`Finished`, `Retired`, `Walk Over`, `Interrupted`); null on a normal live row.
outcome stringnull
winner integernull 1 or 2, null until a result is established.
tour stringnull
tournament stringnull
round stringnull
surface stringnull
best_of integernull
is_doubles boolean
p1_id integernull
p1_name stringnull
p1_short stringnull Display short form, `"J. Sinner"`. A doubles team keeps each side's last token.
p1_country stringnull Three-letter code.
p1_ranking integernull
p2_id integernull
p2_name stringnull
p2_short stringnull
p2_country stringnull
p2_ranking integernull
p1_sets integernull
p2_sets integernull
p1_games integernull Games in the set in play.
p2_games integernull
p1_points stringnull As printed: `"0"`, `"15"`, `"30"`, `"40"`, `"AD"`, or the tiebreak count.
p2_points stringnull
p1_set1 integernull Per-set columns. A set not yet played is null on both sides.
p2_set1 integernull
p1_set2 integernull
p2_set2 integernull
p1_set3 integernull
p2_set3 integernull
p1_set4 integernull
p2_set4 integernull
p1_set5 integernull
p2_set5 integernull
set_line stringnull The completed and in-play sets as one string, `"5-7 2-0"`.
current_set integernull
is_tiebreak boolean
match_tiebreak boolean True while a deciding match tiebreak is in play.
server integernull 1 or 2.
p1_serving booleannull
p2_serving booleannull
break_point_for integernull 1, 2 or null. Cue an animation on the transition to non-null.
set_point_for integernull
match_point_for integernull
p1_win_pct integernull The model probability as a whole percent. Null where no model figure was computed for this state — never guessed.
p2_win_pct integernull
sequence integernull The per-match accept counter. THIS is how a poller detects a new state.
updated_at stringnull
age_seconds integernull Seconds since the score CONTENT last changed.
stale booleannull A live match whose content has frozen past the threshold.
served_at string When this response was built. Changes on every read — do not use it to detect a new state.
View JSON Schema on GitHub

JSON Schema

livetennisapi-com-broadcast-object-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/livetennisapi-com/json-schema/livetennisapi-com-broadcast-object-schema.json",
  "title": "BroadcastObject",
  "description": "One flat object for a live-graphics template. EVERY key below is present on every read; a value we do not hold is `null` rather than absent, because a missing key breaks a template binding. Points and the set line are already in display form.",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/livetennisapi-com-broadcast-api-openapi.yml#/components/schemas/BroadcastObject",
  "type": "object",
  "properties": {
    "match_id": {
      "type": "integer"
    },
    "status": {
      "type": "string",
      "description": "`live`, `completed`, `upcoming`"
    },
    "event_status": {
      "type": [
        "string",
        "null"
      ],
      "description": "The terminal badge where one is stated (`Finished`, `Retired`, `Walk Over`, `Interrupted`); null on a normal live row."
    },
    "outcome": {
      "type": [
        "string",
        "null"
      ]
    },
    "winner": {
      "type": [
        "integer",
        "null"
      ],
      "description": "1 or 2, null until a result is established."
    },
    "tour": {
      "type": [
        "string",
        "null"
      ]
    },
    "tournament": {
      "type": [
        "string",
        "null"
      ]
    },
    "round": {
      "type": [
        "string",
        "null"
      ]
    },
    "surface": {
      "type": [
        "string",
        "null"
      ]
    },
    "best_of": {
      "type": [
        "integer",
        "null"
      ]
    },
    "is_doubles": {
      "type": "boolean"
    },
    "p1_id": {
      "type": [
        "integer",
        "null"
      ]
    },
    "p1_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "p1_short": {
      "type": [
        "string",
        "null"
      ],
      "description": "Display short form, `\"J. Sinner\"`. A doubles team keeps each side's last token."
    },
    "p1_country": {
      "type": [
        "string",
        "null"
      ],
      "description": "Three-letter code."
    },
    "p1_ranking": {
      "type": [
        "integer",
        "null"
      ]
    },
    "p2_id": {
      "type": [
        "integer",
        "null"
      ]
    },
    "p2_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "p2_short": {
      "type": [
        "string",
        "null"
      ]
    },
    "p2_country": {
      "type": [
        "string",
        "null"
      ]
    },
    "p2_ranking": {
      "type": [
        "integer",
        "null"
      ]
    },
    "p1_sets": {
      "type": [
        "integer",
        "null"
      ]
    },
    "p2_sets": {
      "type": [
        "integer",
        "null"
      ]
    },
    "p1_games": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Games in the set in play."
    },
    "p2_games": {
      "type": [
        "integer",
        "null"
      ]
    },
    "p1_points": {
      "type": [
        "string",
        "null"
      ],
      "description": "As printed: `\"0\"`, `\"15\"`, `\"30\"`, `\"40\"`, `\"AD\"`, or the tiebreak count."
    },
    "p2_points": {
      "type": [
        "string",
        "null"
      ]
    },
    "p1_set1": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Per-set columns. A set not yet played is null on both sides."
    },
    "p2_set1": {
      "type": [
        "integer",
        "null"
      ]
    },
    "p1_set2": {
      "type": [
        "integer",
        "null"
      ]
    },
    "p2_set2": {
      "type": [
        "integer",
        "null"
      ]
    },
    "p1_set3": {
      "type": [
        "integer",
        "null"
      ]
    },
    "p2_set3": {
      "type": [
        "integer",
        "null"
      ]
    },
    "p1_set4": {
      "type": [
        "integer",
        "null"
      ]
    },
    "p2_set4": {
      "type": [
        "integer",
        "null"
      ]
    },
    "p1_set5": {
      "type": [
        "integer",
        "null"
      ]
    },
    "p2_set5": {
      "type": [
        "integer",
        "null"
      ]
    },
    "set_line": {
      "type": [
        "string",
        "null"
      ],
      "description": "The completed and in-play sets as one string, `\"5-7 2-0\"`."
    },
    "current_set": {
      "type": [
        "integer",
        "null"
      ]
    },
    "is_tiebreak": {
      "type": "boolean"
    },
    "match_tiebreak": {
      "type": "boolean",
      "description": "True while a deciding match tiebreak is in play."
    },
    "server": {
      "type": [
        "integer",
        "null"
      ],
      "description": "1 or 2."
    },
    "p1_serving": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "p2_serving": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "break_point_for": {
      "type": [
        "integer",
        "null"
      ],
      "description": "1, 2 or null. Cue an animation on the transition to non-null."
    },
    "set_point_for": {
      "type": [
        "integer",
        "null"
      ]
    },
    "match_point_for": {
      "type": [
        "integer",
        "null"
      ]
    },
    "p1_win_pct": {
      "type": [
        "integer",
        "null"
      ],
      "description": "The model probability as a whole percent. Null where no model figure was computed for this state — never guessed."
    },
    "p2_win_pct": {
      "type": [
        "integer",
        "null"
      ]
    },
    "sequence": {
      "type": [
        "integer",
        "null"
      ],
      "description": "The per-match accept counter. THIS is how a poller detects a new state."
    },
    "updated_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "age_seconds": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Seconds since the score CONTENT last changed."
    },
    "stale": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "A live match whose content has frozen past the threshold."
    },
    "served_at": {
      "type": "string",
      "format": "date-time",
      "description": "When this response was built. Changes on every read — do not use it to detect a new state."
    }
  }
}

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-broadcast-object"
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.