{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/livetennisapi-com/json-schema/livetennisapi-com-slate-event-schema.json",
  "title": "SlateEvent",
  "description": "An Event as served by the slate-wide feed (GET /events) — the per-match row plus its id and match.",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/livetennisapi-com-events-api-openapi.yml#/components/schemas/SlateEvent",
  "allOf": [
    {
      "$ref": "#/$defs/Event"
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer",
          "description": "The event's id; the `after_id` cursor."
        },
        "match_id": {
          "type": "integer"
        }
      }
    }
  ],
  "$defs": {
    "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."
        }
      }
    }
  }
}