{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/livetennisapi-com/json-schema/livetennisapi-com-event-schema.json",
  "title": "Event",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/livetennisapi-com-matches-api-openapi.yml#/components/schemas/Event",
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "break",
        "set_won",
        "game_won",
        "momentum_run",
        "stoppage_start",
        "stoppage_end",
        "pause_start",
        "pause_end",
        "medical_timeout_start",
        "medical_timeout_end",
        "trainer_called",
        "trainer_called_end",
        "toilet_break_start",
        "toilet_break_end"
      ],
      "description": "The stoppage family (added 2026-09-12). `medical_timeout_start/end`, `trainer_called/_end` and `toilet_break_start/end` are stated by the match scorer or chair umpire, with `player` = the player concerned. Coverage (2026-09-13): WTA, WTA 125, Challenger and UTR singles — WTA and WTA 125 in two layers: the match state within ~20 s (`trainer_called`, `toilet_break_*`, `stoppage_*`, player null) and a later event layer with a variable delay (measured 2026-09-13: about one minute to an hour behind play), which adds `medical_timeout_start/end` with the player and exact instants; Challenger and UTR from the scorer timeline (22 of 70 finished Challenger matches, median 8 s). ITF World Tennis Tour singles from the court's live-scoring state (the state, not the player: `player` is null on ITF rows; first medical timeout observed and published 2026-09-13). ATP main tour: the live match stage is watched for its medical-timeout and interruption stages — present in the vocabulary, not yet observed on a tennis match, so ATP rows are mapped, not yet proven (`player` null, `at` = our observation instant). Not doubles. `stoppage_start/end` is a whole-match stop (`reason` weather | other when stated, unknown when only a bare suspension flag reached us). `pause_start/end` is an interruption of play measured from our own point clocks (`basis: inferred`), never labelled medical."
    },
    "player": {
      "type": [
        "integer",
        "null"
      ],
      "enum": [
        1,
        2,
        null
      ]
    },
    "timestamp": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "Stoppage family — the UTC instant the stoppage happened (for a pause, its last score change)."
    },
    "detected_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "Stoppage family — when we recorded it."
    },
    "basis": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "observed",
        "inferred",
        null
      ],
      "description": "Stoppage family — observed (a source stated it) or inferred (measured from our clocks)."
    },
    "reason": {
      "type": [
        "string",
        "null"
      ],
      "description": "Stoppage family — medical_timeout | unspecified | no_treatment | taping | changeover_treatment | evaluating | failed | toilet_break | weather | other | resumed | unknown."
    },
    "position": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "point",
        "changeover",
        "setbreak",
        null
      ],
      "description": "pause rows only — where the last point left the match, which sets the silence threshold."
    },
    "score": {
      "type": [
        "object",
        "null"
      ],
      "description": "Stoppage family — sets, games, points, server at the moment of the stoppage."
    },
    "duration_seconds": {
      "type": [
        "integer",
        "null"
      ],
      "description": "end rows only."
    }
  }
}