{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/livetennisapi-com/json-schema/livetennisapi-com-fixture-schema.json",
  "title": "Fixture",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/livetennisapi-com-fixtures-api-openapi.yml#/components/schemas/Fixture",
  "type": "object",
  "properties": {
    "id": {
      "type": "integer"
    },
    "event_date": {
      "type": [
        "string",
        "null"
      ],
      "format": "date"
    },
    "start_time": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "Scheduled start (UTC). Null until the order of play assigns a time — a date-only fixture is a real state, and rows written before 2026-08-03 stay null."
    },
    "player1_id": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Our player id, when the participant is in our roster (exact-key resolution, never a name match). Null otherwise — names are always present regardless."
    },
    "player2_id": {
      "type": [
        "integer",
        "null"
      ],
      "description": "As `player1_id`, for the second participant."
    },
    "tour": {
      "type": [
        "string",
        "null"
      ],
      "description": "The record's OWN tour, which is NOT the `tour` filter vocabulary. It is granular (`juniors_boys`, `juniors_girls`, `challenger_men`) where the filter is grouped (`juniors`, `challenger`), and a doubles team reports it UPPERCASE (`ATP`) where an individual reports lowercase (`atp`). Treat it as an opaque string; do not parse it into the filter enum."
    },
    "tournament": {
      "type": [
        "string",
        "null"
      ]
    },
    "round": {
      "type": [
        "string",
        "null"
      ]
    },
    "round_code": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "F",
        "SF",
        "QF",
        "R16",
        "R32",
        "R64",
        "R128",
        "RR",
        "BR",
        "Q",
        "Q1",
        "Q2",
        "Q3",
        "Q4",
        "ER",
        null
      ],
      "description": "Normalized round — same vocabulary as `Match.round_code`. Null when the label is unrecognised, never guessed."
    },
    "surface": {
      "type": [
        "string",
        "null"
      ]
    },
    "player1_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "player2_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "status": {
      "type": [
        "string",
        "null"
      ]
    }
  }
}