{
  "openapi": "3.1.0",
  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
  "info": {
    "title": "DataSportsAPI",
    "version": "2026-11-16",
    "summary": "Real-time sports data over REST for 24 sports — scores, schedules, lineups, match statistics, tables, and team, player and league profiles.",
    "description": "One consistent JSON contract for 24 sports: fixtures and live scores, lineups and statistics, standings, plus teams, players and leagues, delivered in real time over REST, WebSocket and webhooks.\n\nSuccessful responses use a `{ data, meta? }` envelope; failures return `{ error: { code, message } }` under a matching HTTP status. All ids are DataSportsAPI ids. Each component schema documents its fields, units and enum values, as does the data reference (https://datasportsapi.com/markdown/reference.md). The WebSocket stream, webhooks and widgets are documented at https://datasportsapi.com/docs/.\n\nAvailability: live. During the beta the Free plan allows 1,000 requests a day (100 a day after).",
    "contact": {
      "name": "DataSportsAPI",
      "email": "hello@datasportsapi.com",
      "url": "https://datasportsapi.com/contact/"
    }
  },
  "servers": [
    {
      "url": "https://api.datasportsapi.com",
      "description": "Production"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "externalDocs": {
    "description": "Documentation",
    "url": "https://datasportsapi.com/docs/"
  },
  "tags": [
    {
      "name": "catalog",
      "x-displayName": "Catalog",
      "description": "Catalog"
    },
    {
      "name": "livescores",
      "x-displayName": "Live scores",
      "description": "Live scores. Fixtures that are in play right now. If you are building a live feature, the WebSocket is the better fit: it delivers the same objects and then pushes deltas."
    },
    {
      "name": "fixtures",
      "x-displayName": "Fixtures",
      "description": "Fixtures. Look up fixtures by date, or fetch one match together with its detail sub-resources."
    },
    {
      "name": "teams",
      "x-displayName": "Teams",
      "description": "Teams"
    },
    {
      "name": "players",
      "x-displayName": "Players",
      "description": "Players"
    },
    {
      "name": "leagues",
      "x-displayName": "Leagues",
      "description": "Leagues"
    },
    {
      "name": "discovery",
      "x-displayName": "Discovery",
      "description": "Discovery. Starting points for finding ids: world rankings, plus the full set of a sport’s leagues by country or by category."
    },
    {
      "name": "races",
      "x-displayName": "Race sports",
      "description": "Race sports. Motorsport and cycling — the sports with kind races in /v2/sports. Here a series takes the place of a league (Formula 1, MotoGP; in cycling, the full men’s or women’s calendar). Each race is either a Grand Prix weekend or one cycling race, split into sessions — the timed parts such as practice, qualifying, a sprint, the race itself or a cycling stage. Drivers and riders, like their teams, are TeamRefs, which /v2/teams/{id} resolves. Times are always in milliseconds and distances in metres. The WebSocket does not carry these sports yet; while a session runs, poll /v2/races/{id} and its /results."
    },
    {
      "name": "people",
      "x-displayName": "Referees & managers",
      "description": "Referees & managers. Fixture.referee carries referee ids; TeamDetail.manager and Fixture.homeManager / awayManager carry manager ids. Both kinds can also be found through /v2/search."
    },
    {
      "name": "venues",
      "x-displayName": "Venues",
      "description": "Venues. Venue ids appear on Fixture.venue and TeamDetail.venue, and /v2/search can look venues up too."
    },
    {
      "name": "search",
      "x-displayName": "Search",
      "description": "Search"
    },
    {
      "name": "odds",
      "x-displayName": "Betting odds",
      "description": "Betting odds. Prices from one bookmaker, supplied through our data source, both before kick-off and in play, available since 2026-11-04; the odds carry no bookmaker identity. Odds live exclusively on dedicated endpoints and a dedicated WebSocket channel: fixtures, lists and deltas never include betting fields, so your match data contains no odds unless you request them. Included in the Pro, Business and Enterprise plans, with live prices on odds:{id} for Business and Enterprise accounts. Odds are third-party prices provided for information only — neither betting advice nor an offer to place a bet; make sure you follow the rules on displaying betting odds wherever your users are."
    },
    {
      "name": "tracking",
      "x-displayName": "Tracking data",
      "description": "Tracking data. Positional data for a match, available since 2026-11-12 with history back to 2026-11-07. Football gets a live ball track and live events — goals, shots, cards, substitutions and set pieces seconds after they happen, plus the flow of play (ball safe, attack, dangerous attack, change of possession) — and, after the match, the full event list with positions and passes. Tennis gets every serve and point plus live positions of the ball and the players. Basketball and ice hockey get a match timeline with shot spots, filled live since 2026-11-13 (basketball also keeps its post-match events); darts gets a live timeline of every dart and every visit (since 2026-11-13); and NBA games add the live positions of all ten players and the ball, five times a second (since 2026-11-13). Enterprise plan only: the REST endpoints are below, and the tracking:{id} WebSocket channel streams the same data live. Every position is in the fixture’s coordinate frame (TrackingSummary.coordinates) — 0–100 for football, basketball and ice hockey, with the home side attacking towards x = 100 for the whole match, millimetres from the middle of the net for tennis, and none for darts, where each dart names the bed it hit instead. Players are identified by name from the match squad, without an id."
    },
    {
      "name": "exports",
      "x-displayName": "Bulk exports",
      "description": "Bulk exports. For the Business and Enterprise plans. Get a whole league season as files: create an export, poll its status, then download. Exports are generated in the background from the same data the endpoints above serve; each account may create up to 20 per UTC day, and each one is kept for 7 days. Business reads one year back, so a season that ended before that window is refused (403 history_not_in_plan) on that plan."
    },
    {
      "name": "websocket",
      "x-displayName": "WebSocket",
      "description": "WebSocket. Live deltas for scores and statuses. Obtain a single-use ticket via REST and then open the connection, so your API key never appears in a WebSocket URL. Offered on Business (three simultaneous connections per account) and Enterprise (five), with the tracking:{id} channel kept for Enterprise."
    }
  ],
  "paths": {
    "/v2/sports": {
      "get": {
        "operationId": "sports.list",
        "tags": [
          "catalog"
        ],
        "summary": "Sports",
        "description": "Lists all supported sports, each with the number of matches live right now. Matches the source has left open — 45 min without any change, with a kick-off further back than a match in that sport could run — do not count towards it. kind tells you which endpoint family serves the sport: fixtures, for sports served by the Fixtures, Teams and Leagues endpoints; races, for motorsport and cycling, which the Race sports endpoints cover (their fixture lists stay empty).\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/catalog/sports-list/"
        },
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "slug": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "kind": {
                            "$ref": "#/components/schemas/SportKind"
                          },
                          "live": {
                            "type": "integer"
                          }
                        },
                        "required": [
                          "slug",
                          "name",
                          "kind",
                          "live"
                        ]
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count",
                      "properties": {
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/sports\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.sports.list();"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.sports.list()"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Sports.List(ctx)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa sports list"
          }
        ]
      }
    },
    "/v2/coverage": {
      "get": {
        "operationId": "sports.coverage",
        "tags": [
          "catalog"
        ],
        "summary": "Coverage",
        "description": "Coverage figures for the whole API in one call, open to every plan: entity totals, each sport’s league directory and how far back its headline competitions reach. The totals object counts how many teams, players, fixtures, leagues, seasons, venues, managers and referees have a DataSportsAPI id; each one can be fetched by that id, and the numbers never go down. The bySport list describes every sport’s directory — its categories (countries, tours, regions or games) with the leagues they hold, or the series for motorsport and cycling — together with up to ten headline competitions, each with its number of seasons and its first season; historyFrom is the earliest of those. The history object condenses the depth of all headline competitions into a median span in years and the oldest season. Old seasons are thinner than recent ones: results and tables usually go back further than lineups and statistics. updatedAt says when the figures were computed — totals every hour, directories once a day. A sport may be absent for a while after a restart, until its directory has been read again, and until the very first count is ready the endpoint answers 503 with Retry-After.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/catalog/sports-coverage/"
        },
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Coverage"
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/coverage\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.sports.coverage();"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.sports.coverage()"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Sports.Coverage(ctx)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa sports coverage"
          }
        ]
      }
    },
    "/v2/livescores": {
      "get": {
        "operationId": "livescores.list",
        "tags": [
          "livescores"
        ],
        "summary": "Live scores",
        "description": "Returns every live fixture across all sports, or one sport’s in-play board when ?sport= is set; each match reflects the live index, so its state is identical to the unfiltered call and to the WebSocket. Stale entries — no change for 45 min, and a start further back than a match in that sport can run — are dropped both here and on the WebSocket.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/livescores/list/"
        },
        "parameters": [
          {
            "name": "sport",
            "in": "query",
            "required": false,
            "description": "sport slug as listed by /v2/sports, for example football",
            "schema": {
              "type": "string",
              "enum": [
                "football",
                "tennis",
                "basketball",
                "ice-hockey",
                "esports",
                "volleyball",
                "handball",
                "baseball",
                "american-football",
                "rugby",
                "cricket",
                "mma",
                "table-tennis",
                "darts",
                "snooker",
                "futsal",
                "badminton",
                "waterpolo",
                "cycling",
                "motorsport",
                "minifootball",
                "floorball",
                "bandy",
                "padel"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Fixture"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count, and sport if a filter was applied",
                      "properties": {
                        "count": {
                          "type": "integer"
                        },
                        "sport": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — the sport slug is not recognised\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/livescores\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.livescores.list();"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.livescores.list()"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Livescores.List(ctx, &datasportsapi.LivescoresListParams{})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa livescores list"
          }
        ]
      }
    },
    "/v2/livescores/wire": {
      "get": {
        "operationId": "livescores.wire",
        "tags": [
          "livescores"
        ],
        "summary": "Live wire",
        "description": "Recent moments from the livescores channel, newest first, reaching back 7 days: score changes of any kind (goals, baskets, sets and runs, including corrections that lowered a score), red cards, kick-offs, period starts, breaks and final whistles. Every moment carries the score and status as they stood just after it, plus the ids and names of both sides, which is enough to fill a ticker before the WebSocket has delivered anything, or to show a client what happened while it was away for longer than replay covers. Each moment has exactly one kind, the first that fits in the order score, redCard, finished, break, kickoff, period. Available since 2026-11-16.\n\n**Note:** Nothing older than 7 days is kept. The moments are recorded from the same changes the livescores channel publishes, as we publish them, and at is that publication time. To combine them with live deltas, match on fixtureId + kind + score.\n\n**Plans:** Business and up; other plans receive 403 endpoint_not_in_plan.",
        "x-plans": [
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/livescores/wire/"
        },
        "parameters": [
          {
            "name": "sport",
            "in": "query",
            "required": false,
            "description": "sport slug; only that sport’s moments (all sports when left out)",
            "schema": {
              "type": "string",
              "enum": [
                "football",
                "tennis",
                "basketball",
                "ice-hockey",
                "esports",
                "volleyball",
                "handball",
                "baseball",
                "american-football",
                "rugby",
                "cricket",
                "mma",
                "table-tennis",
                "darts",
                "snooker",
                "futsal",
                "badminton",
                "waterpolo",
                "cycling",
                "motorsport",
                "minifootball",
                "floorball",
                "bandy",
                "padel"
              ]
            }
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "ISO 8601 instant; only moments after it, for example the newest at you already hold",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "before",
            "in": "query",
            "required": false,
            "description": "ISO 8601 instant; only moments before it, which pages backwards (send the oldest at you received)",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "number of moments, 1–100 (30 when left out)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 30
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/LiveWireEvent"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count, sport (null when not filtered), limit",
                      "properties": {
                        "count": {
                          "type": "integer"
                        },
                        "sport": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "limit": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — the sport is not recognised, since or before is not an ISO instant, or limit is outside 1–100\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/livescores/wire\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.livescores.wire();"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.livescores.wire()"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Livescores.Wire(ctx, &datasportsapi.LivescoresWireParams{})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa livescores wire"
          }
        ]
      }
    },
    "/v2/fixtures": {
      "get": {
        "operationId": "fixtures.list",
        "tags": [
          "fixtures"
        ],
        "summary": "Fixtures by date",
        "description": "Fixtures starting on one UTC date, for a single league, one category (country, region or tour, all its leagues at once), one country in a sport, or a whole sport paged ten leagues at a time by league rank.\n\n**Note:** Need a single country’s schedule, amateur and youth competitions included? Pass category= (take the id from that day’s /v2/fixtures/counts?sport= or from /v2/categories), or combine sport= with country=; either returns everything in one request rather than paging through the sport. When only sport is set, keep requesting pages until hasNextPage is false. All pages except the final one contain 10 leagues, so an empty page tells you the day is exhausted; a page may still carry fewer fixtures than leagues, because a league whose matches sit just outside the UTC day adds nothing. The set of fixtures for a date is cached — for minutes on today and future dates, for hours on past dates, and permanently once every fixture has finished — whereas the status, score and clock of a live fixture are accurate to the second (details in Data freshness). If you need a live feed, /v2/livescores or the WebSocket is the better fit.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/fixtures/list/"
        },
        "parameters": [
          {
            "name": "date",
            "in": "query",
            "required": true,
            "description": "UTC date as YYYY-MM-DD, from 1990-01-01 to one year in the future",
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "sport",
            "in": "query",
            "required": false,
            "description": "sport slug; mandatory when neither league nor category is set",
            "schema": {
              "type": "string",
              "enum": [
                "football",
                "tennis",
                "basketball",
                "ice-hockey",
                "esports",
                "volleyball",
                "handball",
                "baseball",
                "american-football",
                "rugby",
                "cricket",
                "mma",
                "table-tennis",
                "darts",
                "snooker",
                "futsal",
                "badminton",
                "waterpolo",
                "cycling",
                "motorsport",
                "minifootball",
                "floorball",
                "bandy",
                "padel"
              ]
            }
          },
          {
            "name": "league",
            "in": "query",
            "required": false,
            "description": "league id — returns only that league’s fixtures for the date, on a single page (page has to be 0)",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "category id, as listed by /v2/categories or /v2/fixtures/counts — all leagues of that country, region or tour for the date, sorted by start time, on a single page (page has to be 0). Available since 2026-11-04",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "two-letter Country.code (EN, ES, US …; case-insensitive), used together with sport — returns the date’s fixtures from that country’s categories in the sport, on a single page. Available since 2026-11-04",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z]{2}$"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "only when sport is the sole filter: page index 0–99 (defaults to 0), each page covering 10 leagues",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 99,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Fixture"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "date, page, count, hasNextPage; the league filter adds league (and sport when passed), with page fixed at 0 and hasNextPage false; the category filter adds category (and sport when passed), single page; the country filter adds sport, country, categoryIds (the categories that were queried), complete; sport on its own adds sport, leagueCount (number of leagues on this page), complete (false if some league lists were temporarily unavailable — try again shortly)",
                      "properties": {
                        "date": {
                          "type": "string"
                        },
                        "sport": {
                          "type": "string"
                        },
                        "league": {
                          "type": "integer"
                        },
                        "category": {
                          "type": "integer"
                        },
                        "country": {
                          "type": "string"
                        },
                        "categoryIds": {
                          "type": "array",
                          "items": {
                            "type": "integer"
                          }
                        },
                        "page": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        },
                        "leagueCount": {
                          "type": "integer"
                        },
                        "hasNextPage": {
                          "type": "boolean"
                        },
                        "complete": {
                          "type": "boolean"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — date absent or malformed, sport not recognised, no sport / league / category supplied, country sent without sport, two or more of league / category / country combined, page outside 0–99, or a non-zero page alongside league, category or country\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — no category with that id exists in DataSportsAPI\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "- upstream_unavailable — not a single league list on the page could be retrieved\n\nUpstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures?date=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.list({ date });\nfor await (const page of client.fixtures.listPages({ date })) { … }"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.list(date=date)\nfor page in client.fixtures.list_pages(date=date): ..."
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.List(ctx, &datasportsapi.FixturesListParams{Date: date})\nfor page, err := range client.Fixtures.ListPages(ctx, &datasportsapi.FixturesListParams{Date: date}) { … }"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures list <date>\n$ dsa fixtures list <date> --all -o csv"
          }
        ]
      }
    },
    "/v2/fixtures/counts": {
      "get": {
        "operationId": "fixtures.counts",
        "tags": [
          "fixtures"
        ],
        "summary": "Fixture counts",
        "description": "Fixture totals for a UTC date without paging: given a sport, the date’s total and a row per category (country, region, tour) with fixture and league counts, for any date; with no sport, today’s total per sport. The liveCount field gives the number of matches currently in play.\n\n**Note:** Dates are UTC, as on /v2/fixtures. liveCount is filled for today only (null on other dates) and comes from our live index — identical to the figure on /v2/sports — rather than from the date’s list, so a match that began yesterday may be included. Categories are sorted by fixture count, largest first; there is no live count per category because the source does not track one. With sport, fixtureCount is the sum across categories; without sport, it is the sum across sports. For one sport these totals may diverge by a few percent, since the category list includes some matches spilling over from late on the previous day. Race sports (motorsport, cycling) have no categories on this endpoint — use /v2/races. Available on all plans.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/fixtures/counts/"
        },
        "parameters": [
          {
            "name": "date",
            "in": "query",
            "required": false,
            "description": "UTC date as YYYY-MM-DD, defaults to today; accepts 1990-01-01 to one year ahead. If sport is omitted, only today is allowed",
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "sport",
            "in": "query",
            "required": false,
            "description": "sport slug — breaks the date’s count down by category",
            "schema": {
              "type": "string",
              "enum": [
                "football",
                "tennis",
                "basketball",
                "ice-hockey",
                "esports",
                "volleyball",
                "handball",
                "baseball",
                "american-football",
                "rugby",
                "cricket",
                "mma",
                "table-tennis",
                "darts",
                "snooker",
                "futsal",
                "badminton",
                "waterpolo",
                "cycling",
                "motorsport",
                "minifootball",
                "floorball",
                "bandy",
                "padel"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/FixtureCounts"
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — malformed date, unrecognised sport, or a date other than today with no sport given\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — the requested date lies before your plan’s history window\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "- upstream_unavailable — counts are temporarily unavailable\n\nUpstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/counts\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.counts();"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.counts()"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.Counts(ctx, &datasportsapi.FixturesCountsParams{})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures counts"
          }
        ]
      }
    },
    "/v2/fixtures/{id}": {
      "get": {
        "operationId": "fixtures.get",
        "tags": [
          "fixtures"
        ],
        "summary": "Fixture",
        "description": "One fixture in full: both teams, score, status, match clock, winner, league, season, round, venue, the referee (career cards per game), the two managers (homeManager / awayManager) and previousLegFixtureId. That field holds our id for the first leg or the previous game in a series, and on a completed second leg aggregateWinner names the side that went through. Some sports add more: seeds (homeSeed / awaySeed); in tennis, surface (hard / clay / grass / carpet, indoor), discipline (singles or doubles) and serving (who is serving at the moment); in darts, servedFirst (the side that threw the opening dart of the match); in cricket, battingSide, note, toss (winner, bat / bowl), tvUmpire and umpires; in MMA and boxing, fightResult (method, round and, for a stoppage, the time), fightCard (main card / prelims, order, weight class) and fightDiscipline (boxing, kickboxing, muayThai, …, if the source tags one); attendance (spectators, when reported); matchFormat (best of sets / legs in darts, best of games in esports); in baseball, inningState (inning, top / bottom, outs, count, runners); in basketball, timeouts (left per side) and bonus (which sides are in the bonus); in American football, downAndDistance (down, yards to go, field position, possession, play type); in football, varCheck (a VAR review in progress and the side it concerns); finalResultOnly (true when the source has nothing beyond the result); and, in set or round sports, durations (seconds per completed set or round, plus the total).\n\n**Note:** All score components live under periods: extra time in football and futsal is periods.extra1 / extra2, overtime in any other sport is periods.overtime, and extra innings in baseball are period10, period11, and so on. A shoot-out is never part of current — it goes in penalties — except that in ice hockey current includes the single goal awarded for winning a shoot-out. status.description is our own label, e.g. “Game 1”, “After overtime”, “After extra time” or “After penalties”. When the source drops coverage of a fixture, its status becomes canceled and both score sides are empty. For a match decided on penalties, winner is the shoot-out winner — second legs included, where the result on the night remains in normalTime; aggregateWinner names the side that progressed on aggregate (null if the source leaves a level aggregate unresolved). Lists and WebSocket snapshots may show aggregateWinner as null, so take it from this endpoint. Only this endpoint fills referee, homeManager / awayManager, previousLegFixtureId, toss, umpires, tvUmpire, fightCard and attendance; in fixture lists, on the live board and in WebSocket snapshots they are null (surface is filled here and on the live tennis board as well). inningState, timeouts, bonus, downAndDistance and varCheck exist only during play and are null at any other time. Every one of them except bonus is pushed in WebSocket deltas — inningState and varCheck as whole objects, timeouts and downAndDistance as partial updates (whole on first appearance, null once play stops). Because the source resends the baseball state roughly once a minute, the count may trail the action. durations — filled for tennis and the other set sports and for MMA rounds, null elsewhere — gains one period each time a set finishes, which is also delivered in WebSocket deltas (the completed period plus the updated totalSeconds; the set in progress began at clock.periodStartedAt). fightResult comes in a separate WebSocket delta, normally after the one that ends the fight, because the source publishes it only 20–60 s after the winner is known. In rugby, periods fill in live: period1 at half-time, then period2 = current − period1 through the second half. Esports periods: CS records 1 for each map won and 0 otherwise; LoL records how many kills the side made in game N. serving replaces firstToServe, which carries the same value and is deprecated but still present for now.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/fixtures/get/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Fixture"
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.get(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.get(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.Get(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures get <id>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/lineups": {
      "get": {
        "operationId": "fixtures.lineups",
        "tags": [
          "fixtures"
        ],
        "summary": "Lineups",
        "description": "Team lineups and formations plus unavailable players, with every player carrying a match rating and statistics.\n\n**Note:** How much you get depends on the fixture: top leagues come with lineups plus per-player ratings and statistics, while many youth, amateur and friendly matches never receive any. Player statistics reuse the team-statistics keys wherever the meaning matches (passes, accuratePasses, shotsOnGoal, tackles, …; bigChancesCreated counts big chances the player set up for a teammate). Each …Percentage field is a share from 0 to 100, with one exception: basketball’s trueShootingPercentage can exceed 100 (for example a handful of free throws plus a three). Players who did not take part have rating and statistics set to null; avgRating (football) holds the player’s season average and is filled mainly before and around kick-off. The profile fields heightCm, dateOfBirth, country and marketValue mirror the player’s profile (/v2/players/{id}) and are null when the source has no value — common in predicted lineups — with marketValue largely limited to football. Preferred foot is missing because the lineups we receive lack it; the profile and the squad have it. position is a sport-dependent word (G means goalkeeper in football, goalie in ice hockey and guard in basketball), while positionCode retains the source’s letter. A fixture without lineups (so far) answers 200 with confirmed: false and both sides empty; only an unknown id gets 404. While a match is live, the data is refreshed roughly every 30 seconds.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/fixtures/lineups/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Lineups"
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/lineups\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.lineups(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.lineups(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.Lineups(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures lineups <id>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/statistics": {
      "get": {
        "operationId": "fixtures.statistics",
        "tags": [
          "fixtures"
        ],
        "summary": "Statistics",
        "description": "Team statistics for the match, organised by period and by category.\n\n**Note:** Coverage is graded the same way as for lineups and grows richer as the match goes on: a lower-tier fixture might offer nothing but cards, whereas a top league delivers every group. Statistic keys form one shared vocabulary across all sports (totalShots, shotsOnGoal, passes, fouls, …; the reference’s Statistic keys lists every key per sport), and group keys follow a fixed table for each sport. In American football, the team-level passingNetYards and passingYardsPerAttempt are gross figures from the source (sacks are not subtracted), whereas a player’s passingNetYards in the lineups is net. A fixture without statistics (yet — before kick-off, for instance) returns 200 with { \"periods\": [] }; you only get 404 for an id that does not exist. Data is refreshed approximately every 30 seconds during a live match.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/fixtures/statistics/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Statistics"
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/statistics\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.statistics(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.statistics(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.Statistics(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures statistics <id>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/events": {
      "get": {
        "operationId": "fixtures.events",
        "tags": [
          "fixtures"
        ],
        "summary": "Events",
        "description": "The match’s incidents in chronological order, oldest first: goals, cards, substitutions, period markers and added-time announcements.\n\n**Note:** Returns an empty array if the fixture has no events (yet). For an injuryTime incident, addedMinute holds the number of added minutes announced. minute is null whenever the clock is not running — before kick-off, at half-time, for bench events and during a shoot-out. Shoot-out kicks are listed last, in the order taken: shootoutSequence numbers them 1…N across both sides, and shootoutRound gives the kick’s position (1st, 2nd, …) within the taker’s side. A period row marks the end of a period: its period is the one just completed, so the period currently in progress has no row; in set sports its homeScore / awayScore are the sets won up to that point. period is filled on every incident. All fields appear on every incident, set to null where irrelevant to the type, and type and detail are closed enums. Football goals carry buildUp, the chain of actions that led to the goal — shots (saved, missed, off the woodwork, penalties saved or missed), passes, crosses, free kicks, tackles, interceptions and clearances — each step with its side, player and minute, start and end pitch positions, assist, body part and expected goals, and the goal itself as the last step; buildUp is [] on all other incidents and when the source provides none. Cricket ball-by-ball and the point-level rows of set sports are not part of this list. Refreshed about every 30 seconds during a live match.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/fixtures/events/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Incident"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count",
                      "properties": {
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/events\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.events(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.events(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.Events(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures events <id>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/play-by-play": {
      "get": {
        "operationId": "fixtures.playByPlay",
        "tags": [
          "fixtures"
        ],
        "summary": "Play by play",
        "description": "Text commentary from the source, one action per entry, oldest first, in football (cards, shots, corners, substitutions and more, by minute) and basketball (each basket, free throw, rebound, foul and turnover). Basketball entries also give the game clock, the running score, the basket’s value and its location on the court.\n\n**Note:** The English text is produced by the source’s data provider and is separate from our AI commentary, which lives at /commentary. type is a closed enum, with other covering anything we have not mapped. Each entry includes every field, null where it does not apply: football uses minute / addedMinute; basketball uses periodSecond (seconds gone in the period), periodSecondsLeft (what the game clock shows), at, position / zone on the court, and scoreType on scoreChange; homeScore / awayScore appear on scoreChange (and on a football penaltyScored, carried forward from the previous goal). If the source has no commentary, the array is empty.\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/fixtures/play-by-play/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PlayByPlayEntry"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count",
                      "properties": {
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — kick-off falls before the start of your plan’s history window\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/play-by-play\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.playByPlay(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.play_by_play(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.PlayByPlay(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures play-by-play <id>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/h2h": {
      "get": {
        "operationId": "fixtures.h2h",
        "tags": [
          "fixtures"
        ],
        "summary": "Head to head",
        "description": "The two teams’ head-to-head record as the source tallies it, seen from this fixture’s home / away point of view, over their recent meetings (around the last ten) plus this fixture once it has finished. For the full list of meetings, call /v2/fixtures/{id}/h2h/fixtures.\n\n**Note:** If the teams have no recorded meeting, data is null rather than a 0/0/0 record. managerDuel gives the two managers’ personal record against each other, counting every team they have managed; it is null if they have never faced each other and in sports that have no managers.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/fixtures/h2h/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "$ref": "#/components/schemas/H2H"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/h2h\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.h2h(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.h2h(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.H2h(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures h2h <id>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/h2h/fixtures": {
      "get": {
        "operationId": "fixtures.h2hFixtures",
        "tags": [
          "fixtures"
        ],
        "summary": "Head-to-head fixtures",
        "description": "Past and scheduled meetings of the two teams, returned as fixtures sorted by kick-off (oldest first); the fixture you asked about is excluded.\n\n**Note:** Each item carries all Fixture fields in their list form, so those only /v2/fixtures/{id} fills (referee and the like) are null. Meetings from before your plan’s history window are omitted, with meta.historyFrom giving the first day included. Teams that have never met produce an empty array.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/fixtures/h2h-fixtures/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Fixture"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count, and historyFrom if your plan caused older meetings to be dropped",
                      "properties": {
                        "count": {
                          "type": "integer"
                        },
                        "historyFrom": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — kick-off falls before the start of your plan’s history window\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/h2h/fixtures\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.h2hFixtures(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.h2h_fixtures(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.H2hFixtures(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures h2h-fixtures <id>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/best-players": {
      "get": {
        "operationId": "fixtures.bestPlayers",
        "tags": [
          "fixtures"
        ],
        "summary": "Best players",
        "description": "The player of the match together with the top-rated players on each team.\n\n**Note:** Filled once ratings exist, which in covered leagues means during or after the match. Until then the answer is 200, with playerOfTheMatch set to null and the lists empty. label tells you what value is: a rating in football, points in basketball and ice hockey, goals in handball, yards in American football. In basketball there is one player per side, with statistics holding their line (points, rebounds, assists, steals, blocks, rating). In baseball (since 2026-11-04) the list holds the players the source rates best, each placed with their team, with role (pitcher or batter) and the stat line, pitching or batting, behind the choice; value and label are null because the source does not document its figure for them, and the ordering is the source’s, best first. Other sports have statistics set to null, and role is null in every sport except baseball.\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/fixtures/best-players/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/BestPlayers"
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/best-players\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.bestPlayers(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.best_players(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.BestPlayers(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures best-players <id>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/momentum": {
      "get": {
        "operationId": "fixtures.momentum",
        "tags": [
          "fixtures"
        ],
        "summary": "Momentum",
        "description": "Attack-momentum curve (football, plus any other sport where the source draws one) with a point for every minute: positive values mean home pressure, negative values away pressure. Tennis uses games instead — a value per game (positive when the home player took it) plus a flag for whether serve was broken.\n\n**Note:** points is filled for football, basketball and ice hockey in covered leagues; games is filled for tennis only (where points stays empty) and is empty for all other sports. Both lists are empty before kick-off and when no graph exists. Football gives each added-time minute its own point: minute stays at the last minute of the period (45 or 90) and addedMinute runs 1, 2, …; in normal time addedMinute is null. In other sports (basketball, handball, …) a minute value ending in .5 can mark the end of a period — 45.5 is half-time. Football and ice hockey have used the curve the source draws on its own website since 2026-11-04 (see the changelog).\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/fixtures/momentum/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Momentum"
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/momentum\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.momentum(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.momentum(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.Momentum(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures momentum <id>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/win-probability": {
      "get": {
        "operationId": "fixtures.winProbability",
        "tags": [
          "fixtures"
        ],
        "summary": "Win probability",
        "description": "DataSportsAPI’s in-house win probabilities for a football fixture: a pre-match estimate, the live home / draw / away split and a curve with a point at kick-off, one per minute and one right after each goal. Red cards, the start or end of a period and big missed chances (reason bigChance) add a point too, and every point is stamped with the UTC instant it refers to (at). Available on Pro, Business and Enterprise plans.\n\n**Note:** This is an analytical indicator, not betting advice, and no bookmaker odds feed into it. The model is at v3 (since 2026-10-25; v2 dated from 2026-10-22) and works openly as follows. Pre-match expected goals for each side combine three inputs. First, each team’s last 30 results in every competition, league and European cups alike, with each result weighted by how strong the opponent was. Second, the team’s domestic league table — goals scored and conceded per game, pulled towards the league average. Third, our league-strength coefficients, estimated from three seasons of European cup matches, so that teams from different leagues share one scale. The result is then mixed with three more signals: the table of the current competition, which gains weight as it fills up (after two games of a European campaign overall strength still dominates; after 30 league games the table does), the latest five results, and home advantage, which is zero in a final. On a backtest held out by season (over 8,000 league matches and 1,500 European ones) this beat v1 on both sets, with the biggest improvement in European ties and in the opening weeks of a season. v3 adds one exception: when a league match involves a newcomer — a side that arrived in the competition by promotion or relegation, early in the season — only the current table and form are used, because the newcomer’s strength measured on its previous league’s scale distorted the estimate. A fixture whose pre-match estimate was set under an earlier model stays on that model (v1 and v2 use the same in-play logic). During play, each side’s remaining goals follow a Poisson distribution over the time left (added time included, with goals becoming more likely as the match progresses); the rate drops for a team reduced to ten men (and rises for its opponent) and is tilted for the following half hour by the previous ten minutes of attack momentum. These constants were fitted on 1,080 completed matches from 12 competitions and validated on the subsequent season. From v3 onwards the in-play result is calibrated — made slightly less confident, since the curve proved a little over-confident on that backtest — and this calibration ramps in across the first 15 minutes so that the kick-off point matches the pre-match estimate. Live expected goals from the shot map are left out of the scoring rate, as they added nothing measurable on that backtest; a big missed chance does, however, still add a point to the curve. home + draw + away = 1, and draw means the scores are level at the end, counting extra time but not a shoot-out. Ahead of kick-off the response holds the pre-match estimate with an empty series; after the final whistle it holds 1 / 0 / 0 and the complete curve, which is stored for good. The pre-match estimate is frozen as soon as the match begins. Each point has an at timestamp for the match moment it stands for — the close of that minute, or the goal or whistle itself — read from the running match clock or, failing that, estimated from kick-off assuming a 15-minute half-time; Along the curve, at only ever goes up. current.at records when the estimate was computed (for a finished match, the end of the match). Points are saved once they are two minutes old and are never altered afterwards, so the curve reflects what the model said in the moment. When polling, set since to your latest at minus two minutes (a late-listed event from the source can still add a point within the most recent two minutes) and overwrite your points after since with the response. For push updates, fixture:{id} WebSocket channels on Business and Enterprise receive a winProbability frame whenever any outcome shifts by one percentage point or more.\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/fixtures/win-probability/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "ISO-8601 timestamp with any offset; limits the curve to points whose at is later than it, for polling clients — current is returned regardless",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/WinProbability"
                    },
                    "meta": {
                      "type": "object",
                      "description": "count (number of points in series), since (echoed when supplied)",
                      "properties": {
                        "count": {
                          "type": "integer"
                        },
                        "since": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- endpoint_not_in_plan — returned to keys on the Free and Starter plans\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_supported — the fixture is not a football match\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/win-probability\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.winProbability(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.win_probability(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.WinProbability(ctx, id, &datasportsapi.FixturesWinProbabilityParams{})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures win-probability <id>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/win-probability/source": {
      "get": {
        "operationId": "fixtures.sourceWinProbability",
        "tags": [
          "fixtures"
        ],
        "summary": "Source win probability",
        "description": "In-game win probability as published by our data source (not DataSportsAPI’s model): home and away values for each minute of play. Limited to American football (NFL), the only sport for which the source provides it. Available on Pro, Business and Enterprise plans.\n\n**Note:** The model field always reads \"source\": the figure comes with the source’s match data, and we do not know how it is calculated. For our own model see /v2/fixtures/{id}/win-probability (football only, models v1 to v3). Treat it as an analytical indicator, not betting advice. minute counts playing time (15 per NFL quarter, with overtime continuing the sequence), at roughly one point per minute; individual minutes may be absent and the curve may begin at 1. The last point is just the source’s final estimate; it is not forced to 1 / 0 when the game ends. Ties are not modelled, so home + away = 1. Any other sport, or a game without source data, returns 200 with an empty series and the period figures set to null. There is no WebSocket frame for it; over REST, polling about every 30 seconds during play is enough.\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/fixtures/source-win-probability/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SourceWinProbability"
                    },
                    "meta": {
                      "type": "object",
                      "description": "count (number of points in series)",
                      "properties": {
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- endpoint_not_in_plan — returned to keys on the Free and Starter plans\n- history_not_in_plan — the fixture predates the history your plan covers\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — no fixture exists with that id\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/win-probability/source\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.sourceWinProbability(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.source_win_probability(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.SourceWinProbability(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures source-win-probability <id>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/commentary": {
      "get": {
        "operationId": "fixtures.commentary",
        "tags": [
          "fixtures"
        ],
        "summary": "AI commentary",
        "description": "AI-written commentary on a football fixture, oldest first by seq (newest 100): a short entry per goal, missed penalty, red card, VAR decision, period start or end, big chance and sustained swing in momentum. Events seconds apart are merged into one entry, and there are summaries at half-time and full time. Available on Pro, Business and Enterprise plans.\n\n**Note:** DataSportsAPI AI writes every line from our own match data alone (score, clock, events, statistics, shot map and our win-probability model) and stays clear of betting language. Entries are generated only while the match is being followed, either through this endpoint or through a fixture:{id} WebSocket channel, so request it while the game is on; a match that nobody followed has no entries. Featured top-league matches on datasportsapi.com always get commentary. Every entry is written a single time and served identically to all clients, and its seq is permanent. kind takes one of these values: kickoff, goal, redCard, missedPenalty, varDecision, bigChance, momentum, periodStart, periodEnd, halfTime, fullTime, update. The minute of a fullTime summary is 90 (120 after extra time). On Business and Enterprise, fixture:{id} channels receive a commentary frame for each new entry.\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/fixtures/commentary/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Commentary"
                    },
                    "meta": {
                      "type": "object",
                      "description": "count, generatedBy",
                      "properties": {
                        "count": {
                          "type": "integer"
                        },
                        "generatedBy": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- endpoint_not_in_plan — returned to keys on the Free and Starter plans\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_supported — the fixture is not a football match\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/commentary\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.commentary(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.commentary(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.Commentary(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures commentary <id>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/shotmap": {
      "get": {
        "operationId": "fixtures.shotmap",
        "tags": [
          "fixtures"
        ],
        "summary": "Shot map",
        "description": "All shots, oldest first, with outcome and expected goals; football gives expectedGoals / expectedGoalsOnTarget, pitch and goal-mouth coordinates, body part and situation, ice hockey technique and strength. Ice hockey shots also carry rink coordinates; basketball lists each field-goal attempt as made, missed or blocked along with its court location.\n\n**Note:** Available for football, ice hockey and basketball in covered leagues; any other case returns an empty array. In football and ice hockey, outcome is goal | save | miss | block | post, and a football shot cleared off the line counts as a block. In basketball the outcomes are goal (made), miss and block; positions are measured from the basket in tenths of a foot, the player and time fields are null, and every home shot comes before the away shots. Only ice hockey uses technique (wrist, snap, slap, …) and strength. goalType is regular, ownGoal or penalty. Shoot-out kicks appear at the end: shootoutSequence is the order of kicks across both teams (matching the events), and shootoutRound is the kick’s number (1st, 2nd, …) for the taker’s side. In football, period (since 2026-10-24; null for earlier data) is derived from the minute: period1, period2, extra1, extra2, or penalties for a shoot-out kick. While a match is live the list is re-read about every 30 seconds; fixture:{id} WebSocket channels (Business and Enterprise) receive the entire list as a shotmap frame whenever it changes.\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/fixtures/shotmap/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Shot"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count",
                      "properties": {
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/shotmap\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.shotmap(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.shotmap(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.Shotmap(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures shotmap <id>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/form": {
      "get": {
        "operationId": "fixtures.form",
        "tags": [
          "fixtures"
        ],
        "summary": "Pre-match form",
        "description": "Pre-match form for both teams: recent results in this competition (oldest first), table position, the numeric table figure (points in football; wins, draws and losses in W-L / W-D-L sports) and average rating — plus each team’s latest matches across all competitions (lastFixtures: fixture id, competition, opponent, home / away, result, score).\n\n**Note:** Provided for covered leagues, both before and after the match. results mirrors the competition’s own form guide, in which an ice-hockey loss in overtime or a shoot-out (OTL at the source) counts as a loss. lastFixtures (since 2026-11-04) lists up to five of the team’s latest finished matches in any competition — league, cup, European or friendly — in chronological order, each carrying our fixture id (usable with /v2/fixtures/{id}); scoreFor / scoreAgainst hold the sides’ current scores (sets in tennis). The source has no tennis form guide, so a player’s side comes with empty results and null table figures, though lastFixtures is still populated. If a fixture has neither, the response is 200 with home and away null; 404 is returned only for ids that do not exist.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/fixtures/form/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PregameForm"
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/form\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.form(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.form(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.Form(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures form <id>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/streaks": {
      "get": {
        "operationId": "fixtures.streaks",
        "tags": [
          "fixtures"
        ],
        "summary": "Streaks",
        "description": "Pre-match streaks: each team’s current run (wins, unbeaten, over 2.5 goals, …) plus streaks drawn from their head-to-head meetings.\n\n**Note:** name is a display string in English, since the source offers no stable key for it. kind tells you how to interpret value: inARow (\"5\" → count 5 consecutive, outOf null), ofLast (\"7/8\" → count 7 out of the last outOf 8), average (\"83\" → an average of 83, with count and outOf null). The lists are empty if no streaks exist.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/fixtures/streaks/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Streaks"
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/streaks\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.streaks(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.streaks(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.Streaks(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures streaks <id>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/heatmap/{playerId}": {
      "get": {
        "operationId": "fixtures.heatmap",
        "tags": [
          "fixtures"
        ],
        "summary": "Player heatmap",
        "description": "A single football player’s activity map for the fixture — each recorded position sample, expressed as percentages of the pitch.\n\n**Note:** Football only, in covered leagues. x measures distance along the pitch in the direction the player attacks (100 = the goal being attacked) and y measures across it. points is empty when no heatmap exists, and other sports likewise get 200 with empty points; an unknown fixture or player id gets 404.\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/fixtures/heatmap/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "playerId",
            "in": "path",
            "required": true,
            "description": "player id issued by DataSportsAPI, for example taken from /lineups",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Heatmap"
                    },
                    "meta": {
                      "type": "object",
                      "description": "playerId, count",
                      "properties": {
                        "playerId": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/heatmap/{playerId}\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.heatmap(id, playerId);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.heatmap(id, player_id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.Heatmap(ctx, id, playerId)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures heatmap <id> <playerId>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/players/{playerId}/actions": {
      "get": {
        "operationId": "fixtures.playerActions",
        "tags": [
          "fixtures"
        ],
        "summary": "Player actions",
        "description": "A pitch-located log of one football player’s on-ball involvement in the fixture: passes and crosses (start → end, completion, key pass, long ball), take-ons, ball carries and defensive work (tackles, interceptions, ball recoveries, clearances, blocks). Available on Pro, Business and Enterprise plans.\n\n**Note:** Football only, in covered leagues. A player who did not play, a fixture yet to kick off and any other sport all return 200 with empty lists. Coordinates run 0–100 in the player’s attacking direction (x 0 is the player’s own goal line, x 100 the goal they attack), the same frame as the heatmap. successful lines up with the accurate / won figures in the lineups’ statistics and is null on ball carries. The source supplies no timestamps, so actions follow the source’s own ordering.\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/fixtures/player-actions/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "playerId",
            "in": "path",
            "required": true,
            "description": "player id issued by DataSportsAPI, for example taken from /lineups",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PlayerActions"
                    },
                    "meta": {
                      "type": "object",
                      "description": "playerId, count (total actions)",
                      "properties": {
                        "playerId": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — kick-off falls before the start of your plan’s history window\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — the fixture id or player id is unknown\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/players/{playerId}/actions\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.playerActions(id, playerId);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.player_actions(id, player_id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.PlayerActions(ctx, id, playerId)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures player-actions <id> <playerId>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/series": {
      "get": {
        "operationId": "fixtures.series",
        "tags": [
          "fixtures"
        ],
        "summary": "Playoff series",
        "description": "Ids of every fixture in the playoff series that contains this fixture (NBA, NHL, MLB postseason …), including this one.\n\n**Note:** Ids follow the source’s ordering. A fixture outside any series, such as a regular-season game, returns an empty list. Any of the ids can be passed to /v2/fixtures/{id}.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/fixtures/series/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "integer"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count",
                      "properties": {
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — kick-off falls before the start of your plan’s history window\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/series\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.series(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.series(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.Series(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures series <id>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/average-positions": {
      "get": {
        "operationId": "fixtures.averagePositions",
        "tags": [
          "fixtures"
        ],
        "summary": "Average positions",
        "description": "Average position of every player during the fixture, grouped by side.\n\n**Note:** Football only, in covered leagues; otherwise the lists are empty. Coordinates use the heatmap frame, oriented in the team’s attacking direction.\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/fixtures/average-positions/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/AveragePositions"
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/average-positions\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.averagePositions(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.average_positions(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.AveragePositions(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures average-positions <id>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/points": {
      "get": {
        "operationId": "fixtures.points",
        "tags": [
          "fixtures"
        ],
        "summary": "Point by point",
        "description": "A point-by-point breakdown of the match. Tennis nests sets → games (server, winner, set score) → points; badminton, table tennis and volleyball nest sets → rallies, with the running score. Cricket nests innings → overs → balls: each ball has its batter, bowler, outcome, runs, extras, wicket and dismissal, and the score after the delivery, and since 2026-11-04 also the source’s commentary text for each ball, the wagon wheel (zone, angle and distance of the shot) and the pitching spot. Baseball lists at-bats with inning, top / bottom, batting side, batter and pitcher, plus the home side’s win probability before and after the at-bat. Darts nests sets → legs (starting score, first thrower, winner, checkout) → visits (visit score, both sides’ remaining totals, checkout).\n\n**Note:** format names the one list that holds data (tennis and rally sports: sets; cricket: innings; baseball: atBats; darts: darts); every other list is empty. Darts visits do not break down into individual darts, as the source has none; a match played in legs is represented as a single set. On cricket balls (since 2026-11-04), commentary carries the source’s English text (null below the top tiers). shot describes the wagon wheel: zone is the fielding sector, as seen for a right-handed batter ( squareLeg, fineLeg, behindWicket, thirdMan, point, coverPoint, cover, longOff, straight, longOn, midWicket), angle in degrees (0 square leg, 90 behind the keeper, 180 point, 270 straight) and distance on a 1–5 scale (5 = reached the boundary); it is null when the batter did not hit the ball. pitchedAt gives where the ball pitched, in the source’s own units, with y growing with distance from the batter (about 25 for a yorker, 41 for a good length, 54 for a short ball). Each baseball at-bat includes the source’s home win probability (0–100, separate from our model) and, since 2026-11-04, an id you can pass to /v2/fixtures/{id}/at-bats/{atBatId}/pitches, where the last pitch listed ends the at-bat with its result. Any other sport, or a match with no point-by-point data yet, gets 200 with format null and every list empty. For rally sports you only get the rallies the source captured; lower tiers may skip some, which shows up as a jump in the running score. Each tennis point holds the score after it (homeScore / awayScore such as \"15\" or \"A\"; null on the game-winning point added at the end), a description (ace or doubleFault) and homeType / awayType (one of won, breakPoint, setPoint, miniBreak, none). In a match tie-break, the deciding set holds it as its only game, played to 10. Refreshed about every 30 seconds during a live match.\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/fixtures/points/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Points"
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/points\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.points(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.points(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.Points(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures points <id>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/scorecard": {
      "get": {
        "operationId": "fixtures.scorecard",
        "tags": [
          "fixtures"
        ],
        "summary": "Scorecard",
        "description": "Full cricket scorecard by innings: total, extras, batting card (runs, balls, fours, sixes, strike rate, state, dismissal, bowler, fielder) and bowling card (overs, maidens, runs, wickets, economy, wides, no-balls). Falls of wicket and partnerships follow.\n\n**Note:** Any other sport, or a cricket match before the first delivery, returns 200 with an empty innings list. Overs follow cricket notation, so 19.3 is 19 overs plus 3 balls; once an over is complete the figure moves up to the next whole number (5 rather than the source’s 4.6), and the same goes for falls of wicket. Partnerships are frequently missing for multi-day matches. Refreshed about every 30 seconds during a live match. current (CricketState) describes the crease in the live innings — striker, non-striker, bowler, over and ball — which we compute from the ball-by-ball data instead of relying on the source’s unreliable current-batsman field. It is null when no innings is under way or the match lacks ball-by-ball coverage, and right after a delivery its batters can briefly read null until the ball-by-ball data and the scorecard agree again. The only ambiguous case is a run out, where it is unclear at which end the batter was dismissed.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/fixtures/scorecard/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Scorecard"
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/scorecard\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.scorecard(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.scorecard(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.Scorecard(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures scorecard <id>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/umpires": {
      "get": {
        "operationId": "fixtures.umpires",
        "tags": [
          "fixtures"
        ],
        "summary": "Umpires",
        "description": "Baseball only: the umpiring crew, giving each umpire’s name, years of experience and position, one of homePlate, firstBase, secondBase, thirdBase, leftField, rightField or other.\n\n**Note:** Other sports, and games whose crew the source has not published, return 200 with an empty array; 404 is reserved for ids that do not exist.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/fixtures/umpires/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Umpire"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count",
                      "properties": {
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — the fixture predates the history your plan covers\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/umpires\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.umpires(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.umpires(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.Umpires(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures umpires <id>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/weather": {
      "get": {
        "operationId": "fixtures.weather",
        "tags": [
          "fixtures"
        ],
        "summary": "Weather",
        "description": "Baseball only: ballpark weather in metric units (°C, %, km/h), with the observed conditions listed before the forecast.\n\n**Note:** For any other sport the response is 200 with an empty array. forecast is true on forecast rows and false on observed ones; condition is one of a fixed list (clear, cloudy, fog, rain, snow, storm, other); the source’s own wording stays in description.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/fixtures/weather/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/WeatherObservation"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count",
                      "properties": {
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — the fixture predates the history your plan covers\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/weather\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.weather(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.weather(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.Weather(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures weather <id>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/games": {
      "get": {
        "operationId": "fixtures.games",
        "tags": [
          "fixtures"
        ],
        "summary": "Esports games",
        "description": "Esports only: the series game by game, each with status, map, start time, duration, winner and, for each side, its score and its players (role, champion / hero, kills, deaths, assists and per-title figures). Those figures are League of Legends gold, creep score and level; Dota 2 net worth, last hits, denies, and gold and experience per minute; Counter-Strike KAST, ADR, K − D, headshot kills, first-kill difference and flash assists. Each side also lists bans and objectives (towers, dragons — broken down by element for League of Legends in dragonsByType —, barons, barracks, …). Since 2026-11-04 Counter-Strike also has a record per round: who won it, the way it ended (elimination, bomb defused, bomb exploded, time expired), the side (CT / T) the home team played, and the side it started on.\n\n**Note:** Any other sport returns 200 with an empty array. Single-map titles (League of Legends) have map set to null. The title decides which player and objective fields carry values: gold, dragons and barons belong to League of Legends; denies, netWorth, goldPerMinute, experiencePerMinute, barracks and firstBlood to Dota 2; averageDamagePerRound, headshotKills, kastPercentage, killDeathDifference, firstKillDifference and flashAssists to Counter-Strike. Fields the source does not track for a title are null. Counter-Strike has neither bans nor objectives, and a map still being played has no lineup — its figures show up a few minutes after the map finishes. rounds is empty for every other title; on a Counter-Strike map it fills up as rounds are completed, with overtime rounds carrying on the numbering and flagged overtime: true, while roundsPerHalf / overtimeRoundsPerHalf define the halves.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/fixtures/games/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/EsportsGame"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count",
                      "properties": {
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — the fixture predates the history your plan covers\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/games\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.games(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.games(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.Games(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures games <id>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/at-bats/{atBatId}/pitches": {
      "get": {
        "operationId": "fixtures.pitches",
        "tags": [
          "fixtures"
        ],
        "summary": "Pitches",
        "description": "Baseball only: one at-bat pitch by pitch — type (MLB Statcast categories: four-seam fastball, sinker, cutter, changeup, curveball, slider, sweeper, …), zone, release speed, result, count and outs after each. Each pitch also carries the score, the batted ball (trajectory, hardness) and what the runners and fielders did. Plays that happen between pitches, such as a stolen-base attempt, appear as rows with kind steal.\n\n**Note:** Other sports get 200 and an empty array. balls / strikes / outs reflect the count AFTER the pitch, and the final pitch (endsAtBat true) carries the at-bat’s result as its outcome. outcome comes from a closed set; when it is other, outcomeCode holds the source’s own code. zone follows MLB Statcast numbering (1–9 inside the strike zone, 11–14 outside it). speedKmh holds the release speed in km/h; multiply it by 0.6214 for mph. For runners, fromBase 0 is the batter, toBase 4 means a run scored, and toBase is null when the runner was put out. Lists saved before 2026-11-04 show AtBat.id as null until they are refreshed.\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/fixtures/pitches/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "atBatId",
            "in": "path",
            "required": true,
            "description": "at-bat identifier, taken from AtBat.id in /v2/fixtures/{id}/points",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Pitch"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "atBatId, count",
                      "properties": {
                        "atBatId": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — the fixture predates the history your plan covers\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — the fixture or at-bat id does not exist\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/at-bats/{atBatId}/pitches\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.pitches(id, atBatId);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.pitches(id, at_bat_id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.Pitches(ctx, id, atBatId)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures pitches <id> <atBatId>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/highlights": {
      "get": {
        "operationId": "fixtures.highlights",
        "tags": [
          "fixtures"
        ],
        "summary": "Highlights",
        "description": "Match highlight videos, each with a title, its URL on the hosting platform (YouTube, X), the host name, the host’s thumbnail, a flag for the source’s main highlight and any country restrictions. DataSportsAPI does not host video; link to it or embed it from the original platform.\n\n**Note:** The main highlight is listed first, with the rest ordered by publication. Videos typically turn up a few hours after the final whistle; before that, and for matches that never get any, the array is empty. countries restricts a video to the listed countries because of broadcast rights; an empty list means it is available everywhere. thumbnailUrl links to an image on the video host itself (i.ytimg.com, pbs.twimg.com); for any other host it is null.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/fixtures/highlights/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Highlight"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count",
                      "properties": {
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — the fixture predates the history your plan covers\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/highlights\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.highlights(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.highlights(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.Highlights(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures highlights <id>"
          }
        ]
      }
    },
    "/v2/teams/{id}": {
      "get": {
        "operationId": "teams.get",
        "tags": [
          "teams"
        ],
        "summary": "Team",
        "description": "Returns a team’s profile — sport, country, venue, colours, logo, gender, whether it is a club or a national team, kind (team / individual / pair), manager and founding date (foundedOn, present for roughly half of all teams). Individual competitors that the source profiles (tennis, MMA) also get person: nickname, date of birth, height, weight, reach and weight class, with tennis adding birthplace, residence, handedness (right / left / ambidextrous), turnedPro (a year) and prize money for the current season and the whole career (Money). MMA and boxing fighters additionally carry record: their career win-draw-loss tally plus their latest fights and how each one was decided.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/teams/get/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI team id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/TeamDetail"
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/teams/{id}\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.teams.get(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.teams.get(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Teams.Get(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa teams get <id>"
          }
        ]
      }
    },
    "/v2/teams/{id}/fixtures": {
      "get": {
        "operationId": "teams.fixtures",
        "tags": [
          "teams"
        ],
        "summary": "Team fixtures",
        "description": "Returns one page of a team’s fixtures, either recent or upcoming.\n\n**Note:** If the team exists but has nothing to list, the response is 200 with an empty array. Since 2026-10-24 every competitor list splits matches the same way. upcoming holds matches not yet started (including ones postponed to a future date), soonest first, and page 0 also includes a next match that the source has filed under recent (tennis players, fighters). recent holds live, finished and called-off matches, with the newest at the top of every page. For a live or just-finished match, status, score and clock are accurate to the second. Once a match kicks off it moves to recent on your next request, and both lists are rebuilt on the first request after any of the team’s matches ends, is rescheduled or is postponed (see Data freshness).\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/teams/fixtures/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI team id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "recent \\| upcoming; upcoming when omitted",
            "schema": {
              "type": "string",
              "enum": [
                "recent",
                "upcoming"
              ],
              "default": "upcoming"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "zero-based page number, a whole number from 0 to 50 (defaults to 0)",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 50,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Fixture"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "type, page, count, hasNextPage",
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "page": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        },
                        "hasNextPage": {
                          "type": "boolean"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — type is neither recent nor upcoming, or page is not a whole number between 0 and 50\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/teams/{id}/fixtures\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.teams.fixtures(id);\nfor await (const page of client.teams.fixturesPages(id)) { … }"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.teams.fixtures(id)\nfor page in client.teams.fixtures_pages(id): ..."
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Teams.Fixtures(ctx, id, &datasportsapi.TeamsFixturesParams{})\nfor page, err := range client.Teams.FixturesPages(ctx, id, &datasportsapi.TeamsFixturesParams{}) { … }"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa teams fixtures <id>\n$ dsa teams fixtures <id> --all -o csv"
          }
        ]
      }
    },
    "/v2/teams/{id}/squad": {
      "get": {
        "operationId": "teams.squad",
        "tags": [
          "teams"
        ],
        "summary": "Squad",
        "description": "Lists the team’s present roster, giving each player’s profile together with their contract expiry and any ongoing injury.\n\n**Note:** Applies to team sports that keep rosters; a team without one returns an empty array. injury is null unless the player is currently injured, in which case it holds status (out / dayToDay / doubtful / other), description, since, expectedReturn and updatedAt.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/teams/squad/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI team id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/SquadPlayer"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count",
                      "properties": {
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/teams/{id}/squad\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.teams.squad(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.teams.squad(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Teams.Squad(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa teams squad <id>"
          }
        ]
      }
    },
    "/v2/teams/{id}/transfers": {
      "get": {
        "operationId": "teams.transfers",
        "tags": [
          "teams"
        ],
        "summary": "Team transfers",
        "description": "Arrivals and departures over roughly the past year, latest first: transfers with fees, loans and their expiry, and US-league roster transactions — signings, trades, the draft, waivers and 10-day contracts.\n\n**Note:** Both teams are identified whenever the source provides them. A free agent signing lacks from and a waiver lacks to, although fromName / toName still give the source’s label for a side it does not link. fee appears only when the source reports an amount, and freeTransfer flags a move that cost nothing. Both lists are empty if the source has no moves.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/teams/transfers/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI team id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/TeamTransfers"
                    },
                    "meta": {
                      "type": "object",
                      "description": "arrivalCount, departureCount",
                      "properties": {
                        "arrivalCount": {
                          "type": "integer"
                        },
                        "departureCount": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/teams/{id}/transfers\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.teams.transfers(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.teams.transfers(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Teams.Transfers(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa teams transfers <id>"
          }
        ]
      }
    },
    "/v2/teams/{id}/statistics": {
      "get": {
        "operationId": "teams.statistics",
        "tags": [
          "teams"
        ],
        "summary": "Team season statistics",
        "description": "Season totals and averages for a team within a single league — goals for and against, shots, possession, rating, clean sheets and more.\n\n**Note:** Keys use the same vocabulary as match statistics (totalShots, shotsOnGoal, cornerKicks, passes, averageRating, …), paired with an …Against variant that holds what opponents recorded. A matches value of 0 is dropped when the other counts are non-zero.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/teams/statistics/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI team id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "league",
            "in": "query",
            "required": true,
            "description": "league id — for example, the league of one of the team’s fixtures",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": true,
            "description": "season id, as listed by /v2/leagues/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "overall \\| home \\| away \\| regularSeason \\| playoffs. When omitted, the season’s native type applies: overall if the season has one (football), otherwise regularSeason (NBA, NHL, …); meta.type reports the one applied",
            "schema": {
              "type": "string",
              "enum": [
                "overall",
                "home",
                "away",
                "regularSeason",
                "playoffs"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/TeamSeasonStatistics"
                    },
                    "meta": {
                      "type": "object",
                      "description": "league, season, type (as applied)",
                      "properties": {
                        "league": {
                          "type": "integer"
                        },
                        "season": {
                          "type": "integer"
                        },
                        "type": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — league or season is absent, or type is something other than overall, home, away, regularSeason or playoffs\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- no_data — no statistics exist at the source for this combination of team, league, season and type (an id DataSportsAPI never assigned gives 404 not_found instead)\n- not_found — the season id does not belong to this league; the error message names the offending parameter, and /v2/leagues/{id}/seasons lists the valid ones\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/teams/{id}/statistics?league=…&season=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.teams.statistics(id, { league, season });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.teams.statistics(id, league=league, season=season)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Teams.Statistics(ctx, id, &datasportsapi.TeamsStatisticsParams{League: league, Season: season})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa teams statistics <id> --league <league> --season <season>"
          }
        ]
      }
    },
    "/v2/teams/{id}/goal-distribution": {
      "get": {
        "operationId": "teams.goalDistribution",
        "tags": [
          "teams"
        ],
        "summary": "Goal distribution",
        "description": "Football: shows at which stage of a match a team scores and concedes across one league season, counting goals in 15-minute bands for all matches, home matches and away matches.\n\n**Note:** The list has three entries (overall, home, away), each split into six bands from 1–15 to 76–90; goals in added time are counted in the band they extend. Empty if the source has no distribution.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/teams/goal-distribution/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI team id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "league",
            "in": "query",
            "required": true,
            "description": "league id — for example, the league of one of the team’s fixtures",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": true,
            "description": "season id, as listed by /v2/leagues/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/GoalDistribution"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "league, season, count",
                      "properties": {
                        "league": {
                          "type": "integer"
                        },
                        "season": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — the season finished before your plan’s history window begins\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — the season id does not belong to this league\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/teams/{id}/goal-distribution?league=…&season=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.teams.goalDistribution(id, { league, season });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.teams.goal_distribution(id, league=league, season=season)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Teams.GoalDistribution(ctx, id, &datasportsapi.TeamsGoalDistributionParams{League: league, Season: season})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa teams goal-distribution <id> --league <league> --season <season>"
          }
        ]
      }
    },
    "/v2/teams/{id}/race-career": {
      "get": {
        "operationId": "teams.raceCareer",
        "tags": [
          "teams"
        ],
        "summary": "Race career",
        "description": "For race sports, the career of a driver or constructor: aggregate totals (races started, wins, podiums, poles, titles) plus one row per series season with championship position, points and figures; a driver’s row also names their constructor in that season. Available since 2026-11-04.\n\n**Note:** Seasons are ordered newest first. A season still in progress shows the standings to date, with position null until the first ranked race. Race-by-race results for a season come from /v2/teams/{id}/races (send the season id). A competitor from another sport gets totals null and an empty seasons list.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/teams/race-career/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI team id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/RaceCareer"
                    },
                    "meta": {
                      "type": "object",
                      "description": "count (number of seasons); historyFrom appears if your plan trimmed older seasons",
                      "properties": {
                        "count": {
                          "type": "integer"
                        },
                        "historyFrom": {
                          "type": "string",
                          "format": "date"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — DataSportsAPI has never assigned this id\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/teams/{id}/race-career\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.teams.raceCareer(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.teams.race_career(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Teams.RaceCareer(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa teams race-career <id>"
          }
        ]
      }
    },
    "/v2/teams/{id}/races": {
      "get": {
        "operationId": "teams.races",
        "tags": [
          "teams"
        ],
        "summary": "Season races",
        "description": "For race sports, how a driver or constructor finished in every race of one series season: a driver’s grid slot, position, points, race time and gap, or a constructor’s position, points and its drivers’ placings. Available since 2026-11-04.\n\n**Note:** Races run oldest first. Each row reflects the weekend’s main race; sprint results live at /v2/races/{id}/results?session=. A driver who did not finish or start shows position null, a state such as didNotFinish / didNotStart / … and an outReason. The list is empty if the competitor took no part in that season.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/teams/races/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI team id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": true,
            "description": "series season id, taken from /v2/teams/{id}/race-career or /v2/series/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/TeamRaceResult"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "season, count; historyFrom appears if your plan trimmed older races",
                      "properties": {
                        "season": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        },
                        "historyFrom": {
                          "type": "string",
                          "format": "date"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — the season parameter was not supplied\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — all of the season’s races predate your plan’s history window\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — DataSportsAPI has never assigned this id\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/teams/{id}/races?season=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.teams.races(id, { season });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.teams.races(id, season=season)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Teams.Races(ctx, id, &datasportsapi.TeamsRacesParams{Season: season})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa teams races <id> --season <season>"
          }
        ]
      }
    },
    "/v2/teams/{id}/statistics/seasons": {
      "get": {
        "operationId": "teams.statisticsSeasons",
        "tags": [
          "teams"
        ],
        "summary": "Statistics seasons",
        "description": "An index of the leagues and seasons with team season statistics, giving the league and season values that /v2/teams/{id}/statistics accepts along with the statistics types offered in each. Available since 2026-11-04.\n\n**Note:** Shares its shape with /v2/players/{id}/seasons, newest season first. Two related indexes: /v2/teams/{id}/standings/seasons lists the leagues in which the team appears in a table (types is empty there), and /v2/teams/{id}/top-players/seasons lists where /v2/teams/{id}/top-players has squad statistics.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/teams/statistics-seasons/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI team id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PlayerLeagueSeasons"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count",
                      "properties": {
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — DataSportsAPI has never assigned this id\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/teams/{id}/statistics/seasons\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.teams.statisticsSeasons(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.teams.statistics_seasons(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Teams.StatisticsSeasons(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa teams statistics-seasons <id>"
          }
        ]
      }
    },
    "/v2/teams/{id}/top-players/seasons": {
      "get": {
        "operationId": "teams.topPlayersSeasons",
        "tags": [
          "teams"
        ],
        "summary": "Squad statistics seasons",
        "description": "Lists the leagues and seasons where squad (player) statistics exist for the team — the inputs for /v2/teams/{id}/top-players. Available since 2026-11-04.\n\n**Note:** Uses the response shape of /v2/teams/{id}/statistics/seasons.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/teams/top-players-seasons/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI team id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PlayerLeagueSeasons"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count",
                      "properties": {
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — DataSportsAPI has never assigned this id\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/teams/{id}/top-players/seasons\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.teams.topPlayersSeasons(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.teams.top_players_seasons(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Teams.TopPlayersSeasons(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa teams top-players-seasons <id>"
          }
        ]
      }
    },
    "/v2/teams/{id}/standings/seasons": {
      "get": {
        "operationId": "teams.standingsSeasons",
        "tags": [
          "teams"
        ],
        "summary": "Table seasons",
        "description": "Lists every league and season where the team appears in a standings table, ready to pass to /v2/leagues/{id}/standings. Available since 2026-11-04.\n\n**Note:** Uses the response shape of /v2/teams/{id}/statistics/seasons, except that types is empty: choose overall, home or away through /v2/leagues/{id}/standings?type= instead.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/teams/standings-seasons/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI team id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PlayerLeagueSeasons"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count",
                      "properties": {
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — DataSportsAPI has never assigned this id\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/teams/{id}/standings/seasons\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.teams.standingsSeasons(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.teams.standings_seasons(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Teams.StandingsSeasons(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa teams standings-seasons <id>"
          }
        ]
      }
    },
    "/v2/teams/{id}/year-statistics": {
      "get": {
        "operationId": "teams.yearStatistics",
        "tags": [
          "teams"
        ],
        "summary": "Tennis year statistics",
        "description": "A tennis player’s calendar year by surface, one row each: matches and wins, tournaments entered and won, aces and double faults, break points, tie-breaks, serve and return points, winners and unforced errors.\n\n**Note:** Derived fields: servicePoints = firstServesIn + secondServes and secondServesIn = secondServes − doubleFaults. Team sports, and years in which the player had no matches, return an empty list.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/teams/year-statistics/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI team id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "year",
            "in": "query",
            "required": true,
            "description": "calendar year such as 2026",
            "schema": {
              "type": "integer",
              "minimum": 1990,
              "maximum": 2100
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/TennisYearStatistics"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "year, count",
                      "properties": {
                        "year": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — year is absent or malformed\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — the year finished before your plan’s history window begins\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/teams/{id}/year-statistics?year=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.teams.yearStatistics(id, { year });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.teams.year_statistics(id, year=year)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Teams.YearStatistics(ctx, id, &datasportsapi.TeamsYearStatisticsParams{Year: year})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa teams year-statistics <id> --year <year>"
          }
        ]
      }
    },
    "/v2/teams/{id}/grand-slams": {
      "get": {
        "operationId": "teams.grandSlams",
        "tags": [
          "teams"
        ],
        "summary": "Grand Slam results",
        "description": "Shows, year by year, how far a tennis player went at each Grand Slam. Available since 2026-11-04.\n\n**Note:** Years run oldest first and go back as far as the source does — roughly five. round carries the source’s label for the deepest round reached; won flags a title and inProgress an edition still being played. Team sports return an empty list.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/teams/grand-slams/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI team id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/GrandSlamResults"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count",
                      "properties": {
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — DataSportsAPI has never assigned this id\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/teams/{id}/grand-slams\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.teams.grandSlams(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.teams.grand_slams(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Teams.GrandSlams(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa teams grand-slams <id>"
          }
        ]
      }
    },
    "/v2/teams/{id}/leagues": {
      "get": {
        "operationId": "teams.leagues",
        "tags": [
          "teams"
        ],
        "summary": "Team leagues",
        "description": "All competitions the team takes part in now or has taken part in before: domestic league, cups, European competitions and friendly tournaments.\n\n**Note:** Use a returned league id with /v2/leagues/{id}/seasons and the other season endpoints. Players do not need this step, as /v2/players/{id}/seasons already returns their leagues together with the seasons. The array is empty when the source lists no competitions.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/teams/leagues/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI team id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/LeagueRef"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count",
                      "properties": {
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/teams/{id}/leagues\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.teams.leagues(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.teams.leagues(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Teams.Leagues(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa teams leagues <id>"
          }
        ]
      }
    },
    "/v2/teams/{id}/trophies": {
      "get": {
        "operationId": "teams.trophies",
        "tags": [
          "teams"
        ],
        "summary": "Trophies",
        "description": "Everything the team has won: each competition, typed as domestic league, domestic cup, international cup or other, with a flag for major titles, the number of wins and the winning seasons, most recent first.\n\n**Note:** A team that has never won a trophy gets 200 and an empty array.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/teams/trophies/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI team id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Trophy"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count (number of competitions), totalCount (overall trophy tally as the source counts it, or null if the source gives none)",
                      "properties": {
                        "count": {
                          "type": "integer"
                        },
                        "totalCount": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/teams/{id}/trophies\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.teams.trophies(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.teams.trophies(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Teams.Trophies(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa teams trophies <id>"
          }
        ]
      }
    },
    "/v2/teams/{id}/position-history": {
      "get": {
        "operationId": "teams.positionHistory",
        "tags": [
          "teams"
        ],
        "summary": "Position history",
        "description": "Tracks a team’s league position week by week through one season, starting at week 1: the position at the end of each week and the fixtures played in it.\n\n**Note:** Works only for league competitions that have a table, not for cups. In a week without a match, the previous week’s position carries over.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/teams/position-history/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI team id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "league",
            "in": "query",
            "required": true,
            "description": "league id, for instance one returned by /v2/teams/{id}/leagues",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": true,
            "description": "season id, as listed by /v2/leagues/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PositionHistoryPoint"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "league, season, count",
                      "properties": {
                        "league": {
                          "type": "integer"
                        },
                        "season": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — league or season is absent or malformed\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — the season finished before your plan’s history window begins\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- no_data — the source holds no position history for this team, league and season (an id DataSportsAPI never assigned gives 404 not_found instead)\n- not_found — the season id does not belong to this league; the error message names the offending parameter, and /v2/leagues/{id}/seasons lists the valid ones\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/teams/{id}/position-history?league=…&season=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.teams.positionHistory(id, { league, season });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.teams.position_history(id, league=league, season=season)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Teams.PositionHistory(ctx, id, &datasportsapi.TeamsPositionHistoryParams{League: league, Season: season})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa teams position-history <id> --league <league> --season <season>"
          }
        ]
      }
    },
    "/v2/teams/{id}/career-statistics": {
      "get": {
        "operationId": "teams.careerStatistics",
        "tags": [
          "teams"
        ],
        "summary": "Career statistics",
        "description": "Career-long numbers for an MMA fighter: strikes landed and absorbed per round, split by target (head, body, legs) and by position (distance, clinch, ground); accuracy and defence percentages; takedowns and submissions per 15 minutes; and the time spent in each position.\n\n**Note:** Figures given per round or per 15 minutes are averages, *Percentage keys hold shares from 0 to 100 and *Seconds keys are cumulative totals. For the career win-draw-loss record, read TeamDetail.record.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/teams/career-statistics/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI team id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/FighterCareerStatistics"
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- no_data — career statistics exist only for MMA fighters, and the source may have none even for one (an id DataSportsAPI never assigned gives 404 not_found instead)\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/teams/{id}/career-statistics\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.teams.careerStatistics(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.teams.career_statistics(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Teams.CareerStatistics(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa teams career-statistics <id>"
          }
        ]
      }
    },
    "/v2/teams/{id}/rankings": {
      "get": {
        "operationId": "teams.rankings",
        "tags": [
          "teams"
        ],
        "summary": "Team rankings",
        "description": "Gives a team’s or competitor’s place in each ranking table DataSportsAPI serves: the ATP / WTA rankings and live rankings for tennis players (career high included) plus their UTR rating; the FIFA or World Rugby ranking for national teams; UEFA coefficients for clubs; the padel world ranking for padel players; and the UFC or Fight Nation Championship division for fighters.\n\n**Note:** Each table contributes one row, ordered as in /v2/rankings, and that row is the team’s entry in /v2/rankings/{type}. Rankings we do not serve are omitted. Since 2026-11-04, a utr-men / utr-women row puts the player’s UTR rating (16.45) in points, along with the best position ever reached and its date (bestPositionAt). If the team is in no table, the array is empty. bestPosition holds the career high when the source supplies it (tennis), while bestPositionAt is seldom filled.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/teams/rankings/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI team id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/TeamRanking"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count",
                      "properties": {
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/teams/{id}/rankings\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.teams.rankings(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.teams.rankings(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Teams.Rankings(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa teams rankings <id>"
          }
        ]
      }
    },
    "/v2/teams/{id}/top-players": {
      "get": {
        "operationId": "teams.topPlayers",
        "tags": [
          "teams"
        ],
        "summary": "Team top players",
        "description": "Season leaderboards limited to one team’s players within a league — highest-rated players, leading scorers, top assisters and so on — paginated like the league-wide leaderboards.\n\n**Note:** Response shape and pagination match /v2/leagues/{id}/top-players, filtered to this team’s players. An empty array means the source holds nothing for this team in that league season.\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/teams/top-players/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI team id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "league",
            "in": "query",
            "required": true,
            "description": "id of a league the team competes in (see /v2/teams/{id}/leagues)",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": true,
            "description": "season id, as listed by /v2/leagues/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "overall \\| home \\| away \\| regularSeason \\| playoffs. When omitted, the season’s native type applies: overall if the season has one (football), otherwise regularSeason (NBA, NHL, …); meta.type reports the one applied",
            "schema": {
              "type": "string",
              "enum": [
                "overall",
                "home",
                "away",
                "regularSeason",
                "playoffs"
              ]
            }
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "restricts the response to a single leaderboard, named by one of this season’s categories such as goals; an unrecognised value returns 400 listing the season’s categories",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9]{1,60}$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "number of entries in each leaderboard, 1–50 (defaults to 10)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "default": 10
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "which block of limit entries to return, 0–49; the default 0 shows the leaders",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 49,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/TopPlayersCategory"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "season, type (as applied), category (null means every category), limit, page, count (number of categories), hasNextPage",
                      "properties": {
                        "season": {
                          "type": "integer"
                        },
                        "type": {
                          "type": "string"
                        },
                        "category": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "limit": {
                          "type": "integer"
                        },
                        "page": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        },
                        "hasNextPage": {
                          "type": "boolean"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — league or season is absent, or paging, type or category is invalid (the rules of /v2/leagues/{id}/top-players apply)\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — the season finished before your plan’s history window begins\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — the season id does not belong to this league\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/teams/{id}/top-players?league=…&season=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.teams.topPlayers(id, { league, season });\nfor await (const page of client.teams.topPlayersPages(id, { league, season })) { … }"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.teams.top_players(id, league=league, season=season)\nfor page in client.teams.top_players_pages(id, league=league, season=season): ..."
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Teams.TopPlayers(ctx, id, &datasportsapi.TeamsTopPlayersParams{League: league, Season: season})\nfor page, err := range client.Teams.TopPlayersPages(ctx, id, &datasportsapi.TeamsTopPlayersParams{League: league, Season: season}) { … }"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa teams top-players <id> --league <league> --season <season>\n$ dsa teams top-players <id> --league <league> --season <season> --all -o csv"
          }
        ]
      }
    },
    "/v2/teams/{id}/featured-fixture": {
      "get": {
        "operationId": "teams.featuredFixture",
        "tags": [
          "teams"
        ],
        "summary": "Featured fixture",
        "description": "Returns the match the source highlights for a team, which is normally its next fixture or the one it is playing right now.\n\n**Note:** While the match is live, score and clock are accurate to the second.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/teams/featured-fixture/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI team id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Fixture"
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- no_data — the source is not highlighting any match for this team at the moment; 404 not_found — DataSportsAPI has never assigned this id\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/teams/{id}/featured-fixture\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.teams.featuredFixture(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.teams.featured_fixture(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Teams.FeaturedFixture(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa teams featured-fixture <id>"
          }
        ]
      }
    },
    "/v2/players/{id}": {
      "get": {
        "operationId": "players.get",
        "tags": [
          "players"
        ],
        "summary": "Player",
        "description": "A player’s profile: position and detailed positions (goalkeeper, centreBack, leftWinger, striker, …; empty array if none), team, nationality, physique, market value, contract expiry, current injury (null if fit).\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/players/get/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI player id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Player"
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/players/{id}\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.players.get(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.players.get(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Players.Get(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa players get <id>"
          }
        ]
      }
    },
    "/v2/players/{id}/transfers": {
      "get": {
        "operationId": "players.transfers",
        "tags": [
          "players"
        ],
        "summary": "Player transfers",
        "description": "Every move in the player’s career, most recent first, returned as the same Transfer objects that team transfer lists use.\n\n**Note:** Returns an empty array if the source records no moves.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/players/transfers/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI player id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Transfer"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count",
                      "properties": {
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/players/{id}/transfers\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.players.transfers(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.players.transfers(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Players.Transfers(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa players transfers <id>"
          }
        ]
      }
    },
    "/v2/transfers": {
      "get": {
        "operationId": "transfers.list",
        "tags": [
          "players"
        ],
        "summary": "Latest transfers",
        "description": "A feed of the newest football transfers from all leagues, 50 per page, built from the same Transfer objects as team transfer lists. Order it by date (newest move first), by fee (largest first) or by player popularity, Filters narrow it to one league (moves to or from its clubs), a position, a nationality and an age range.\n\n**Note:** Covers football alone, the only sport for which the source maintains this feed. latest orders moves by the date they take effect, which means a loan expiring today is listed next to a signing announced today. Releases and moves into free agency end at \"No team\" — to stays null and toName holds that label. The feed updates every 30 minutes.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/players/transfers-list/"
        },
        "parameters": [
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "latest \\| fee \\| popular; latest when omitted",
            "schema": {
              "type": "string",
              "enum": [
                "latest",
                "fee",
                "popular"
              ],
              "default": "latest"
            }
          },
          {
            "name": "league",
            "in": "query",
            "required": false,
            "description": "league id; keeps only moves into or out of that league’s clubs",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "position",
            "in": "query",
            "required": false,
            "description": "goalkeeper \\| defender \\| midfielder \\| forward",
            "schema": {
              "type": "string",
              "enum": [
                "goalkeeper",
                "defender",
                "midfielder",
                "forward"
              ]
            }
          },
          {
            "name": "nationality",
            "in": "query",
            "required": false,
            "description": "two-letter country code in the form Country.code uses, case-insensitive (England EN, Scotland SX, Wales WA, Northern Ireland NX)",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z]{2}$"
            }
          },
          {
            "name": "minAge",
            "in": "query",
            "required": false,
            "description": "minimum player age in whole years, 15–45",
            "schema": {
              "type": "integer",
              "minimum": 15,
              "maximum": 45
            }
          },
          {
            "name": "maxAge",
            "in": "query",
            "required": false,
            "description": "maximum player age in whole years, 15–45; must not be lower than minAge",
            "schema": {
              "type": "integer",
              "minimum": 15,
              "maximum": 45
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "page number from 0 to 50 (defaults to 0)",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 50,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Transfer"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "sort, league, position, nationality, minAge, maxAge, page, count, hasNextPage",
                      "properties": {
                        "sort": {
                          "type": "string"
                        },
                        "league": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "position": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "nationality": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "minAge": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "maxAge": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "page": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        },
                        "hasNextPage": {
                          "type": "boolean"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — sort or position takes a value not listed above, nationality is not a country code, an age falls outside 15–45 or minAge exceeds maxAge, or page is outside 0–50\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — DataSportsAPI has never assigned this league id\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/transfers\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.transfers.list();\nfor await (const page of client.transfers.listPages()) { … }"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.transfers.list()\nfor page in client.transfers.list_pages(): ..."
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Transfers.List(ctx, &datasportsapi.TransfersListParams{})\nfor page, err := range client.Transfers.ListPages(ctx, &datasportsapi.TransfersListParams{}) { … }"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa transfers list\n$ dsa transfers list --all -o csv"
          }
        ]
      }
    },
    "/v2/players/{id}/seasons": {
      "get": {
        "operationId": "players.seasons",
        "tags": [
          "players"
        ],
        "summary": "Player seasons",
        "description": "Lists each league and season for which the player has statistics, together with the statistics types offered in each (overall, home, away, regularSeason, playoffs).\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/players/seasons/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI player id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PlayerLeagueSeasons"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count",
                      "properties": {
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/players/{id}/seasons\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.players.seasons(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.players.seasons(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Players.Seasons(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa players seasons <id>"
          }
        ]
      }
    },
    "/v2/players/{id}/fixtures": {
      "get": {
        "operationId": "players.fixtures",
        "tags": [
          "players"
        ],
        "summary": "Player fixtures",
        "description": "One page of the player’s most recent fixtures, across every team they appeared for; since 2026-10-24 each page lists the newest first. Page 0 opens with any fixtures not yet started, soonest first (since 2026-10-27; earlier, a player with two matches ahead saw the later one first), then continues with the rest newest first. Every fixture includes playerMatch: the side the player was on, whether they remained on the bench, their rating, their match statistics (minutes in football; box scores in basketball and ice hockey) and their goals, assists and cards.\n\n**Note:** A known player with no fixtures at the source gets 200 and an empty array. playerMatch.statistics shares its per-player keys with the lineups.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/players/fixtures/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI player id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "zero-based page number, a whole number from 0 to 50; the default 0 holds the most recent fixtures",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 50,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PlayerFixture"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "page, count, hasNextPage",
                      "properties": {
                        "page": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        },
                        "hasNextPage": {
                          "type": "boolean"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — page is not a whole number between 0 and 50\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/players/{id}/fixtures\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.players.fixtures(id);\nfor await (const page of client.players.fixturesPages(id)) { … }"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.players.fixtures(id)\nfor page in client.players.fixtures_pages(id): ..."
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Players.Fixtures(ctx, id, &datasportsapi.PlayersFixturesParams{})\nfor page, err := range client.Players.FixturesPages(ctx, id, &datasportsapi.PlayersFixturesParams{}) { … }"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa players fixtures <id>\n$ dsa players fixtures <id> --all -o csv"
          }
        ]
      }
    },
    "/v2/players/{id}/statistics": {
      "get": {
        "operationId": "players.statistics",
        "tags": [
          "players"
        ],
        "summary": "Player season statistics",
        "description": "Season totals and averages for a player within a single league — goals, minutes, averageRating, expected goals, passes, duels and more.\n\n**Note:** Keys use the same vocabulary as match statistics: totalShots, shotsOnGoal, passes, averageRating, goalInvolvements, minutesPerGoal (omitted when the player has not scored), kilometersCovered (metersCovered / 1000) and so on. The data reference lists every football key with what it measures (season statistic keys). For football, ratingBreakdown shows how much shooting, passing, dribbling, defending and (goalkeepers only) goalkeeping added to the season rating; it is null when the source provides none.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/players/statistics/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI player id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "league",
            "in": "query",
            "required": true,
            "description": "league id, as listed by /v2/players/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": true,
            "description": "season id, as listed by /v2/leagues/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "a type the season offers according to /seasons (overall \\| home \\| away \\| regularSeason \\| playoffs); when omitted, the season’s native type applies — overall, otherwise regularSeason",
            "schema": {
              "type": "string",
              "enum": [
                "overall",
                "home",
                "away",
                "regularSeason",
                "playoffs"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PlayerStatistics"
                    },
                    "meta": {
                      "type": "object",
                      "description": "league, season, type (as applied)",
                      "properties": {
                        "league": {
                          "type": "integer"
                        },
                        "season": {
                          "type": "integer"
                        },
                        "type": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — league or season is absent, or type is something other than overall, home, away, regularSeason or playoffs\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- no_data — no statistics exist at the source for this combination of player, league, season and type (an id DataSportsAPI never assigned gives 404 not_found instead)\n- not_found — the season id does not belong to this league; the error message names the offending parameter, and /v2/leagues/{id}/seasons lists the valid ones\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/players/{id}/statistics?league=…&season=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.players.statistics(id, { league, season });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.players.statistics(id, league=league, season=season)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Players.Statistics(ctx, id, &datasportsapi.PlayersStatisticsParams{League: league, Season: season})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa players statistics <id> --league <league> --season <season>"
          }
        ]
      }
    },
    "/v2/players/{id}/statistics/rankings": {
      "get": {
        "operationId": "players.statisticsRankings",
        "tags": [
          "players"
        ],
        "summary": "Season rankings",
        "description": "For every statistic, shows how the player compares with the rest of the league in one season: their value, their place (tied values share a place), how many players are tied there and how many are ranked in total. Available on Pro, Business and Enterprise plans.\n\n**Note:** statistic takes its keys from /v2/players/{id}/statistics. Returns an empty list when the source ranks nobody, as in minor leagues and other sports.\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/players/statistics-rankings/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI player id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "league",
            "in": "query",
            "required": true,
            "description": "league id, as listed by /v2/players/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": true,
            "description": "season id, as listed by /v2/leagues/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "statistics type; overall when omitted",
            "schema": {
              "type": "string",
              "enum": [
                "overall",
                "home",
                "away",
                "regularSeason",
                "playoffs"
              ],
              "default": "overall"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PlayerStatRanking"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "league, season, type, count",
                      "properties": {
                        "league": {
                          "type": "integer"
                        },
                        "season": {
                          "type": "integer"
                        },
                        "type": {
                          "type": "string"
                        },
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — the season finished before your plan’s history window begins\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — the season id does not belong to this league\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/players/{id}/statistics/rankings?league=…&season=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.players.statisticsRankings(id, { league, season });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.players.statistics_rankings(id, league=league, season=season)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Players.StatisticsRankings(ctx, id, &datasportsapi.PlayersStatisticsRankingsParams{League: league, Season: season})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa players statistics-rankings <id> --league <league> --season <season>"
          }
        ]
      }
    },
    "/v2/players/{id}/penalties": {
      "get": {
        "operationId": "players.penalties",
        "tags": [
          "players"
        ],
        "summary": "Penalties",
        "description": "Football penalty record for a player across one league season: totals scored and taken, plus each kick: its fixture, its outcome (goal, save, miss, post), its xG and where in the goal it went. Available since 2026-11-04.\n\n**Note:** Only penalties during play are included, not shoot-outs, ordered oldest first. goalMouth uses the same goal-mouth frame as the shot map. Without source data, the list is empty and the counts are null.\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/players/penalties/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI player id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "league",
            "in": "query",
            "required": true,
            "description": "league id, as listed by /v2/players/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": true,
            "description": "season id, as listed by /v2/leagues/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PenaltyHistory"
                    },
                    "meta": {
                      "type": "object",
                      "description": "league, season, count",
                      "properties": {
                        "league": {
                          "type": "integer"
                        },
                        "season": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — the season finished before your plan’s history window begins\n- endpoint_not_in_plan — returned to keys on the Free and Starter plans\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — the season id does not belong to this league\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/players/{id}/penalties?league=…&season=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.players.penalties(id, { league, season });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.players.penalties(id, league=league, season=season)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Players.Penalties(ctx, id, &datasportsapi.PlayersPenaltiesParams{League: league, Season: season})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa players penalties <id> --league <league> --season <season>"
          }
        ]
      }
    },
    "/v2/players/{id}/attributes": {
      "get": {
        "operationId": "players.attributes",
        "tags": [
          "players"
        ],
        "summary": "Player attributes",
        "description": "Attribute ratings (0–100) for a football player from the source’s scouting model: attacking, technical, tactical, defending and creativity, or for a goalkeeper saves, anticipation, ball distribution, aerial and tactical. Includes current and earlier-year values, the average for players in the same position, strengths and weaknesses, and the detailed positions the player covers.\n\n**Note:** Keys belonging to the other profile are null — a goalkeeper, for example, has no attacking rating. history starts with the current values (yearsAgo 0, 1, 2, …). strengths / weaknesses draw from a closed set (PlayerCharacteristic) and can be empty.\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/players/attributes/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI player id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PlayerAttributes"
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- no_data — the source has no rating for this player, as with other sports and many lower leagues; 404 not_found — DataSportsAPI has never assigned this id\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/players/{id}/attributes\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.players.attributes(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.players.attributes(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Players.Attributes(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa players attributes <id>"
          }
        ]
      }
    },
    "/v2/players/{id}/national-team": {
      "get": {
        "operationId": "players.nationalTeam",
        "tags": [
          "players"
        ],
        "summary": "National team",
        "description": "Caps, goals and debut date for every national side the player has represented, at senior and youth level.\n\n**Note:** Returns an empty array if the player has never appeared for a national team, or if the source keeps no record of it.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/players/national-team/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI player id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/NationalTeamRecord"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count",
                      "properties": {
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/players/{id}/national-team\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.players.nationalTeam(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.players.national_team(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Players.NationalTeam(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa players national-team <id>"
          }
        ]
      }
    },
    "/v2/players/{id}/career": {
      "get": {
        "operationId": "players.career",
        "tags": [
          "players"
        ],
        "summary": "Career",
        "description": "The player’s career table, newest season first: statistics for each competition and season played at club and international level, either overall or split into regular season / playoffs where the league does so.\n\n**Note:** There is a row for each competition, season and type, so an NBA season yields two rows (regularSeason and playoffs). statistics shares its keys with /v2/players/{id}/statistics, and passing a row’s league and season ids to that endpoint returns the same figures. Seasons that finished before your plan’s history window are omitted.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/players/career/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI player id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PlayerCareerSeason"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count; historyFrom is added if your plan excluded older seasons",
                      "properties": {
                        "count": {
                          "type": "integer"
                        },
                        "historyFrom": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/players/{id}/career\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.players.career(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.players.career(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Players.Career(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa players career <id>"
          }
        ]
      }
    },
    "/v2/players/{id}/heatmap": {
      "get": {
        "operationId": "players.heatmap",
        "tags": [
          "players"
        ],
        "summary": "Season heatmap",
        "description": "Football: a player’s match heatmaps summed over one league season to show where they were active — each point with the number of samples recorded on it — plus the matches included.\n\n**Note:** x / y range from 0 to 100 as in the match heatmap, with x running along the pitch in the direction the player’s team attacks. Use count to weight the density. Limited to football in covered leagues.\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/players/heatmap/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI player id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "league",
            "in": "query",
            "required": true,
            "description": "league id, as listed by /v2/players/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": true,
            "description": "season id, as listed by /v2/leagues/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SeasonHeatmap"
                    },
                    "meta": {
                      "type": "object",
                      "description": "league, season, count (number of points)",
                      "properties": {
                        "league": {
                          "type": "integer"
                        },
                        "season": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — the season finished before your plan’s history window begins\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- no_data — for this player, league and season the source has no season heatmap; 404 not_found — the season id belongs to a different league\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/players/{id}/heatmap?league=…&season=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.players.heatmap(id, { league, season });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.players.heatmap(id, league=league, season=season)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Players.Heatmap(ctx, id, &datasportsapi.PlayersHeatmapParams{League: league, Season: season})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa players heatmap <id> --league <league> --season <season>"
          }
        ]
      }
    },
    "/v2/players/{id}/ratings": {
      "get": {
        "operationId": "players.ratings",
        "tags": [
          "players"
        ],
        "summary": "Season ratings",
        "description": "Match-by-match ratings for a player across one league season, oldest first, forming the points of a rating graph; each point gives the match, its kick-off, the player’s side and the opponent.\n\n**Note:** Values are the source’s football match ratings on a 0–10 scale. The array is empty if none of the player’s matches that season received a rating.\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/players/ratings/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI player id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "league",
            "in": "query",
            "required": true,
            "description": "league id, as listed by /v2/players/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": true,
            "description": "season id, as listed by /v2/leagues/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PlayerRating"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "league, season, count",
                      "properties": {
                        "league": {
                          "type": "integer"
                        },
                        "season": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — the season finished before your plan’s history window begins\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — the season id does not belong to this league\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/players/{id}/ratings?league=…&season=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.players.ratings(id, { league, season });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.players.ratings(id, league=league, season=season)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Players.Ratings(ctx, id, &datasportsapi.PlayersRatingsParams{League: league, Season: season})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa players ratings <id> --league <league> --season <season>"
          }
        ]
      }
    },
    "/v2/leagues/{id}": {
      "get": {
        "operationId": "leagues.get",
        "tags": [
          "leagues"
        ],
        "summary": "League",
        "description": "A league’s profile: tier (level in the national pyramid), gender, reigning champion and its title count, clubs with the most titles, the divisions above and below, and when the current season starts and ends. The category field reflects how our data source groups leagues — by country, by region (e.g. International), by tour (e.g. ATP) or by esports title; country is populated only for categories that are countries.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/leagues/get/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "league id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/LeagueDetail"
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/leagues/{id}\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.leagues.get(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.leagues.get(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Leagues.Get(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa leagues get <id>"
          }
        ]
      }
    },
    "/v2/leagues/{id}/seasons": {
      "get": {
        "operationId": "leagues.seasons",
        "tags": [
          "leagues"
        ],
        "summary": "Seasons",
        "description": "Lists the league’s seasons, most recent first. year is the label to display, while startYear / endYear hold the numeric years — identical when a season runs within one calendar year.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/leagues/seasons/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "league id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Season"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count",
                      "properties": {
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- no_data — our data source keeps no season list for this league\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/leagues/{id}/seasons\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.leagues.seasons(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.leagues.seasons(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Leagues.Seasons(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa leagues seasons <id>"
          }
        ]
      }
    },
    "/v2/leagues/{id}/champions": {
      "get": {
        "operationId": "leagues.champions",
        "tags": [
          "leagues"
        ],
        "summary": "Champions",
        "description": "Recent title winners of the league, most recent first — each entry gives the season, the year in which it finished and the champion.\n\n**Note:** Covers only the last ten seasons our data source records; no earlier page exists. Competitions for which the source records no champions return an empty list.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/leagues/champions/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "league id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/LeagueChampion"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count",
                      "properties": {
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/leagues/{id}/champions\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.leagues.champions(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.leagues.champions(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Leagues.Champions(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa leagues champions <id>"
          }
        ]
      }
    },
    "/v2/leagues/{id}/venues": {
      "get": {
        "operationId": "leagues.venues",
        "tags": [
          "leagues"
        ],
        "summary": "Season venues",
        "description": "Lists every venue where matches of a league season are played. Available since 2026-11-04.\n\n**Note:** Venues come in the same shape fixtures use; fetch /v2/venues/{id} for the full profile. Because our data source leaves the country out of this list, we fill country from the venue data on fixtures and on /v2/venues/{id} (England is EN); it is null only when neither provides one. If the source has no venues for the season, the list is empty.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/leagues/venues/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "league id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": true,
            "description": "season id, as listed by /v2/leagues/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Venue"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "season, count",
                      "properties": {
                        "season": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — your plan’s history window begins after this season ended\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — the season id does not belong to this league\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/leagues/{id}/venues?season=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.leagues.venues(id, { season });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.leagues.venues(id, season=season)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Leagues.Venues(ctx, id, &datasportsapi.LeaguesVenuesParams{Season: season})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa leagues venues <id> --season <season>"
          }
        ]
      }
    },
    "/v2/leagues/{id}/calendar": {
      "get": {
        "operationId": "leagues.calendar",
        "tags": [
          "leagues"
        ],
        "summary": "Season calendar",
        "description": "Returns each UTC day of a league season on which fixtures are scheduled, together with the number of fixtures — handy for drawing a season calendar or linking straight to a matchday via /v2/fixtures?date=&league=. Available since 2026-11-04.\n\n**Note:** Days are sorted oldest first. The list is rebuilt every day, so a rescheduled fixture moves to its new date within a day.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/leagues/calendar/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "league id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": true,
            "description": "season id, as listed by /v2/leagues/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/SeasonDay"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "season, count (number of days), fixtureCount (fixtures across all those days)",
                      "properties": {
                        "season": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        },
                        "fixtureCount": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — your plan’s history window begins after this season ended\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — the season id does not belong to this league\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/leagues/{id}/calendar?season=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.leagues.calendar(id, { season });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.leagues.calendar(id, season=season)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Leagues.Calendar(ctx, id, &datasportsapi.LeaguesCalendarParams{Season: season})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa leagues calendar <id> --season <season>"
          }
        ]
      }
    },
    "/v2/leagues/{id}/player-of-the-season/history": {
      "get": {
        "operationId": "leagues.playerOfTheSeasonHistory",
        "tags": [
          "leagues"
        ],
        "summary": "Players of the season",
        "description": "A season-by-season record of the league’s player of the season — an award our data source bases on match ratings — giving the winner, their club, their average rating and their number of appearances. Available since 2026-11-04.\n\n**Note:** Sorted most recent first. The season in progress has no winner yet; follow its contest at /v2/leagues/{id}/player-of-the-season/race.\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/leagues/player-of-the-season-history/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "league id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PlayerOfTheSeasonWinner"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count, plus historyFrom if your plan’s history window removed older seasons",
                      "properties": {
                        "count": {
                          "type": "integer"
                        },
                        "historyFrom": {
                          "type": "string",
                          "format": "date"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- endpoint_not_in_plan — returned on the Free and Starter plans\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — DataSportsAPI never issued this id\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/leagues/{id}/player-of-the-season/history\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.leagues.playerOfTheSeasonHistory(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.leagues.player_of_the_season_history(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Leagues.PlayerOfTheSeasonHistory(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa leagues player-of-the-season-history <id>"
          }
        ]
      }
    },
    "/v2/leagues/{id}/teams": {
      "get": {
        "operationId": "leagues.teams",
        "tags": [
          "leagues"
        ],
        "summary": "Season teams",
        "description": "Lists the participants of a single league season; works just as well for cups and other competitions that have no table.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/leagues/teams/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "league id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": true,
            "description": "season id, as listed by /v2/leagues/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/TeamRef"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "season, count",
                      "properties": {
                        "season": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — your plan’s history window begins after this season ended\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — the season id does not belong to this league\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/leagues/{id}/teams?season=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.leagues.teams(id, { season });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.leagues.teams(id, season=season)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Leagues.Teams(ctx, id, &datasportsapi.LeaguesTeamsParams{Season: season})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa leagues teams <id> --season <season>"
          }
        ]
      }
    },
    "/v2/leagues/{id}/seasons/{seasonId}": {
      "get": {
        "operationId": "leagues.season",
        "tags": [
          "leagues"
        ],
        "summary": "Season",
        "description": "Key figures for a season — running totals such as goals, home and away wins, draws and cards — plus the teams new to the division, whether relegated into it from above or promoted from below.\n\n**Note:** The statistic keys come from our data source and differ between sports. hostCountries lists a tournament’s host nations as Country objects — CA, MX and US for the 2026 World Cup; eleven hosts for EURO 2020, with England as EN and Scotland as SX — and stays empty for a regular league season. A season with no figures still answers 200, with empty statistics and lists; only an unknown id, or a season from another league, gets 404.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/leagues/season/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "league id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "seasonId",
            "in": "path",
            "required": true,
            "description": "season id, as listed by /v2/leagues/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SeasonInfo"
                    },
                    "meta": {
                      "type": "object",
                      "description": "season",
                      "properties": {
                        "season": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — seasonId does not belong to this league; the error message names the parameter, and /v2/leagues/{id}/seasons lists the valid ones\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/leagues/{id}/seasons/{seasonId}\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.leagues.season(id, seasonId);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.leagues.season(id, season_id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Leagues.Season(ctx, id, seasonId)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa leagues season <id> <seasonId>"
          }
        ]
      }
    },
    "/v2/leagues/{id}/standings": {
      "get": {
        "operationId": "leagues.standings",
        "tags": [
          "leagues"
        ],
        "summary": "Standings",
        "description": "League tables for a single season. With no extra parameters you get the one table marked primary for the season — the league table, or in a group stage the first group; meta.overall tells you whether it includes every team. Add group=all to get every table (conferences, divisions, groups), or type=home / type=away for a table built from home or away games alone.\n\n**Note:** A season may hold several tables, listed in our data source’s order — for example two conferences, four divisions and a league table in the NHL, two conferences and an overall table in MLS, and one table per group at a World Cup. Exactly one table is flagged primary and served by default — the league table if there is one, otherwise the largest table, and the first group when all are the same size. overall is true solely for a table that contains every team in the season. position always runs 1..n; we re-rank rows whenever the source’s numbering does not. A column that does not apply to a sport is null — the NBA ranks on winPercentage, so its points column is null; draws is null in any table where a draw is impossible (basketball, ice hockey, baseball, volleyball, …); overtimeLosses is filled in ice hockey; scoresFor / scoresAgainst are measured in scoreUnit (goals, points, runs, sets, …); streak (+3 means three straight wins, −2 two straight losses) appears where the source provides it (NBA, EuroLeague, Liga ACB, …). form, added on 2026-10-24, lists up to five of the team’s most recent results in this competition season, oldest first — only home or only away results in the home / away tables — and is null where the source has none. Football publishes split home / away tables, and so do a number of basketball, handball, volleyball and ice-hockey competitions — the KHL, the SuperLega, Liga ACB, the EuroLeague and the Handball-Bundesliga among them. The NBA and NHL publish none and the NFL stops updating its versions, so for those three sports (basketball, ice hockey, American football) we compute them ourselves (meta.source computed) from the finished regular-season fixtures: a home row counts only home games, an away row only away games. They carry only the columns that the same method, run over every game, reproduces exactly for the overall table (NBA: wins, losses, winPercentage, gamesBehind within each table, scores; NFL: wins, losses, draws, winPercentage, scores; NHL: wins, losses, overtimeLosses — defeats in overtime or a shoot-out — and points at 2 per win plus 1 per overtime loss, scores). In those sports a published home / away table that lacks games is swapped for the computed one. In winPercentage a tie is worth half a win. Rows are ordered by points or win share, with ties broken by wins and then score difference — head-to-head is never used. Updated once a day.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/leagues/standings/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "league id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": true,
            "description": "season id, as listed by /v2/leagues/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "group",
            "in": "query",
            "required": false,
            "description": "pass all to get the season’s complete set of tables, typed StandingsGroup[]",
            "schema": {
              "type": "string",
              "enum": [
                "all"
              ]
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "which games count: overall (all of them; the default), home or away (only that side’s games); total, the old name for overall, keeps working for one more release",
            "schema": {
              "type": "string",
              "enum": [
                "overall",
                "home",
                "away",
                "total"
              ],
              "default": "overall"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/StandingsRow"
                          },
                          "description": "default"
                        },
                        {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/StandingsGroup"
                          },
                          "description": "group=all"
                        }
                      ]
                    },
                    "meta": {
                      "type": "object",
                      "description": "season, type, source (upstream = taken from our data source, computed = derived by us from the fixtures), count (number of rows, or of tables with group=all); without group=all it also includes group (name of the table), groupCount (number of tables in the season), overall (true if the table includes every team), tieBreakRule, scoreUnit",
                      "properties": {
                        "season": {
                          "type": "integer"
                        },
                        "type": {
                          "type": "string"
                        },
                        "source": {
                          "type": "string"
                        },
                        "group": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "groupCount": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        },
                        "overall": {
                          "type": "boolean"
                        },
                        "tieBreakRule": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "scoreUnit": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — one of: season missing or invalid; a group value other than all; a type outside overall|home|away\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- no_data — this season lacks that table at the source (a home / away table it never publishes, say — except in basketball, ice hockey and American football, where we compute it); 404 not_found — DataSportsAPI never issued this id\n- not_found — the season id does not belong to this league; the error message names the offending parameter, and /v2/leagues/{id}/seasons lists the valid ones\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/leagues/{id}/standings?season=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.leagues.standings(id, { season });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.leagues.standings(id, season=season)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Leagues.Standings(ctx, id, &datasportsapi.LeaguesStandingsParams{Season: season})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa leagues standings <id> --season <season>"
          }
        ]
      }
    },
    "/v2/leagues/{id}/rounds": {
      "get": {
        "operationId": "leagues.rounds",
        "tags": [
          "leagues"
        ],
        "summary": "Rounds",
        "description": "Lists every round of a season and indicates which one is current.\n\n**Note:** Round numbers are not unique across phases — a qualifying round 1 and a league-phase round 1 can coexist — so pass both slug and prefix of the round to /fixtures to hit the right one. Where our data source does not structure a competition in rounds (NBA / NHL regular seasons, individual tennis or MMA events), this list is empty even though fixtures may still have fixture.round set.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/leagues/rounds/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "league id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": true,
            "description": "season id, as listed by /v2/leagues/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Rounds"
                    },
                    "meta": {
                      "type": "object",
                      "description": "season",
                      "properties": {
                        "season": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — the season id does not belong to this league; the error message names the offending parameter, and /v2/leagues/{id}/seasons lists the valid ones\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/leagues/{id}/rounds?season=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.leagues.rounds(id, { season });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.leagues.rounds(id, season=season)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Leagues.Rounds(ctx, id, &datasportsapi.LeaguesRoundsParams{Season: season})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa leagues rounds <id> --season <season>"
          }
        ]
      }
    },
    "/v2/leagues/{id}/fixtures": {
      "get": {
        "operationId": "leagues.fixtures",
        "tags": [
          "leagues"
        ],
        "summary": "League fixtures",
        "description": "Returns all fixtures in a single round of a season.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/leagues/fixtures/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "league id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": true,
            "description": "season id, as listed by /v2/leagues/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "round",
            "in": "query",
            "required": true,
            "description": "round number taken from /rounds, between 1 and 9999",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999
            }
          },
          {
            "name": "slug",
            "in": "query",
            "required": false,
            "description": "slug of the round as given by /rounds, if the round has one",
            "schema": {
              "type": "string",
              "pattern": "^[a-z0-9-]{1,60}$"
            }
          },
          {
            "name": "prefix",
            "in": "query",
            "required": false,
            "description": "prefix of the round as given by /rounds; applied only in combination with slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Fixture"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "season, round, slug, prefix, count",
                      "properties": {
                        "season": {
                          "type": "integer"
                        },
                        "round": {
                          "type": "integer"
                        },
                        "slug": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "prefix": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — season or round is absent, or slug or prefix is malformed\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — the season id does not belong to this league; the error message names the offending parameter, and /v2/leagues/{id}/seasons lists the valid ones\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/leagues/{id}/fixtures?season=…&round=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.leagues.fixtures(id, { season, round });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.leagues.fixtures(id, season=season, round=round)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Leagues.Fixtures(ctx, id, &datasportsapi.LeaguesFixturesParams{Season: season, Round: round})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa leagues fixtures <id> --season <season> --round <round>"
          }
        ]
      }
    },
    "/v2/leagues/{id}/top-players": {
      "get": {
        "operationId": "leagues.topPlayers",
        "tags": [
          "leagues"
        ],
        "summary": "Top players",
        "description": "Season leaderboards per statistic (rating, goals, assists, xG, tackles, saves and more; up to 50 players each at our data source), paged with limit players per board (10 by default), or one board via category.\n\n**Note:** Paging slices every leaderboard at the same places, so page 1 with limit 10 returns places 11–20 of each one. For a statistic’s complete top 50, request category=goals&limit=50 (a single leaderboard, about 20 KB) rather than every leaderboard at that depth (32 in football, roughly 550 KB at 50 entries each). The available categories depend on the sport (around 30 in football; points, rebounds, assists, … in basketball) and reuse the statistic key names (averageRating, goals, cleanSheets, goalInvolvements, …). statistic tells you which key inside each entry’s statistics the leaderboard is ranked on — football’s mostConceded / leastConceded, for instance, rank on goalsConceded. If type is omitted, the season’s default applies (regularSeason for the NBA, NHL, …). Leagues, seasons or types that have no leaderboards yield an empty array.\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/leagues/top-players/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "league id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": true,
            "description": "season id, as listed by /v2/leagues/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "overall \\| home \\| away \\| regularSeason \\| playoffs. When omitted, the season’s own default applies: overall if the season has it (football), otherwise regularSeason (NBA, NHL, …); meta.type reports the value used",
            "schema": {
              "type": "string",
              "enum": [
                "overall",
                "home",
                "away",
                "regularSeason",
                "playoffs"
              ]
            }
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "restricts the response to one leaderboard, given as one of this season’s categories (e.g. goals); an unknown value returns 400 with the season’s categories listed",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9]{1,60}$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "how many entries each leaderboard returns, 1–50 (10 if omitted)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "default": 10
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "which slice of limit entries to return, 0–49; 0 (the default) starts at the leaders",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 49,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/TopPlayersCategory"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "season, type (the value actually applied), category (null when every leaderboard is included), limit, page, count (how many categories), hasNextPage (true while at least one leaderboard has entries past this page)",
                      "properties": {
                        "season": {
                          "type": "integer"
                        },
                        "type": {
                          "type": "string"
                        },
                        "category": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "limit": {
                          "type": "integer"
                        },
                        "page": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        },
                        "hasNextPage": {
                          "type": "boolean"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — one of: season missing or invalid; type outside overall, home, away, regularSeason, playoffs; limit not in 1–50; page not in 0–49; category unknown (the message then lists the season’s categories)\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — the season id does not belong to this league; the error message names the offending parameter, and /v2/leagues/{id}/seasons lists the valid ones\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/leagues/{id}/top-players?season=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.leagues.topPlayers(id, { season });\nfor await (const page of client.leagues.topPlayersPages(id, { season })) { … }"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.leagues.top_players(id, season=season)\nfor page in client.leagues.top_players_pages(id, season=season): ..."
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Leagues.TopPlayers(ctx, id, &datasportsapi.LeaguesTopPlayersParams{Season: season})\nfor page, err := range client.Leagues.TopPlayersPages(ctx, id, &datasportsapi.LeaguesTopPlayersParams{Season: season}) { … }"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa leagues top-players <id> --season <season>\n$ dsa leagues top-players <id> --season <season> --all -o csv"
          }
        ]
      }
    },
    "/v2/leagues/{id}/top-performances": {
      "get": {
        "operationId": "leagues.topPerformances",
        "tags": [
          "leagues"
        ],
        "summary": "Top match performances",
        "description": "Record individual match performances in a league season. For each statistic — in football goals, assists, rating, xG, key passes, saves, top speed, distance covered, …; in basketball points, rebounds, assists, …; in ice hockey points, hits, saves, … — you get up to 10 players, each with the value and the fixture in which it was achieved. Pass category to limit the response to one statistic.\n\n**Note:** category takes a per-match statistic key, as found in a lineup player’s statistics (goals, assists, rating, keyPass, successfulDribbles, topSpeed, kilometersCovered, …) — not a season-leaderboard key such as averageRating. Entries keep our data source’s ranking with the best at the top — and for missed penalties, turnovers and errors leading to a goal, the best is the highest count. fixture contains the complete Fixture (teams, score, start). If type is omitted, the season’s default applies (regularSeason for the NBA, NHL, …). These lists exist for football, basketball and ice hockey; a league that has none returns an empty array. Updated daily.\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/leagues/top-performances/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "league id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": true,
            "description": "season id, as listed by /v2/leagues/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "overall \\| home \\| away \\| regularSeason \\| playoffs. When omitted, the season’s own default applies: overall if the season has it (football), otherwise regularSeason (NBA, NHL, …); meta.type reports the value used",
            "schema": {
              "type": "string",
              "enum": [
                "overall",
                "home",
                "away",
                "regularSeason",
                "playoffs"
              ]
            }
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "restricts the response to a single statistic key from the list (e.g. topSpeed)",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9]{1,60}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/TopPerformancesCategory"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "season, type (the value actually applied), category (null when every statistic is included), count (how many categories)",
                      "properties": {
                        "season": {
                          "type": "integer"
                        },
                        "type": {
                          "type": "string"
                        },
                        "category": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — one of: season missing or invalid; type outside overall, home, away, regularSeason, playoffs; category malformed\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — the season id does not belong to this league\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/leagues/{id}/top-performances?season=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.leagues.topPerformances(id, { season });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.leagues.top_performances(id, season=season)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Leagues.TopPerformances(ctx, id, &datasportsapi.LeaguesTopPerformancesParams{Season: season})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa leagues top-performances <id> --season <season>"
          }
        ]
      }
    },
    "/v2/leagues/{id}/draft": {
      "get": {
        "operationId": "leagues.draft",
        "tags": [
          "leagues"
        ],
        "summary": "Draft",
        "description": "One round of a league’s draft (NBA, NFL or any league whose draft our data source tracks): picks in order, each with the selecting club, the club it came from by trade and the player (an id for /v2/players). Each pick also carries the prospect details as the draft records them (position, top-prospect flag, college), and clubs without a pick in that round are listed as well.\n\n**Note:** prospect.position uses the draft’s own abbreviations (basketball: G, F, C, FC; American football: QB, WR, OT, …). Only traded picks carry tradedFrom — the Clippers, for instance, made the NBA 2026 #5 pick, acquired from the Pacers. player is null if our data source has no profile for the selected player. While a draft is under way, picks appear as they are made. Updated daily.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/leagues/draft/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "league id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "year",
            "in": "query",
            "required": true,
            "description": "year of the draft, for example 2026",
            "schema": {
              "type": "integer",
              "minimum": 1950
            }
          },
          {
            "name": "round",
            "in": "query",
            "required": false,
            "description": "round number, 1–20; defaults to 1 (the NBA draft has 2 rounds, the NFL’s 7)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 20,
              "default": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/DraftRound"
                    },
                    "meta": {
                      "type": "object",
                      "description": "year, round, count (number of picks)",
                      "properties": {
                        "year": {
                          "type": "integer"
                        },
                        "round": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — one of: no year given; a year before 1950 or beyond next year; a round not in 1–20\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — drafts count as dated to the end of their year, so on the Free, Starter and Pro plans it leaves the history window as soon as the following year begins\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- no_data — no draft took place that year, or that round does not exist in it\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/leagues/{id}/draft?year=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.leagues.draft(id, { year });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.leagues.draft(id, year=year)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Leagues.Draft(ctx, id, &datasportsapi.LeaguesDraftParams{Year: year})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa leagues draft <id> --year <year>"
          }
        ]
      }
    },
    "/v2/leagues/{id}/top-teams": {
      "get": {
        "operationId": "leagues.topTeams",
        "tags": [
          "leagues"
        ],
        "summary": "Top teams",
        "description": "Per-statistic team leaderboards for a season — average rating, goals scored, clean sheets, possession and more — paged the same way as top-players.\n\n**Note:** Paging works as in /top-players, with limit teams on each leaderboard (10 by default). Which categories exist depends on the sport; they are named after the statistic keys used by the team statistics. statistic names the key inside each entry’s statistics that the leaderboard ranks by. matches is null whenever our data source reports 0 alongside non-zero totals. Leagues, seasons or types without leaderboards yield an empty array.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/leagues/top-teams/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "league id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": true,
            "description": "season id, as listed by /v2/leagues/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "overall \\| home \\| away \\| regularSeason \\| playoffs. When omitted, the season’s own default applies: overall if the season has it (football), otherwise regularSeason (NBA, NHL, …); meta.type reports the value used",
            "schema": {
              "type": "string",
              "enum": [
                "overall",
                "home",
                "away",
                "regularSeason",
                "playoffs"
              ]
            }
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "restricts the response to one leaderboard, given as one of this season’s categories (e.g. goals); an unknown value returns 400 with the season’s categories listed",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9]{1,60}$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "how many entries each leaderboard returns, 1–50 (10 if omitted)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "default": 10
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "which slice of limit entries to return, 0–49; 0 (the default) starts at the leaders",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 49,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/TopTeamsCategory"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "season, type (the value actually applied), category (null when every leaderboard is included), limit, page, count (how many categories), hasNextPage",
                      "properties": {
                        "season": {
                          "type": "integer"
                        },
                        "type": {
                          "type": "string"
                        },
                        "category": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "limit": {
                          "type": "integer"
                        },
                        "page": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        },
                        "hasNextPage": {
                          "type": "boolean"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — one of: season missing or invalid; type outside overall, home, away, regularSeason, playoffs; limit not in 1–50; page not in 0–49; category unknown\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — the season id does not belong to this league; the error message names the offending parameter, and /v2/leagues/{id}/seasons lists the valid ones\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/leagues/{id}/top-teams?season=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.leagues.topTeams(id, { season });\nfor await (const page of client.leagues.topTeamsPages(id, { season })) { … }"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.leagues.top_teams(id, season=season)\nfor page in client.leagues.top_teams_pages(id, season=season): ..."
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Leagues.TopTeams(ctx, id, &datasportsapi.LeaguesTopTeamsParams{Season: season})\nfor page, err := range client.Leagues.TopTeamsPages(ctx, id, &datasportsapi.LeaguesTopTeamsParams{Season: season}) { … }"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa leagues top-teams <id> --season <season>\n$ dsa leagues top-teams <id> --season <season> --all -o csv"
          }
        ]
      }
    },
    "/v2/leagues/{id}/player-statistics": {
      "get": {
        "operationId": "leagues.playerStatistics",
        "tags": [
          "leagues"
        ],
        "summary": "Player statistics explorer",
        "description": "A sortable player-statistics table for a football season: every player in the league, 20 per page, ordered by any statistic and returned with one column set — summary, attack, defense, passing, goalkeeping or other — with optional position and team filters. Only football leagues are covered, because our data source offers no equivalent for other sports (checked against the NBA, NHL and EuroLeague on 2026-10-28); those leagues return 404 not_supported, and /v2/leagues/{id}/top-players serves their season leaders instead.\n\n**Note:** Statistic keys follow the season-statistics naming of /v2/players/{id}/statistics. Every row always includes appearances and minutesPlayed, plus the sort key when the chosen group does not contain it. Page through until hasNextPage turns false; there are never more than 50 pages (1,000 players). For just the leaders in one statistic, /top-players is cheaper.\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/leagues/player-statistics/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "league id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": true,
            "description": "season id, as listed by /v2/leagues/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "group",
            "in": "query",
            "required": false,
            "description": "summary (default) \\| attack \\| defense \\| passing \\| goalkeeping \\| other — selects the set of statistics returned on each row",
            "schema": {
              "type": "string",
              "enum": [
                "summary",
                "attack",
                "defense",
                "passing",
                "goalkeeping",
                "other"
              ],
              "default": "summary"
            }
          },
          {
            "name": "order",
            "in": "query",
            "required": false,
            "description": "season-statistic key used for sorting; defaults to averageRating, and an invalid key returns a 400 listing the accepted ones",
            "schema": {
              "type": "string",
              "enum": [
                "accurateCrosses",
                "accurateCrossesPercentage",
                "accurateFinalThirdPasses",
                "accurateLongBalls",
                "accurateLongBallsPercentage",
                "accurateOppositionHalfPasses",
                "accurateOwnHalfPasses",
                "accuratePasses",
                "accuratePassesPercentage",
                "aerialDuelsWon",
                "aerialDuelsWonPercentage",
                "appearances",
                "assists",
                "averageRating",
                "bigChancesCreated",
                "bigChancesMissed",
                "blocks",
                "cleanSheets",
                "clearances",
                "crossesNotClaimed",
                "dispossessed",
                "dribbledPast",
                "duelsWon",
                "duelsWonPercentage",
                "errorsLeadingToGoal",
                "errorsLeadingToShot",
                "expectedGoals",
                "fouls",
                "freeKickGoals",
                "goalConversionPercentage",
                "goals",
                "goalsConcededInsideBox",
                "goalsConcededOutsideBox",
                "goalsInsideBox",
                "goalsOutsideBox",
                "groundDuelsWon",
                "groundDuelsWonPercentage",
                "headedGoals",
                "highClaims",
                "hitWoodwork",
                "inaccuratePasses",
                "interceptions",
                "keyPasses",
                "leftFootGoals",
                "matchesStarted",
                "minutesPlayed",
                "offsides",
                "ownGoals",
                "passToAssist",
                "passes",
                "penaltiesConceded",
                "penaltiesFaced",
                "penaltiesTaken",
                "penaltiesWon",
                "penaltyConversion",
                "penaltyGoals",
                "penaltySaves",
                "possessionLost",
                "punches",
                "redCards",
                "rightFootGoals",
                "runsOut",
                "savedShotsFromInsideTheBox",
                "savedShotsFromOutsideTheBox",
                "saves",
                "setPieceConversion",
                "setPieceShots",
                "shotsBlocked",
                "shotsOffGoal",
                "shotsOnGoal",
                "successfulDribbles",
                "successfulDribblesPercentage",
                "successfulRunsOut",
                "tackles",
                "totalShots",
                "wasFouled",
                "yellowCards"
              ],
              "default": "averageRating"
            }
          },
          {
            "name": "direction",
            "in": "query",
            "required": false,
            "description": "desc (default) \\| asc",
            "schema": {
              "type": "string",
              "enum": [
                "desc",
                "asc"
              ],
              "default": "desc"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "zero-based page number, an integer from 0 to 49 (0 if omitted)",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 49,
              "default": 0
            }
          },
          {
            "name": "position",
            "in": "query",
            "required": false,
            "description": "one or more of goalkeeper, defender, midfielder, forward, separated by commas",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "team",
            "in": "query",
            "required": false,
            "description": "team id; restricts the rows to that team’s players",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PlayerStatisticsRow"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "season, group, order, direction, page, position (null, or the requested positions sorted), team, count, pageCount, hasNextPage",
                      "properties": {
                        "season": {
                          "type": "integer"
                        },
                        "group": {
                          "type": "string"
                        },
                        "order": {
                          "type": "string"
                        },
                        "direction": {
                          "type": "string"
                        },
                        "page": {
                          "type": "integer"
                        },
                        "position": {
                          "anyOf": [
                            {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "team": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "count": {
                          "type": "integer"
                        },
                        "pageCount": {
                          "type": "integer"
                        },
                        "hasNextPage": {
                          "type": "boolean"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — season is absent; group, order, direction or position is unrecognised; page is not 0–49; or team is not an id. The message lists every offending parameter with its accepted values, e.g. “invalid order (one of …)”, so all of them can be fixed in one go\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — your plan’s history window begins after this season ended\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_supported — only football leagues are supported\n- no_data — our data source holds no player statistics for this league and season (or for the requested team)\n- not_found — the season id does not belong to this league; the error message names the offending parameter, and /v2/leagues/{id}/seasons lists the valid ones\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/leagues/{id}/player-statistics?season=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.leagues.playerStatistics(id, { season });\nfor await (const page of client.leagues.playerStatisticsPages(id, { season })) { … }"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.leagues.player_statistics(id, season=season)\nfor page in client.leagues.player_statistics_pages(id, season=season): ..."
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Leagues.PlayerStatistics(ctx, id, &datasportsapi.LeaguesPlayerStatisticsParams{Season: season})\nfor page, err := range client.Leagues.PlayerStatisticsPages(ctx, id, &datasportsapi.LeaguesPlayerStatisticsParams{Season: season}) { … }"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa leagues player-statistics <id> --season <season>\n$ dsa leagues player-statistics <id> --season <season> --all -o csv"
          }
        ]
      }
    },
    "/v2/leagues/{id}/cup-trees": {
      "get": {
        "operationId": "leagues.cupTrees",
        "tags": [
          "leagues"
        ],
        "summary": "Cup trees",
        "description": "A season’s knockout brackets (the knockout phase of a cup in football and other sports, a playoff tree, a tennis draw), nested as rounds, then ties, then each tie’s two participants (team, seed, winner, score), then DataSportsAPI fixture ids.\n\n**Note:** score is the tie result as our data source reports it — aggregate goals across both legs in football, series wins in basketball and ice hockey, sets in tennis — and penalties holds shoot-out goals. fromBlock gives the order of the previous-round tie the participant advanced from. A null team marks a placeholder slot (“winner of QF 1”), and matchCount 0 marks a bye. Load the individual matches with /v2/fixtures/{id}. Seasons without a knockout phase return an empty array.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/leagues/cup-trees/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "league id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": true,
            "description": "season id, as listed by /v2/leagues/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/CupTree"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "season, count",
                      "properties": {
                        "season": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — season is absent or invalid\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — your plan’s history window begins after this season ended\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — the season id does not belong to this league; the error message names the offending parameter, and /v2/leagues/{id}/seasons lists the valid ones\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/leagues/{id}/cup-trees?season=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.leagues.cupTrees(id, { season });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.leagues.cup_trees(id, season=season)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Leagues.CupTrees(ctx, id, &datasportsapi.LeaguesCupTreesParams{Season: season})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa leagues cup-trees <id> --season <season>"
          }
        ]
      }
    },
    "/v2/leagues/{id}/team-of-the-week/periods": {
      "get": {
        "operationId": "leagues.teamOfTheWeekPeriods",
        "tags": [
          "leagues"
        ],
        "summary": "Team of the week periods",
        "description": "Every period in the season for which a team of the week exists, newest first — rounds in football and other round-based leagues, weeks in the NBA.\n\n**Note:** An empty array means our data source picked no team of the week in that league and season. Any period id from this list works with /v2/leagues/{id}/team-of-the-week.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/leagues/team-of-the-week-periods/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "league id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": true,
            "description": "season id, as listed by /v2/leagues/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/TeamOfTheWeekPeriod"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "season, count",
                      "properties": {
                        "season": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — your plan’s history window begins after this season ended\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — the season id does not belong to this league\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/leagues/{id}/team-of-the-week/periods?season=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.leagues.teamOfTheWeekPeriods(id, { season });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.leagues.team_of_the_week_periods(id, season=season)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Leagues.TeamOfTheWeekPeriods(ctx, id, &datasportsapi.LeaguesTeamOfTheWeekPeriodsParams{Season: season})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa leagues team-of-the-week-periods <id> --season <season>"
          }
        ]
      }
    },
    "/v2/leagues/{id}/team-of-the-week": {
      "get": {
        "operationId": "leagues.teamOfTheWeek",
        "tags": [
          "leagues"
        ],
        "summary": "Team of the week",
        "description": "The team of the week for one round or week, set out as a line-up of the top-rated players: formation, then each player with their club, position, the rating that won them the spot and the match they earned it in.\n\n**Note:** Football teams have 11 players, with order 1 being the goalkeeper; NBA teams have 5 players in formation \"2-3\". Ratings are our data source’s match ratings on a 0–10 scale. Once published, a team of the week is final.\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/leagues/team-of-the-week/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "league id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": true,
            "description": "season id, as listed by /v2/leagues/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "period",
            "in": "query",
            "required": false,
            "description": "a period id listed by /v2/leagues/{id}/team-of-the-week/periods; defaults to the latest period",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/TeamOfTheWeek"
                    },
                    "meta": {
                      "type": "object",
                      "description": "season, period (the period actually shown), count (players in the team)",
                      "properties": {
                        "season": {
                          "type": "integer"
                        },
                        "period": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — your plan’s history window begins after this season ended\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- no_data — no team of the week is available from our data source for this league and season so far\n- not_found — the period belongs to a different season, or the season to a different league\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/leagues/{id}/team-of-the-week?season=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.leagues.teamOfTheWeek(id, { season });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.leagues.team_of_the_week(id, season=season)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Leagues.TeamOfTheWeek(ctx, id, &datasportsapi.LeaguesTeamOfTheWeekParams{Season: season})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa leagues team-of-the-week <id> --season <season>"
          }
        ]
      }
    },
    "/v2/leagues/{id}/featured-fixtures": {
      "get": {
        "operationId": "leagues.featuredFixtures",
        "tags": [
          "leagues"
        ],
        "summary": "Featured fixtures",
        "description": "Matches our data source highlights for a league, typically the standout game of the round.\n\n**Note:** Normally a single match, or an empty array if nothing is highlighted. During play, the live state is accurate to the second.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/leagues/featured-fixtures/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "league id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Fixture"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count",
                      "properties": {
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/leagues/{id}/featured-fixtures\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.leagues.featuredFixtures(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.leagues.featured_fixtures(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Leagues.FeaturedFixtures(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa leagues featured-fixtures <id>"
          }
        ]
      }
    },
    "/v2/leagues/{id}/player-of-the-season": {
      "get": {
        "operationId": "leagues.playerOfTheSeason",
        "tags": [
          "leagues"
        ],
        "summary": "Player of the season",
        "description": "Player of the season for a completed league season as chosen by our data source — the highest average match rating among players with enough appearances — together with their club and appearance count.\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/leagues/player-of-the-season/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "league id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": true,
            "description": "season id, as listed by /v2/leagues/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PlayerOfTheSeason"
                    },
                    "meta": {
                      "type": "object",
                      "description": "season",
                      "properties": {
                        "season": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — your plan’s history window begins after this season ended\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- no_data — no award exists yet, either because the season is not over (the contest is at /player-of-the-season/race) or because the league does not hand one out; 404 not_found — the season id belongs to a different league\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/leagues/{id}/player-of-the-season?season=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.leagues.playerOfTheSeason(id, { season });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.leagues.player_of_the_season(id, season=season)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Leagues.PlayerOfTheSeason(ctx, id, &datasportsapi.LeaguesPlayerOfTheSeasonParams{Season: season})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa leagues player-of-the-season <id> --season <season>"
          }
        ]
      }
    },
    "/v2/leagues/{id}/player-of-the-season/race": {
      "get": {
        "operationId": "leagues.playerOfTheSeasonRace",
        "tags": [
          "leagues"
        ],
        "summary": "Player of the season race",
        "description": "The ongoing contest for player of the season: the front-runners ranked by average rating, highest first.\n\n**Note:** Our data source shows the leading three. Leagues that have no player-of-the-season race return an empty array.\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/leagues/player-of-the-season-race/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "league id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": true,
            "description": "season id, as listed by /v2/leagues/{id}/seasons",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PlayerOfTheSeasonCandidate"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "season, count",
                      "properties": {
                        "season": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — your plan’s history window begins after this season ended\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — the season id does not belong to this league\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/leagues/{id}/player-of-the-season/race?season=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.leagues.playerOfTheSeasonRace(id, { season });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.leagues.player_of_the_season_race(id, season=season)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Leagues.PlayerOfTheSeasonRace(ctx, id, &datasportsapi.LeaguesPlayerOfTheSeasonRaceParams{Season: season})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa leagues player-of-the-season-race <id> --season <season>"
          }
        ]
      }
    },
    "/v2/rankings": {
      "get": {
        "operationId": "rankings.list",
        "tags": [
          "discovery"
        ],
        "summary": "Rankings",
        "description": "Every ranking DataSportsAPI provides: FIFA (men), World Rugby (men), UEFA coefficients (countries, clubs), ATP and WTA singles (official, live), UTR ratings and padel world rankings (men and women each). The divisions of the UFC and of Fight Nation Championship are included too.\n\n**Note:** entry indicates what each row of a ranking represents: team (a club or national side), competitor (a player or fighter, delivered as a TeamRef of kind individual) or country. The list comes from our own catalogue, so no upstream request is made.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/discovery/rankings-list/"
        },
        "parameters": [
          {
            "name": "sport",
            "in": "query",
            "required": false,
            "description": "sport slug; limits the list to rankings of that sport",
            "schema": {
              "type": "string",
              "enum": [
                "football",
                "tennis",
                "basketball",
                "ice-hockey",
                "esports",
                "volleyball",
                "handball",
                "baseball",
                "american-football",
                "rugby",
                "cricket",
                "mma",
                "table-tennis",
                "darts",
                "snooker",
                "futsal",
                "badminton",
                "waterpolo",
                "cycling",
                "motorsport",
                "minifootball",
                "floorball",
                "bandy",
                "padel"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/RankingTypeInfo"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count, and sport when a sport filter was applied",
                      "properties": {
                        "sport": {
                          "type": "string"
                        },
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — the sport is not recognised\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/rankings\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.rankings.list();"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.rankings.list()"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Rankings.List(ctx, &datasportsapi.RankingsListParams{})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa rankings list"
          }
        ]
      }
    },
    "/v2/rankings/{type}": {
      "get": {
        "operationId": "rankings.get",
        "tags": [
          "discovery"
        ],
        "summary": "Ranking",
        "description": "Returns one ranking, leaders first. Each row gives the current and previous position, current and previous points, the highest position reached and the number of tournaments played.\n\n**Note:** team holds the ranked team or competitor; it is null on UEFA country rows, where league is the country’s top division and country the country itself. In UFC and FNC divisions the champion sits at position 0 (the fnc-* types, available since 2026-11-04, cover Fight Nation Championship’s seven men’s divisions: the champion plus ten). On the utr-men and utr-women tables (available since 2026-11-04), points holds the player’s actual Universal Tennis Rating (for example 16.45 for Sinner), and the table runs 500 players deep. Any column our data source does not track for a given ranking is null.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/discovery/rankings-get/"
        },
        "parameters": [
          {
            "name": "type",
            "in": "path",
            "required": true,
            "description": "which ranking to return — any type listed by /v2/rankings, such as atp, fifa-men, uefa-clubs, utr-men, ufc-lightweight",
            "schema": {
              "type": "string",
              "enum": [
                "fifa-men",
                "uefa-countries",
                "uefa-clubs",
                "world-rugby-men",
                "atp",
                "wta",
                "atp-live",
                "wta-live",
                "utr-men",
                "utr-women",
                "padel-men",
                "padel-women",
                "ufc-flyweight",
                "ufc-bantamweight",
                "ufc-featherweight",
                "ufc-lightweight",
                "ufc-welterweight",
                "ufc-middleweight",
                "ufc-light-heavyweight",
                "ufc-heavyweight",
                "ufc-womens-strawweight",
                "ufc-womens-flyweight",
                "ufc-womens-bantamweight",
                "fnc-bantamweight",
                "fnc-featherweight",
                "fnc-lightweight",
                "fnc-welterweight",
                "fnc-middleweight",
                "fnc-light-heavyweight",
                "fnc-heavyweight"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/RankingRow"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "type, updatedAt (null, or the moment our data source last refreshed the table), count",
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "updatedAt": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — the ranking type does not exist\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/rankings/{type}\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.rankings.get(type);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.rankings.get(type)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Rankings.Get(ctx, type)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa rankings get <type>"
          }
        ]
      }
    },
    "/v2/categories": {
      "get": {
        "operationId": "categories.list",
        "tags": [
          "discovery"
        ],
        "summary": "Categories",
        "description": "Returns the categories of a sport — the buckets our data source sorts leagues into: countries, regions (Europe, International), tours (ATP) and esports titles.\n\n**Note:** country is filled only for categories that represent a country. Use a category id with /v2/leagues?category=; if kind is races (motorsport, cycling), use /v2/series?category= instead, because race sports are organised into series rather than leagues.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/discovery/categories-list/"
        },
        "parameters": [
          {
            "name": "sport",
            "in": "query",
            "required": true,
            "description": "sport slug, as listed by /v2/sports",
            "schema": {
              "type": "string",
              "enum": [
                "football",
                "tennis",
                "basketball",
                "ice-hockey",
                "esports",
                "volleyball",
                "handball",
                "baseball",
                "american-football",
                "rugby",
                "cricket",
                "mma",
                "table-tennis",
                "darts",
                "snooker",
                "futsal",
                "badminton",
                "waterpolo",
                "cycling",
                "motorsport",
                "minifootball",
                "floorball",
                "bandy",
                "padel"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Category"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "sport, kind (fixtures | races — the same value /v2/sports gives), count",
                      "properties": {
                        "sport": {
                          "type": "string"
                        },
                        "kind": {
                          "$ref": "#/components/schemas/SportKind"
                        },
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — sport is absent or not recognised\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/categories?sport=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.categories.list({ sport });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.categories.list(sport=sport)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Categories.List(ctx, &datasportsapi.CategoriesListParams{Sport: sport})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa categories list <sport>"
          }
        ]
      }
    },
    "/v2/leagues": {
      "get": {
        "operationId": "leagues.list",
        "tags": [
          "discovery"
        ],
        "summary": "League directory",
        "description": "Directory of leagues: all leagues within a category, or all leagues of a given sport in a given country.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/discovery/leagues-list/"
        },
        "parameters": [
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "category id from /v2/categories; use it on its own, never combined with country",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "sport",
            "in": "query",
            "required": false,
            "description": "sport slug; must be paired with country",
            "schema": {
              "type": "string",
              "enum": [
                "football",
                "tennis",
                "basketball",
                "ice-hockey",
                "esports",
                "volleyball",
                "handball",
                "baseball",
                "american-football",
                "rugby",
                "cricket",
                "mma",
                "table-tennis",
                "darts",
                "snooker",
                "futsal",
                "badminton",
                "waterpolo",
                "cycling",
                "motorsport",
                "minifootball",
                "floorball",
                "bandy",
                "padel"
              ]
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "Country.code value, two letters (EN, ES, US, …), case-insensitive; only valid together with sport",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z]{2}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/LeagueRef"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "for a category query, category and count; for a sport + country query, sport, country, categoryIds (the country’s categories), count and complete (false if at least one category’s list was temporarily unavailable — try again shortly)",
                      "properties": {
                        "category": {
                          "type": "integer"
                        },
                        "sport": {
                          "type": "string"
                        },
                        "country": {
                          "type": "string"
                        },
                        "categoryIds": {
                          "type": "array",
                          "items": {
                            "type": "integer"
                          }
                        },
                        "count": {
                          "type": "integer"
                        },
                        "complete": {
                          "type": "boolean"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — one of: no category and no sport + country pair; category sent together with country; a country code that is not two letters; an unrecognised sport\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_supported — the category or sport belongs to a race sport (motorsport, cycling), which uses series instead of leagues; the message points to /v2/series?category=\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "- upstream_unavailable — every category list for the country failed to load\n\nUpstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/leagues\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.leagues.list();"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.leagues.list()"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Leagues.List(ctx, &datasportsapi.LeaguesListParams{})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa leagues list"
          }
        ]
      }
    },
    "/v2/leagues/popular": {
      "get": {
        "operationId": "leagues.popular",
        "tags": [
          "discovery"
        ],
        "summary": "Popular leagues",
        "description": "Our data source’s selection of a sport’s most popular leagues for a visitor from a given country, kept in the source’s order: domestic leagues and the major international competitions come first. Designed to feed a “top leagues” menu.\n\n**Note:** No list exists for race sports or MMA, so they get an empty array. Elsewhere, LeagueRef.priority (where set) is the field to sort other league lists by.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/discovery/leagues-popular/"
        },
        "parameters": [
          {
            "name": "sport",
            "in": "query",
            "required": true,
            "description": "sport slug, as listed by /v2/sports",
            "schema": {
              "type": "string",
              "enum": [
                "football",
                "tennis",
                "basketball",
                "ice-hockey",
                "esports",
                "volleyball",
                "handball",
                "baseball",
                "american-football",
                "rugby",
                "cricket",
                "mma",
                "table-tennis",
                "darts",
                "snooker",
                "futsal",
                "badminton",
                "waterpolo",
                "cycling",
                "motorsport",
                "minifootball",
                "floorball",
                "bandy",
                "padel"
              ]
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "two-letter country code of the visitor (TR, GB, US, …; case-insensitive). If omitted, the source’s international list is returned",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z]{2}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/LeagueRef"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "sport, country (null when the request had no country), count",
                      "properties": {
                        "sport": {
                          "type": "string"
                        },
                        "country": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — sport is missing or not recognised, or country is not a two-letter code\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/leagues/popular?sport=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.leagues.popular({ sport });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.leagues.popular(sport=sport)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Leagues.Popular(ctx, &datasportsapi.LeaguesPopularParams{Sport: sport})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa leagues popular <sport>"
          }
        ]
      }
    },
    "/v2/races": {
      "get": {
        "operationId": "races.list",
        "tags": [
          "races"
        ],
        "summary": "Races",
        "description": "Returns every race that has a session beginning on a given UTC day, with all of each race’s sessions included.\n\n**Note:** A day lists no more than 40 races. A race weekend shows up on each day on which one of its sessions begins. Our data source sometimes records a weekend twice, under two identically named series (NASCAR Cup Series); we drop the copy whose series has no seasons from the day’s list, although its id still resolves on /v2/races/{id}.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/races/list/"
        },
        "parameters": [
          {
            "name": "sport",
            "in": "query",
            "required": true,
            "description": "motorsport \\| cycling",
            "schema": {
              "type": "string",
              "enum": [
                "motorsport",
                "cycling"
              ]
            }
          },
          {
            "name": "date",
            "in": "query",
            "required": true,
            "description": "UTC date in YYYY-MM-DD format",
            "schema": {
              "type": "string",
              "format": "date"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Race"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "date, sport, count, complete (false if some races were temporarily unavailable — try again shortly)",
                      "properties": {
                        "date": {
                          "type": "string"
                        },
                        "sport": {
                          "type": "string"
                        },
                        "count": {
                          "type": "integer"
                        },
                        "complete": {
                          "type": "boolean"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — the date is missing or not a valid day, or the sport is not one of the race sports\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — your plan’s history does not reach back to that date\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "- upstream_unavailable — every race of the day failed to load\n\nUpstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/races?sport=…&date=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.races.list({ date, sport });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.races.list(date=date, sport=sport)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Races.List(ctx, &datasportsapi.RacesListParams{Date: date, Sport: sport})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa races list --date <date> --sport <sport>"
          }
        ]
      }
    },
    "/v2/races/{id}": {
      "get": {
        "operationId": "races.get",
        "tags": [
          "races"
        ],
        "summary": "Race",
        "description": "One race in full: series, season, round, status, dates, winner, circuit (motorsport: name, city, country, lap length), host country, laps and distance, category (cycling) and its sessions in start-time order. Each session carries its type, status, start time, laps, distance, winner, weather, track condition, temperatures and safety car, plus the stage’s towns and profile (cycling).\n\n**Note:** startDate / endDate are UTC dates, whereas sessions have exact timestamps. winner refers to the main race — for a cycling stage race, the general classification — and is filled once it has finished. circuit.lengthMeters and distanceMeters are provided for Formula 1 and NASCAR, converted from miles where needed; MotoGP has laps only, because our data source keeps no circuit length or race distance for it. A race with no laps / distance of its own inherits those of the main race session.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/races/get/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "race id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Race"
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — your plan’s history does not reach back to the race’s start\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — the id is not a race id (season and session ids are rejected too)\n- no_data — this is a duplicate that our data source files under a second series but never runs (NASCAR Cup); error.series, and error.race when a match is found, identify the genuine series and race\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/races/{id}\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.races.get(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.races.get(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Races.Get(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa races get <id>"
          }
        ]
      }
    },
    "/v2/races/{id}/results": {
      "get": {
        "operationId": "races.results",
        "tags": [
          "races"
        ],
        "summary": "Race results",
        "description": "A race’s classification — in motorsport the main race session (the last of type race) with grid, pit stops, tyre stints, the set now fitted (currentTyre: compound, new or used), inPit, best laps and points. That session is named in meta.session, and inPit is true while the car sits in the pit lane during a running session. For a cycling stage race it is the general classification, with every rider’s secondary classifications (points, mountains, young rider, jersey). Pass session= to get a single session instead (a practice, a qualifying, a stage) or a single qualifying part (Q1, Q2…). Where our data source stores a knock-out qualifying only part by part (MotoGP), we merge the parts into the series’ own ranking: the Q2 riders first in their Q2 order, then the Q1 riders who did not advance in their Q1 order, with the places counting on; every line states which part it comes from.\n\n**Note:** state is one of classified, didNotFinish, didNotStart, disqualified or notClassified. Anyone outside the classification has position null, and our data source may also skip a place. timeMs holds the total time for a race or stage, or the best lap for practice and qualifying. For lapped competitors (see lapsBehind), for those who are out and for classified riders whose time the source did not record (cycling), timeMs, gapMs and intervalMs are null. tyreStints is filled for Formula 1 races only; cycling is null except on the overall result of a stage race. Only a qualifying merged from its parts has part (\"Q2\", \"Q1\"). In that case timeMs / gapMs / intervalMs refer to that part (best lap, gap to the part’s fastest), lines without a time get position null, and until a part has finished its participants occupy its places (during Q2, riders eliminated in Q1 are ranked from 13th down). Formula 1 qualifying comes as a table of its own, with part null.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/races/results/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "race id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "session",
            "in": "query",
            "required": false,
            "description": "id of one of the race’s sessions (see /v2/races/{id}) or of a qualifying part listed under sessions[].parts",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/RaceResult"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "race, session (the session returned — in motorsport the main race session if none was requested; null means the race’s own table), count",
                      "properties": {
                        "race": {
                          "type": "integer"
                        },
                        "session": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — session is invalid\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — your plan’s history does not reach back to the race’s start\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — the id is not a race id, or the session belongs to a different race\n- no_data — this race is the duplicate entry kept under a second series (same behaviour as /v2/races/{id}); the genuine series and race are given in error.series / error.race\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/races/{id}/results\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.races.results(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.races.results(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Races.Results(ctx, id, &datasportsapi.RacesResultsParams{})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa races results <id>"
          }
        ]
      }
    },
    "/v2/races/{id}/laps": {
      "get": {
        "operationId": "races.laps",
        "tags": [
          "races"
        ],
        "summary": "Race laps",
        "description": "Lap-by-lap progress of a race session: every driver’s position at the end of each lap (lap 0 is the starting grid), their tyre compound, their pit stops (recorded on the in-lap) and the lap on which they retired. Available on Pro, Business and Enterprise plans.\n\n**Note:** Covers Formula 1 race sessions (verified on the 2026 Mexico GP). Sessions and series for which our data source has no lap chart — qualifying, practice, MotoGP — return an empty list. Lap times and gaps are not included; use /results for the timed classification.\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/races/laps/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "race id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "session",
            "in": "query",
            "required": false,
            "description": "which session to chart, by id from /v2/races/{id}; without it the main race session is used",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/RaceCompetitorLaps"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "race, session (the session whose laps are shown), count",
                      "properties": {
                        "race": {
                          "type": "integer"
                        },
                        "session": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — your plan’s history does not reach back to the race’s start\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — the id is not a race id, or the session belongs to a different race\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/races/{id}/laps\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.races.laps(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.races.laps(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Races.Laps(ctx, id, &datasportsapi.RacesLapsParams{})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa races laps <id>"
          }
        ]
      }
    },
    "/v2/series": {
      "get": {
        "operationId": "series.list",
        "tags": [
          "races"
        ],
        "summary": "Series",
        "description": "Lists the series under a race-sport category, such as NASCAR Cup Series, Truck Series and Xfinity under Nascar, Formula 1 under Formula 1, and Cycling Men and Cycling Women under cycling’s International.\n\n**Note:** You get an empty list for a category that holds no series, such as motorsport’s International or any category belonging to a fixture sport. A series id from here works with /v2/series/{id}/seasons, /races and /standings.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/races/series-list/"
        },
        "parameters": [
          {
            "name": "category",
            "in": "query",
            "required": true,
            "description": "motorsport or cycling category id — list them with /v2/categories?sport=motorsport or ?sport=cycling",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/SeriesRef"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "category, count",
                      "properties": {
                        "category": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — category is absent or invalid\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — DataSportsAPI never issued this category id\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/series?category=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.series.list({ category });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.series.list(category=category)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Series.List(ctx, &datasportsapi.SeriesListParams{Category: category})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa series list <category>"
          }
        ]
      }
    },
    "/v2/series/{id}": {
      "get": {
        "operationId": "series.get",
        "tags": [
          "races"
        ],
        "summary": "One series",
        "description": "Basic details of a racing series — its name, slug and sport.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/races/series-get/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "series id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SeriesRef"
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- no_data — our data source returns nothing for this series (an id DataSportsAPI never issued gives 404 not_found instead)\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/series/{id}\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.series.get(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.series.get(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Series.Get(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa series get <id>"
          }
        ]
      }
    },
    "/v2/series/{id}/seasons": {
      "get": {
        "operationId": "series.seasons",
        "tags": [
          "races"
        ],
        "summary": "Series seasons",
        "description": "Lists a series’ seasons, most recent first.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/races/series-seasons/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "series id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Season"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count",
                      "properties": {
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- no_data — our data source keeps no season list for this series\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/series/{id}/seasons\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.series.seasons(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.series.seasons(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Series.Seasons(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa series seasons <id>"
          }
        ]
      }
    },
    "/v2/series/{id}/races": {
      "get": {
        "operationId": "series.races",
        "tags": [
          "races"
        ],
        "summary": "Series races",
        "description": "Lists the races in one season of a series. Sessions are left out here; fetch them from /v2/races/{id}.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/races/series-races/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "series id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": false,
            "description": "season id from /v2/series/{id}/seasons; the most recent season is used if omitted",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/RaceSummary"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "season (the season actually served), count, and historyFrom when your plan’s history window hid older races",
                      "properties": {
                        "season": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        },
                        "historyFrom": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — season is invalid\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — your plan’s history window begins after this season ended\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — the season id is not among this series’ seasons; 404 no_data — no seasons exist for the series\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/series/{id}/races\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.series.races(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.series.races(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Series.Races(ctx, id, &datasportsapi.SeriesRacesParams{})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa series races <id>"
          }
        ]
      }
    },
    "/v2/series/{id}/standings": {
      "get": {
        "operationId": "series.standings",
        "tags": [
          "races"
        ],
        "summary": "Series standings",
        "description": "A season’s championship table for drivers / riders (type=competitors, default) or teams (type=teams), listing points, wins, podiums, pole positions and fastest laps, plus races started and points-scoring races.\n\n**Note:** Cycling has no teams standings and returns an empty array for them. In the teams table, team is null. Columns our data source does not track are null. meta.figuresSource says whether wins / podiums / polePositions / racesStarted / racesWithPoints are upstream (taken from the source’s own table) or computed. They are computed for MotoGP, whose table carries only positions and points: we derive the figures from the main race of every completed round — a win is 1st place, a podium a top-3 finish, a pole grid position 1; sprints are ignored, and a team is credited for each of its entries, with one start per race. For MotoGP, fastestLaps remains null.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/races/series-standings/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "series id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": false,
            "description": "season id from /v2/series/{id}/seasons; the most recent season is used if omitted",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "competitors (default) \\| teams",
            "schema": {
              "type": "string",
              "enum": [
                "competitors",
                "teams"
              ],
              "default": "competitors"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/SeriesStandingsRow"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "season (the season actually served), type, count, figuresSource (upstream | computed)",
                      "properties": {
                        "season": {
                          "type": "integer"
                        },
                        "type": {
                          "type": "string"
                        },
                        "count": {
                          "type": "integer"
                        },
                        "figuresSource": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — the season id is invalid, or type is something other than competitors|teams\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- history_not_in_plan — your plan’s history window begins after this season ended\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — the season id is not among this series’ seasons; 404 no_data — no seasons exist for the series\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/series/{id}/standings\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.series.standings(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.series.standings(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Series.Standings(ctx, id, &datasportsapi.SeriesStandingsParams{})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa series standings <id>"
          }
        ]
      }
    },
    "/v2/referees/{id}": {
      "get": {
        "operationId": "referees.get",
        "tags": [
          "people"
        ],
        "summary": "Referee",
        "description": "Referee profile with country, sport, career totals (matches plus yellow, red and second-yellow cards) and a per-competition breakdown of appearances, cards and penalties awarded.\n\n**Note:** Career totals come straight from the source. competitions covers every competition the referee has officiated in, or is [] if the source lists none. Figures are not broken down by season, because the source has no such split.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/people/referees-get/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI referee id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/RefereeProfile"
                    },
                    "meta": {
                      "type": "object",
                      "description": "competitionCount",
                      "properties": {
                        "competitionCount": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — DataSportsAPI has never assigned this id\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/referees/{id}\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.referees.get(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.referees.get(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Referees.Get(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa referees get <id>"
          }
        ]
      }
    },
    "/v2/referees/{id}/fixtures": {
      "get": {
        "operationId": "referees.fixtures",
        "tags": [
          "people"
        ],
        "summary": "Referee fixtures",
        "description": "Returns one page of matches the referee has officiated (recent) or has been assigned to (upcoming), split by the same rule as team fixtures.\n\n**Note:** upcoming covers matches yet to start, soonest first; recent covers live, finished and called-off matches, newest first. A referee who exists but has no appointments gets 200 with an empty array.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/people/referees-fixtures/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI referee id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "recent \\| upcoming; upcoming when omitted",
            "schema": {
              "type": "string",
              "enum": [
                "recent",
                "upcoming"
              ],
              "default": "upcoming"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "zero-based page number, a whole number from 0 to 50 (defaults to 0)",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 50,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Fixture"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "type, page, count, hasNextPage; historyFrom is added if your plan excluded older fixtures",
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "page": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        },
                        "hasNextPage": {
                          "type": "boolean"
                        },
                        "historyFrom": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — type is neither recent nor upcoming, or page is not a whole number between 0 and 50\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/referees/{id}/fixtures\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.referees.fixtures(id);\nfor await (const page of client.referees.fixturesPages(id)) { … }"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.referees.fixtures(id)\nfor page in client.referees.fixtures_pages(id): ..."
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Referees.Fixtures(ctx, id, &datasportsapi.RefereesFixturesParams{})\nfor page, err := range client.Referees.FixturesPages(ctx, id, &datasportsapi.RefereesFixturesParams{}) { … }"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa referees fixtures <id>\n$ dsa referees fixtures <id> --all -o csv"
          }
        ]
      }
    },
    "/v2/managers/{id}": {
      "get": {
        "operationId": "managers.get",
        "tags": [
          "people"
        ],
        "summary": "Manager",
        "description": "Profile of a manager or head coach: country, date of birth, favoured formation, present team, career totals (games, wins, draws, losses, goals, points) and each job held with its own record, most recent first.\n\n**Note:** For the job currently held, to is the contract expiry and therefore lies in the future. scoresFor / scoresAgainst may be null on a job for which the source reports results only.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/people/managers-get/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI manager id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ManagerProfile"
                    },
                    "meta": {
                      "type": "object",
                      "description": "stintCount",
                      "properties": {
                        "stintCount": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — DataSportsAPI has never assigned this id\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/managers/{id}\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.managers.get(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.managers.get(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Managers.Get(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa managers get <id>"
          }
        ]
      }
    },
    "/v2/managers/{id}/fixtures": {
      "get": {
        "operationId": "managers.fixtures",
        "tags": [
          "people"
        ],
        "summary": "Manager fixtures",
        "description": "One page of the matches a manager has recently had or has coming up, divided by the same rule as team fixtures.\n\n**Note:** upcoming covers matches yet to start, soonest first; recent covers live, finished and called-off matches, newest first. A manager who exists but has no matches to show gets 200 with an empty array.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/people/managers-fixtures/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI manager id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "recent \\| upcoming; upcoming when omitted",
            "schema": {
              "type": "string",
              "enum": [
                "recent",
                "upcoming"
              ],
              "default": "upcoming"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "zero-based page number, a whole number from 0 to 50 (defaults to 0)",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 50,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Fixture"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "type, page, count, hasNextPage; historyFrom is added if your plan excluded older fixtures",
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "page": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        },
                        "hasNextPage": {
                          "type": "boolean"
                        },
                        "historyFrom": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — type is neither recent nor upcoming, or page is not a whole number between 0 and 50\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/managers/{id}/fixtures\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.managers.fixtures(id);\nfor await (const page of client.managers.fixturesPages(id)) { … }"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.managers.fixtures(id)\nfor page in client.managers.fixtures_pages(id): ..."
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Managers.Fixtures(ctx, id, &datasportsapi.ManagersFixturesParams{})\nfor page, err := range client.Managers.FixturesPages(ctx, id, &datasportsapi.ManagersFixturesParams{}) { … }"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa managers fixtures <id>\n$ dsa managers fixtures <id> --all -o csv"
          }
        ]
      }
    },
    "/v2/venues/{id}": {
      "get": {
        "operationId": "venues.get",
        "tags": [
          "venues"
        ],
        "summary": "Venue",
        "description": "One stadium or arena: its city, country, capacity, coordinates, a photo and home teams, plus per-sport totals over all matches the source holds there (match count, goals or points scored, home wins, draws).\n\n**Note:** sports is ordered by matches played, and its slugs are the values /v2/venues/{id}/fixtures accepts. latitude / longitude are null if the source has no coordinates.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/venues/get/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI venue id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/VenueProfile"
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — DataSportsAPI has never assigned this id\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/venues/{id}\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.venues.get(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.venues.get(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Venues.Get(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa venues get <id>"
          }
        ]
      }
    },
    "/v2/venues/{id}/fixtures": {
      "get": {
        "operationId": "venues.fixtures",
        "tags": [
          "venues"
        ],
        "summary": "Venue fixtures",
        "description": "Returns one page of past or scheduled matches at a venue in a single sport, split by the same rule as team fixtures.\n\n**Note:** upcoming covers matches yet to start, soonest first; recent covers live, finished and called-off matches, newest first. If the venue has no matches in that sport, the response is 200 with an empty array.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/venues/fixtures/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "DataSportsAPI venue id, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "sport",
            "in": "query",
            "required": false,
            "description": "sport slug taken from VenueProfile.sports; when omitted, the sport played most often at the venue",
            "schema": {
              "type": "string",
              "enum": [
                "football",
                "tennis",
                "basketball",
                "ice-hockey",
                "esports",
                "volleyball",
                "handball",
                "baseball",
                "american-football",
                "rugby",
                "cricket",
                "mma",
                "table-tennis",
                "darts",
                "snooker",
                "futsal",
                "badminton",
                "waterpolo",
                "cycling",
                "motorsport",
                "minifootball",
                "floorball",
                "bandy",
                "padel"
              ]
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "recent \\| upcoming; upcoming when omitted",
            "schema": {
              "type": "string",
              "enum": [
                "recent",
                "upcoming"
              ],
              "default": "upcoming"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "zero-based page number, a whole number from 0 to 50 (defaults to 0)",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 50,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Fixture"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "sport, type, page, count, hasNextPage; historyFrom is added if your plan excluded older fixtures",
                      "properties": {
                        "sport": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "type": {
                          "type": "string"
                        },
                        "page": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        },
                        "hasNextPage": {
                          "type": "boolean"
                        },
                        "historyFrom": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — type is neither recent nor upcoming, page is not a whole number between 0 and 50, or sport is not recognised\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/venues/{id}/fixtures\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.venues.fixtures(id);\nfor await (const page of client.venues.fixturesPages(id)) { … }"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.venues.fixtures(id)\nfor page in client.venues.fixtures_pages(id): ..."
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Venues.Fixtures(ctx, id, &datasportsapi.VenuesFixturesParams{})\nfor page, err := range client.Venues.FixturesPages(ctx, id, &datasportsapi.VenuesFixturesParams{}) { … }"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa venues fixtures <id>\n$ dsa venues fixtures <id> --all -o csv"
          }
        ]
      }
    },
    "/v2/search": {
      "get": {
        "operationId": "search.query",
        "tags": [
          "search"
        ],
        "summary": "Search",
        "description": "A single search over teams (individual competitors included), players, managers, referees, leagues, fixtures, venues, racing series and races; each hit’s type names the endpoint family its id is valid for. Those families are /v2/teams, /v2/players, /v2/managers, /v2/referees, /v2/leagues, /v2/fixtures, /v2/series and /v2/races (venue ids are covered in the note). Player hits include the player’s current team; fixture hits include the teams, league, start time and status; venue hits include city, country and capacity.\n\n**Note:** This API models every competitor as a team, so tennis players and other individual-sport athletes are returned with type team. type is a closed set — manager, referee, series and race were added on 2026-10-24, fixture and venue on 2026-11-04 — so ignore any value your client does not recognise. Three fields depend on the type and are null for all others: venue (a Venue), team (the player’s current team, as a TeamRef) and fixture ({ home, away, league, startTime, status }, with status as the coarse StatusType — the score and the rest come from /v2/fixtures/{id}). Venue hit ids work with /v2/venues/{id} and match the id in Fixture.venue and TeamDetail.venue. Since 2026-11-04 team hits include gender (male | female | mixed, matching TeamDetail), which lets you mark a women’s team without a call to /v2/teams/{id}; it is null for every other type. Venue hits come from a separate search at the source and are merged in by relevance. Passing type (since 2026-11-09) restricts the list to that type, returns 20 hits per page and reaches much further than the mixed list: ask for ?q=smith&type=player and pages go up to 50; hasNextPage stays true as long as a page is full. type=series comes from the mixed list and is therefore a single page — the source offers no paged search for series. Managers and referees also get image, a photo on our CDN (since 2026-11-04; null if the source has none); series, races, fixtures and venues always have image null.\n\n**Plans:** Every plan, Free included.",
        "x-plans": [
          "free",
          "starter",
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/search/query/"
        },
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "text to search for: 2–100 characters once trimmed and free of control characters, otherwise a 400 names q as the problem",
            "schema": {
              "type": "string",
              "minLength": 2,
              "maxLength": 100
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "limits hits to one type — team \\| player \\| league \\| manager \\| referee \\| series \\| race \\| fixture \\| venue — at 20 per page; leave it out for the single-page mixed list",
            "schema": {
              "type": "string",
              "enum": [
                "team",
                "player",
                "league",
                "manager",
                "referee",
                "series",
                "race",
                "fixture",
                "venue"
              ]
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "page number from 0 to 50 (defaults to 0); a page above 0 needs a type other than series",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 50,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/SearchResult"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "query, type, page, count, hasNextPage",
                      "properties": {
                        "query": {
                          "type": "string"
                        },
                        "type": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "page": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        },
                        "hasNextPage": {
                          "type": "boolean"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — q is absent, type is not recognised, page is not within 0–50, or page is above 0 while type is missing or set to series\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/search?q=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.search.query({ q });\nfor await (const page of client.search.queryPages({ q })) { … }"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.search.query(q=q)\nfor page in client.search.query_pages(q=q): ..."
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Search.Query(ctx, &datasportsapi.SearchQueryParams{Q: q})\nfor page, err := range client.Search.QueryPages(ctx, &datasportsapi.SearchQueryParams{Q: q}) { … }"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa search query <q>\n$ dsa search query <q> --all -o csv"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/odds": {
      "get": {
        "operationId": "fixtures.odds",
        "tags": [
          "odds"
        ],
        "summary": "Fixture odds",
        "description": "All markets the bookmaker offers on a fixture — result (1X2), double chance, draw no bet, winner, first to score, both teams to score, Asian handicap, handicap / point spread, goal / card / corner / points totals, the cricket toss winner, most sixes, a hundred / fifty in the match, and next goal (live). Each comes with opening and current prices in decimal and fractional form, the direction of the latest price change, its suspension state and, once the match is over, the winning selections. Available on Pro, Business and Enterprise plans.\n\n**Note:** Every market has a key that stays the same for the whole fixture, built from the kind followed by :period, :line and :live (\"result\", \"result:half1\", \"totalGoals:2.5\", \"asianHandicap:-1.25\", \"winner:live\"); use it to merge WebSocket odds frames. During play the bookmaker shows the in-play market (live: true, key ending …:live) alongside the now-closed pre-match market, which keeps its final prices from before kick-off. line is the figure of a total or the handicap of the HOME side; when the line moves, the market gets a new key. decimal equals 1 + fractional, rounded to 2 decimal places. winning is null until settlement and wherever nobody settles the market, and settledBy tells you who set it. The source leaves some markets unsettled: on NBA games the point spread (handicap) and the first-quarter winner were still null hours after full time when we checked on 2026-11-05, and so were football Asian handicaps and total cards on every finished fixture days later (checked 2026-11-12), while results, winners and goal totals came within minutes (settledBy \"source\"). Since 2026-11-12 we settle two of those from the final result ourselves, marked settledBy \"computed\" and never overriding a flag the source has set: football Asian handicaps on half lines, from the regular-time score, and football total cards on half lines when the match saw yellow cards only, all shown to players on the pitch and with the incidents and statistics in agreement. Any other market the source leaves open stays null permanently. A bet is decided by the bookmaker’s own rules. An empty markets list, with updatedAt null, means the bookmaker offers nothing on the fixture — typical for minor leagues and matches far in the future. Over REST the data refreshes roughly every 30 seconds in play; subscribe to odds:{id} to receive every price change.\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/odds/fixtures-odds/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Odds"
                    },
                    "meta": {
                      "type": "object",
                      "description": "count (number of markets)",
                      "properties": {
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- endpoint_not_in_plan — returned to keys on the Free and Starter plans\n- history_not_in_plan — the fixture predates the history your plan covers\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — DataSportsAPI never issued this id\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/odds\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.odds(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.odds(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.Odds(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures odds <id>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/odds/winning": {
      "get": {
        "operationId": "fixtures.winningOdds",
        "tags": [
          "odds"
        ],
        "summary": "Winning odds",
        "description": "Winning odds set each side’s win price against the probability it implies and how often sides priced that way have really won: the source’s figures, showing at a glance if the market under- or overrates a side. Available on Pro, Business and Enterprise plans.\n\n**Note:** expectedWinPercentage is the probability implied by the price — roughly 100 / decimal, rounded, with the bookmaker’s margin still included. actualWinPercentage is the share of sides at that price that went on to win, according to our data source, which does not disclose the sample or the time span behind it. Which pre-match price is used is the source’s choice, and it can match none of the opening or current prices in /v2/fixtures/{id}/odds. Only the two sides are compared, so no draw entry exists. Where the source lacks figures for a side, that side is null (sometimes only one side is covered); for fixtures the source does not cover at all — most minor leagues, doubles, matches far in the future — both sides and updatedAt are null. Refreshed at the same rate as the odds: about every 30 seconds in play.\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/odds/fixtures-winning-odds/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/WinningOdds"
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- endpoint_not_in_plan — returned to keys on the Free and Starter plans\n- history_not_in_plan — the fixture predates the history your plan covers\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — DataSportsAPI never issued this id\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/odds/winning\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.fixtures.winningOdds(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.fixtures.winning_odds(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Fixtures.WinningOdds(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa fixtures winning-odds <id>"
          }
        ]
      }
    },
    "/v2/odds": {
      "get": {
        "operationId": "odds.list",
        "tags": [
          "odds"
        ],
        "summary": "Odds by day",
        "description": "Returns the headline market for every fixture of a sport that the bookmaker prices on a given day — the three-way result in sports with draws, otherwise the winner. A complete odds list in a single request. Available on Pro, Business and Enterprise plans.\n\n**Note:** The day follows the bookmaker’s own list, which may stretch a few hours before or after the UTC day; to place a fixture correctly, take its startTime from /v2/fixtures/{id} or from your own day listing. Updated every few minutes. For all markets on one fixture, call /v2/fixtures/{id}/odds.\n\n**Plans:** Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "pro",
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/odds/list/"
        },
        "parameters": [
          {
            "name": "sport",
            "in": "query",
            "required": true,
            "description": "sport slug, as listed by /v2/sports",
            "schema": {
              "type": "string",
              "enum": [
                "football",
                "tennis",
                "basketball",
                "ice-hockey",
                "esports",
                "volleyball",
                "handball",
                "baseball",
                "american-football",
                "rugby",
                "cricket",
                "mma",
                "table-tennis",
                "darts",
                "snooker",
                "futsal",
                "badminton",
                "waterpolo",
                "cycling",
                "motorsport",
                "minifootball",
                "floorball",
                "bandy",
                "padel"
              ]
            }
          },
          {
            "name": "date",
            "in": "query",
            "required": false,
            "description": "date as YYYY-MM-DD; defaults to the current UTC day",
            "schema": {
              "type": "string",
              "format": "date"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/FeaturedOdds"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count, date, sport",
                      "properties": {
                        "count": {
                          "type": "integer"
                        },
                        "date": {
                          "type": "string"
                        },
                        "sport": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — sport is missing or not recognised, or the date is not in YYYY-MM-DD form\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- endpoint_not_in_plan — returned to keys on the Free and Starter plans\n- history_not_in_plan — your plan’s history does not reach back to that date\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/odds?sport=…\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.odds.list({ sport });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.odds.list(sport=sport)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Odds.List(ctx, &datasportsapi.OddsListParams{Sport: sport})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa odds list <sport>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/tracking": {
      "get": {
        "operationId": "tracking.get",
        "tags": [
          "tracking"
        ],
        "summary": "Tracking summary",
        "description": "Which tracking data a fixture holds (Enterprise only): its sport and coordinate frame, a final flag once the match is over, a complete flag once the post-match read is in, the counts of ball frames, tracked events and timeline events, and whether the players were tracked too (players, NBA games, since 2026-11-13).\n\n**Note:** Arriving live: football’s goals, shots, cards, substitutions, set pieces and flow of play, about 9 seconds after they happen (roughly 15 at most), and the timelines of basketball, ice hockey and darts, about 5 seconds behind (timelineEvent frames on the WebSocket). Football’s passes and most event details, and the basketball events, wait for the post-match read, which lands between a few minutes and an hour after the end: complete turns true then, a trackingStatus frame announces it on the WebSocket, and that is the moment to fetch the events and the timeline again. The ball track exists only as recorded during play — a frame the source did not capture live is never filled in later.\n\n**Plans:** Requires the Enterprise plan; every other plan receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/tracking/get/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/TrackingSummary"
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- endpoint_not_in_plan — returned on every plan except Enterprise\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — DataSportsAPI never issued this id\n- no_data — this fixture is not followed by the source (its sport or league has no tracking)\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/tracking\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.tracking.get(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.tracking.get(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Tracking.Get(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa tracking get <id>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/tracking/ball": {
      "get": {
        "operationId": "tracking.ball",
        "tags": [
          "tracking"
        ],
        "summary": "Ball track",
        "description": "Ball positions recorded live for a football or tennis match, oldest first, on Enterprise only: about 14 positions per minute of football play on the 0–100 pitch, about one per tennis shot, measured in millimetres from the net. Each call returns up to limit frames recorded after since; to read on, send meta.next as the next since.\n\n**Note:** Basketball, ice hockey and matches the source does not follow have no ball track, so the list comes back empty. To poll a match in progress, send the at of the newest frame you already hold as since. The tracking:{id} channel is the alternative: it pushes each frame within about a second.\n\n**Plans:** Requires the Enterprise plan; every other plan receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/tracking/ball/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "return only frames recorded after this instant (ISO-8601 with any offset; the instant itself is excluded) — meta.next from the previous page, or the at of your newest frame",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "frames per page, 1–5000 (5000 if omitted, enough for a whole football match)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 5000,
              "default": 5000
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/BallFrame"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count, hasNextPage, next (the since value for the following page, or null)",
                      "properties": {
                        "count": {
                          "type": "integer"
                        },
                        "hasNextPage": {
                          "type": "boolean"
                        },
                        "next": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — since or limit is malformed\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- endpoint_not_in_plan — returned on every plan except Enterprise\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — DataSportsAPI never issued this id\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/tracking/ball\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.tracking.ball(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.tracking.ball(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Tracking.Ball(ctx, id, &datasportsapi.TrackingBallParams{})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa tracking ball <id>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/tracking/events": {
      "get": {
        "operationId": "tracking.events",
        "tags": [
          "tracking"
        ],
        "summary": "Tracked events",
        "description": "Every tracked event with its position, in the order of play, on Enterprise only — football passes from start to end point, set pieces, shots, cards, fouls, substitutions and the attacking flow; tennis serves, faults and points (each with the game score after it), plus where the ball and the players were; basketball shots and where they were taken, rebounds, fouls and turnovers. Up to 1,000 per page, optionally narrowed to one type or to events after an instant.\n\n**Note:** key never changes, and trackedEvent frames use the identical key for the same event. The clock fields depend on the sport — minute and second for football, set and game for tennis, period for basketball. player, assist, playerIn and playerOut stay null if the source gives no name or the squad list lacks that player. Clock housekeeping entries are left out. During a live football match you receive flowAttack / flowDangerousAttack / flowBallSafe (side is the team in possession and position is where the ball is; read together they give the current state of play), possessionChange (without a side), goal, attemptAtGoal, corner, freeKick, throwIn, goalKick, yellowCard, redCard, substitution, possibleGoal / possibleCorner and more, around 18 a minute; passes are added by the post-match read. Ice hockey has no tracked events (use the timeline instead), and most basketball matches have none until the post-match read.\n\n**Plans:** Requires the Enterprise plan; every other plan receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/tracking/events/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "return only this event type, written in camelCase (pass, attemptAtGoal, goal, serve, point, ballSituation, threePointer, …)",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z][A-Za-z0-9]{0,59}$"
            }
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "return only events after this instant (ISO-8601 with any offset; the instant itself is excluded)",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "zero-based page of the filtered list, 0–999 (defaults to 0)",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 999,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/TrackedEvent"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "page, count, total (after filtering), hasNextPage",
                      "properties": {
                        "page": {
                          "type": "integer"
                        },
                        "count": {
                          "type": "integer"
                        },
                        "total": {
                          "type": "integer"
                        },
                        "hasNextPage": {
                          "type": "boolean"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — a malformed type, since or page\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- endpoint_not_in_plan — returned on every plan except Enterprise\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — DataSportsAPI never issued this id\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/tracking/events\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.tracking.events(id);\nfor await (const page of client.tracking.eventsPages(id)) { … }"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.tracking.events(id)\nfor page in client.tracking.events_pages(id): ..."
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Tracking.Events(ctx, id, &datasportsapi.TrackingEventsParams{})\nfor page, err := range client.Tracking.EventsPages(ctx, id, &datasportsapi.TrackingEventsParams{}) { … }"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa tracking events <id>\n$ dsa tracking events <id> --all -o csv"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/tracking/timeline": {
      "get": {
        "operationId": "tracking.timeline",
        "tags": [
          "tracking"
        ],
        "summary": "Match timeline",
        "description": "The timeline of a basketball, ice hockey or darts match, oldest first, filled live about 5 seconds behind play since 2026-11-13 (Enterprise only): every shot and where it was taken (made or missed; on target, blocked or saved), goals with the scorer and assists, penalties and their length, faceoffs, hits, timeouts and the score of each period — and in darts each dart with the bed it landed in and each visit with its score, the points left to get, and the legs and sets.\n\n**Note:** Events the source withdrew and clock housekeeping are left out. In basketball a made basket has type goal, with points set. Basketball and ice hockey positions run 0–100; home plays towards x = 100 and away towards x = 0 throughout. The source does not say which way a team attacks (its ice hockey spots swap ends every period, and some basketball games swap baskets at half-time), so each side’s positions are mirrored for a period (x → 100 − x, y → 100 − y) whenever its shots in that period fall in the wrong half; a side without shots in a period takes its direction from the opponent and from the neighbouring periods — so while a match is live, an event from a period with no shots yet can still move once shots arrive (sent as an upsert frame). Darts: a dartThrow carries darts.score, number, multiplier, ring (single, double, treble, outerBull, bull or miss), bed (for a single, the inner or outer single bed as the source gives it, since 2026-11-13; null for every other ring) and doubleAttempt; a visit carries darts.score as the visit total, dartsThrown, remaining (what each side still needs), legs and sets; checkout is the visit that took a leg, with checkoutDouble; legWon has the legs in homeScore / awayScore, and setWon and matchWon close the set and the match. Darts events have no position, and some darts competitions are reported visit by visit only. While a match is in play the source can correct an event or take it back, so read the timeline again or follow tracking:{id}. Football and tennis have no timeline, so the list is empty for them.\n\n**Plans:** Requires the Enterprise plan; every other plan receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/tracking/timeline/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/TimelineEvent"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count",
                      "properties": {
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- endpoint_not_in_plan — returned on every plan except Enterprise\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — DataSportsAPI never issued this id\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/tracking/timeline\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.tracking.timeline(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.tracking.timeline(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Tracking.Timeline(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa tracking timeline <id>"
          }
        ]
      }
    },
    "/v2/fixtures/{id}/tracking/players": {
      "get": {
        "operationId": "tracking.players",
        "tags": [
          "tracking"
        ],
        "summary": "Player tracking",
        "description": "Player tracking for NBA games, since 2026-11-13 (Enterprise only): all ten players on court plus the ball, at five frames per second, ordered by frame — who holds the ball, the game clock and the shot clock, and for every player the name, shirt number, side and position. With no cursor you get the newest frames (the last 30 seconds unless you set limit); with a cursor, the page that follows it.\n\n**Note:** Only NBA games carry it — TrackingSummary.players tells you whether a fixture does — and the list is empty for every other fixture. Positions use the same court frame as the rest of the basketball data: x runs 0–100 along the court and y 0–100 across it, with the home side shooting towards x = 100 in all periods (the sides swap ends at half-time; the frame does not move). Which way each team plays is inferred each period from where its shots are taken, so a live frame from the first seconds of a game, before anyone has shot, can come out mirrored; read it again later and it is corrected. There are no frames during half-time. ball.height is in metres (the rim sits at 3.05). Frames reach us about 1–2 seconds behind play, five per second sharing one at, so play them back by frame, 0.2 s between each. Only games recorded live have frames. For the live feed, take the playerFrame frames on tracking:{id}.\n\n**Plans:** Requires the Enterprise plan; every other plan receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/tracking/players/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "fixture id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "after",
            "in": "query",
            "required": false,
            "description": "frames that come after this frame counter (PlayerFrame.frame; that counter excluded) — meta.next from the previous page",
            "schema": {
              "type": "integer",
              "minimum": 0
            }
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "frames received after this instant (ISO-8601 with any offset; that instant excluded); ignored when after is sent",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "frames per page, 1–3000 (150 if omitted, which is 30 seconds)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 3000,
              "default": 150
            }
          },
          {
            "name": "fps",
            "in": "query",
            "required": false,
            "description": "5 for every frame (the default) or 1 for one frame per second",
            "schema": {
              "type": "integer",
              "enum": [
                1,
                5
              ],
              "default": 5
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PlayerFrame"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count, hasNextPage, next (the after value for the following page, or null)",
                      "properties": {
                        "count": {
                          "type": "integer"
                        },
                        "hasNextPage": {
                          "type": "boolean"
                        },
                        "next": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "- bad_request — after, since, limit or fps is malformed\n\nBad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- endpoint_not_in_plan — returned on every plan except Enterprise\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — DataSportsAPI never issued this id\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/fixtures/{id}/tracking/players\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.tracking.players(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.tracking.players(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Tracking.Players(ctx, id, &datasportsapi.TrackingPlayersParams{})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa tracking players <id>"
          }
        ]
      }
    },
    "/v2/exports": {
      "post": {
        "operationId": "exports.create",
        "tags": [
          "exports"
        ],
        "summary": "Create an export",
        "description": "Kicks off an export of a single league season. JSON body: league (DataSportsAPI league id), season (taken from /v2/leagues/{id}/seasons) and format, one of json (the default — a single season.json containing league, season, rounds, all fixtures, standings, top players and top teams exactly as the endpoints return them), csv or parquet (each giving two flat tables: fixtures and standings). The response is 202 with the export object, in status pending.\n\n**Note:** Fixtures are collected round by round, so a competition our data source does not split into rounds (NBA and NHL regular seasons) produces an export without fixtures; the export’s error field lists whatever could not be read (“not included: topPlayers”). Because we mirror the source’s listing, a match that was postponed and replayed later may appear twice — once as the postponed fixture and once as the played one, each with its own id (Premier League 25/26: 381 fixtures, one of them postponed). Columns in the CSV / Parquet files — fixtures: fixture_id, sport, start_time, round, round_name, status, status_description, home_team_id, home_team, away_team_id, away_team, home_score, away_score, winner, venue; standings: table, primary, position, team_id, team, played, wins, draws, losses, scores_for, scores_against, points, zone.\n\n**Plans:** Requires Business or Enterprise; any lower plan receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/exports/create/"
        },
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "league": {
                    "type": "integer",
                    "minimum": 1,
                    "description": "Our league id."
                  },
                  "season": {
                    "type": "integer",
                    "minimum": 1,
                    "description": "A season id of that league, from /v2/leagues/{id}/seasons."
                  },
                  "format": {
                    "type": "string",
                    "enum": [
                      "json",
                      "csv",
                      "parquet"
                    ],
                    "default": "json",
                    "description": "json writes a single season.json; csv and parquet each write a fixtures table and a standings table."
                  }
                },
                "required": [
                  "league",
                  "season"
                ]
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Accepted",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Export"
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "- not_found — the league does not exist, or the season does not belong to it\n\nNot found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "- export_limit — the allowance of 20 exports per UTC day has been used up\n\nPer-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -X POST -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/exports\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.exports.create({ league, season });"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.exports.create(league=league, season=season)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Exports.Create(ctx, &datasportsapi.ExportsCreateParams{League: league, Season: season})"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa exports create --league <league> --season <season>"
          }
        ]
      },
      "get": {
        "operationId": "exports.list",
        "tags": [
          "exports"
        ],
        "summary": "Exports",
        "description": "Lists your 20 most recent exports, latest first; those that are ready come with newly issued download links.\n\n**Plans:** Requires Business or Enterprise; any lower plan receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/exports/list/"
        },
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Export"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "description": "count",
                      "properties": {
                        "count": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/exports\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.exports.list();"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.exports.list()"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Exports.List(ctx)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa exports list"
          }
        ]
      }
    },
    "/v2/exports/{id}": {
      "get": {
        "operationId": "exports.get",
        "tags": [
          "exports"
        ],
        "summary": "Export status",
        "description": "Returns a single export. Check it every few seconds until status becomes ready (or failed); building a season takes anywhere from a few seconds (when cached) to a few minutes. files contains a download URL for each file, valid for one hour (see linksExpireAt); request the export again to get new links.\n\n**Plans:** Requires Business or Enterprise; any lower plan receives 403 endpoint_not_in_plan.",
        "x-plans": [
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/exports/get/"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "export id issued by DataSportsAPI, a positive integer",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Export"
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Refused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/exports/{id}\""
          },
          {
            "lang": "TypeScript",
            "label": "TypeScript",
            "source": "const { data, meta } = await client.exports.get(id);"
          },
          {
            "lang": "Python",
            "label": "Python",
            "source": "res = client.exports.get(id)"
          },
          {
            "lang": "Go",
            "label": "Go",
            "source": "res, err := client.Exports.Get(ctx, id)"
          },
          {
            "lang": "Shell",
            "label": "CLI",
            "source": "$ dsa exports get <id>"
          }
        ]
      }
    },
    "/v2/stream/ticket": {
      "post": {
        "operationId": "websocket.streamTicket",
        "tags": [
          "websocket"
        ],
        "summary": "Stream ticket",
        "description": "Issues a one-time ticket for opening a connection, valid for 30 seconds. The call is authenticated, rate-limited and counted against your usage exactly like any other /v2 request, and it takes no request body.\n\n**Plans:** Requires Business or Enterprise; on a lower plan the ticket request returns 403 ws_not_available. The tracking:{id} channel needs Enterprise and is refused on Business with channel_forbidden.",
        "x-plans": [
          "business",
          "enterprise"
        ],
        "externalDocs": {
          "description": "Docs page",
          "url": "https://datasportsapi.com/docs/websocket/stream-ticket/"
        },
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "ticket": {
                          "type": "string"
                        },
                        "url": {
                          "type": "string",
                          "format": "uri"
                        },
                        "expiresInSeconds": {
                          "type": "integer"
                        }
                      },
                      "required": [
                        "ticket",
                        "url",
                        "expiresInSeconds"
                      ]
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad request (`bad_request`): the message lists the values the parameter accepts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key (`unauthorized`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "- ws_not_available — WebSocket access is not part of your plan\n\nRefused: your plan does not include this endpoint (`endpoint_not_in_plan`), the requested data predates your plan's history window (`history_not_in_plan`; see `historyFrom`), or the caller's IP is missing from the account's allowlist (`ip_not_allowed`, Business and Enterprise).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Not found (`not_found`), valid ids with no source data behind them (`no_data`, e.g. tracking of a fixture the source does not follow), or an endpoint that does not cover this sport (`not_supported`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Per-minute rate exceeded (`rate_limited`) or the period's quota spent (`quota_exceeded`); wait the `Retry-After` seconds.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Our fault (`internal_error`); safe to retry with backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Upstream data temporarily unavailable (`upstream_unavailable`); try again once the `Retry-After` seconds have passed.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "cURL",
            "source": "curl -X POST -H \"Authorization: Bearer sk_live_…\" \\\n    \"https://api.datasportsapi.com/v2/stream/ticket\""
          }
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "Your secret API key: `Authorization: Bearer sk_live_…`. Publishable widget keys (`pk_live_…`) work only for the endpoints widgets read, from the sites registered on them."
      }
    },
    "headers": {
      "RateLimit-Limit": {
        "description": "Your plan's request quota for the current period (UTC month on paid plans, UTC day on Free).",
        "schema": {
          "type": "integer"
        }
      },
      "RateLimit-Remaining": {
        "description": "Requests still available in the current period.",
        "schema": {
          "type": "integer"
        }
      },
      "RateLimit-Reset": {
        "description": "Seconds until the period ends and the quota refills.",
        "schema": {
          "type": "integer"
        }
      },
      "Retry-After": {
        "description": "Seconds to wait before trying again.",
        "schema": {
          "type": "integer"
        }
      }
    },
    "schemas": {
      "Fixture": {
        "type": "object",
        "description": "A single match. Every endpoint and every WebSocket snapshot returns it in this same shape.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The fixture’s DataSportsAPI id."
          },
          "sport": {
            "type": "string",
            "description": "Slug of the sport, matching the values listed by /v2/sports."
          },
          "status": {
            "$ref": "#/components/schemas/Status",
            "description": "Current state of the match."
          },
          "startTime": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Kick-off time. Holds the scheduled start until the source logs the actual kick-off, which then takes its place (the live feed delivers it a few minutes after play begins). Identical across all endpoints and WebSocket deltas."
          },
          "league": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/LeagueRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Competition the fixture belongs to. It is null if the source places the fixture in a competition that has no matching league (observed in minor regional football, e.g. South Africa’s National Second Division on 2026-10-23); in that case season and round are null as well."
          },
          "season": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Season"
              },
              {
                "type": "null"
              }
            ],
            "description": "Season the fixture is part of."
          },
          "round": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Round"
              },
              {
                "type": "null"
              }
            ],
            "description": "Round of the fixture, for competitions organised in rounds."
          },
          "home": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "The home team. Null until that slot is settled, e.g. while the source still shows a placeholder like \"WQF1\" (winner of quarter-final 1)."
          },
          "away": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "The away team. Null until that slot is settled (for instance a \"WQF1\" placeholder from the source)."
          },
          "homeScore": {
            "$ref": "#/components/schemas/ScoreSide",
            "description": "Score of the home team."
          },
          "awayScore": {
            "$ref": "#/components/schemas/ScoreSide",
            "description": "Score of the away team."
          },
          "winner": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Winner"
              },
              {
                "type": "null"
              }
            ],
            "description": "Stays null until status.type is finished, and also when a fight ends as a no contest (`fightResult.method` noContest). When penalties decide the match, this is always the shoot-out winner regardless of the source (which, on a second leg, reports the team that won the 90 minutes). If the source omits the winner, or declares a draw in a sport where draws are impossible (finishes in regular time or overtime; cricket excluded), we derive it from the score."
          },
          "venue": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Venue"
              },
              {
                "type": "null"
              }
            ],
            "description": "Where the match is played, if known (frequently null in lower divisions). Populated on /fixtures/{id}, and in date lists when the source provides it. Round, team, player and live lists never include a venue, so a null there means \"omitted\" rather than \"unknown\" — fetch /fixtures/{id} to get it."
          },
          "clock": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Clock"
              },
              {
                "type": "null"
              }
            ],
            "description": "The match clock. Null if the source keeps no clock for this fixture, and after the match ends."
          },
          "firstToServe": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Deprecated (2026-10-23); mirrors `serving`. Because the source refreshes it each game / leg, it reflects who is serving (throwing) at the moment, not who served first. Use `serving` instead."
          },
          "serving": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tennis, darts and other sports with a serve: which side is currently serving (throwing), refreshed by the source every game / leg. Null if the source gives no indication."
          },
          "servedFirst": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Darts: which side threw the opening dart of the match (`serving` is whoever is throwing now). Fixed for the whole match once play begins; null before that, when the source does not say, and in every other sport (only darts data carries it). Since 2026-11-11."
          },
          "homeSeed": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "For seeded events such as tennis draws or playoff brackets (basketball, …): the seed of the home side (\"1\", \"12\") or its entry status (\"WC\" wild card, \"Q\" qualifier, \"LL\" lucky loser, \"PR\" protected ranking, …), exactly as shown in the draw. Null for an unseeded side."
          },
          "awaySeed": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Seed or entry status of the away side; see homeSeed."
          },
          "note": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Cricket: the match note supplied by the source, which becomes the result line at the end (\"Pakistan beat Sri Lanka by 37 runs\"). Intended for display only."
          },
          "battingSide": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Cricket: which side is currently at the crease. Null outside a live innings and in every other sport."
          },
          "fightResult": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FightResult"
              },
              {
                "type": "null"
              }
            ],
            "description": "MMA / boxing: how, in which round and at what time the fight ended. Null before status.type reaches finished, and when the source supplies no method."
          },
          "fightDiscipline": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FightDiscipline"
              },
              {
                "type": "null"
              }
            ],
            "description": "Combat sports: the bout’s discipline, when the source labels it (the `mma` sport includes boxing, kickboxing and Muay Thai cards as well). Only some cards are labelled (ONE, Queensbury, certain OKTAGON fights; never UFC or PFL), so a null value does not imply MMA."
          },
          "referee": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Referee"
              },
              {
                "type": "null"
              }
            ],
            "description": "Match official, if the source names one (football and a few other sports; in cricket, the match referee). Present on /fixtures/{id}; always null in lists, where it is omitted."
          },
          "homeManager": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ManagerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Manager or head coach of the home side for this match, if the source names one. Present on /fixtures/{id}; null in lists."
          },
          "awayManager": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ManagerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Manager or head coach of the away side; behaves like homeManager."
          },
          "surface": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Surface"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tennis: the surface the match is played on. Present on /fixtures/{id} and in live lists; null in other sports."
          },
          "discipline": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/MatchDiscipline"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tennis: whether it is singles or doubles. Present on every fixture endpoint, in lists and in WebSocket snapshots; null in other sports and when the source specifies neither. Since 2026-11-11."
          },
          "toss": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CricketToss"
              },
              {
                "type": "null"
              }
            ],
            "description": "Cricket: the toss result, after it has taken place. Present on /fixtures/{id}; null in other sports."
          },
          "umpires": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              {
                "type": "null"
              }
            ],
            "description": "Cricket: the on-field umpires, named as the source writes them (frequently with a country code, e.g. \"Asif Yaqoob (PAK)\"). Null when none are listed and in other sports."
          },
          "tvUmpire": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Cricket: the TV (third) umpire, formatted as for umpires."
          },
          "previousLegFixtureId": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Two-legged ties and playoff series: the DataSportsAPI id of the preceding leg / game, when the source links the two. Look that id up on /fixtures/{id} to get the first-leg score."
          },
          "aggregateWinner": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Once the return leg of a two-legged tie is over: the side that went through. Taken from the source’s verdict when available; otherwise from `aggregated` (the higher total advances) or, if the aggregate is level, from the shoot-out. Null in every other case, including a level aggregate the source leaves unresolved (an away-goals rule). Compare `winner`, which refers to this match alone: when a second leg goes to penalties both fields name the shoot-out winner, but otherwise they can disagree (a side may win the second leg yet be eliminated). Filled on /fixtures/{id}; in lists and live snapshots it can be null."
          },
          "fightCard": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FightCard"
              },
              {
                "type": "null"
              }
            ],
            "description": "MMA / boxing: the bout’s section of the card, its running order and its weight class, if the source lists them."
          },
          "attendance": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Crowd figure, if the source reports one (observed for NBA and MLB games, frequently only after the game has started). Present on /fixtures/{id}; omitted (null) in lists."
          },
          "matchFormat": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/MatchFormat"
              },
              {
                "type": "null"
              }
            ],
            "description": "Darts and esports: the format of the match (best of N sets / legs / games), if the source states it. Null in other sports."
          },
          "inningState": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/InningState"
              },
              {
                "type": "null"
              }
            ],
            "description": "Baseball: the live game situation — inning, half, balls, strikes, outs and runners on base. Null when the game is not in progress or interrupted, and in other sports. Delivered live via WebSocket deltas."
          },
          "timeouts": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Timeouts"
              },
              {
                "type": "null"
              }
            ],
            "description": "Basketball: timeouts each side has left. Null outside an in-progress or interrupted game, and whenever the source does not track them. Delivered live via WebSocket deltas."
          },
          "downAndDistance": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DownAndDistance"
              },
              {
                "type": "null"
              }
            ],
            "description": "American football: the current down, distance and field position. Null when the game is not in progress or interrupted, and in other sports. Delivered live via WebSocket deltas. Available since 2026-11-09."
          },
          "varCheck": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/VarCheck"
              },
              {
                "type": "null"
              }
            ],
            "description": "Football: an ongoing VAR review. Null when no review is under way, outside play and in other sports. Delivered live via WebSocket deltas. Available since 2026-11-09."
          },
          "bonus": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BasketballBonus"
              },
              {
                "type": "null"
              }
            ],
            "description": "Basketball: whether each side is in the bonus. Null outside an in-progress or interrupted game, and whenever the source does not report it. The source’s live feed never carries it, so it appears in REST responses and lists only. Available since 2026-11-09."
          },
          "finalResultOnly": {
            "type": "boolean",
            "description": "True if the source provides only the final result for this fixture, with no live score, clock or events during play (available since 2026-11-09)."
          },
          "durations": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Durations"
              },
              {
                "type": "null"
              }
            ],
            "description": "Sports played in sets or rounds: the length of every finished period (available since 2026-11-04). Null for sports the source does not time by period (football, basketball, …) and until the first period is over. Delivered live via WebSocket deltas."
          },
          "lineupsAvailable": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "Becomes true when the source publishes lineups for the fixture, whether predicted or official (check `confirmed` on /v2/fixtures/{id}/lineups to tell them apart), and false if they are withdrawn. We set it the moment the source’s live feed announces lineups, or when a lineup we fetch contains players. Null means we have no information yet (no announcement observed, nothing fetched). WebSocket deltas carry it live — on fixture:{id} from before kick-off, and on the list channels once play starts. Available since 2026-11-04."
          },
          "lineupsConfirmed": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "Becomes true when the official lineups are released (matching `confirmed` on /v2/fixtures/{id}/lineups); otherwise behaves like lineupsAvailable, with null meaning we have no information. Delivered live via WebSocket deltas. Available since 2026-11-04."
          }
        },
        "required": [
          "id",
          "sport",
          "status",
          "startTime",
          "league",
          "season",
          "round",
          "home",
          "away",
          "homeScore",
          "awayScore",
          "winner",
          "venue",
          "clock",
          "firstToServe",
          "serving",
          "servedFirst",
          "homeSeed",
          "awaySeed",
          "note",
          "battingSide",
          "fightResult",
          "fightDiscipline",
          "referee",
          "homeManager",
          "awayManager",
          "surface",
          "discipline",
          "toss",
          "umpires",
          "tvUmpire",
          "previousLegFixtureId",
          "aggregateWinner",
          "fightCard",
          "attendance",
          "matchFormat",
          "inningState",
          "timeouts",
          "downAndDistance",
          "varCheck",
          "bonus",
          "finalResultOnly",
          "durations",
          "lineupsAvailable",
          "lineupsConfirmed"
        ]
      },
      "Status": {
        "type": "object",
        "description": "The state of a match.",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/StatusType",
            "description": "High-level state, computed from `phase` (mapping in the StatusPhase table)."
          },
          "phase": {
            "$ref": "#/components/schemas/StatusPhase",
            "description": "Detailed state, computed from `code`."
          },
          "code": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "The source’s raw status code (the data dictionary lists every value); `phase`, `period` and `finish` give you its meaning ready-made."
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Human-readable English label taken from our status table (status codes in the data dictionary) and adapted to the sport, for example \"Halftime\", \"2nd half\", \"After penalties\", \"After extra time\" (football), \"After extra innings\" (baseball), \"After overtime\" (basketball, ice hockey, …), \"1st innings\" (cricket) or \"Coverage canceled\". For a code we do not recognise, the source’s own wording is passed through. Use it for display, never for branching logic."
          },
          "period": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PeriodKey"
              },
              {
                "type": "null"
              }
            ],
            "description": "Period currently being played, or the one just completed during a break. Null before the start and after the end."
          },
          "finish": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FinishType"
              },
              {
                "type": "null"
              }
            ],
            "description": "The way the result was reached. Only set when `type` is finished; null otherwise."
          }
        },
        "required": [
          "type",
          "phase",
          "code",
          "description",
          "period",
          "finish"
        ]
      },
      "ScoreSide": {
        "type": "object",
        "description": "Score of one team.",
        "properties": {
          "current": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "The headline score you would see on a scoreboard: goals, points, sets won (tennis / volleyball) or runs (cricket, baseball), counting extra time / overtime. Shoot-out goals are excluded and reported in `penalties` instead — except in ice hockey, where the shoot-out winner is given one extra goal (3-3 after overtime becomes 3-4). Before the start, and for fixtures whose coverage was canceled, it is null."
          },
          "periods": {
            "type": "object",
            "propertyNames": {
              "$ref": "#/components/schemas/PeriodKey"
            },
            "additionalProperties": {
              "type": "number"
            },
            "description": "The score split by period and keyed by PeriodKey — goals per half, quarter or period; games per set in tennis; points per set in volleyball and table tennis; runs per inning in baseball. Extra periods are included too: football and futsal use `extra1` / `extra2`; American football, basketball, handball, ice hockey, water polo and others use `overtime`; baseball extra innings run from `period10` upwards (`overtime` only if the source reports extra-innings runs as one total). When the source’s breakdown is complete the values sum to `current`; it is occasionally incomplete (some baseball leagues omit innings, a few futsal matches lack a half), and ice hockey decided by a shoot-out is intentionally one goal short (see `current`). Esports uses one key per game (map), with a title-dependent meaning: Counter-Strike stores 1 for each map a side won and 0 for the rest (maps not played count as 0, through period5 in a best of 3); in League of Legends it is the side’s kill count in game N, so the values do not sum to `current`, which counts games won. Each game’s winner and score are on /fixtures/{id}/games. Empty when the source gives no breakdown."
          },
          "tieBreaks": {
            "type": "object",
            "propertyNames": {
              "$ref": "#/components/schemas/PeriodKey"
            },
            "additionalProperties": {
              "type": "number"
            },
            "description": "Tennis: points won in each set’s tie-break, using the same keys as `periods` (e.g. { \"period2\": 7 })."
          },
          "normalTime": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Score when regulation time ended, if the source provides it."
          },
          "penalties": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Goals converted in a penalty shoot-out. In ice hockey the shoot-out winner gets 1 here and the loser 0, in line with the single goal added to `current`."
          },
          "aggregated": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Combined score across both legs of a two-legged tie."
          },
          "series": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Playoff series: number of games this side has won in the series to date (basketball, baseball, ice hockey, water polo)."
          },
          "point": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tennis: score within the current game — \"0\" | \"15\" | \"30\" | \"40\" | \"A\", or a plain number (\"0\"–\"N\") during a tie-break. Darts: the points the side still has to score in the current leg (\"501\" when a leg starts). Null when play is neither in progress nor interrupted."
          },
          "redCards": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Football: number of red cards this side has received, counting second yellows."
          },
          "innings": {
            "type": "object",
            "propertyNames": {
              "$ref": "#/components/schemas/PeriodKey"
            },
            "additionalProperties": {
              "$ref": "#/components/schemas/CricketInnings"
            },
            "description": "Cricket: each innings of this side, keyed inning1…N. Empty in other sports."
          },
          "hits": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Baseball: hit total, i.e. the H in the R/H/E line."
          },
          "errors": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Baseball: error total, i.e. the E in the R/H/E line."
          }
        },
        "required": [
          "current",
          "periods",
          "tieBreaks",
          "normalTime",
          "penalties",
          "aggregated",
          "series",
          "point",
          "redCards",
          "innings",
          "hits",
          "errors"
        ]
      },
      "CricketInnings": {
        "type": "object",
        "description": "A single cricket innings played by one side.",
        "properties": {
          "runs": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Total runs made."
          },
          "wickets": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of wickets that have fallen."
          },
          "overs": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Overs delivered, in cricket notation (49.5 means 49 overs plus 5 balls)."
          },
          "runRate": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Average runs scored per over."
          },
          "targetRunRate": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Run rate the chasing side needs to reach its target."
          }
        },
        "required": [
          "runs",
          "wickets",
          "overs",
          "runRate",
          "targetRunRate"
        ]
      },
      "Clock": {
        "type": "object",
        "description": "Timing data for a match. Running clocks (football, rugby, …): compute elapsed = periodOffsetSeconds + (now − periodStartedAt) and minute = floor(elapsed / 60) + 1; once periodEndSeconds is passed, display periodEndSeconds / 60 followed by \"+\" and the extra minutes. This applies only while status.phase is inprogress. Stop clocks (basketball, handball, ice hockey, …): playedSeconds is the value at playedAt and advances only while `running` is true. Tennis, table tennis, badminton and esports (set / map sports) carry only `periodStartedAt` (start of the current set or map), and only if the source sends it — the clock as a whole is frequently null. A field is null whenever the source does not provide it for that sport; the entire clock is null when no clock exists and after the match ends. Lists other than /fixtures/{id} may include fewer clock fields (static values such as periodLengthSeconds can be null there).",
        "properties": {
          "periodStartedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Moment the clock for the current period was started."
          },
          "periodOffsetSeconds": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Running clock: seconds already on the clock at the start of the period (2700 for the second half in football). Unit: seconds."
          },
          "periodEndSeconds": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Running clock: clock reading, in seconds, at which regulation time for the period runs out (2700 for the first half in football). Unit: seconds."
          },
          "maxExtraSeconds": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Running clock: upper bound on the added time the source’s display permits after periodEndSeconds. Unit: seconds."
          },
          "injuryTimeMinutes": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Stoppage time announced for the current period. Unit: minutes."
          },
          "playedSeconds": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Stop clock: time played in seconds, valid at `playedAt`. Unit: seconds."
          },
          "playedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Timestamp at which `playedSeconds` was captured."
          },
          "running": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "Stop clock: true while the game clock is ticking."
          },
          "runningUpdatedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Time of the most recent change to `running`."
          },
          "periodLengthSeconds": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Stop clock: duration of a single regulation period. Unit: seconds."
          },
          "overtimeLengthSeconds": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Duration of a single overtime period. Unit: seconds."
          },
          "periodCount": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "How many regulation periods the match has (in combat sports, the scheduled rounds)."
          },
          "lastPeriodEndedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "End time of the latest completed period. During a break (half-time, between periods) this marks when the break started, so the break has lasted now − lastPeriodEndedAt. Used with football-style running clocks; null if the source sends nothing (before the first break, in other sports, or for data stored before 2026-11-04). Available since 2026-11-04."
          }
        },
        "required": [
          "periodStartedAt",
          "periodOffsetSeconds",
          "periodEndSeconds",
          "maxExtraSeconds",
          "injuryTimeMinutes",
          "playedSeconds",
          "playedAt",
          "running",
          "runningUpdatedAt",
          "periodLengthSeconds",
          "overtimeLengthSeconds",
          "periodCount",
          "lastPeriodEndedAt"
        ]
      },
      "FightResult": {
        "type": "object",
        "description": "MMA / boxing: the way a completed fight was settled.",
        "properties": {
          "method": {
            "$ref": "#/components/schemas/FightMethod",
            "description": "The winning method."
          },
          "round": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Round in which the fight finished."
          },
          "roundTimeSeconds": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Elapsed time in that round when the fight was halted (KO, TKO, submission, disqualification, …), if the source records it. Null for every decision (unanimous, split, majority, technical, drawn ones too): nothing stopped the fight, and the source’s figure cannot be trusted there. Unit: seconds."
          }
        },
        "required": [
          "method",
          "round",
          "roundTimeSeconds"
        ]
      },
      "Referee": {
        "type": "object",
        "description": "The match official (for cricket, the match referee) and the career totals the source records for them. For a per-match rate, divide a total by `games`.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The referee’s DataSportsAPI id."
          },
          "name": {
            "type": "string",
            "description": "Name of the referee."
          },
          "slug": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Slug for use in URLs."
          },
          "country": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Country"
              },
              {
                "type": "null"
              }
            ],
            "description": "Country of the referee, if the source supplies it."
          },
          "games": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of matches the source has logged with this referee in charge, across the whole career and all competitions."
          },
          "yellowCards": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Yellow cards issued across those matches. Null in sports that have no cards (cricket)."
          },
          "redCards": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Direct red cards issued across those matches. Null in sports that have no cards."
          },
          "yellowRedCards": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Dismissals for a second yellow across those matches. Null in sports that have no cards."
          },
          "image": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ],
            "description": "Referee photo hosted on our CDN. Null if no image exists or it has not been uploaded yet. Available since 2026-11-04."
          }
        },
        "required": [
          "id",
          "name",
          "slug",
          "country",
          "games",
          "yellowCards",
          "redCards",
          "yellowRedCards",
          "image"
        ]
      },
      "Surface": {
        "type": "object",
        "description": "Tennis: the type of court used for the match.",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/SurfaceType",
            "description": "Surface category of the court."
          },
          "indoor": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True for an indoor court and false for an outdoor one; null if the source does not specify."
          },
          "name": {
            "type": "string",
            "description": "Surface label as worded by the source, such as \"Hardcourt outdoor\". For display only."
          }
        },
        "required": [
          "type",
          "indoor",
          "name"
        ]
      },
      "CricketToss": {
        "type": "object",
        "description": "Cricket: outcome of the coin toss.",
        "properties": {
          "winner": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Toss winner; null if the team the source names matches neither participant."
          },
          "decision": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TossDecision"
              },
              {
                "type": "null"
              }
            ],
            "description": "The choice the toss winner made."
          }
        },
        "required": [
          "winner",
          "decision"
        ]
      },
      "FightCard": {
        "type": "object",
        "description": "MMA / boxing: a bout’s placement on the event card.",
        "properties": {
          "section": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FightCardSection"
              },
              {
                "type": "null"
              }
            ],
            "description": "The part of the card (main card, prelims, …), if the source specifies it."
          },
          "order": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Position of the bout in the source’s numbering of the card; larger numbers come later, and the main event carries the largest."
          },
          "weightClass": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Weight class of the bout, using the source’s naming (\"light\", \"bantam\", \"feather\", …)."
          }
        },
        "required": [
          "section",
          "order",
          "weightClass"
        ]
      },
      "FixturePatch": {
        "type": "object",
        "description": "Contents of `changes` in a WebSocket delta: a partial Fixture that keeps the same field names and nesting. Deep-merge it into your local Fixture — nested objects merge key by key, while any other value (null included) overwrites. No fields beyond those listed here are ever sent.",
        "properties": {
          "status": {
            "type": "object",
            "properties": {
              "type": {
                "$ref": "#/components/schemas/StatusType"
              },
              "phase": {
                "$ref": "#/components/schemas/StatusPhase"
              },
              "code": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "description": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "period": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/PeriodKey"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "finish": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/FinishType"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "description": "Status fields that were modified. A status change always repeats type, phase and finish, plus period when it is known."
          },
          "startTime": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Updated start time, either because the fixture was rescheduled or because the source has logged the actual kick-off (see Fixture.startTime)."
          },
          "winner": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Winner"
              },
              {
                "type": "null"
              }
            ],
            "description": "Sent once the match is over."
          },
          "homeScore": {
            "$ref": "#/components/schemas/ScoreSidePatch",
            "description": "Modified fields of the home ScoreSide."
          },
          "awayScore": {
            "$ref": "#/components/schemas/ScoreSidePatch",
            "description": "Modified fields of the away ScoreSide."
          },
          "clock": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "periodStartedAt": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "date-time"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "periodOffsetSeconds": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "periodEndSeconds": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "maxExtraSeconds": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "injuryTimeMinutes": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "playedSeconds": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "playedAt": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "date-time"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "running": {
                    "anyOf": [
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "runningUpdatedAt": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "date-time"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "periodLengthSeconds": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "overtimeLengthSeconds": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "periodCount": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "lastPeriodEndedAt": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "date-time"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                }
              },
              {
                "type": "null"
              }
            ],
            "description": "Since 2026-11-14 the whole Clock (every field, null where there is no value) is sent whenever any part of it changes. Deep-merging it gives the same result as before, and a client that held no clock now receives a complete one. A null value signals the match has ended; discard the clock."
          },
          "firstToServe": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Deprecated; carries the same value as `serving`."
          },
          "serving": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Side currently serving (throwing)."
          },
          "servedFirst": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Darts: which side opened the match, sent as soon as the source provides it. Since 2026-11-11."
          },
          "note": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Cricket: updated match note."
          },
          "battingSide": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Cricket: side currently batting; null when nobody is."
          },
          "inningState": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/InningState"
              },
              {
                "type": "null"
              }
            ],
            "description": "Baseball: updated game state, always delivered as a complete object; null once play has stopped."
          },
          "timeouts": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "homeRemaining": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "awayRemaining": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "perTeam": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                }
              },
              {
                "type": "null"
              }
            ],
            "description": "Basketball: timeout counts that were modified; null once play has stopped."
          },
          "downAndDistance": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "down": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "yardsToGo": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "possession": {
                    "anyOf": [
                      {
                        "$ref": "#/components/schemas/Side"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "ballOn": {
                    "anyOf": [
                      {
                        "$ref": "#/components/schemas/Side"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "yardLine": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "goalToGo": {
                    "anyOf": [
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "playType": {
                    "anyOf": [
                      {
                        "$ref": "#/components/schemas/DownPlayType"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                }
              },
              {
                "type": "null"
              }
            ],
            "description": "American football: fields that were modified (the full object when tracking begins); null once play has stopped. Available since 2026-11-09."
          },
          "varCheck": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/VarCheck"
              },
              {
                "type": "null"
              }
            ],
            "description": "Football: a full object when a VAR review begins, null when it finishes. Available since 2026-11-09."
          },
          "durations": {
            "type": "object",
            "properties": {
              "periods": {
                "type": "object",
                "propertyNames": {
                  "$ref": "#/components/schemas/PeriodKey"
                },
                "additionalProperties": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "totalSeconds": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "description": "A newly finished period with its length in seconds (keyed as in ScoreSide.periods; null means the source removed it, so delete it), together with the updated total. Merge it the same way as a score map."
          },
          "fightResult": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FightResult"
              },
              {
                "type": "null"
              }
            ],
            "description": "MMA / boxing: how, in which round and when the fight finished, sent as a whole object once the source has it. Expect it in a delta after the one that ends the fight, since the source releases it ~20–60 s after the winner is known."
          },
          "lineupsAvailable": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True when lineups are published and false when they are pulled, sent as soon as the source announces it, including before kick-off (fixture:{id}). Available since 2026-11-04."
          },
          "lineupsConfirmed": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "Signals that the official lineups have been released. Available since 2026-11-04."
          }
        }
      },
      "ScoreSidePatch": {
        "type": "object",
        "description": "Only the ScoreSide fields that changed.",
        "properties": {
          "current": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "The headline score you would see on a scoreboard: goals, points, sets won (tennis / volleyball) or runs (cricket, baseball), counting extra time / overtime. Shoot-out goals are excluded and reported in `penalties` instead — except in ice hockey, where the shoot-out winner is given one extra goal (3-3 after overtime becomes 3-4). Before the start, and for fixtures whose coverage was canceled, it is null."
          },
          "normalTime": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Score when regulation time ended, if the source provides it."
          },
          "penalties": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Goals converted in a penalty shoot-out. In ice hockey the shoot-out winner gets 1 here and the loser 0, in line with the single goal added to `current`."
          },
          "aggregated": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Combined score across both legs of a two-legged tie."
          },
          "series": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Playoff series: number of games this side has won in the series to date (basketball, baseball, ice hockey, water polo)."
          },
          "point": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tennis: score within the current game — \"0\" | \"15\" | \"30\" | \"40\" | \"A\", or a plain number (\"0\"–\"N\") during a tie-break. Darts: the points the side still has to score in the current leg (\"501\" when a leg starts). Null when play is neither in progress nor interrupted."
          },
          "redCards": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Football: number of red cards this side has received, counting second yellows."
          },
          "hits": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Baseball: hit total, i.e. the H in the R/H/E line."
          },
          "errors": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Baseball: error total, i.e. the E in the R/H/E line."
          },
          "periods": {
            "type": "object",
            "propertyNames": {
              "$ref": "#/components/schemas/PeriodKey"
            },
            "additionalProperties": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            },
            "description": "Just the periods whose value changed. A null value means the source removed that period, so delete it."
          },
          "tieBreaks": {
            "type": "object",
            "propertyNames": {
              "$ref": "#/components/schemas/PeriodKey"
            },
            "additionalProperties": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            },
            "description": "Just the tie-breaks whose value changed; null means one was removed."
          },
          "innings": {
            "type": "object",
            "propertyNames": {
              "$ref": "#/components/schemas/PeriodKey"
            },
            "additionalProperties": {
              "$ref": "#/components/schemas/CricketInnings"
            },
            "description": "Just the innings that changed. Merge them key by key, as with periods; any innings left out keeps its previous value."
          }
        }
      },
      "TeamRef": {
        "type": "object",
        "description": "Compact team reference embedded in other objects (fixtures, standings, players, leaders).",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The team’s DataSportsAPI id."
          },
          "name": {
            "type": "string",
            "description": "Name of the team. Individual sports (tennis, table tennis, darts, MMA, …) also model each competitor as a team — a single player, or a doubles pair."
          },
          "slug": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Slug for use in URLs."
          },
          "shortName": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Abbreviated display name, if the source provides one."
          },
          "code": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Abbreviation of 1–4 characters as used on scoreboards (e.g. \"ARS\", \"LA\"); generated artificially for individual sports."
          },
          "image": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ],
            "description": "Team logo hosted on our CDN; null if the team has no image."
          }
        },
        "required": [
          "id",
          "name",
          "slug",
          "shortName",
          "code",
          "image"
        ]
      },
      "TeamDetail": {
        "type": "object",
        "description": "Full profile of a team.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The team’s DataSportsAPI id."
          },
          "name": {
            "type": "string",
            "description": "Name of the team. Individual sports (tennis, table tennis, darts, MMA, …) also model each competitor as a team — a single player, or a doubles pair."
          },
          "slug": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Slug for use in URLs."
          },
          "shortName": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Abbreviated display name, if the source provides one."
          },
          "code": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Abbreviation of 1–4 characters as used on scoreboards (e.g. \"ARS\", \"LA\"); generated artificially for individual sports."
          },
          "image": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ],
            "description": "Team logo hosted on our CDN; null if the team has no image."
          },
          "sport": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Slug of the sport."
          },
          "country": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Country"
              },
              {
                "type": "null"
              }
            ],
            "description": "Country the team is based in or represents."
          },
          "venue": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Venue"
              },
              {
                "type": "null"
              }
            ],
            "description": "The team’s home ground."
          },
          "colors": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "primary": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "secondary": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "text": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "primary",
                  "secondary",
                  "text"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Kit colours in #rrggbb form. Null when the source has no real colours for the team (the source fills in a placeholder blue for every individual competitor and most minor teams)."
          },
          "gender": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamGender"
              },
              {
                "type": "null"
              }
            ],
            "description": "Whether the team is men’s, women’s or mixed; null if the source does not specify."
          },
          "national": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True for a national team, false for a club; null if the source does not specify."
          },
          "kind": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamKind"
              },
              {
                "type": "null"
              }
            ],
            "description": "Distinguishes a team, a single competitor in an individual sport and a doubles pair; null if the source does not specify."
          },
          "manager": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ManagerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Current manager or head coach, if the source names one."
          },
          "person": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Person"
              },
              {
                "type": "null"
              }
            ],
            "description": "For individual competitors the source profiles (tennis, MMA): date of birth, height, weight and so on. Null for everyone else."
          },
          "record": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FighterRecord"
              },
              {
                "type": "null"
              }
            ],
            "description": "MMA / boxing fighters: career win-draw-loss record together with how their most recent fights ended. Null for all other teams."
          },
          "foundedOn": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Founding date of the club, if the source has it (roughly half of the teams we have read); null otherwise. Available since 2026-11-09."
          }
        },
        "required": [
          "id",
          "name",
          "slug",
          "shortName",
          "code",
          "image",
          "sport",
          "country",
          "venue",
          "colors",
          "gender",
          "national",
          "kind",
          "manager",
          "person",
          "record",
          "foundedOn"
        ]
      },
      "Person": {
        "type": "object",
        "description": "Personal details of an individual competitor (`kind: individual`) for whom the source keeps a profile (tennis players, MMA fighters). Field names and units match Player.",
        "properties": {
          "dateOfBirth": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Birth date."
          },
          "heightCm": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Body height. Unit: cm."
          },
          "weightKg": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Body weight in kilograms (for MMA, the weight the fighter is listed at)."
          },
          "reachCm": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Arm reach, for MMA. Unit: cm."
          },
          "nickname": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "MMA ring name or nickname, such as \"Storm\"."
          },
          "weightClass": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Weight class in the source’s wording (MMA: \"feather\", \"light\", \"bantam\", …)."
          },
          "birthplace": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Place of birth in the source’s wording (\"San Candido, Italy\")."
          },
          "residence": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Place of residence in the source’s wording (\"Monte Carlo, Monaco\")."
          },
          "handedness": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Handedness"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tennis: which hand the player plays with."
          },
          "turnedPro": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tennis: year the player became a professional."
          },
          "prizeMoneySeason": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Money"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tennis: prize money earned in the current season."
          },
          "prizeMoneyCareer": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Money"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tennis: total prize money earned over the career."
          }
        },
        "required": [
          "dateOfBirth",
          "heightCm",
          "weightKg",
          "reachCm",
          "nickname",
          "weightClass",
          "birthplace",
          "residence",
          "handedness",
          "turnedPro",
          "prizeMoneySeason",
          "prizeMoneyCareer"
        ]
      },
      "LeagueRef": {
        "type": "object",
        "description": "A league or competition. /v2/leagues/{id} and every league list return this same shape.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The league’s DataSportsAPI id."
          },
          "name": {
            "type": "string",
            "description": "Name of the league or competition."
          },
          "slug": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Slug for use in URLs."
          },
          "sport": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Slug of the sport, matching the values listed by /v2/sports."
          },
          "category": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "How the source groups the league: by country (\"England\"), region (\"International\", \"North America\", \"World\"), tour (\"ATP\", \"WTA\") or game (esports: \"Counter Strike\"). It is not necessarily a country; use `country` for that."
          },
          "country": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Country"
              },
              {
                "type": "null"
              }
            ],
            "description": "Country of the league when its category is a country; null for regions, tours and games."
          },
          "image": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ],
            "description": "League logo hosted on our CDN; null if the league has no image."
          },
          "priority": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "The source’s prominence ranking for the competition, handy for ordering leagues: a higher value means a bigger competition (for example 719 for the Champions League, 704 for the Premier League, 702 for LaLiga, 519 for Primeira Liga), and 0 means unranked. It is filled only where the source supplies it: on the league embedded in a fixture and in the /v2/fixtures?date&sport day lists. Everywhere else — league profiles, directories, search — it is null, as it is on rows saved before 2026-11-04. Available since 2026-11-04."
          }
        },
        "required": [
          "id",
          "name",
          "slug",
          "sport",
          "category",
          "country",
          "image",
          "priority"
        ]
      },
      "Country": {
        "type": "object",
        "description": "A country record.",
        "properties": {
          "code": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Two-letter code supplied by the source. ISO 3166-1 alpha-2, apart from XK for Kosovo and four codes for the UK home nations (England EN, Scotland SX, Wales WA, Northern Ireland NX). Null if unknown."
          },
          "name": {
            "type": "string",
            "description": "Country name in English."
          },
          "flag": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ],
            "description": "Flag image (PNG) hosted on our CDN. Null when there is no code or the image has not been uploaded yet. Available since 2026-11-04."
          }
        },
        "required": [
          "code",
          "name",
          "flag"
        ]
      },
      "Season": {
        "type": "object",
        "description": "One season of a league.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The season’s DataSportsAPI id."
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Full season name, such as \"Premier League 26/27\"."
          },
          "year": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Display label in the source’s format: \"26/27\" or \"2026/2027\" when the season spans two years, \"2026\" for a calendar-year season. Use startYear / endYear for sorting and filtering."
          },
          "startYear": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Year in which the season begins (2026 for both \"26/27\" and \"2026\"); null if the label cannot be parsed."
          },
          "endYear": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Year in which the season finishes (2027 for \"26/27\"; equal to startYear for a calendar-year season); null if the label cannot be parsed."
          }
        },
        "required": [
          "id",
          "name",
          "year",
          "startYear",
          "endYear"
        ]
      },
      "Round": {
        "type": "object",
        "description": "One round within a league season.",
        "properties": {
          "number": {
            "type": "integer",
            "description": "Round number from the source. Treat it as an opaque key rather than a sequence: cups count rounds by how many entrants remain (32 for a tennis \"Round of 64\"), and playoff rounds get large values (636). Use it with /v2/leagues/{id}/fixtures. The source gives some competitions no round structure — NBA and NHL regular seasons, NCAA, one-off tennis or MMA events; their fixtures may still have a round, but /rounds comes back empty and filtering by round yields nothing, so query them by date."
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Name of the round, if it has one (\"Quarterfinals\", \"Playoff round\")."
          },
          "slug": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tells apart rounds that share a number across different phases. When present, include it in /fixtures requests."
          },
          "prefix": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "An additional qualifier (e.g. \"Qualification\"); send it to /fixtures along with slug."
          }
        },
        "required": [
          "number",
          "name",
          "slug",
          "prefix"
        ]
      },
      "Rounds": {
        "type": "object",
        "description": "All rounds of a season plus the one in progress. Returned empty (`current: null`, `rounds: []`) for competitions the source does not structure in rounds; see Round.number.",
        "properties": {
          "current": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Round"
              },
              {
                "type": "null"
              }
            ]
          },
          "rounds": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Round"
            }
          }
        },
        "required": [
          "current",
          "rounds"
        ]
      },
      "Venue": {
        "type": "object",
        "description": "A stadium or arena: where a fixture takes place, or a team’s home ground.",
        "properties": {
          "id": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "The venue’s DataSportsAPI id; null if the source supplies the venue without an id."
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Name of the stadium or arena."
          },
          "city": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "City where the venue is located."
          },
          "country": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Country"
              },
              {
                "type": "null"
              }
            ],
            "description": "Country where the venue is located."
          },
          "capacity": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of seats."
          }
        },
        "required": [
          "id",
          "name",
          "city",
          "country",
          "capacity"
        ]
      },
      "PlayerRef": {
        "type": "object",
        "description": "Compact player reference embedded in other objects.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The player’s DataSportsAPI id."
          },
          "name": {
            "type": "string",
            "description": "Name of the player."
          },
          "slug": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Slug for use in URLs."
          },
          "shortName": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Abbreviated display name such as \"B. Saka\", if the source provides one."
          },
          "image": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ],
            "description": "Player photo hosted on our CDN; null if the player has no image."
          }
        },
        "required": [
          "id",
          "name",
          "slug",
          "shortName",
          "image"
        ]
      },
      "ManagerRef": {
        "type": "object",
        "description": "Compact reference to a team’s manager (head coach), embedded in other objects.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The manager’s DataSportsAPI id."
          },
          "name": {
            "type": "string",
            "description": "Name of the manager or head coach."
          },
          "slug": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Slug for use in URLs."
          },
          "shortName": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Abbreviated name such as \"F. Hurzeler\"."
          },
          "image": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ],
            "description": "Manager photo hosted on our CDN. Null if no image exists or it has not been uploaded yet. Available since 2026-11-04."
          }
        },
        "required": [
          "id",
          "name",
          "slug",
          "shortName",
          "image"
        ]
      },
      "Player": {
        "type": "object",
        "description": "Full profile of a player.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The player’s DataSportsAPI id."
          },
          "name": {
            "type": "string",
            "description": "The player’s full name."
          },
          "slug": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Slug for use in URLs."
          },
          "shortName": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Abbreviated name such as \"B. Saka\"."
          },
          "position": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Position"
              },
              {
                "type": "null"
              }
            ],
            "description": "Primary playing position."
          },
          "positionCode": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Position code as used by the source."
          },
          "jerseyNumber": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Shirt number as a string, since basketball and American football treat \"0\" and \"00\" as distinct numbers. Null if unknown; rugby squads’ \"0\" placeholder is dropped."
          },
          "heightCm": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Body height. Unit: cm."
          },
          "preferredFoot": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "left",
                  "right",
                  "both"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Football: the player’s stronger foot — left, right or both."
          },
          "dateOfBirth": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Birth date."
          },
          "country": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Country"
              },
              {
                "type": "null"
              }
            ],
            "description": "The player’s nationality."
          },
          "marketValue": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Money"
              },
              {
                "type": "null"
              }
            ],
            "description": "Estimated value on the transfer market; null if unknown."
          },
          "contractUntil": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date the current contract expires; null if unknown."
          },
          "image": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ],
            "description": "Player photo hosted on our CDN."
          },
          "injury": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Injury"
              },
              {
                "type": "null"
              }
            ],
            "description": "Ongoing injury, if the source records one (football, mainly in covered leagues); null means no injury is listed."
          },
          "detailedPositions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DetailedPosition"
            },
            "description": "Football: fine-grained positions the player occupies, primary first (e.g. [\"striker\"], [\"rightWinger\", \"attackingMidfielder\"]). Empty if the source lists none, as in other sports and minor leagues; `position` keeps the broad line either way."
          },
          "team": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Team the player currently belongs to."
          }
        },
        "required": [
          "id",
          "name",
          "slug",
          "shortName",
          "position",
          "positionCode",
          "jerseyNumber",
          "heightCm",
          "preferredFoot",
          "dateOfBirth",
          "country",
          "marketValue",
          "contractUntil",
          "image",
          "injury",
          "detailedPositions",
          "team"
        ]
      },
      "Injury": {
        "type": "object",
        "description": "An injury a player is currently carrying.",
        "properties": {
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Name of the injury, such as \"Hamstring Injury\"."
          },
          "status": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/InjuryStatus"
              },
              {
                "type": "null"
              }
            ],
            "description": "Availability status: out, day to day, …"
          },
          "since": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date the injury began (UTC day)."
          },
          "expectedReturn": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Projected return date (UTC day), if the source offers an estimate."
          },
          "updatedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Time of the source’s latest update to this injury."
          }
        },
        "required": [
          "description",
          "status",
          "since",
          "expectedReturn",
          "updatedAt"
        ]
      },
      "SquadPlayer": {
        "type": "object",
        "description": "A member of a squad. Identical to Player minus `team`, which is implied by the squad.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The player’s DataSportsAPI id."
          },
          "name": {
            "type": "string",
            "description": "The player’s full name."
          },
          "slug": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Slug for use in URLs."
          },
          "shortName": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Abbreviated name such as \"B. Saka\"."
          },
          "position": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Position"
              },
              {
                "type": "null"
              }
            ],
            "description": "Primary playing position."
          },
          "positionCode": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Position code as used by the source."
          },
          "jerseyNumber": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Shirt number as a string, since basketball and American football treat \"0\" and \"00\" as distinct numbers. Null if unknown; rugby squads’ \"0\" placeholder is dropped."
          },
          "heightCm": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Body height. Unit: cm."
          },
          "preferredFoot": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "left",
                  "right",
                  "both"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Football: the player’s stronger foot — left, right or both."
          },
          "dateOfBirth": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Birth date."
          },
          "country": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Country"
              },
              {
                "type": "null"
              }
            ],
            "description": "The player’s nationality."
          },
          "marketValue": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Money"
              },
              {
                "type": "null"
              }
            ],
            "description": "Estimated value on the transfer market; null if unknown."
          },
          "contractUntil": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date the current contract expires; null if unknown."
          },
          "image": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ],
            "description": "Player photo hosted on our CDN."
          },
          "injury": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Injury"
              },
              {
                "type": "null"
              }
            ],
            "description": "Ongoing injury, if the source records one (football, mainly in covered leagues); null means no injury is listed."
          },
          "detailedPositions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DetailedPosition"
            },
            "description": "Football: fine-grained positions the player occupies, primary first (e.g. [\"striker\"], [\"rightWinger\", \"attackingMidfielder\"]). Empty if the source lists none, as in other sports and minor leagues; `position` keeps the broad line either way."
          }
        },
        "required": [
          "id",
          "name",
          "slug",
          "shortName",
          "position",
          "positionCode",
          "jerseyNumber",
          "heightCm",
          "preferredFoot",
          "dateOfBirth",
          "country",
          "marketValue",
          "contractUntil",
          "image",
          "injury",
          "detailedPositions"
        ]
      },
      "Transfer": {
        "type": "object",
        "description": "A single player movement between teams, such as a transfer, loan, signing, trade or release. It has no id; the combination of player, type and date identifies it.",
        "properties": {
          "player": {
            "$ref": "#/components/schemas/PlayerRef",
            "description": "Player involved in the move."
          },
          "type": {
            "$ref": "#/components/schemas/TransferType",
            "description": "Category of the move."
          },
          "date": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date the move became effective (UTC day); null if the source gives no date."
          },
          "from": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Club the player departed; null for a free agent or for a side the source has no team record for (see `fromName`)."
          },
          "fromName": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The club the player left, named as the source writes it (e.g. \"Bryne FK Yth.\"); set even when `from` is null."
          },
          "to": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Club the player moved to; null after a waiver, release or retirement, or for a side the source has no team record for (`toName` then reads \"No team\" for releases and free agents)."
          },
          "toName": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Name of the destination club as written by the source; works like `fromName`."
          },
          "fee": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Money"
              },
              {
                "type": "null"
              }
            ],
            "description": "Transfer fee, if the source states it. Null for free, undisclosed or unknown fees and for any move that is not a transfer."
          },
          "freeTransfer": {
            "type": "boolean",
            "description": "True if the source marks the move as free, meaning no fee changed hands."
          },
          "draft": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "round": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "pick": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "round",
                  "pick"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "For type draft: the round and pick number, if listed. Null otherwise."
          }
        },
        "required": [
          "player",
          "type",
          "date",
          "from",
          "fromName",
          "to",
          "toName",
          "fee",
          "freeTransfer",
          "draft"
        ]
      },
      "TeamTransfers": {
        "type": "object",
        "description": "Recent incoming and outgoing moves for a team as listed by the source, covering roughly the past year.",
        "properties": {
          "arrivals": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Transfer"
            },
            "description": "Incoming moves, most recent first."
          },
          "departures": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Transfer"
            },
            "description": "Outgoing moves, most recent first."
          }
        },
        "required": [
          "arrivals",
          "departures"
        ]
      },
      "TransferFeed": {
        "type": "object",
        "description": "One page of the most recent football transfers (GET /v2/transfers). Available since 2026-11-09.",
        "properties": {
          "transfers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Transfer"
            },
            "description": "Moves on this page (no more than 50), sorted as requested."
          },
          "hasNextPage": {
            "type": "boolean",
            "description": "True if another page might contain further moves."
          }
        },
        "required": [
          "transfers",
          "hasNextPage"
        ]
      },
      "Money": {
        "type": "object",
        "description": "A monetary value.",
        "properties": {
          "amount": {
            "type": "number",
            "description": "The value, expressed in units of `currency`."
          },
          "currency": {
            "type": "string",
            "description": "Currency as an ISO 4217 code, such as \"EUR\"."
          }
        },
        "required": [
          "amount",
          "currency"
        ]
      },
      "Lineups": {
        "type": "object",
        "description": "Team sheets for both sides.",
        "properties": {
          "confirmed": {
            "type": "boolean",
            "description": "True when the official lineups have been released; false means they are predicted or not yet published."
          },
          "home": {
            "$ref": "#/components/schemas/TeamLineup",
            "description": "Lineup of the home side."
          },
          "away": {
            "$ref": "#/components/schemas/TeamLineup",
            "description": "Lineup of the away side."
          }
        },
        "required": [
          "confirmed",
          "home",
          "away"
        ]
      },
      "TeamLineup": {
        "type": "object",
        "description": "The lineup of a single side.",
        "properties": {
          "formation": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tactical formation, such as \"4-2-3-1\" (football)."
          },
          "players": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LineupPlayer"
            }
          },
          "missing": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MissingPlayer"
            }
          }
        },
        "required": [
          "formation",
          "players",
          "missing"
        ]
      },
      "LineupPlayer": {
        "type": "object",
        "description": "An individual entry in a lineup.",
        "properties": {
          "player": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Player reference."
          },
          "position": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Position"
              },
              {
                "type": "null"
              }
            ],
            "description": "Position the player fills in this lineup."
          },
          "positionCode": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Position code from the source, as shown on a team sheet (\"G\", \"LW\", \"QB\", \"1B\")."
          },
          "jerseyNumber": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Shirt number as a string, since \"00\" is possible."
          },
          "substitute": {
            "type": "boolean",
            "description": "True if the player started on the bench."
          },
          "captain": {
            "type": "boolean",
            "description": "True for the team captain."
          },
          "heightCm": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Height, copied over from the profile at GET /v2/players/{id}; null if the source has no value. Available since 2026-11-06. Unit: cm."
          },
          "dateOfBirth": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Birth date from the player’s profile; null if unknown. Available since 2026-11-06."
          },
          "country": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Country"
              },
              {
                "type": "null"
              }
            ],
            "description": "Nationality from the player’s profile, flag included; null if unknown. Available since 2026-11-06."
          },
          "marketValue": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Money"
              },
              {
                "type": "null"
              }
            ],
            "description": "Estimated market value from the player’s profile; null if unknown (the source only provides it for some football players). Available since 2026-11-06."
          },
          "rating": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Match rating to 2 decimal places (e.g. 7.4); null for an unrated player."
          },
          "avgRating": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Football: the player’s average match rating over the season (2 decimals), included when the source sends it with the lineup — usually in the run-up to kick-off and around it."
          },
          "ratingVersions": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "original": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "alternative": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "original",
                  "alternative"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Football: the rating from the original model alongside the one from the source’s alternative model."
          },
          "star": {
            "anyOf": [
              {
                "type": "integer",
                "enum": [
                  1,
                  2,
                  3
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Ice hockey: whether the player was picked as first, second or third star of the game."
          },
          "battingOrder": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Baseball: the player’s slot in the batting order."
          },
          "statistics": {
            "anyOf": [
              {
                "type": "object",
                "additionalProperties": {
                  "type": "number"
                }
              },
              {
                "type": "null"
              }
            ],
            "description": "The player’s match statistics, using sport-specific camelCase keys from the same vocabulary as team statistics: whenever a key measures the same thing as a team StatItem, it shares that key (football minutesPlayed, passes, accuratePasses, shotsOnGoal, expectedGoals …; basketball points, fieldGoalsMade, fieldGoalsAttempted, secondsPlayed …; ice hockey goals, shotsOnGoal, penalties, plusMinus, savePercentage …). Every …Percentage key is a share from 0 to 100 — ice-hockey save percentages too (94.1 rather than 0.941). Values are in seconds where the key name says so. Null if the player has no statistics."
          }
        },
        "required": [
          "player",
          "position",
          "positionCode",
          "jerseyNumber",
          "substitute",
          "captain",
          "heightCm",
          "dateOfBirth",
          "country",
          "marketValue",
          "rating",
          "avgRating",
          "ratingVersions",
          "star",
          "battingOrder",
          "statistics"
        ]
      },
      "MissingPlayer": {
        "type": "object",
        "description": "A player who is unavailable for a fixture.",
        "properties": {
          "player": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Player reference."
          },
          "availability": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Availability"
              },
              {
                "type": "null"
              }
            ],
            "description": "Whether the player is ruled out or only doubtful."
          },
          "reason": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/MissingReason"
              },
              {
                "type": "null"
              }
            ],
            "description": "Cause of the absence."
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Further detail in the source’s words, such as \"Hamstring Injury\" or \"Red card suspension\"."
          },
          "expectedReturnAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Anticipated return time, if known."
          }
        },
        "required": [
          "player",
          "availability",
          "reason",
          "description",
          "expectedReturnAt"
        ]
      },
      "Statistics": {
        "type": "object",
        "description": "Match statistics broken down by period.",
        "properties": {
          "periods": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "period": {
                  "anyOf": [
                    {
                      "type": "string",
                      "const": "all"
                    },
                    {
                      "$ref": "#/components/schemas/PeriodKey"
                    }
                  ]
                },
                "groups": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StatGroup"
                  }
                }
              },
              "required": [
                "period",
                "groups"
              ]
            },
            "description": "An entry for each period the source provides statistics for, beginning with \"all\"."
          }
        },
        "required": [
          "periods"
        ]
      },
      "StatGroup": {
        "type": "object",
        "description": "A themed set of statistics.",
        "properties": {
          "key": {
            "type": "string",
            "description": "Stable group identifier from a per-sport table, not derived from the display name — \"matchOverview\", \"attack\", \"other\" and so on."
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Human-readable group title, such as \"Match overview\"."
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/StatItem"
            }
          }
        },
        "required": [
          "key",
          "name",
          "items"
        ]
      },
      "StatItem": {
        "type": "object",
        "description": "A single match statistic with values for both teams.",
        "properties": {
          "key": {
            "type": "string",
            "description": "Stable camelCase identifier. A given key always denotes the same quantity, across all sports and in lineup player statistics, though it may show up in two groups. Ratio keys are named after the successes their `value` counts (`aerialDuelsWon`, `fieldGoalsMade`, `accurateCrosses`, `firstServesIn`, `powerPlayConversion`) and never end in `…Percentage`; that suffix is reserved for keys whose `value` is already a 0–100 share (`duelsWonPercentage`, `corsiPercentage`). Note that `blocks` counts attempts this side blocked, while `shotsBlocked` counts this side’s own shots that got blocked. The data dictionary lists every key per sport."
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "English label as provided by the source."
          },
          "kind": {
            "$ref": "#/components/schemas/StatKind",
            "description": "Tells you how to interpret the value and total of the statistic."
          },
          "higherIs": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/HigherIs"
              },
              {
                "type": "null"
              }
            ],
            "description": "Indicates whether a larger number is better; use it to emphasise the side that leads."
          },
          "home": {
            "$ref": "#/components/schemas/StatSide",
            "description": "Home side’s figures."
          },
          "away": {
            "$ref": "#/components/schemas/StatSide",
            "description": "Away side’s figures."
          }
        },
        "required": [
          "key",
          "name",
          "kind",
          "higherIs",
          "home",
          "away"
        ]
      },
      "StatSide": {
        "type": "object",
        "description": "A single team’s value for a statistic.",
        "properties": {
          "display": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Ready-to-display text, such as \"57%\", \"33/53 (62%)\" or \"1:22\"."
          },
          "value": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Underlying numeric value; interpret it using the item’s `kind`."
          },
          "total": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "For kind ratio, the number of attempts; for kind time, the seconds available. Null for other kinds."
          }
        },
        "required": [
          "display",
          "value",
          "total"
        ]
      },
      "Incident": {
        "type": "object",
        "description": "Something that happened during a match. As with all timeline lists, entries run oldest first (chronological order).",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/IncidentType",
            "description": "Category of the event."
          },
          "detail": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/IncidentDetail"
              },
              {
                "type": "null"
              }
            ],
            "description": "Sub-category within the type; null on period and injuryTime rows."
          },
          "side": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Side the event is credited to (an own goal belongs to the side that benefits from it); null on period / injuryTime rows."
          },
          "minute": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Match minute. Null whenever the clock is stopped — before kick-off, at half-time and after full time, for bench events, and during a shoot-out. Unit: minutes."
          },
          "addedMinute": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "How far into stoppage time the event happened (90+3 gives minute 90, addedMinute 3). On injuryTime rows it holds the announced minutes. Unit: minutes."
          },
          "second": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Game clock in seconds, if the source supplies it — present on all rows in ice hockey, basketball, handball and rugby, but only on period rows in football. Unit: seconds."
          },
          "period": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PeriodKey"
              },
              {
                "type": "null"
              }
            ],
            "description": "Period in which the event took place. On period rows it is the period that just ended (ET → extra2, PEN → penalties, FT → period2 in football and period4 in basketball). On other rows it is the period bounded by the surrounding period rows, or the source’s own value when supplied; shoot-out kicks use penalties. Null only if it cannot be determined (no period row yet and the period length for the sport is unknown)."
          },
          "player": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Main player involved: the scorer, the booked or penalised player, the subject of a VAR check, or the shoot-out taker."
          },
          "playerName": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Name of the player; filled even when the source provides a name without a player record (as with some own goals)."
          },
          "assists": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PlayerRef"
            },
            "description": "Players credited with assists on the goal, in order (up to two in ice hockey)."
          },
          "playerIn": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "For a substitution: the player entering the field."
          },
          "playerOut": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "For a substitution: the player leaving the field."
          },
          "drawnBy": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "For an ice hockey suspension: the player who drew the penalty."
          },
          "homeScore": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Home score immediately after the event (on goals, period rows and shoot-out kicks). For period rows in set sports (volleyball, table tennis, badminton) it is the number of sets won so far; the points inside each set are given by /points and by the fixture’s `periods`."
          },
          "awayScore": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Away score immediately after the event (sets won, on period rows in set sports)."
          },
          "text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "On period rows: the label a scoreboard would show (\"HT\", \"FT\", \"Q4\", \"3rd period\", \"Overtime\", \"PEN\"). For display only."
          },
          "reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "For a card, why it was shown (\"Foul\", \"Violent conduct\"); for a suspension, the offence (\"Holding\"); for a missed penalty, how it was missed (\"Goalkeeper save\", \"Off target\")."
          },
          "rescinded": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "For a card: true if it was later withdrawn."
          },
          "confirmed": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "For a varDecision: true when the original decision was upheld."
          },
          "shootoutSequence": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "For a shootoutPenalty: position of the kick in the overall order across both teams (1 is the opening kick of the shoot-out)."
          },
          "shootoutRound": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "For a shootoutPenalty: the round, i.e. whether it was the taking side’s 1st, 2nd, … kick."
          },
          "durationSeconds": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "For a suspension: how long the player is excluded. Unit: seconds."
          },
          "buildUp": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BuildUpStep"
            },
            "description": "For a football goal: the sequence of passes and shots leading up to it, ending with the goal itself (covered leagues only; empty elsewhere and for all other incidents)."
          }
        },
        "required": [
          "type",
          "detail",
          "side",
          "minute",
          "addedMinute",
          "second",
          "period",
          "player",
          "playerName",
          "assists",
          "playerIn",
          "playerOut",
          "drawnBy",
          "homeScore",
          "awayScore",
          "text",
          "reason",
          "rescinded",
          "confirmed",
          "shootoutSequence",
          "shootoutRound",
          "durationSeconds",
          "buildUp"
        ]
      },
      "KeyedIncident": {
        "type": "object",
        "description": "An incident paired with its stable key, as used in events frames.",
        "properties": {
          "key": {
            "type": "string",
            "description": "Identifier of the incident that stays stable within the fixture, built as `type:side:minute:addedMinute` (e.g. \"goal:home:34:0\", with \"-\" standing in for a null side or minute). Additional incidents in the same slot get `#2`, `#3`, … in list order. The player is not part of the key, so correcting the scorer or goal type keeps the key and counts as an update; correcting the minute produces a new key and removes the old one."
          },
          "incident": {
            "$ref": "#/components/schemas/Incident",
            "description": "The match event itself. As with all timeline lists, entries run oldest first (chronological order)."
          }
        },
        "required": [
          "key",
          "incident"
        ]
      },
      "IncidentChanges": {
        "type": "object",
        "description": "The difference between an events frame and the one before it.",
        "properties": {
          "added": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Keys of incidents that did not exist in the previous events frame (or in the server’s earlier copy)."
          },
          "updated": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Keys of incidents whose details were modified (scorer, assist, build-up, rescinded card, …)."
          },
          "removed": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/KeyedIncident"
            },
            "description": "Incidents that have disappeared from the source, each with its final content — for example a goal cancelled by VAR. The score reverts through a delta, and the goal shows up here once REST confirms its removal."
          }
        },
        "required": [
          "added",
          "updated",
          "removed"
        ]
      },
      "BuildUpStep": {
        "type": "object",
        "description": "A single action in the move leading to a goal, as mapped by the source (football, covered leagues).",
        "properties": {
          "action": {
            "$ref": "#/components/schemas/BuildUpAction",
            "description": "Type of action performed in this step."
          },
          "side": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Team of the player performing the action (for an own goal, the final step belongs to the defending side)."
          },
          "player": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Player who performed the action."
          },
          "minute": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Minute of the match. Unit: minutes."
          },
          "position": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PitchSpot"
              },
              {
                "type": "null"
              }
            ],
            "description": "Pitch location where the action began."
          },
          "endPosition": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PitchSpot"
              },
              {
                "type": "null"
              }
            ],
            "description": "For a pass / cross: where the ball ended up. Null for other actions."
          },
          "assist": {
            "type": "boolean",
            "description": "True for the pass credited as the assist."
          },
          "bodyPart": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BodyPart"
              },
              {
                "type": "null"
              }
            ],
            "description": "For the goal: the body part used to strike it."
          },
          "expectedGoals": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "For a goal / savedShot: xG value of the chance on a 0–1 scale, if the source provides it."
          },
          "expectedGoalsOnTarget": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "For a goal / savedShot: expected goals on target (xGOT), if available."
          },
          "goalMouthLocation": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/GoalMouthLocation"
              },
              {
                "type": "null"
              }
            ],
            "description": "For the goal: the area of the goal mouth it went into."
          }
        },
        "required": [
          "action",
          "side",
          "player",
          "minute",
          "position",
          "endPosition",
          "assist",
          "bodyPart",
          "expectedGoals",
          "expectedGoalsOnTarget",
          "goalMouthLocation"
        ]
      },
      "PitchSpot": {
        "type": "object",
        "description": "A location on a football pitch.",
        "properties": {
          "x": {
            "type": "number",
            "description": "Lengthwise position from 0 to 100, oriented in the attacking direction of the SCORING side (100 is the goal the ball ended up in, own goals included). For away goals we rotate the source’s coordinates, in which the home side always attacks towards 100 (corrected 2026-10-23). Unit: percent."
          },
          "y": {
            "type": "number",
            "description": "Widthwise position from 0 to 100, rotated together with x (seen from the scoring side). Unit: percent."
          }
        },
        "required": [
          "x",
          "y"
        ]
      },
      "H2H": {
        "type": "object",
        "description": "The record of the two teams against each other; the endpoint answers null when there is none.",
        "properties": {
          "homeWins": {
            "type": "integer",
            "description": "Meetings won by the home team of this fixture."
          },
          "awayWins": {
            "type": "integer",
            "description": "Meetings won by the away team of this fixture."
          },
          "draws": {
            "type": "integer",
            "description": "Number of drawn meetings."
          },
          "managerDuel": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ManagerDuel"
              },
              {
                "type": "null"
              }
            ],
            "description": "How the two managers have fared head to head (football and other sports that have managers). Null if they have never met or the source has no data."
          }
        },
        "required": [
          "homeWins",
          "awayWins",
          "draws",
          "managerDuel"
        ]
      },
      "ManagerDuel": {
        "type": "object",
        "description": "Head-to-head record between the two managers, counting every team either of them has managed.",
        "properties": {
          "homeManager": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ManagerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Manager of the home team in this fixture."
          },
          "awayManager": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ManagerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Manager of the away team."
          },
          "homeWins": {
            "type": "integer",
            "description": "Wins for teams led by the home manager over teams led by the away manager."
          },
          "awayWins": {
            "type": "integer",
            "description": "Wins for the away manager’s teams."
          },
          "draws": {
            "type": "integer",
            "description": "Number of drawn meetings."
          }
        },
        "required": [
          "homeManager",
          "awayManager",
          "homeWins",
          "awayWins",
          "draws"
        ]
      },
      "PregameForm": {
        "type": "object",
        "description": "Form of both sides heading into a fixture. A side is null if the source has no form for it. If only recent matches exist — tennis, for instance, has no competition form guide at the source — `results` is empty and the table figures are null, but `lastFixtures` is filled.",
        "properties": {
          "home": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamForm"
              },
              {
                "type": "null"
              }
            ]
          },
          "away": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamForm"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "home",
          "away"
        ]
      },
      "TeamForm": {
        "type": "object",
        "description": "Pre-match form of a single side.",
        "properties": {
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FormResult"
            },
            "description": "Up to five most recent results in this competition prior to the fixture, ordered from oldest to newest."
          },
          "position": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Table position before the fixture."
          },
          "points": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Points in the table before the fixture, for competitions whose standings use points (football, ice hockey, handball, rugby, …); null otherwise."
          },
          "wins": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Wins going into the fixture, for tables that count wins and losses instead of points (W-L in basketball and baseball, W-D-L in MMA); null otherwise. In MMA it is the source’s tally inside the event’s competition — e.g. Volkanovski at 8-0-3 ahead of UFC 333, with a 28-0-4 career record — not the career record — that lives in TeamDetail.record on /v2/teams/{id}."
          },
          "draws": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Draws, for records that include them (MMA W-D-L); null otherwise."
          },
          "losses": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Losses, set alongside `wins`; null otherwise."
          },
          "avgRating": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Average player rating of the side over its recent matches (2 decimals)."
          },
          "lastFixtures": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FormFixture"
            },
            "description": "The source’s team form, which spans ALL competitions: up to five completed matches played before this fixture, oldest to newest, each carrying opponent, score and result. It differs from `results`, which only covers this competition, and it is filled for tennis too. Empty if the source has nothing, and on forms saved before 2026-11-04 until their next refresh. Available since 2026-11-04."
          }
        },
        "required": [
          "results",
          "position",
          "points",
          "wins",
          "draws",
          "losses",
          "avgRating",
          "lastFixtures"
        ]
      },
      "FormFixture": {
        "type": "object",
        "description": "A recent match played by a side ahead of a fixture, including its score (used in TeamForm.lastFixtures).",
        "properties": {
          "fixtureId": {
            "type": "integer",
            "description": "DataSportsAPI id of that match (GET /v2/fixtures/{id})."
          },
          "startTime": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Start time of the match (UTC)."
          },
          "league": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/LeagueRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Competition the match belonged to, of any type (league, cup, European, friendly)."
          },
          "side": {
            "$ref": "#/components/schemas/Side",
            "description": "Whether the team was home or away in that match."
          },
          "opponent": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "The opposing team."
          },
          "scoreFor": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Score the team achieved, equal to its side’s Fixture score `current` (goals, points; sets in tennis)."
          },
          "scoreAgainst": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Score of the opposing team."
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FormResult"
              },
              {
                "type": "null"
              }
            ],
            "description": "Outcome for the team as interpreted by the source; matches settled in overtime or on penalties count as a win for the side that prevailed."
          }
        },
        "required": [
          "fixtureId",
          "startTime",
          "league",
          "side",
          "opponent",
          "scoreFor",
          "scoreAgainst",
          "result"
        ]
      },
      "Streaks": {
        "type": "object",
        "description": "Runs of form for both teams heading into a fixture.",
        "properties": {
          "general": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Streak"
            },
            "description": "For both sides, the streaks that run through their latest matches in every competition before this fixture. After the final whistle it keeps the streaks the match was played with."
          },
          "headToHead": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Streak"
            },
            "description": "Streaks drawn from matches between the two sides."
          }
        },
        "required": [
          "general",
          "headToHead"
        ]
      },
      "Streak": {
        "type": "object",
        "description": "A noteworthy team streak to highlight before a fixture.",
        "properties": {
          "name": {
            "type": "string",
            "description": "English description of the streak, such as \"Wins\", \"No losses\" or \"More than 2.5 goals\". Display text only, since the source provides no stable key."
          },
          "kind": {
            "$ref": "#/components/schemas/StreakKind",
            "description": "How to read the figure: an average, a consecutive run, or x out of the last y."
          },
          "value": {
            "type": "string",
            "description": "The figure exactly as the source formats it: \"5\" for five in a row, \"7/8\" when seven of the last eight qualified, \"83\" for an average."
          },
          "count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of matches for which the streak holds (the 5 in \"5\", the 7 in \"7/8\"); null for an average."
          },
          "outOf": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "The y in an \"x of the last y\" streak; null for consecutive runs and averages."
          },
          "average": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "For kind average, the value itself (83 points a game); null otherwise."
          },
          "side": {
            "$ref": "#/components/schemas/StreakSide",
            "description": "Which team the streak belongs to."
          },
          "continued": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True if the streak is still active."
          }
        },
        "required": [
          "name",
          "kind",
          "value",
          "count",
          "outOf",
          "average",
          "side",
          "continued"
        ]
      },
      "BestPlayers": {
        "type": "object",
        "description": "Top performers for each team.",
        "properties": {
          "playerOfTheMatch": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BestPlayer"
              },
              {
                "type": "null"
              }
            ],
            "description": "The player of the match, in sports that award one."
          },
          "home": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BestPlayer"
            }
          },
          "away": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BestPlayer"
            }
          }
        },
        "required": [
          "playerOfTheMatch",
          "home",
          "away"
        ]
      },
      "BestPlayer": {
        "type": "object",
        "description": "One of the standout players in a match.",
        "properties": {
          "player": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Player reference."
          },
          "value": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Figure the ranking is based on (a rating, points, goals, yards). Null in baseball, where the list simply follows the source’s ordering (best first) without a figure we can account for."
          },
          "label": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BestPlayerLabel"
              },
              {
                "type": "null"
              }
            ],
            "description": "Describes what `value` measures."
          },
          "statistics": {
            "anyOf": [
              {
                "type": "object",
                "additionalProperties": {
                  "type": "number"
                }
              },
              {
                "type": "null"
              }
            ],
            "description": "Basketball: the player’s stat line, using the same keys as lineup statistics (points, rebounds, assists, steals, blocks, rating). For baseball, available since 2026-11-04, the numbers — pitching or batting — that got the player picked (pitchingInningsPitched, pitchingStrikeOuts, battingHits, battingHomeRuns, battingRbi, …). Null in any sport where the source lists nothing."
          },
          "role": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BestPlayerRole"
              },
              {
                "type": "null"
              }
            ],
            "description": "Baseball (since 2026-11-04): pitcher or batter, i.e. the role the player was picked for; null for every other sport."
          }
        },
        "required": [
          "player",
          "value",
          "label",
          "statistics",
          "role"
        ]
      },
      "Momentum": {
        "type": "object",
        "description": "Values for drawing a momentum chart: one per game in tennis, one per minute in football, basketball, handball, ice hockey and the like.",
        "properties": {
          "points": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "minute": {
                  "type": "number"
                },
                "addedMinute": {
                  "anyOf": [
                    {
                      "type": "integer"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "value": {
                  "type": "number"
                }
              },
              "required": [
                "minute",
                "addedMinute",
                "value"
              ]
            },
            "description": "One value for every minute, in match order; points in added time come after the final minute of their period."
          },
          "periodLengthMinutes": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "How long one regulation period lasts — 45 minutes in football, 10 in basketball, 20 in ice hockey. Unit: minutes."
          },
          "periodCount": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of regulation periods."
          },
          "overtimeLengthMinutes": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Duration of a single overtime period. Unit: minutes."
          },
          "overtimeCount": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "How many overtime periods were played, if the source reports it."
          },
          "games": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "period": {
                  "$ref": "#/components/schemas/PeriodKey"
                },
                "game": {
                  "type": "integer"
                },
                "value": {
                  "type": "number"
                },
                "breakOfServe": {
                  "type": "boolean"
                }
              },
              "required": [
                "period",
                "game",
                "value",
                "breakOfServe"
              ]
            },
            "description": "Tennis: a value for each game in sequence (minute points stay empty). Empty in other sports."
          }
        },
        "required": [
          "points",
          "periodLengthMinutes",
          "periodCount",
          "overtimeLengthMinutes",
          "overtimeCount",
          "games"
        ]
      },
      "Shot": {
        "type": "object",
        "description": "A single shot attempt (football, ice hockey, basketball field goals). Lists run chronologically, oldest first, with shoot-out kicks at the end in kick order. Basketball is the exception: the source gives no timing, so home shots come before away shots in the source’s order, and only side, outcome and position are filled.",
        "properties": {
          "side": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Team that took the shot."
          },
          "player": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Player who took the shot."
          },
          "goalkeeper": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Football: the opposing goalkeeper."
          },
          "outcome": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ShotOutcome"
              },
              {
                "type": "null"
              }
            ],
            "description": "Result of the shot."
          },
          "technique": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ShotTechnique"
              },
              {
                "type": "null"
              }
            ],
            "description": "Ice hockey: type of shot."
          },
          "goalType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ShotGoalType"
              },
              {
                "type": "null"
              }
            ],
            "description": "Set on goals only: regular, ownGoal or penalty."
          },
          "situation": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ShotSituation"
              },
              {
                "type": "null"
              }
            ],
            "description": "Football: the phase of play that produced the shot."
          },
          "bodyPart": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BodyPart"
              },
              {
                "type": "null"
              }
            ],
            "description": "Football: body part used to strike the ball."
          },
          "strength": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ShotStrength"
              },
              {
                "type": "null"
              }
            ],
            "description": "Ice hockey: the manpower situation at the time."
          },
          "expectedGoals": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "xG value of the chance on a 0–1 scale."
          },
          "expectedGoalsOnTarget": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Football: post-shot expected goals (xGOT), set for shots on target."
          },
          "minute": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Minute of the match. Unit: minutes."
          },
          "addedMinute": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "How far into stoppage time the shot came. Unit: minutes."
          },
          "second": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Game clock reading in seconds. Unit: seconds."
          },
          "period": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PeriodKey"
              },
              {
                "type": "null"
              }
            ],
            "description": "Period in which the shot came. In football the minute decides it (shoot-out kicks → penalties, 45+2 → period1, 92 → extra1); basketball has no timing, so it stays null."
          },
          "position": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Point"
              },
              {
                "type": "null"
              }
            ],
            "description": "Where the shot was taken from. Football: pitch percentages 0–100, with x measured from the goal line under attack and y across the pitch. Ice hockey: x roughly 0–240 along the ice (rink units from the source, each side attacking one end) and y covering 0–100 from side to side. Basketball: tenths of a foot measured from the basket being attacked; x runs across the court (−250…250 sideline to sideline), y away from the basket (0 is the rim, and the NBA three-point arc sits at 237.5)."
          },
          "goalMouth": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Point"
              },
              {
                "type": "null"
              }
            ],
            "description": "Football: point at which the ball crossed the goal line (y 0–100 across the goal mouth, z for height)."
          },
          "goalMouthLocation": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/GoalMouthLocation"
              },
              {
                "type": "null"
              }
            ],
            "description": "Football: zone of the goal mouth the shot reached, or of the near miss."
          },
          "blockPosition": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Point"
              },
              {
                "type": "null"
              }
            ],
            "description": "Football: the point at which a blocked or saved shot was halted."
          },
          "shootoutSequence": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Football shoot-out kicks: where the kick falls in the combined order of both teams (the same numbering the shoot-out incidents use)."
          },
          "shootoutRound": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Football shoot-out kicks: which of the shooting side’s kicks this was (1st, 2nd, …)."
          }
        },
        "required": [
          "side",
          "player",
          "goalkeeper",
          "outcome",
          "technique",
          "goalType",
          "situation",
          "bodyPart",
          "strength",
          "expectedGoals",
          "expectedGoalsOnTarget",
          "minute",
          "addedMinute",
          "second",
          "period",
          "position",
          "goalMouth",
          "goalMouthLocation",
          "blockPosition",
          "shootoutSequence",
          "shootoutRound"
        ]
      },
      "Point": {
        "type": "object",
        "description": "A coordinate pair; see Shot for each sport’s coordinate system.",
        "properties": {
          "x": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "y": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "z": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "x",
          "y",
          "z"
        ]
      },
      "Heatmap": {
        "type": "object",
        "description": "Activity map of one player across a fixture (football, covered leagues).",
        "properties": {
          "points": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/HeatPoint"
            },
            "description": "All recorded samples, meant to be drawn as a density map. If the source has no heatmap for this player and fixture — always so outside football — the list comes back empty with 200, not 404."
          }
        },
        "required": [
          "points"
        ]
      },
      "HeatPoint": {
        "type": "object",
        "description": "A single touch or position sample within a heatmap.",
        "properties": {
          "x": {
            "type": "number",
            "description": "Lengthwise position from 0 to 100, oriented in the player’s attacking direction (100 is the goal being attacked). Unit: percent."
          },
          "y": {
            "type": "number",
            "description": "Widthwise position from 0 to 100. Unit: percent."
          }
        },
        "required": [
          "x",
          "y"
        ]
      },
      "AveragePositions": {
        "type": "object",
        "description": "Mean on-pitch positions of every player on both sides (football, covered leagues).",
        "properties": {
          "home": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AveragePosition"
            }
          },
          "away": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AveragePosition"
            }
          }
        },
        "required": [
          "home",
          "away"
        ]
      },
      "AveragePosition": {
        "type": "object",
        "description": "Where a player was positioned on average during a fixture.",
        "properties": {
          "player": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Player reference."
          },
          "jerseyNumber": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The player’s shirt number."
          },
          "position": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Position"
              },
              {
                "type": "null"
              }
            ],
            "description": "Position as used in lineups, derived from `positionCode`."
          },
          "positionCode": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Single-letter position code from the source (\"G\", \"D\", \"M\", \"F\")."
          },
          "x": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Mean lengthwise position from 0 to 100, oriented in the team’s attacking direction. Unit: percent."
          },
          "y": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Mean widthwise position from 0 to 100. Unit: percent."
          },
          "pointsCount": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of position samples the average is computed from."
          }
        },
        "required": [
          "player",
          "jerseyNumber",
          "position",
          "positionCode",
          "x",
          "y",
          "pointsCount"
        ]
      },
      "Points": {
        "type": "object",
        "description": "A fixture’s point-by-point record, shaped by sport: sets → games → points in tennis, sets → rallies in rally sports, innings → overs → balls in cricket, at-bats in baseball, and sets → legs → visits in darts.",
        "properties": {
          "format": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PointsFormat"
              },
              {
                "type": "null"
              }
            ],
            "description": "Names the list among `sets` / `innings` / `atBats` / `darts` that has data. Null until something arrives, and in sports without any point-by-point data — those get 200 with empty lists rather than 404."
          },
          "sets": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PointSet"
            },
            "description": "Tennis and rally sports: an entry for each set, in sequence."
          },
          "innings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/InningsBalls"
            },
            "description": "Cricket: an entry for each innings, in sequence."
          },
          "atBats": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AtBat"
            },
            "description": "Baseball: all plate appearances in chronological order, oldest first."
          },
          "darts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DartsSet"
            },
            "description": "Darts: nested sets → legs → visits, in sequence."
          }
        },
        "required": [
          "format",
          "sets",
          "innings",
          "atBats",
          "darts"
        ]
      },
      "PointSet": {
        "type": "object",
        "description": "Point-by-point detail of a single set.",
        "properties": {
          "period": {
            "$ref": "#/components/schemas/PeriodKey",
            "description": "Which set this is: period1, period2, …"
          },
          "homeScore": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Games (tennis) or points (rally sports) the home side won in the set, taken from the final listed score. For a tennis match tie-break the points are counted (10-8), consistent with the fixture’s period score."
          },
          "awayScore": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Games / points the away side won in the set."
          },
          "games": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TennisGame"
            },
            "description": "Tennis: each game in sequence. Empty for rally sports."
          },
          "points": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RallyPoint"
            },
            "description": "Rally sports: each rally in sequence as recorded by the source. Lower-tier coverage may skip a rally, which shows up as a jump in the running score. Empty for tennis."
          }
        },
        "required": [
          "period",
          "homeScore",
          "awayScore",
          "games",
          "points"
        ]
      },
      "TennisGame": {
        "type": "object",
        "description": "A single game within a tennis set.",
        "properties": {
          "number": {
            "type": "integer",
            "description": "Position of the game in the set (13 is the tie-break). When a match tie-break stands in for the deciding set, it is that set’s game 1, played to 10 points."
          },
          "server": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "The serving side. For a tie-break the source reports whoever served its LAST point rather than its first (verified against real tie-breaks on 2026-10-19)."
          },
          "winner": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Side that took the game; if it differs from the server, serve was broken. For a completed tie-break we take the winner from its final point, because in a check on 2026-10-19 the source had the wrong game winner on 3 of 8 match tie-breaks."
          },
          "homeGames": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Games won by the home side in the set once this game is over."
          },
          "awayGames": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Games won by the away side in the set once this game is over."
          },
          "points": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TennisPoint"
            },
            "description": "Each point in sequence. For a completed game the final point is the one that decided it (its `winner` matches the game’s winner); for a game still under way, the points played so far."
          }
        },
        "required": [
          "number",
          "server",
          "winner",
          "homeGames",
          "awayGames",
          "points"
        ]
      },
      "TennisPoint": {
        "type": "object",
        "description": "A single point within a tennis game.",
        "properties": {
          "homeScore": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Home side’s game score following the point: \"0\", \"15\", \"30\", \"40\", \"A\" (plain numbers in a tie-break). It is a string to accommodate \"A\". Null on the point that closes a regular game, since no score exists once the game is over."
          },
          "awayScore": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Away side’s game score following the point; null in the same case as `homeScore`."
          },
          "winner": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Side that won the point, inferred from how the score changed; null if that cannot be inferred."
          },
          "description": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TennisPointDescription"
              },
              {
                "type": "null"
              }
            ],
            "description": "Marks an ace or a double fault; null for all other points and for the game-winning point we append. The source does not list that final point, so an ace that closes a game goes unmarked."
          },
          "homeType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TennisPointType"
              },
              {
                "type": "null"
              }
            ],
            "description": "What the point means for the home side (point won, now holding break or set point, mini-break in a tie-break). Null on the game-winning point added at the end."
          },
          "awayType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TennisPointType"
              },
              {
                "type": "null"
              }
            ],
            "description": "Significance of the point for the away side, as for homeType."
          }
        },
        "required": [
          "homeScore",
          "awayScore",
          "winner",
          "description",
          "homeType",
          "awayType"
        ]
      },
      "RallyPoint": {
        "type": "object",
        "description": "A single rally within a set (volleyball, table tennis, badminton).",
        "properties": {
          "winner": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Side that won the rally."
          },
          "homeScore": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Home side’s points in the set following the rally."
          },
          "awayScore": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Away side’s points in the set following the rally."
          }
        },
        "required": [
          "winner",
          "homeScore",
          "awayScore"
        ]
      },
      "InningsBalls": {
        "type": "object",
        "description": "Ball-by-ball record of a single cricket innings.",
        "properties": {
          "inning": {
            "$ref": "#/components/schemas/PeriodKey",
            "description": "Innings key (inning1, inning2, …), matching ScoreSide.innings."
          },
          "battingSide": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Side at bat during this innings."
          },
          "overs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Over"
            },
            "description": "Each over in sequence."
          }
        },
        "required": [
          "inning",
          "battingSide",
          "overs"
        ]
      },
      "Over": {
        "type": "object",
        "description": "A single over within an innings.",
        "properties": {
          "number": {
            "type": "integer",
            "description": "Over number, starting at 1 for the opening over. Cricket notation counts completed overs instead, so the 3rd ball of over 46 reads \"45.3\"."
          },
          "balls": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Ball"
            },
            "description": "Each delivery in sequence."
          }
        },
        "required": [
          "number",
          "balls"
        ]
      },
      "Ball": {
        "type": "object",
        "description": "A single cricket delivery.",
        "properties": {
          "sequence": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Running delivery counter from the source across the whole match, useful for ordering deliveries between overs."
          },
          "ball": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Delivery number inside the over; extras can take it above 6."
          },
          "outcome": {
            "$ref": "#/components/schemas/BallOutcome",
            "description": "Result of the delivery."
          },
          "runs": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Runs scored off the bat."
          },
          "totalRuns": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "All runs the delivery contributed, extras included."
          },
          "wicket": {
            "type": "boolean",
            "description": "True if a wicket fell on this ball."
          },
          "dismissal": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Dismissal"
              },
              {
                "type": "null"
              }
            ],
            "description": "Manner of dismissal, when a wicket fell."
          },
          "batter": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Batter facing the delivery."
          },
          "bowler": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Bowler who delivered the ball."
          },
          "fielder": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Fielder who took part in a dismissal (catch, run-out, stumping)."
          },
          "dismissedBatter": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Batter who was dismissed, which is not always the striker (run-outs)."
          },
          "scoreRuns": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Batting side’s total runs once the delivery is complete."
          },
          "scoreWickets": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Wickets fallen once the delivery is complete."
          },
          "commentary": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "English ball-by-ball commentary for the delivery, verbatim from the source — e.g. \"FOUR! … driven firmly through the covers\". Null if the source has none (lower-tier matches, or deliveries stored before 2026-11-04). Available since 2026-11-04."
          },
          "shot": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CricketShot"
              },
              {
                "type": "null"
              }
            ],
            "description": "Direction the ball travelled off the bat, as plotted on a wagon wheel. Null if the source records no direction (an unhit dot ball, a leave, a bye; lower-tier matches). Available since 2026-11-04."
          },
          "pitchedAt": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Point"
              },
              {
                "type": "null"
              }
            ],
            "description": "Landing spot of the ball for a pitch map, in the source’s units: y increases with distance from the batter’s stumps (yorker ≈ 25, good length ≈ 41, short ball ≈ 54) and x spans the width of the pitch (values of ≈ 6–26 observed); z is always null. Null if the source has no data. Available since 2026-11-04."
          }
        },
        "required": [
          "sequence",
          "ball",
          "outcome",
          "runs",
          "totalRuns",
          "wicket",
          "dismissal",
          "batter",
          "bowler",
          "fielder",
          "dismissedBatter",
          "scoreRuns",
          "scoreWickets",
          "commentary",
          "shot",
          "pitchedAt"
        ]
      },
      "CricketShot": {
        "type": "object",
        "description": "Direction and distance of a cricket shot, forming one line on the wagon wheel.",
        "properties": {
          "zone": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CricketShotZone"
              },
              {
                "type": "null"
              }
            ],
            "description": "Field sector of the shot; null if the source provides only an angle."
          },
          "angle": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Shot direction in degrees in the source’s reference frame, seen from a right-handed batter: 0 ≈ square leg, 90 ≈ right behind the keeper, 180 ≈ point, 270 ≈ straight back down the pitch. Unit: degrees."
          },
          "distance": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "How far the ball went, on a 1–5 scale set by the source: 1–2 near the bat (say, back to the bowler or edged to the keeper), 3 the ring, 4 the deep, 5 the boundary — every four and six. We inferred these bands from the data on 2026-11-04; the source does not document them."
          }
        },
        "required": [
          "zone",
          "angle",
          "distance"
        ]
      },
      "AtBat": {
        "type": "object",
        "description": "A single baseball plate appearance. The at-bat list has no outcome field; the result is that of the final pitch (`/at-bats/{atBatId}/pitches`).",
        "properties": {
          "id": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "DataSportsAPI id of the at-bat, for use with /v2/fixtures/{id}/at-bats/{atBatId}/pitches. Present since 2026-11-04; lists saved before then show null."
          },
          "inning": {
            "type": "integer",
            "description": "Inning number (10, 11, … indicate extra innings)."
          },
          "half": {
            "type": "string",
            "enum": [
              "top",
              "bottom"
            ],
            "description": "top: the away team is batting; bottom: the home team is batting."
          },
          "battingSide": {
            "$ref": "#/components/schemas/Side",
            "description": "Side at bat, derived from the half."
          },
          "batter": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Batter reference."
          },
          "pitcher": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Pitcher reference."
          },
          "homeWinProbabilityBefore": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Home win probability before the at-bat on a 0–100 scale, as calculated by the SOURCE (not a DataSportsAPI model, and not bookmaker odds). Unit: percent."
          },
          "homeWinProbabilityAfter": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Home win probability after the at-bat according to the source, 0–100; the away probability is 100 − home. Unit: percent."
          },
          "at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Time the at-bat was recorded."
          }
        },
        "required": [
          "id",
          "inning",
          "half",
          "battingSide",
          "batter",
          "pitcher",
          "homeWinProbabilityBefore",
          "homeWinProbabilityAfter",
          "at"
        ]
      },
      "DartsSet": {
        "type": "object",
        "description": "A single set in darts; a match played in legs consists of one set.",
        "properties": {
          "number": {
            "type": "integer",
            "description": "Set number, always 1 in a legs match."
          },
          "winner": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Winner of the set; null in a match played in legs and while the set is still going."
          },
          "homeSets": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Sets won by the home side once this set is over; null in a legs match."
          },
          "awaySets": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Sets won by the away side once this set is over; null in a legs match."
          },
          "legs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DartsLeg"
            },
            "description": "Each leg in sequence."
          }
        },
        "required": [
          "number",
          "winner",
          "homeSets",
          "awaySets",
          "legs"
        ]
      },
      "DartsLeg": {
        "type": "object",
        "description": "A single darts leg broken down visit by visit.",
        "properties": {
          "number": {
            "type": "integer",
            "description": "Leg number inside the set (in a legs match, the whole match is one set)."
          },
          "startScore": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Starting score for each player in the leg (501), as listed by the source."
          },
          "throwingFirst": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Side that threw first in the leg according to the source (the throw alternates between legs). The visit list may still open with the other player; this has been seen once on a first leg."
          },
          "winner": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Side that won the leg; null while it is still being played."
          },
          "homeLegs": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Legs won by the home side in the set once this leg is over."
          },
          "awayLegs": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Legs won by the away side in the set once this leg is over."
          },
          "checkout": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Score of the visit that won the leg (the checkout); null while the leg is in progress or if the final visit is missing."
          },
          "visits": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DartsVisit"
            },
            "description": "Each visit in sequence."
          }
        },
        "required": [
          "number",
          "startScore",
          "throwingFirst",
          "winner",
          "homeLegs",
          "awayLegs",
          "checkout",
          "visits"
        ]
      },
      "DartsVisit": {
        "type": "object",
        "description": "One player’s turn at the board: a visit of up to three darts. The source does not report how many darts were thrown.",
        "properties": {
          "side": {
            "$ref": "#/components/schemas/Side",
            "description": "Side that threw."
          },
          "scored": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Points scored in the visit, computed as the thrower’s remaining score before minus after. 0 covers both a scoreless visit and a bust, which the source does not distinguish. Null if the drop is impossible for one visit (over 180, meaning the source skipped a visit)."
          },
          "homeRemaining": {
            "type": "integer",
            "description": "Home side’s remaining score once the visit is done."
          },
          "awayRemaining": {
            "type": "integer",
            "description": "Away side’s remaining score once the visit is done."
          },
          "checkout": {
            "type": "boolean",
            "description": "True if this visit won the leg by bringing the thrower to 0; `scored` then holds the checkout."
          }
        },
        "required": [
          "side",
          "scored",
          "homeRemaining",
          "awayRemaining",
          "checkout"
        ]
      },
      "Bases": {
        "type": "object",
        "description": "Baseball: occupancy of each base.",
        "properties": {
          "first": {
            "type": "boolean",
            "description": "True when first base is occupied."
          },
          "second": {
            "type": "boolean",
            "description": "True when second base is occupied."
          },
          "third": {
            "type": "boolean",
            "description": "True when third base is occupied."
          }
        },
        "required": [
          "first",
          "second",
          "third"
        ]
      },
      "InningState": {
        "type": "object",
        "description": "Baseball: the current game situation — inning, half, count, outs and runners. It contains no batter or pitcher because the source does not provide them here; find the current at-bat’s in /points `atBats`. The source’s live feed refreshes this state roughly once a minute rather than after each pitch, so the count may trail the game by up to a minute.",
        "properties": {
          "inning": {
            "type": "integer",
            "description": "Current inning (10, 11, … indicate extra innings)."
          },
          "half": {
            "type": "string",
            "enum": [
              "top",
              "bottom"
            ],
            "description": "top: the away team is batting; bottom: the home team is batting."
          },
          "battingSide": {
            "$ref": "#/components/schemas/Side",
            "description": "Side at bat, derived from the half."
          },
          "balls": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of balls in the current count."
          },
          "strikes": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of strikes in the current count."
          },
          "outs": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Outs recorded in the half-inning; 3 means the half has just finished."
          },
          "bases": {
            "$ref": "#/components/schemas/Bases",
            "description": "Occupancy of each base."
          }
        },
        "required": [
          "inning",
          "half",
          "battingSide",
          "balls",
          "strikes",
          "outs",
          "bases"
        ]
      },
      "Timeouts": {
        "type": "object",
        "description": "Basketball: remaining timeouts for each side, as tracked by the source.",
        "properties": {
          "homeRemaining": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Timeouts still available to the home side."
          },
          "awayRemaining": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Timeouts still available to the away side."
          },
          "perTeam": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Timeouts each side is allotted for the game (7 in the NBA)."
          }
        },
        "required": [
          "homeRemaining",
          "awayRemaining",
          "perTeam"
        ]
      },
      "CurrentTyre": {
        "type": "object",
        "description": "Tyres currently fitted to a car (available since 2026-11-09).",
        "properties": {
          "compound": {
            "$ref": "#/components/schemas/TyreCompound",
            "description": "Tyre compound."
          },
          "isNew": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True for a fresh set, false for a used one; null if the source does not specify."
          }
        },
        "required": [
          "compound",
          "isNew"
        ]
      },
      "DragonsByType": {
        "type": "object",
        "description": "League of Legends: count of elemental dragons killed, split by element (available since 2026-11-09).",
        "properties": {
          "chemtech": {
            "type": "integer",
            "description": "Number of Chemtech dragons killed."
          },
          "cloud": {
            "type": "integer",
            "description": "Number of Cloud dragons killed."
          },
          "hextech": {
            "type": "integer",
            "description": "Number of Hextech dragons killed."
          },
          "infernal": {
            "type": "integer",
            "description": "Number of Infernal dragons killed."
          },
          "mountain": {
            "type": "integer",
            "description": "Number of Mountain dragons killed."
          },
          "ocean": {
            "type": "integer",
            "description": "Number of Ocean dragons killed."
          }
        },
        "required": [
          "chemtech",
          "cloud",
          "hextech",
          "infernal",
          "mountain",
          "ocean"
        ]
      },
      "DownAndDistance": {
        "type": "object",
        "description": "American football: current down, distance and field position as tracked by the source (available since 2026-11-09). The live feed pushes an update after every play; fields not included in an update keep their previous value.",
        "properties": {
          "down": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "The down in play (1–4); null on a kickoff and on the try that follows a touchdown."
          },
          "yardsToGo": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Yards needed for a first down (or to the goal line when goalToGo); null when there is no down."
          },
          "possession": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Side in possession of the ball."
          },
          "ballOn": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Half of the field the ball is in; combined with yardLine, \"home 35\" means the home side’s 35-yard line."
          },
          "yardLine": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Yard line within that half (50 is midfield)."
          },
          "goalToGo": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True if the goal line is the line to gain (the source calls it isGoalPossession)."
          },
          "playType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DownPlayType"
              },
              {
                "type": "null"
              }
            ],
            "description": "Kind of play the ball is set up for: scrimmage play, kickoff or try."
          }
        },
        "required": [
          "down",
          "yardsToGo",
          "possession",
          "ballOn",
          "yardLine",
          "goalToGo",
          "playType"
        ]
      },
      "VarCheck": {
        "type": "object",
        "description": "Football: an ongoing video (VAR) review (available since 2026-11-09).",
        "properties": {
          "side": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Side whose incident (a goal, a penalty, a card) is being reviewed, if the source specifies it; null when it does not name one."
          }
        },
        "required": [
          "side"
        ]
      },
      "BasketballBonus": {
        "type": "object",
        "description": "Basketball: bonus (penalty situation) status for each side, as reported by the source (available since 2026-11-09).",
        "properties": {
          "home": {
            "type": "boolean",
            "description": "True when the home side is in the bonus, so the away side’s next team foul awards it free throws."
          },
          "away": {
            "type": "boolean",
            "description": "True when the away side is in the bonus."
          }
        },
        "required": [
          "home",
          "away"
        ]
      },
      "MatchFormat": {
        "type": "object",
        "description": "Length of the match in sets / legs / games, if the source states it.",
        "properties": {
          "bestOfSets": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Darts: number of sets in the format (\"best of 5 sets\"); 1 indicates a legs match without sets."
          },
          "bestOfLegs": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Darts: legs per set if `bestOfSets` > 1, otherwise legs in the whole match (\"best of 7 legs\")."
          },
          "bestOfGames": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Esports: how many games (maps) the series is played over (\"best of 3\")."
          }
        },
        "required": [
          "bestOfSets",
          "bestOfLegs",
          "bestOfGames"
        ]
      },
      "Umpires": {
        "type": "object",
        "description": "Baseball only: the umpires working a game.",
        "properties": {
          "umpires": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Umpire"
            },
            "description": "Crew members in the source’s order, starting with home plate; empty if the source lists none and in other sports."
          }
        },
        "required": [
          "umpires"
        ]
      },
      "Umpire": {
        "type": "object",
        "description": "A single umpire working a baseball game.",
        "properties": {
          "name": {
            "type": "string",
            "description": "Umpire’s full name in the source’s spelling."
          },
          "position": {
            "$ref": "#/components/schemas/UmpirePosition",
            "description": "Umpire’s station for this game."
          },
          "experienceYears": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Experience in years, according to the source."
          }
        },
        "required": [
          "name",
          "position",
          "experienceYears"
        ]
      },
      "Weather": {
        "type": "object",
        "description": "Baseball: conditions at the ballpark. The source reports weather for baseball alone, so other sports return an empty list. The source reports in °F and mph; we convert to metric (58 °F → 14.44 °C, 5 mph → 8.05 km/h). For a stadium with a roof, the reported weather is still the outdoor one.",
        "properties": {
          "observations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/WeatherObservation"
            },
            "description": "Measured and forecast conditions in the source’s order, with the observation first; empty if the source has none and in other sports."
          }
        },
        "required": [
          "observations"
        ]
      },
      "WeatherObservation": {
        "type": "object",
        "description": "Weather conditions at a venue at a given moment.",
        "properties": {
          "at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "When the observation was made — or, for a forecast, when it was issued."
          },
          "forecast": {
            "type": "boolean",
            "description": "True if this is a forecast, false if it is a measured observation."
          },
          "condition": {
            "$ref": "#/components/schemas/WeatherCondition",
            "description": "Broad weather category."
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Conditions as worded by the source (\"Overcast\"). For display only."
          },
          "temperatureC": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Temperature of the air in °C. Unit: celsius."
          },
          "dewPointC": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Dew-point temperature in °C. Unit: celsius."
          },
          "humidityPercent": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Relative humidity on a 0–100 scale. Unit: percent."
          },
          "cloudCoverPercent": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Share of the sky covered by cloud, 0–100. Unit: percent."
          },
          "windSpeedKmh": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Speed of the wind in km/h. Unit: kilometersPerHour."
          },
          "windDirection": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Compass point the wind blows from (\"SE\", \"SSE\")."
          }
        },
        "required": [
          "at",
          "forecast",
          "condition",
          "description",
          "temperatureC",
          "dewPointC",
          "humidityPercent",
          "cloudCoverPercent",
          "windSpeedKmh",
          "windDirection"
        ]
      },
      "EsportsGames": {
        "type": "object",
        "description": "Esports: a game-by-game breakdown of a fixture, with map, winner and score, lineups including K/D/A, bans and objectives.",
        "properties": {
          "games": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EsportsGame"
            },
            "description": "Each game in sequence; empty before the first game starts and in other sports."
          }
        },
        "required": [
          "games"
        ]
      },
      "EsportsGame": {
        "type": "object",
        "description": "A single game (map) within an esports series.",
        "properties": {
          "number": {
            "type": "integer",
            "description": "Position of the game in the series (1, 2, …)."
          },
          "status": {
            "type": "string",
            "enum": [
              "notstarted",
              "inprogress",
              "interrupted",
              "willcontinue",
              "postponed",
              "canceled",
              "finished"
            ],
            "description": "Status type of this game (finished, inprogress, notstarted, …)."
          },
          "map": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Map played (\"Dust2\"); null for single-map titles (League of Legends)."
          },
          "startedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Start time of the game."
          },
          "durationSeconds": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "How long the game lasted. Unit: seconds."
          },
          "winner": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Side that won the game; null until it ends."
          },
          "home": {
            "$ref": "#/components/schemas/EsportsGameSide",
            "description": "Home side’s data for this game."
          },
          "away": {
            "$ref": "#/components/schemas/EsportsGameSide",
            "description": "Away side’s data for this game."
          },
          "homeStartingSide": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CsSide"
              },
              {
                "type": "null"
              }
            ],
            "description": "Counter-Strike: which side the home team opened the map on; null for other titles. Available since 2026-11-04."
          },
          "rounds": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EsportsRound"
            },
            "description": "Counter-Strike: the rounds so far, in order, with winner, how it ended and which side the home team was on. Empty for other titles, and until the source lists them (it adds a map’s rounds while they are played). Available since 2026-11-04."
          },
          "roundsPerHalf": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Counter-Strike: rounds per regulation half (12 under MR12); null if unspecified."
          },
          "overtimeRoundsPerHalf": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Counter-Strike: how many rounds an overtime half has (3 under MR3); null without overtime."
          }
        },
        "required": [
          "number",
          "status",
          "map",
          "startedAt",
          "durationSeconds",
          "winner",
          "home",
          "away",
          "homeStartingSide",
          "rounds",
          "roundsPerHalf",
          "overtimeRoundsPerHalf"
        ]
      },
      "EsportsRound": {
        "type": "object",
        "description": "Counter-Strike: a single round on a map.",
        "properties": {
          "number": {
            "type": "integer",
            "description": "Round number within the game, starting at 1; overtime rounds carry on the same count."
          },
          "overtime": {
            "type": "boolean",
            "description": "True for an overtime round."
          },
          "winner": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Side that won the round."
          },
          "outcome": {
            "$ref": "#/components/schemas/CsRoundOutcome",
            "description": "The way the round was decided."
          },
          "homeSide": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CsSide"
              },
              {
                "type": "null"
              }
            ],
            "description": "Side the home team played on in this round (the away team had the opposite one); null if the source does not specify."
          }
        },
        "required": [
          "number",
          "overtime",
          "winner",
          "outcome",
          "homeSide"
        ]
      },
      "RaceCareer": {
        "type": "object",
        "description": "Racing: the career history of a driver or constructor (GET /v2/teams/{id}/race-career).",
        "properties": {
          "totals": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/RaceCareerTotals"
              },
              {
                "type": "null"
              }
            ],
            "description": "Aggregated career figures; null if the source has none."
          },
          "seasons": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RaceCareerSeason"
            },
            "description": "One entry per season, most recent first."
          }
        },
        "required": [
          "totals",
          "seasons"
        ]
      },
      "PenaltyHistory": {
        "type": "object",
        "description": "Penalty record of a player for a single league season (GET /v2/players/{id}/penalties).",
        "properties": {
          "scored": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Penalties converted during the league season."
          },
          "attempts": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Total penalties attempted."
          },
          "penalties": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PenaltyKick"
            },
            "description": "Every penalty taken, in chronological order (oldest first)."
          }
        },
        "required": [
          "scored",
          "attempts",
          "penalties"
        ]
      },
      "PenaltyKick": {
        "type": "object",
        "description": "A single penalty taken by a player (football).",
        "properties": {
          "fixtureId": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Fixture in which the penalty was taken."
          },
          "startTime": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Start time of that fixture."
          },
          "outcome": {
            "$ref": "#/components/schemas/ShotOutcome",
            "description": "Result of the kick: goal, save, miss or post."
          },
          "goalMouthLocation": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/GoalMouthLocation"
              },
              {
                "type": "null"
              }
            ],
            "description": "Where the ball finished relative to the goal, from the taker’s perspective."
          },
          "goalMouth": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Point"
              },
              {
                "type": "null"
              }
            ],
            "description": "Point at which the ball crossed the goal line, on 0–100 axes following the source’s drawing of the goal; null if not provided."
          },
          "expectedGoals": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Expected-goals value of the penalty (roughly 0.79)."
          }
        },
        "required": [
          "fixtureId",
          "startTime",
          "outcome",
          "goalMouthLocation",
          "goalMouth",
          "expectedGoals"
        ]
      },
      "SeasonDay": {
        "type": "object",
        "description": "A date in a league season that has fixtures (GET /v2/leagues/{id}/calendar).",
        "properties": {
          "date": {
            "type": "string",
            "format": "date",
            "description": "Calendar day of the season, in UTC."
          },
          "fixtureCount": {
            "type": "integer",
            "description": "Number of the league season’s fixtures on that day."
          }
        },
        "required": [
          "date",
          "fixtureCount"
        ]
      },
      "PlayerOfTheSeasonWinner": {
        "type": "object",
        "description": "The player of the season named for a league in a past season.",
        "properties": {
          "player": {
            "$ref": "#/components/schemas/PlayerRef",
            "description": "Player reference."
          },
          "team": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Team the player represented that season."
          },
          "rating": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "The player’s mean match rating for the season according to the source, rounded to 2 decimals."
          },
          "appearances": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of matches in which the player received a rating."
          },
          "season": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Season"
              },
              {
                "type": "null"
              }
            ],
            "description": "Season in which the award was won."
          }
        },
        "required": [
          "player",
          "team",
          "rating",
          "appearances",
          "season"
        ]
      },
      "GrandSlamResults": {
        "type": "object",
        "description": "Results of a tennis player at a single Grand Slam, as returned by GET /v2/teams/{id}/grand-slams.",
        "properties": {
          "league": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/LeagueRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "The Grand Slam tournament, represented as a league."
          },
          "years": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GrandSlamYear"
            },
            "description": "One entry per year, oldest first, going back as far as the source’s records."
          }
        },
        "required": [
          "league",
          "years"
        ]
      },
      "GrandSlamYear": {
        "type": "object",
        "description": "A tennis player’s furthest progress at a given Grand Slam in a particular year.",
        "properties": {
          "year": {
            "type": "integer",
            "description": "The calendar year."
          },
          "season": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Season"
              },
              {
                "type": "null"
              }
            ],
            "description": "The league season for that year’s edition, if we have its id."
          },
          "round": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Deepest round reached, in the source’s wording (\"Final\", \"Semifinals\", \"Round of 16\")."
          },
          "won": {
            "type": "boolean",
            "description": "True if the player took the title."
          },
          "inProgress": {
            "type": "boolean",
            "description": "True while the edition is still running, meaning the round may still change."
          }
        },
        "required": [
          "year",
          "season",
          "round",
          "won",
          "inProgress"
        ]
      },
      "RaceCareerTotals": {
        "type": "object",
        "description": "Career totals for a driver or constructor as counted by the source, combining all its series.",
        "properties": {
          "racesStarted": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of race starts across the career."
          },
          "wins": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of races won."
          },
          "podiums": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of top-three finishes."
          },
          "polePositions": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of times starting from pole."
          },
          "championships": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of world championships won."
          }
        },
        "required": [
          "racesStarted",
          "wins",
          "podiums",
          "polePositions",
          "championships"
        ]
      },
      "RaceCareerSeason": {
        "type": "object",
        "description": "A single season in a driver’s or constructor’s career within one series.",
        "properties": {
          "series": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SeriesRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Racing series the season belongs to."
          },
          "season": {
            "$ref": "#/components/schemas/Season",
            "description": "The series season; its id is what the `season` parameter expects on the /v2/series/{id}/… endpoints and on /v2/teams/{id}/races."
          },
          "team": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "For a driver, the team (constructor) driven for that season; null on a constructor’s own row."
          },
          "position": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Position in the championship standings; null if unranked (or not yet ranked)."
          },
          "points": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Points earned in the championship."
          },
          "racesStarted": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of race starts."
          },
          "wins": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of races won."
          },
          "podiums": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of top-three finishes."
          },
          "polePositions": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of times starting from pole."
          }
        },
        "required": [
          "series",
          "season",
          "team",
          "position",
          "points",
          "racesStarted",
          "wins",
          "podiums",
          "polePositions"
        ]
      },
      "TeamRaceResult": {
        "type": "object",
        "description": "One race result in a season for a driver or constructor (from GET /v2/teams/{id}/races).",
        "properties": {
          "race": {
            "$ref": "#/components/schemas/RaceSummary",
            "description": "The race weekend in question; the result refers to its main race."
          },
          "position": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Finishing position of a driver, or a constructor’s ranking among constructors; null if unclassified (see `state`)."
          },
          "points": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Championship points earned in this race."
          },
          "state": {
            "$ref": "#/components/schemas/RaceResultState",
            "description": "Whether a driver was classified and, if not, why; constructors are always classified."
          },
          "outReason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Reason a driver did not finish, in the source’s words (\"Retired\"); null when classified."
          },
          "gridPosition": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Grid slot the driver started from."
          },
          "timeMs": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Driver’s total race time in ms; null if the driver is out, and for constructors. Unit: milliseconds."
          },
          "gapMs": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Driver’s gap to the winner; for the winner, and for drivers who are out or lapped, it is null. Unit: milliseconds."
          },
          "drivers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TeamRaceDriver"
            },
            "description": "Drivers who raced for the constructor in that event; empty on a driver’s row."
          }
        },
        "required": [
          "race",
          "position",
          "points",
          "state",
          "outReason",
          "gridPosition",
          "timeMs",
          "gapMs",
          "drivers"
        ]
      },
      "TeamRaceDriver": {
        "type": "object",
        "description": "A constructor’s driver in a particular race.",
        "properties": {
          "driver": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Driver reference."
          },
          "position": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Finishing position; null if not classified."
          },
          "gapMs": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Gap to the winner; for the winner, and for drivers who are out or lapped, it is null. Unit: milliseconds."
          }
        },
        "required": [
          "driver",
          "position",
          "gapMs"
        ]
      },
      "EsportsGameSide": {
        "type": "object",
        "description": "A single team’s data for one esports game.",
        "properties": {
          "score": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Score of the side in this game — rounds won in Counter-Strike, kills in League of Legends and Dota 2."
          },
          "periods": {
            "type": "object",
            "propertyNames": {
              "$ref": "#/components/schemas/PeriodKey"
            },
            "additionalProperties": {
              "type": "number"
            },
            "description": "Counter-Strike: rounds won in each half (period1, period2), with all overtime rounds combined under `overtime`, so the values sum to the game score. Empty if the source has no breakdown."
          },
          "players": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EsportsGamePlayer"
            },
            "description": "Players fielded by the side; empty if the source provides no lineup."
          },
          "bans": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EsportsCharacter"
            },
            "description": "Characters banned by the side, in ban order; empty if none are listed."
          },
          "statistics": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/EsportsTeamStats"
              },
              {
                "type": "null"
              }
            ],
            "description": "Objective statistics; null if the source has none."
          }
        },
        "required": [
          "score",
          "periods",
          "players",
          "bans",
          "statistics"
        ]
      },
      "EsportsGamePlayer": {
        "type": "object",
        "description": "Stat line for one player in one esports game. Only the fields relevant to the title are filled and the rest stay null: League of Legends uses gold / creepScore / level; Dota 2 uses creepScore (last hits) / level / denies / netWorth / goldPerMinute / experiencePerMinute; Counter-Strike uses averageDamagePerRound / headshotKills / kastPercentage / killDeathDifference / firstKillDifference / flashAssists.",
        "properties": {
          "player": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Player reference."
          },
          "role": {
            "$ref": "#/components/schemas/EsportsRole",
            "description": "Role the player filled in this game."
          },
          "character": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/EsportsCharacter"
              },
              {
                "type": "null"
              }
            ],
            "description": "Champion / hero the player used."
          },
          "kills": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Kill count."
          },
          "deaths": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Death count."
          },
          "assists": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Assist count."
          },
          "gold": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "League of Legends: total gold earned."
          },
          "creepScore": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Creeps killed — minions and monsters in League of Legends, last hits in Dota 2."
          },
          "level": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Champion / hero level when the game ended (League of Legends, Dota 2)."
          },
          "denies": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Dota 2: friendly creeps the player last-hit to deny the opponent their gold."
          },
          "netWorth": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Dota 2: final net worth in gold (gold held plus items)."
          },
          "goldPerMinute": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Dota 2: average gold earned per minute of play."
          },
          "experiencePerMinute": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Dota 2: average experience earned per minute of play."
          },
          "averageDamagePerRound": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Counter-Strike: ADR — hit points of damage dealt per round, on average."
          },
          "headshotKills": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Counter-Strike: number of kills scored with a headshot. This is a count capped by `kills`, not a percentage."
          },
          "kastPercentage": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Counter-Strike: KAST, the 0–100 share of rounds in which the player recorded a kill or assist, survived, or was traded. Unit: percent."
          },
          "killDeathDifference": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Counter-Strike: kills minus deaths; negative if the player died more often than they killed."
          },
          "firstKillDifference": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Counter-Strike: opening kills minus opening deaths — an opening duel being the round’s first kill, whether by or on the player. Summed over every player on a map, the values come to 0."
          },
          "flashAssists": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Counter-Strike: kills made by teammates on opponents this player had blinded with a flash."
          }
        },
        "required": [
          "player",
          "role",
          "character",
          "kills",
          "deaths",
          "assists",
          "gold",
          "creepScore",
          "level",
          "denies",
          "netWorth",
          "goldPerMinute",
          "experiencePerMinute",
          "averageDamagePerRound",
          "headshotKills",
          "kastPercentage",
          "killDeathDifference",
          "firstKillDifference",
          "flashAssists"
        ]
      },
      "EsportsCharacter": {
        "type": "object",
        "description": "A champion / hero / agent that was picked or banned.",
        "properties": {
          "name": {
            "type": "string",
            "description": "Character name (\"Viktor\")."
          },
          "slug": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Slug for use in URLs."
          }
        },
        "required": [
          "name",
          "slug"
        ]
      },
      "EsportsTeamStats": {
        "type": "object",
        "description": "One side’s objectives in one game of League of Legends or Dota 2: kills and towers, plus barracks and first blood in Dota 2. Fields that do not exist in the title are null. Counter-Strike has no objectives, so the whole object is null.",
        "properties": {
          "kills": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Kill count."
          },
          "gold": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Total gold earned by the side."
          },
          "towers": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Opposing towers taken down (in Dota 2, the towers the opponent lost)."
          },
          "inhibitors": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of inhibitors taken down."
          },
          "dragons": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Dragons (drakes) killed according to the source’s count, excluding `elderDragons`."
          },
          "elderDragons": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of Elder dragons killed."
          },
          "barons": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of Barons (Nashor) killed."
          },
          "heraldTaken": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True if the side secured the Rift Herald."
          },
          "barracks": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Dota 2: opposing barracks taken down (those the opponent lost)."
          },
          "dragonsByType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DragonsByType"
              },
              {
                "type": "null"
              }
            ],
            "description": "League of Legends: elemental dragon kills by element (they add up to `dragons`). Null in other titles, or if the source does not split them. Available since 2026-11-09."
          },
          "firstBlood": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "Dota 2: true if the side scored first blood, i.e. the opening kill of the game."
          }
        },
        "required": [
          "kills",
          "gold",
          "towers",
          "inhibitors",
          "dragons",
          "elderDragons",
          "barons",
          "heraldTaken",
          "barracks",
          "dragonsByType",
          "firstBlood"
        ]
      },
      "Scorecard": {
        "type": "object",
        "description": "Complete scorecard of a cricket fixture. For other sports the response is 200 with `{ innings: [], current: null }` rather than 404.",
        "properties": {
          "innings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ScorecardInnings"
            },
            "description": "All innings, in the order played; empty until the first ball is bowled, and in other sports."
          },
          "current": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CricketState"
              },
              {
                "type": "null"
              }
            ],
            "description": "The innings under way right now: striker, non-striker, bowler, plus the current over and ball. Null whenever no innings is under way (not started, between innings, finished) and in other sports."
          }
        },
        "required": [
          "innings",
          "current"
        ]
      },
      "CricketState": {
        "type": "object",
        "description": "The batters at the crease during a live innings. We DERIVE this from the ball-by-ball data instead of using the source’s current-batsman field: we start from the batter on the last ball, switch ends whenever an odd number of runs is run and when an over ends, and bring in the new batter after a wicket. Validated against the following ball on more than 3,000 deliveries.",
        "properties": {
          "inning": {
            "$ref": "#/components/schemas/PeriodKey",
            "description": "Key of the innings under way (inning1, inning2, …)."
          },
          "battingSide": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Side currently at bat."
          },
          "striker": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Batter due to face the next delivery. Null when this cannot be determined at the moment (no ball bowled yet in the innings, or a brief mismatch between the ball-by-ball and the scorecard just after a delivery)."
          },
          "nonStriker": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "The second batter at the crease; null when unknown, under the same conditions as striker."
          },
          "bowler": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Bowler of the current over. Null between overs, because the next bowler is only known once they deliver a ball."
          },
          "over": {
            "type": "integer",
            "description": "Current over, numbered from 1 as in Points; once an over is completed it moves on to the next one."
          },
          "ball": {
            "type": "integer",
            "description": "Legal balls bowled in the current over so far (0–5), not counting wides and no-balls."
          }
        },
        "required": [
          "inning",
          "battingSide",
          "striker",
          "nonStriker",
          "bowler",
          "over",
          "ball"
        ]
      },
      "ScorecardInnings": {
        "type": "object",
        "description": "One cricket innings: totals, the batting card and the bowling card, falls of wicket and partnerships.",
        "properties": {
          "inning": {
            "$ref": "#/components/schemas/PeriodKey",
            "description": "Innings key in match order (inning1, inning2, …): the second innings of the match is always inning2, regardless of who bats. Uses the same keys as Points.innings."
          },
          "battingSide": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Side currently at bat."
          },
          "battingTeam": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Team at bat in this innings."
          },
          "bowlingTeam": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Team in the field in this innings."
          },
          "runs": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Innings total, combining runs off the bat and extras."
          },
          "wickets": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Wickets fallen, including a batter retired hurt who is unable to return."
          },
          "overs": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Overs received, in cricket notation (19.3 means 19 overs plus 3 balls)."
          },
          "extras": {
            "$ref": "#/components/schemas/Extras",
            "description": "Runs conceded other than off the bat."
          },
          "batting": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ScorecardBatter"
            },
            "description": "Batting card in order of appearance, including did-not-bat entries."
          },
          "bowling": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ScorecardBowler"
            },
            "description": "Bowling card in the order the bowlers were used."
          },
          "fallOfWickets": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FallOfWicket"
            },
            "description": "Each fall of wicket in sequence; retirements are not counted as falls."
          },
          "partnerships": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Partnership"
            },
            "description": "Each batting partnership in sequence."
          }
        },
        "required": [
          "inning",
          "battingSide",
          "battingTeam",
          "bowlingTeam",
          "runs",
          "wickets",
          "overs",
          "extras",
          "batting",
          "bowling",
          "fallOfWickets",
          "partnerships"
        ]
      },
      "ScorecardBatter": {
        "type": "object",
        "description": "A single entry on a batting card, listed in batting order.",
        "properties": {
          "batter": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Batter reference."
          },
          "state": {
            "$ref": "#/components/schemas/BatterState",
            "description": "Current status of the batter’s innings."
          },
          "dismissal": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Dismissal"
              },
              {
                "type": "null"
              }
            ],
            "description": "Manner of dismissal; only set when `state` is out."
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "State as phrased by the source (\"Not out\", \"LBW\", \"Did not bat\", \"Caught & Bowled\"). For display only."
          },
          "bowler": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Bowler involved in the dismissal, who is credited with the wicket unless it was a run out. The source also names a bowler on a retired-hurt line."
          },
          "fielder": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Fielder involved in the dismissal: whoever took the catch (the bowler for caught & bowled), the wicket-keeper for a stumping, or the fielder who effected a run out."
          },
          "runs": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Runs the batter made."
          },
          "balls": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of deliveries faced."
          },
          "fours": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of boundaries for four."
          },
          "sixes": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of sixes struck."
          },
          "strikeRate": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Runs scored per 100 balls, to 2 decimals; null until the batter has faced a ball."
          }
        },
        "required": [
          "batter",
          "state",
          "dismissal",
          "description",
          "bowler",
          "fielder",
          "runs",
          "balls",
          "fours",
          "sixes",
          "strikeRate"
        ]
      },
      "ScorecardBowler": {
        "type": "object",
        "description": "A single bowler’s figures from the bowling card; entries follow the order in which they bowled.",
        "properties": {
          "bowler": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "The player who bowled these figures."
          },
          "overs": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Overs delivered, written the cricket way: 3.4 means three complete overs plus four balls."
          },
          "maidens": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Count of maiden overs."
          },
          "runs": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Runs charged to the bowler: wides and no-balls count towards it, byes and leg byes do not."
          },
          "wickets": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Dismissals credited to the bowler; run outs and retirements are excluded."
          },
          "wides": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of wides delivered."
          },
          "noBalls": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of no-balls delivered."
          },
          "economy": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Runs conceded per six-ball over, to two decimal places; null until the first delivery."
          }
        },
        "required": [
          "bowler",
          "overs",
          "maidens",
          "runs",
          "wickets",
          "wides",
          "noBalls",
          "economy"
        ]
      },
      "FallOfWicket": {
        "type": "object",
        "description": "A single entry in the fall-of-wickets list.",
        "properties": {
          "wicket": {
            "type": "integer",
            "description": "Wicket number, counting from 1 for the first dismissal."
          },
          "runs": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Team score at the moment the wicket went down."
          },
          "overs": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Point in the innings at which it went down, in cricket notation: 4.2 is the second ball of the fifth over, while the sixth ball of that over is written 5 (never 4.6)."
          },
          "batter": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "The dismissed batter."
          }
        },
        "required": [
          "wicket",
          "runs",
          "overs",
          "batter"
        ]
      },
      "Partnership": {
        "type": "object",
        "description": "A stand between two batters. Our data source provides these for limited-overs games; multi-day matches frequently come without any.",
        "properties": {
          "batter1": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "The first batter in the stand."
          },
          "batter2": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "The second batter in the stand."
          },
          "runs": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Runs the pair put on together."
          },
          "balls": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of balls the stand lasted."
          }
        },
        "required": [
          "batter1",
          "batter2",
          "runs",
          "balls"
        ]
      },
      "Extras": {
        "type": "object",
        "description": "Runs credited to the batting side that did not come off the bat.",
        "properties": {
          "total": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Combined extras, computed as wides + noBalls + byes + legByes + penalties."
          },
          "wides": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Extras from wides."
          },
          "noBalls": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Extras from no-balls."
          },
          "byes": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Extras from byes."
          },
          "legByes": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Extras from leg byes."
          },
          "penalties": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Runs awarded as penalties."
          }
        },
        "required": [
          "total",
          "wides",
          "noBalls",
          "byes",
          "legByes",
          "penalties"
        ]
      },
      "StandingsGroup": {
        "type": "object",
        "description": "A single standings table within a season — the overall table, or a conference, division or group.",
        "properties": {
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The table’s label, such as \"Eastern Conference\", \"Group A\" or \"NHL\"."
          },
          "primary": {
            "type": "boolean",
            "description": "Marks the table that /standings returns when none is requested. Each season has exactly one: the overall table if it exists, otherwise the largest one (for a group stage, the first group)."
          },
          "overall": {
            "type": "boolean",
            "description": "`true` when the table includes all of the season’s teams (a league table); `false` for conference and division tables and for the individual groups of a group stage."
          },
          "tieBreakRule": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "How ties are broken, as described by our data source."
          },
          "scoreUnit": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/StandingsScoreUnit"
              },
              {
                "type": "null"
              }
            ],
            "description": "Unit behind this table’s scoresFor / scoresAgainst columns. Tables without score columns (cricket) return null."
          },
          "rows": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/StandingsRow"
            }
          }
        },
        "required": [
          "name",
          "primary",
          "overall",
          "tieBreakRule",
          "scoreUnit",
          "rows"
        ]
      },
      "StandingsRow": {
        "type": "object",
        "description": "A team’s line in a standings table. Any column that is irrelevant to the sport is null.",
        "properties": {
          "position": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Position in this table, from 1 to n. When our data source’s positions do not run 1..n (as in its NBA tables early in a season), we rank the rows ourselves by win share, then wins, then fewer losses — or by points, then score difference, then scores for."
          },
          "team": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "The team this row describes."
          },
          "played": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of games played."
          },
          "wins": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Total wins, including those in overtime."
          },
          "draws": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Drawn games — filled in American football, cricket, football, futsal, handball and rugby. Where a table has no draw column (baseball, basketball, esports, ice hockey, volleyball, water polo, …) the value is null, meaning the column does not exist — not that no draws have happened yet."
          },
          "losses": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Total losses, including those in overtime."
          },
          "overtimeWins": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Ice hockey only: overtime wins as tallied by our data source. Where shoot-outs are counted separately (the KHL, the NHL’s league table) this covers overtime alone; elsewhere it combines overtime and shoot-out wins. Null where no figure is listed."
          },
          "overtimeLosses": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Ice hockey only. Across all NHL tables — league, conference, division, and the home / away tables we compute — it counts losses in overtime and in shoot-outs together, i.e. the NHL’s OTL column, each worth a point. Elsewhere it is the overtime-loss figure our data source reports (for the KHL, overtime losses only)."
          },
          "scoresFor": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "How much the team has scored — goals, points, runs, sets, … depending on the table’s `scoreUnit`."
          },
          "scoresAgainst": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "How much the team has conceded, expressed in the table’s `scoreUnit`."
          },
          "scoreDifference": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Difference between the two: scoresFor − scoresAgainst."
          },
          "points": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Points in the table; null for tables ordered by win percentage (NBA)."
          },
          "winPercentage": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Basketball, baseball and American football: proportion of games won, from 0 to 1, calculated the league’s way (in the NFL a tie is worth half a win). Unit: ratio."
          },
          "gamesBehind": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Basketball and baseball: how many games the team trails the leader (the side with the best wins − losses), calculated as ((leader wins − wins) + (losses − leader losses)) / 2. Our data source shows 0 for every row of its EuroLeague tables; the computed NBA home / away tables work it out separately for each table."
          },
          "streak": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "The team’s ongoing streak in this competition: +3 means three wins in a row, −2 two defeats in a row. Present when our data source’s table includes it (NBA, EuroLeague, Liga ACB, …); null for other tables and for home / away tables."
          },
          "zone": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Name of the zone (qualification or relegation) this row sits in — for example \"Champions League\", \"Playoffs\" or \"Relegation\"."
          },
          "form": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/FormResult"
                }
              },
              {
                "type": "null"
              }
            ],
            "description": "Up to five of the team’s latest results in this competition season, ordered oldest first so the newest comes last; a home / away table shows only home / away results. Null when our data source gives no form for this table — computed tables, rows stored earlier, or a read that failed."
          }
        },
        "required": [
          "position",
          "team",
          "played",
          "wins",
          "draws",
          "losses",
          "overtimeWins",
          "overtimeLosses",
          "scoresFor",
          "scoresAgainst",
          "scoreDifference",
          "points",
          "winPercentage",
          "gamesBehind",
          "streak",
          "zone",
          "form"
        ]
      },
      "CupTree": {
        "type": "object",
        "description": "Bracket view of a league season’s knockout phase: cup rounds, playoffs or a tennis draw.",
        "properties": {
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "What the bracket is called — \"CONMEBOL Libertadores 2026, Knockout stage\" or \"NBA 25/26, Playoffs\", for instance."
          },
          "currentRound": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "`order` of the round currently being played, or the next one due. Null if our data source does not supply it, or once the bracket is complete (at that point the source points to a round beyond the final one)."
          },
          "rounds": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CupRound"
            },
            "description": "The bracket’s rounds, beginning with the first."
          }
        },
        "required": [
          "name",
          "currentRound",
          "rounds"
        ]
      },
      "CupRound": {
        "type": "object",
        "description": "A single round within a knockout bracket.",
        "properties": {
          "order": {
            "type": "integer",
            "description": "Position of the round in the bracket, starting at 1 for the opening round."
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Label our data source gives the round, such as \"1/8\", \"Quarterfinals\", \"Round of 32\" or \"Conference finals\"."
          },
          "blocks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CupBlock"
            },
            "description": "Ties in this round, listed from the top of the bracket down."
          }
        },
        "required": [
          "order",
          "name",
          "blocks"
        ]
      },
      "CupBlock": {
        "type": "object",
        "description": "A single tie in a knockout round — one match, a two-legged tie or a series.",
        "properties": {
          "order": {
            "type": "integer",
            "description": "Where the tie sits in its round, counting from the top as our data source lays out the bracket. Values rise but are not guaranteed to run 1..n: byes or late-entering teams leave gaps (UCL qualifiers 15, 16, 19, …)."
          },
          "home": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CupParticipant"
              },
              {
                "type": "null"
              }
            ],
            "description": "The participant listed first (first-leg home side or higher seed); null if the slot is unfilled."
          },
          "away": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CupParticipant"
              },
              {
                "type": "null"
              }
            ],
            "description": "The participant listed second; null if the slot is unfilled (a bye)."
          },
          "finished": {
            "type": "boolean",
            "description": "`true` once the tie is settled — a participant has been marked as winner, or our data source reports it finished."
          },
          "inProgress": {
            "type": "boolean",
            "description": "`true` while any of the tie’s fixtures is live."
          },
          "startTime": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Start time of the tie’s opening fixture, in UTC; null if it has not been scheduled."
          },
          "matchCount": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of fixtures that make up the tie (2 for two legs, 7 for a best-of-7, or 1); 0 for a bye."
          },
          "fixtureIds": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "Fixture ids for the tie (usable with /v2/fixtures/{id}), in the order our data source gives them."
          },
          "automaticProgression": {
            "type": "boolean",
            "description": "Flag from our data source indicating the participant advances without playing a fixture."
          },
          "venue": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Venue"
              },
              {
                "type": "null"
              }
            ],
            "description": "Venue of the tie when our data source provides one (for a one-off final, or the ground of the first leg)."
          }
        },
        "required": [
          "order",
          "home",
          "away",
          "finished",
          "inProgress",
          "startTime",
          "matchCount",
          "fixtureIds",
          "automaticProgression",
          "venue"
        ]
      },
      "CupParticipant": {
        "type": "object",
        "description": "One of the two sides in a knockout tie.",
        "properties": {
          "team": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "The team or individual competitor. Null as long as the slot is only a placeholder (“winner of quarter-final 1”); check `fromBlock` in that case."
          },
          "seed": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Seeding or entry label in our data source’s own spelling (\"1\", \"Q\" for qualifier, \"WC\" for wild card); null if there is none."
          },
          "winner": {
            "type": "boolean",
            "description": "`true` if this side won the tie and advanced."
          },
          "score": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "This side’s score in the tie as reported by our data source: aggregate goals across the legs in football, series games won in basketball and ice hockey, sets in a single tennis match. Null until the tie has been played."
          },
          "penalties": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Football only: goals this side scored in a penalty shoot-out, if the tie needed one; otherwise null."
          },
          "fromBlock": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "The `order` value of the block, one round back (PREVIOUS round), that this participant advanced from. Null in the opening round, or when our data source provides no link and the team did not appear in the previous round (a new entrant)."
          }
        },
        "required": [
          "team",
          "seed",
          "winner",
          "score",
          "penalties",
          "fromBlock"
        ]
      },
      "SearchResult": {
        "type": "object",
        "description": "A single search match, ordered by our data source’s relevance ranking. Competitors in tennis and other individual sports come back as `team` results. Since 2026-10-24 managers, referees, racing series and races can match too; since 2026-11-04, fixtures and venues as well, plus a player’s `team`.",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/SearchType",
            "description": "The kind of entity matched, which tells you which endpoint its id is for."
          },
          "id": {
            "type": "integer",
            "description": "Identifier of the matched entity. Which endpoint it works with depends on `type`: /v2/teams, /v2/players, /v2/leagues, /v2/managers, /v2/referees, /v2/series, /v2/races, /v2/fixtures or /v2/venues."
          },
          "name": {
            "type": "string",
            "description": "Name to show; for a fixture it is our data source’s \"Home - Away\" string."
          },
          "slug": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "sport": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Slug of the sport; null for venues, as a venue does not belong to a single sport."
          },
          "gender": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamGender"
              },
              {
                "type": "null"
              }
            ],
            "description": "Only set on `team` results (since 2026-11-04): whether the team is men’s, women’s or mixed, as shown on TeamDetail. All other result types return null, as does an individual competitor flagged mixed by our data source."
          },
          "image": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ],
            "description": "Image on our CDN — a logo for teams and leagues, a photo for players, managers and referees. Series, races, fixtures and venues never have one; for other entities it is null when no image exists or it is still to be uploaded."
          },
          "team": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "For player results, the club our data source currently lists them at (since 2026-11-04). Null for other types and for players with no team (free agents, retired)."
          },
          "fixture": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SearchFixture"
              },
              {
                "type": "null"
              }
            ],
            "description": "Populated only for `fixture` results (since 2026-11-04) with the key facts of the match; null otherwise."
          },
          "venue": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Venue"
              },
              {
                "type": "null"
              }
            ],
            "description": "Populated only for `venue` results (since 2026-11-04) with the venue’s city, country and capacity; null otherwise."
          }
        },
        "required": [
          "type",
          "id",
          "name",
          "slug",
          "sport",
          "gender",
          "image",
          "team",
          "fixture",
          "venue"
        ]
      },
      "SearchFixture": {
        "type": "object",
        "description": "The match summary carried by a `fixture` search result (since 2026-11-04). For status, score and everything else, call /v2/fixtures/{id}.",
        "properties": {
          "home": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "The home side; null until it has been determined."
          },
          "away": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "The away side; null until it has been determined."
          },
          "league": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/LeagueRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Competition the match belongs to; null if our data source does not name one."
          },
          "startTime": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Planned start time in UTC; null if our data source does not provide one."
          },
          "status": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/StatusType"
              },
              {
                "type": "null"
              }
            ],
            "description": "Broad match state when the search ran (no more detailed state is available here); null if our data source gives none."
          }
        },
        "required": [
          "home",
          "away",
          "league",
          "startTime",
          "status"
        ]
      },
      "TopPlayersCategory": {
        "type": "object",
        "description": "One leaderboard for a season.",
        "properties": {
          "category": {
            "type": "string",
            "description": "Which leaderboard this is — for example football: goals, averageRating, expectedGoals; basketball: rebounds, points; ice hockey: savePercentage, points. It equals `statistic`, except for football’s `mostConceded` / `leastConceded`, which rank goalkeepers by goals conceded with the most / fewest first."
          },
          "statistic": {
            "type": "string",
            "description": "The `statistics` key this leaderboard is built on; each entry’s `value` holds it as a season total. The ordering is our data source’s: counting statistics are generally ranked PER APPEARANCE (value ÷ appearances, so 104 NBA points in 3 games sits above 115 in 4), while ratings and shares rank by the value itself. Treat list position, not `value`, as the rank."
          },
          "players": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TopPlayerEntry"
            }
          }
        },
        "required": [
          "category",
          "statistic",
          "players"
        ]
      },
      "TopPlayerEntry": {
        "type": "object",
        "description": "A single player on a leaderboard.",
        "properties": {
          "player": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ]
          },
          "team": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ]
          },
          "value": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "This player’s figure for the ranked statistic, i.e. `statistics[statistic]`."
          },
          "appearances": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of appearances."
          },
          "playedEnough": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "`true` if the player has played enough minutes or games to qualify for the ranking."
          },
          "statistics": {
            "type": "object",
            "additionalProperties": {
              "type": "number"
            },
            "description": "All numeric statistics supplied with the ranked entry, under v2 keys that match the per-match key for the same measure (naming conventions for season figures: `…PerMatch` is the total divided by matches, `…Per90` is per 90 minutes, `average…` is a season mean, `…Percentage` runs 0–100, `<key>Against` holds the opponents’ figure, and units are spelled out in the key (`…Seconds`, `…Kmh`))."
          }
        },
        "required": [
          "player",
          "team",
          "value",
          "appearances",
          "playedEnough",
          "statistics"
        ]
      },
      "TopPerformancesCategory": {
        "type": "object",
        "description": "For one statistic, the highest individual match figures recorded in a league season (since 2026-11-09).",
        "properties": {
          "category": {
            "type": "string",
            "description": "Which per-match player statistic the list ranks. Keys match those in a lineup player’s `statistics` — for football rating, goals, assists, kilometersCovered, topSpeed, keyPass, …; for basketball points, rebounds, …; for ice hockey points, hits, …."
          },
          "performances": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TopPerformance"
            },
            "description": "At most 10 entries, top performance first in our data source’s ranking — for turnovers, errors and misses that means the highest count, not the lowest."
          }
        },
        "required": [
          "category",
          "performances"
        ]
      },
      "TopPerformance": {
        "type": "object",
        "description": "A single player’s figure from a single match.",
        "properties": {
          "player": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ]
          },
          "fixture": {
            "$ref": "#/components/schemas/Fixture",
            "description": "The fixture in which the figure was recorded."
          },
          "value": {
            "type": "number",
            "description": "The figure itself, in whatever unit the category’s per-match statistic uses — e.g. rating 0–10, topSpeed in km/h, kilometersCovered in km."
          }
        },
        "required": [
          "player",
          "fixture",
          "value"
        ]
      },
      "DraftRound": {
        "type": "object",
        "description": "A single round of a league draft, as returned by GET /v2/leagues/{id}/draft. Available since 2026-11-09.",
        "properties": {
          "picks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DraftPick"
            },
            "description": "Picks in this round, sorted by overall pick number."
          },
          "teamsWithoutPick": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TeamRef"
            },
            "description": "Clubs that hold no pick in this round because they traded or forfeited it."
          }
        },
        "required": [
          "picks",
          "teamsWithoutPick"
        ]
      },
      "DraftPick": {
        "type": "object",
        "description": "A single selection in a draft (since 2026-11-09).",
        "properties": {
          "overallPick": {
            "type": "integer",
            "description": "Pick number counted across the entire draft."
          },
          "round": {
            "type": "integer",
            "description": "Round in which the pick falls."
          },
          "pickInRound": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Pick number counted within its round."
          },
          "team": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Club that makes the selection."
          },
          "tradedFrom": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "For a traded pick, the club that originally owned it; null if it was not traded."
          },
          "player": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "The drafted player as a record available from /v2/players/{id}; null if our data source has no player entry for them."
          },
          "prospect": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DraftProspect"
              },
              {
                "type": "null"
              }
            ],
            "description": "The drafted player as described in the draft listing; null while the pick is still to be made."
          }
        },
        "required": [
          "overallPick",
          "round",
          "pickInRound",
          "team",
          "tradedFrom",
          "player",
          "prospect"
        ]
      },
      "DraftProspect": {
        "type": "object",
        "description": "How the draft itself describes the selected player.",
        "properties": {
          "name": {
            "type": "string",
            "description": "Name of the prospect as printed in the draft."
          },
          "position": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Listed position, using our data source’s abbreviations: G, F, C, FC, … in basketball; QB, WR, OT, … in American football."
          },
          "topProspect": {
            "type": "boolean",
            "description": "`true` if they were flagged as a top prospect ahead of the draft."
          },
          "fromTeam": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "The college or former club they come from, when our data source holds it as a team."
          },
          "fromTeamName": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Name of that college or club as given in the draft — filled even when fromTeam is null."
          }
        },
        "required": [
          "name",
          "position",
          "topProspect",
          "fromTeam",
          "fromTeamName"
        ]
      },
      "TopTeamsCategory": {
        "type": "object",
        "description": "One team leaderboard for a season.",
        "properties": {
          "category": {
            "type": "string",
            "description": "Leaderboard identifier — in football, for example, averageRating, goalsScored or cleanSheets."
          },
          "statistic": {
            "type": "string",
            "description": "The `statistics` key this leaderboard is built on; each entry’s `value` holds it as a season total. The ordering is our data source’s: counting statistics are generally ranked PER APPEARANCE (value ÷ appearances, so 104 NBA points in 3 games sits above 115 in 4), while ratings and shares rank by the value itself. Treat list position, not `value`, as the rank."
          },
          "teams": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TopTeamEntry"
            },
            "description": "Teams on the leaderboard, top-ranked first."
          }
        },
        "required": [
          "category",
          "statistic",
          "teams"
        ]
      },
      "TopTeamEntry": {
        "type": "object",
        "description": "A single team on a leaderboard.",
        "properties": {
          "team": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ]
          },
          "value": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "This team’s figure for the ranked statistic, i.e. `statistics[statistic]`."
          },
          "matches": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of matches played."
          },
          "statistics": {
            "type": "object",
            "additionalProperties": {
              "type": "number"
            },
            "description": "All numeric statistics supplied with the ranked entry, under v2 keys that match the per-match key for the same measure (naming conventions for season figures: `…PerMatch` is the total divided by matches, `…Per90` is per 90 minutes, `average…` is a season mean, `…Percentage` runs 0–100, `<key>Against` holds the opponents’ figure, and units are spelled out in the key (`…Seconds`, `…Kmh`))."
          }
        },
        "required": [
          "team",
          "value",
          "matches",
          "statistics"
        ]
      },
      "TeamSeasonStatistics": {
        "type": "object",
        "description": "Statistics for one team in a given league, season and type.",
        "properties": {
          "statistics": {
            "type": "object",
            "additionalProperties": {
              "type": "number"
            },
            "description": "Totals and averages for the season under v2 keys, which match the per-match key for the same measure (naming conventions for season figures: `…PerMatch` is the total divided by matches, `…Per90` is per 90 minutes, `average…` is a season mean, `…Percentage` runs 0–100, `<key>Against` holds the opponents’ figure, and units are spelled out in the key (`…Seconds`, `…Kmh`)). Football examples: goalsScored, goalsConceded, matches, averageRating, totalShots, averageBallPossession, cleanSheets, …. Ratings are rounded to two decimal places."
          }
        },
        "required": [
          "statistics"
        ]
      },
      "SeasonInfo": {
        "type": "object",
        "description": "Key facts about a season: running totals and the teams new to it.",
        "properties": {
          "statistics": {
            "type": "object",
            "additionalProperties": {
              "type": "number"
            },
            "description": "Totals for the season under our data source’s own names (football: goals, yellowCards, redCards, homeTeamWins, awayTeamWins, draws, numberOfCompetitors; in other sports numberOfCompetitors may be the only one)."
          },
          "newcomersUpperDivision": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TeamRef"
            },
            "description": "Newcomers this season that came down from the division above."
          },
          "newcomersLowerDivision": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TeamRef"
            },
            "description": "Newcomers this season that came up from the division below."
          },
          "newcomersOther": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TeamRef"
            },
            "description": "Newcomers that arrived by any other route."
          },
          "hostCountries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Country"
            },
            "description": "Host nations of a tournament held in particular countries, listed in our data source’s order — Canada, Mexico and USA for the 2026 World Cup, eleven of them for EURO 2020. League seasons usually leave it empty, though a few name their country (Germany for the Bundesliga; USA for MLS and the NFL). `code` is null when the name is missing from our data source’s country list."
          }
        },
        "required": [
          "statistics",
          "newcomersUpperDivision",
          "newcomersLowerDivision",
          "newcomersOther",
          "hostCountries"
        ]
      },
      "PlayerLeagueSeasons": {
        "type": "object",
        "description": "A league in which the player has recorded statistics, together with the relevant seasons.",
        "properties": {
          "league": {
            "$ref": "#/components/schemas/LeagueRef",
            "description": "League or competition reference — the same structure /v2/leagues/{id} and all league lists return."
          },
          "seasons": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "integer"
                },
                "name": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "year": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "startYear": {
                  "anyOf": [
                    {
                      "type": "integer"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "endYear": {
                  "anyOf": [
                    {
                      "type": "integer"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "types": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SeasonStatsType"
                  }
                }
              },
              "required": [
                "id",
                "name",
                "year",
                "startYear",
                "endYear",
                "types"
              ]
            }
          }
        },
        "required": [
          "league",
          "seasons"
        ]
      },
      "PlayerStatistics": {
        "type": "object",
        "description": "Statistics for one player in a given league, season and type.",
        "properties": {
          "team": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ]
          },
          "statistics": {
            "type": "object",
            "additionalProperties": {
              "type": "number"
            },
            "description": "Totals and averages for the season under v2 keys, which match the per-match key for the same measure (naming conventions for season figures: `…PerMatch` is the total divided by matches, `…Per90` is per 90 minutes, `average…` is a season mean, `…Percentage` runs 0–100, `<key>Against` holds the opponents’ figure, and units are spelled out in the key (`…Seconds`, `…Kmh`)). Football examples: appearances, minutesPlayed, goals, averageRating, expectedGoals, … — the complete football key list, with what each key measures, is under season statistic keys in this reference. Ratings are rounded to two decimal places."
          },
          "ratingBreakdown": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/RatingBreakdown"
              },
              {
                "type": "null"
              }
            ],
            "description": "Football: how the season rating breaks down across parts of the game; null if the source gives no breakdown (other sports, or seasons that have no ratings). Since 2026-11-11."
          }
        },
        "required": [
          "team",
          "statistics",
          "ratingBreakdown"
        ]
      },
      "RatingBreakdown": {
        "type": "object",
        "description": "Football only, since 2026-11-11: how each part of a player’s game pushed their season rating up or down, as the source works it out — expressed as rating points per match, positive when above a neutral contribution and negative when below (e.g. 0.13 for dribbling, −0.02 for passing).",
        "properties": {
          "shotValue": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Contribution of shooting to the season rating; null when the source omits it (as for goalkeepers)."
          },
          "passValue": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Contribution of passing to the season rating."
          },
          "dribbleValue": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Contribution of dribbling to the season rating."
          },
          "defensiveValue": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Contribution of defending to the season rating."
          },
          "goalkeeperValue": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Contribution of goalkeeping to the season rating; set for goalkeepers only, null for everyone else."
          }
        },
        "required": [
          "shotValue",
          "passValue",
          "dribbleValue",
          "defensiveValue",
          "goalkeeperValue"
        ]
      },
      "PlayerFixture": {
        "type": "object",
        "description": "An entry in a player’s fixture list: a Fixture plus the player’s personal involvement (`playerMatch`).",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The fixture’s id."
          },
          "sport": {
            "type": "string",
            "description": "Slug of the sport, matching /v2/sports."
          },
          "status": {
            "$ref": "#/components/schemas/Status",
            "description": "Current state of the match."
          },
          "startTime": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "When the match starts: initially the planned time, swapped for the actual kick-off once our data source logs it (its live feed delivers this a few minutes after the start). Every endpoint and every WebSocket delta carries the same value."
          },
          "league": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/LeagueRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Competition the fixture belongs to. Null if our data source places the fixture in a competition without a matching league — seen on 2026-10-23 in minor regional football, e.g. South Africa’s National Second Division; in that case season and round are null as well."
          },
          "season": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Season"
              },
              {
                "type": "null"
              }
            ],
            "description": "Season the fixture is part of."
          },
          "round": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Round"
              },
              {
                "type": "null"
              }
            ],
            "description": "Round of the fixture, for competitions organised in rounds."
          },
          "home": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "The home side; null until it is known (our data source shows a placeholder such as \"WQF1\", the winner of quarter-final 1)."
          },
          "away": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "The away side; null until it is known (our data source shows a placeholder such as \"WQF1\")."
          },
          "homeScore": {
            "$ref": "#/components/schemas/ScoreSide",
            "description": "The home side’s score."
          },
          "awayScore": {
            "$ref": "#/components/schemas/ScoreSide",
            "description": "The away side’s score."
          },
          "winner": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Winner"
              },
              {
                "type": "null"
              }
            ],
            "description": "Remains null until status.type is finished, and stays null for a fight declared a no contest (`fightResult.method` noContest). If a match was settled on penalties, this is always the shoot-out winner, regardless of our data source (which, on a second leg, names whoever won the 90 minutes). When the source omits a winner, or reports a draw in a sport where draws are impossible, we derive it from the score (matches ending in regular time or overtime; cricket excluded)."
          },
          "venue": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Venue"
              },
              {
                "type": "null"
              }
            ],
            "description": "Where the match is played, if known (lower tiers often have none). Populated on /fixtures/{id} and, when our data source provides it, in date lists. Round, team, player and live lists never include a venue, so null there means \"not included\" rather than \"unknown\"; fetch /fixtures/{id} to get it."
          },
          "clock": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Clock"
              },
              {
                "type": "null"
              }
            ],
            "description": "Running match clock; null if our data source has no clock for the fixture, and after the match ends."
          },
          "firstToServe": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Deprecated since 2026-10-23 — mirrors `serving`. Because our data source refreshes it every game / leg, it reflects the side serving (throwing) at present, not the one that served first; use `serving` instead."
          },
          "serving": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tennis, darts and other sports with a serve: which side is serving (throwing) at the moment, refreshed by our data source each game / leg. Null if the source does not report it."
          },
          "servedFirst": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Darts: which side threw first in the match (`serving` tells you who is throwing at present). Set when play starts and unchanged afterwards; null before the start, when the source is silent, and for every sport other than darts. Since 2026-11-11."
          },
          "homeSeed": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "In seeded events — tennis draws, or playoff seeding in basketball and other sports — the seed of the home side (\"1\", \"12\") or its entry status (\"WC\" wild card, \"Q\" qualifier, \"LL\" lucky loser, \"PR\" protected ranking, …) as printed on the draw. Unseeded sides get null."
          },
          "awaySeed": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Seed or entry status of the away side, following the same rules as homeSeed."
          },
          "note": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Cricket only: our data source’s match note, which becomes the result line after the finish (\"Pakistan beat Sri Lanka by 37 runs\"). Intended for display only."
          },
          "battingSide": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Cricket only: the side currently batting. Null when no innings is under way, and for all other sports."
          },
          "fightResult": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FightResult"
              },
              {
                "type": "null"
              }
            ],
            "description": "MMA and boxing: how, in which round and at what time the fight ended. Null until status.type is finished, or when our data source gives no method."
          },
          "fightDiscipline": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FightDiscipline"
              },
              {
                "type": "null"
              }
            ],
            "description": "Combat sports: the discipline of this bout when our data source tags one (the `mma` sport includes boxing, kickboxing and Muay Thai cards too). Only some cards get a tag — ONE, Queensbury and some OKTAGON fights, but never UFC or PFL — so null tells you nothing about whether the bout is MMA."
          },
          "referee": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Referee"
              },
              {
                "type": "null"
              }
            ],
            "description": "Named only if our data source has one (football and some other sports; in cricket, the match referee). You get it on /fixtures/{id}; list endpoints return null since it is not included there."
          },
          "homeManager": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ManagerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Manager or head coach of the home side for this fixture, if our data source names one. Populated on /fixtures/{id}; null in lists."
          },
          "awayManager": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ManagerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Manager or head coach of the away side; same behaviour as homeManager."
          },
          "surface": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Surface"
              },
              {
                "type": "null"
              }
            ],
            "description": "Court surface for tennis matches, returned on /fixtures/{id} and in live lists; other sports get null."
          },
          "discipline": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/MatchDiscipline"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tennis: whether the match is singles or doubles, given on all fixture endpoints, lists and WebSocket snapshots; other sports, and matches the source does not label, get null. Since 2026-11-11."
          },
          "toss": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CricketToss"
              },
              {
                "type": "null"
              }
            ],
            "description": "Cricket only: the toss result, once it has taken place. Populated on /fixtures/{id}; null for every other sport."
          },
          "umpires": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              {
                "type": "null"
              }
            ],
            "description": "Cricket only: the on-field umpires in our data source’s wording (frequently with a country code, e.g. \"Asif Yaqoob (PAK)\"); null if none are listed, and for every other sport."
          },
          "tvUmpire": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Cricket only: the TV (third) umpire, handled the same way as umpires."
          },
          "previousLegFixtureId": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "For two-legged ties and playoff series: the fixture id of the tie’s preceding leg / game, if our data source links it. Look it up via /fixtures/{id} to get the first-leg score."
          },
          "aggregateWinner": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Set only once a two-legged tie’s return leg has finished: the team that progressed. We take our data source’s verdict; failing that, we use `aggregated` (the higher total goes through) or, when the aggregate is level, the shoot-out. Null in all other cases, including a level aggregate the source leaves unresolved (an away-goals rule). Compare `winner`, which is this match’s winner: after a second leg settled on penalties both point to the shoot-out winner, but otherwise they can disagree (a team can win the second leg yet be eliminated). Only /fixtures/{id} fills it; lists and live snapshots leave it out and may show null."
          },
          "fightCard": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FightCard"
              },
              {
                "type": "null"
              }
            ],
            "description": "MMA and boxing: the bout’s card section, position on the card and weight class, if our data source lists them."
          },
          "attendance": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Crowd size, if our data source reports one (observed for NBA and MLB games, often appearing only after the game has started). Populated on /fixtures/{id}; lists return null because it is not included."
          },
          "matchFormat": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/MatchFormat"
              },
              {
                "type": "null"
              }
            ],
            "description": "Match format for darts and esports — best of N sets / legs / games — when our data source provides it. Other sports get null."
          },
          "inningState": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/InningState"
              },
              {
                "type": "null"
              }
            ],
            "description": "Baseball only: the game situation right now — inning, half, balls, strikes, outs and runners on base. It is null while the game is not in progress or interrupted, and in every other sport. WebSocket deltas carry it live."
          },
          "timeouts": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Timeouts"
              },
              {
                "type": "null"
              }
            ],
            "description": "Basketball: timeouts left for each side, filled only during an in-progress or interrupted game and only if our data source tracks them; null otherwise. WebSocket deltas carry live updates."
          },
          "downAndDistance": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DownAndDistance"
              },
              {
                "type": "null"
              }
            ],
            "description": "American football only: down, distance and field position at this moment. It is null while the game is not in progress or interrupted, and in every other sport. Delivered live through WebSocket deltas. Available since 2026-11-09."
          },
          "varCheck": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/VarCheck"
              },
              {
                "type": "null"
              }
            ],
            "description": "Football only: an ongoing VAR review; null when there is none, outside play, and for every other sport. Delivered live through WebSocket deltas. Available since 2026-11-09."
          },
          "bonus": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BasketballBonus"
              },
              {
                "type": "null"
              }
            ],
            "description": "Basketball only: the side or sides in the bonus. It is null while the game is not in progress or interrupted, and when our data source gives no value; the source’s live feed lacks it, so you only get it over REST and in lists. Available since 2026-11-09."
          },
          "finalResultOnly": {
            "type": "boolean",
            "description": "`true` if our data source covers only the final result of this fixture, with no live score, clock or events during play (since 2026-11-09)."
          },
          "durations": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Durations"
              },
              {
                "type": "null"
              }
            ],
            "description": "Sports played in sets or rounds: the length of every finished period (since 2026-11-04). Null for sports our data source does not time by period (football, basketball, …) and until the first period is over. Delivered live through WebSocket deltas."
          },
          "lineupsAvailable": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "`true` once our data source has published lineups for the fixture, whether predicted or official (`confirmed` on /v2/fixtures/{id}/lineups tells you which); `false` if they were withdrawn. We set it the moment the source’s live feed announces lineups, or when a lineup we fetch contains players. Null means we have no information (no announcement observed, nothing fetched). WebSocket deltas carry it live — on fixture:{id} from before kick-off, and on the list channels once play starts. Available since 2026-11-04."
          },
          "lineupsConfirmed": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "`true` once official lineups have been released (`confirmed` on /v2/fixtures/{id}/lineups), set in the same way as lineupsAvailable; null means we have no information. Delivered live through WebSocket deltas. Available since 2026-11-04."
          },
          "playerMatch": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerMatch"
              },
              {
                "type": "null"
              }
            ],
            "description": "The player’s own involvement in this fixture, or null when our data source has nothing listed."
          }
        },
        "required": [
          "id",
          "sport",
          "status",
          "startTime",
          "league",
          "season",
          "round",
          "home",
          "away",
          "homeScore",
          "awayScore",
          "winner",
          "venue",
          "clock",
          "firstToServe",
          "serving",
          "servedFirst",
          "homeSeed",
          "awaySeed",
          "note",
          "battingSide",
          "fightResult",
          "fightDiscipline",
          "referee",
          "homeManager",
          "awayManager",
          "surface",
          "discipline",
          "toss",
          "umpires",
          "tvUmpire",
          "previousLegFixtureId",
          "aggregateWinner",
          "fightCard",
          "attendance",
          "matchFormat",
          "inningState",
          "timeouts",
          "downAndDistance",
          "varCheck",
          "bonus",
          "finalResultOnly",
          "durations",
          "lineupsAvailable",
          "lineupsConfirmed",
          "playerMatch"
        ]
      },
      "PlayerMatch": {
        "type": "object",
        "description": "One player’s personal involvement in a single fixture.",
        "properties": {
          "side": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Which side the player represented."
          },
          "onBench": {
            "type": "boolean",
            "description": "`true` if the player was a named substitute who never came on."
          },
          "rating": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Player’s match rating (for example 7.4), rounded to two decimal places; null if there is none — the player did not take part, was not rated, or the match has not been played yet."
          },
          "statistics": {
            "type": "object",
            "additionalProperties": {
              "type": "number"
            },
            "description": "Statistics for this match as supplied with the player’s fixture list, using the same keys as lineup statistics (football: minutesPlayed; basketball: points, rebounds, assists, fieldGoalsMade, fieldGoalsAttempted, secondsPlayed, plusMinus …; ice hockey: goals, assists, shotsOnGoal, secondsPlayed …). All …Percentage values are on a 0–100 scale. An empty object when nothing is available."
          },
          "incidents": {
            "type": "object",
            "additionalProperties": {
              "type": "number"
            },
            "description": "Per-player tallies built from the match incidents, e.g. goals (penalties included), penaltyGoals (spot-kicks among those goals), assists, yellowCards, redCards …; an empty object if nothing applies."
          }
        },
        "required": [
          "side",
          "onBench",
          "rating",
          "statistics",
          "incidents"
        ]
      },
      "RankingTypeInfo": {
        "type": "object",
        "description": "An entry in GET /v2/rankings describing one ranking table; use its `type` with GET /v2/rankings/{type}.",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/RankingTypeSlug",
            "description": "Identifier of an available ranking table; GET /v2/rankings lists them all with names."
          },
          "name": {
            "type": "string",
            "description": "Human-readable name, such as \"ATP singles ranking\"."
          },
          "sport": {
            "type": "string",
            "description": "Slug of the sport, matching /v2/sports."
          },
          "gender": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamGender"
              },
              {
                "type": "null"
              }
            ],
            "description": "Whether the ranking is for men or women; null for rankings of countries."
          },
          "entry": {
            "$ref": "#/components/schemas/RankingEntry",
            "description": "What each row of the ranking represents."
          }
        },
        "required": [
          "type",
          "name",
          "sport",
          "gender",
          "entry"
        ]
      },
      "Ranking": {
        "type": "object",
        "description": "A full ranking table, as returned by GET /v2/rankings/{type}.",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/RankingTypeSlug",
            "description": "Identifier of an available ranking table; GET /v2/rankings lists them all with names."
          },
          "updatedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Time of our data source’s most recent update to the table."
          },
          "rows": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RankingRow"
            },
            "description": "All rows, highest-ranked first."
          }
        },
        "required": [
          "type",
          "updatedAt",
          "rows"
        ]
      },
      "RankingRow": {
        "type": "object",
        "description": "A single entry in a ranking table.",
        "properties": {
          "position": {
            "type": "integer",
            "description": "Rank, where 1 is the top spot. In MMA division rankings the champion leads the list with position 0."
          },
          "previousPosition": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Rank in the ranking’s previous edition (0 marks the MMA champion); null if our data source does not provide it."
          },
          "points": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Points in the ranking. UEFA uses coefficients and UTR the rating itself (e.g. 16.45); rankings with no points, such as MMA, give null."
          },
          "previousPoints": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Previous edition’s points; null if our data source does not include them."
          },
          "bestPosition": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Highest rank ever reached (tennis); null for other rankings."
          },
          "tournamentsPlayed": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of tournaments that count towards the total (ATP); null for other rankings."
          },
          "team": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Team-type object for whoever is ranked; tennis players and fighters are modelled as teams too. In a ranking of countries this is null."
          },
          "league": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/LeagueRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "For a country ranking (UEFA): that country’s top league; null for other rankings."
          },
          "country": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Country"
              },
              {
                "type": "null"
              }
            ],
            "description": "Country of the team or competitor, or — for UEFA’s country ranking — the ranked country itself; null if unknown."
          }
        },
        "required": [
          "position",
          "previousPosition",
          "points",
          "previousPoints",
          "bestPosition",
          "tournamentsPlayed",
          "team",
          "league",
          "country"
        ]
      },
      "Category": {
        "type": "object",
        "description": "A bucket of leagues inside a sport, forming the top tier of the league directory.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Category identifier. Use it as the `category` parameter of GET /v2/leagues, or of GET /v2/fixtures to list that category’s fixtures on a given day (since 2026-11-04)."
          },
          "name": {
            "type": "string",
            "description": "Category label: a country such as \"England\", a region such as \"International\" or \"World\", a tour such as \"ATP\", or a game in esports."
          },
          "slug": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Slug for use in URLs."
          },
          "sport": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Slug of the sport, matching /v2/sports."
          },
          "country": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Country"
              },
              {
                "type": "null"
              }
            ],
            "description": "The country this category represents, if it is a country; null for regions, tours and games. Pass its `code` to GET /v2/leagues as `country`."
          }
        },
        "required": [
          "id",
          "name",
          "slug",
          "sport",
          "country"
        ]
      },
      "PlayerStatisticsRow": {
        "type": "object",
        "description": "A single player’s row in the player-statistics explorer for a league season.",
        "properties": {
          "player": {
            "$ref": "#/components/schemas/PlayerRef",
            "description": "The player, in the reference shape used by every other object."
          },
          "team": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Club the player represented in this league season — after a mid-season move, the most recent one."
          },
          "statistics": {
            "type": "object",
            "additionalProperties": {
              "type": "number"
            },
            "description": "Totals for the season in the requested statistics group, keyed with v2 season-statistic names (identical to /v2/players/{id}/statistics: averageRating, goals, expectedGoals, shotsOnGoal, cleanSheets, …; `…Percentage` runs 0–100). Keys our data source omits for a player are left out, and averageRating is missing for unrated players (for whom the source sends 0)."
          }
        },
        "required": [
          "player",
          "team",
          "statistics"
        ]
      },
      "SeriesRef": {
        "type": "object",
        "description": "A racing series, which plays the role of a league in race sports: a motorsport championship, or in cycling the complete men’s or women’s road calendar. Races sit inside its seasons, and /v2/series/{id}/standings ranks competitors across a season.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The series’ id."
          },
          "name": {
            "type": "string",
            "description": "Name of the series, for example \"Formula 1\", \"MotoGP\" or \"NASCAR Cup Series\". Cycling is organised differently: our data source bundles each gender’s road races into a single series (\"Cycling Men\", \"Cycling Women\")."
          },
          "slug": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Slug for use in URLs."
          },
          "sport": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Slug of the sport, matching /v2/sports."
          }
        },
        "required": [
          "id",
          "name",
          "slug",
          "sport"
        ]
      },
      "Circuit": {
        "type": "object",
        "description": "The track hosting a motorsport race.",
        "properties": {
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Name of the track (\"Circuit of the Americas\")."
          },
          "city": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "City where the circuit is located."
          },
          "country": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Country"
              },
              {
                "type": "null"
              }
            ],
            "description": "Country where the circuit is located."
          },
          "lengthMeters": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Length of one lap, in metres. Unit: meters."
          }
        },
        "required": [
          "name",
          "city",
          "country",
          "lengthMeters"
        ]
      },
      "Race": {
        "type": "object",
        "description": "Covers either a motorsport weekend (with practice, qualifying, sprint and race sessions) or a cycling event — a one-day race or a stage race.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The race’s id."
          },
          "name": {
            "type": "string",
            "description": "What the race is called, e.g. \"USA GP\", \"Tour de France\", \"Gran Piemonte\"."
          },
          "slug": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Slug for use in URLs."
          },
          "sport": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Slug of the sport, matching /v2/sports."
          },
          "series": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SeriesRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Series that includes this race."
          },
          "season": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Season"
              },
              {
                "type": "null"
              }
            ],
            "description": "Which season of the series the race falls in (\"Formula 1 2026\"); its id is what the /v2/series/{id}/… endpoints expect."
          },
          "round": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Championship round number as assigned by our data source; cancelled races may leave gaps in the sequence."
          },
          "status": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/StatusType"
              },
              {
                "type": "null"
              }
            ],
            "description": "State of the race: notstarted before its first session, inprogress, finished after all sessions are complete, canceled, or postponed."
          },
          "startDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "First day of the race (UTC); the sessions carry exact times. /v2/races and /v2/races/{id} never put it later than the first session’s day, while the race list of a season (/v2/series/{id}/races) keeps our data source’s dates."
          },
          "endDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Last day of the race (UTC). /v2/races and /v2/races/{id} never put it earlier than the last session’s day."
          },
          "country": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Country"
              },
              {
                "type": "null"
              }
            ],
            "description": "Country hosting the race."
          },
          "circuit": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Circuit"
              },
              {
                "type": "null"
              }
            ],
            "description": "Track used (motorsport); null for cycling."
          },
          "laps": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "How many laps the main race is scheduled for (motorsport)."
          },
          "distanceMeters": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Main-race distance for motorsport, given in metres. Unit: meters."
          },
          "category": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Cycling: the race category (e.g. \"World Tour 1 Grand Tour\"), as our data source labels it."
          },
          "winner": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Who won — the main race in motorsport, the general classification in a cycling stage race — filled only after the finish. Drivers and riders are TeamRefs (kind individual), just as tennis players are."
          },
          "sessions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RaceSession"
            },
            "description": "All sessions, sorted by start time (oldest first)."
          }
        },
        "required": [
          "id",
          "name",
          "slug",
          "sport",
          "series",
          "season",
          "round",
          "status",
          "startDate",
          "endDate",
          "country",
          "circuit",
          "laps",
          "distanceMeters",
          "category",
          "winner",
          "sessions"
        ]
      },
      "RaceSnapshot": {
        "type": "object",
        "description": "Snapshot sent on the race:{id} channel: the race, its sessions and the results of the current session.",
        "properties": {
          "race": {
            "$ref": "#/components/schemas/Race",
            "description": "Covers either a motorsport weekend (with practice, qualifying, sprint and race sessions) or a cycling event — a one-day race or a stage race."
          },
          "session": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Which session the results belong to — the live one if any, otherwise the most recently finished; null until a session has run."
          },
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RaceResult"
            },
            "description": "Classification for that session, as from /v2/races/{id}/results?session=; [] while none exists."
          }
        },
        "required": [
          "race",
          "session",
          "results"
        ]
      },
      "RaceSummary": {
        "type": "object",
        "description": "A race in a season listing, without sessions (fetch /v2/races/{id} for those).",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The race’s id."
          },
          "name": {
            "type": "string",
            "description": "What the race is called, e.g. \"USA GP\", \"Tour de France\", \"Gran Piemonte\"."
          },
          "slug": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Slug for use in URLs."
          },
          "sport": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Slug of the sport, matching /v2/sports."
          },
          "series": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SeriesRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Series that includes this race."
          },
          "season": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Season"
              },
              {
                "type": "null"
              }
            ],
            "description": "Which season of the series the race falls in (\"Formula 1 2026\"); its id is what the /v2/series/{id}/… endpoints expect."
          },
          "round": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Championship round number as assigned by our data source; cancelled races may leave gaps in the sequence."
          },
          "status": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/StatusType"
              },
              {
                "type": "null"
              }
            ],
            "description": "State of the race: notstarted before its first session, inprogress, finished after all sessions are complete, canceled, or postponed."
          },
          "startDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "First day of the race (UTC); the sessions carry exact times. /v2/races and /v2/races/{id} never put it later than the first session’s day, while the race list of a season (/v2/series/{id}/races) keeps our data source’s dates."
          },
          "endDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Last day of the race (UTC). /v2/races and /v2/races/{id} never put it earlier than the last session’s day."
          },
          "country": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Country"
              },
              {
                "type": "null"
              }
            ],
            "description": "Country hosting the race."
          },
          "circuit": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Circuit"
              },
              {
                "type": "null"
              }
            ],
            "description": "Track used (motorsport); null for cycling."
          },
          "laps": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "How many laps the main race is scheduled for (motorsport)."
          },
          "distanceMeters": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Main-race distance for motorsport, given in metres. Unit: meters."
          },
          "category": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Cycling: the race category (e.g. \"World Tour 1 Grand Tour\"), as our data source labels it."
          },
          "winner": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Who won — the main race in motorsport, the general classification in a cycling stage race — filled only after the finish. Drivers and riders are TeamRefs (kind individual), just as tennis players are."
          }
        },
        "required": [
          "id",
          "name",
          "slug",
          "sport",
          "series",
          "season",
          "round",
          "status",
          "startDate",
          "endDate",
          "country",
          "circuit",
          "laps",
          "distanceMeters",
          "category",
          "winner"
        ]
      },
      "RaceSession": {
        "type": "object",
        "description": "A timed segment of a race. In motorsport that is a practice, qualifying, sprint or the race itself; in cycling it is a stage of a stage race (a one-day race consists of a single session, the race).",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Identifier of the session, accepted by /v2/races/{id}/results?session=."
          },
          "name": {
            "type": "string",
            "description": "Name of the session as provided by our data source (\"Practice 1\", \"Qualification\", \"Grand Prix\", \"Stage 5\")."
          },
          "type": {
            "$ref": "#/components/schemas/RaceSessionType",
            "description": "Kind of session."
          },
          "status": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/StatusType"
              },
              {
                "type": "null"
              }
            ],
            "description": "State of the session, using the fixture status types; null if our data source gives none."
          },
          "startTime": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Planned start time in UTC."
          },
          "laps": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Planned lap count (motorsport races)."
          },
          "lapsCompleted": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Laps actually completed; fewer than `laps` if the race was shortened."
          },
          "distanceMeters": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "How far the session covers in metres — for cycling, the stage length. Unit: meters."
          },
          "departureCity": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Town the stage departs from (cycling)."
          },
          "arrivalCity": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Town where the stage finishes (cycling)."
          },
          "profile": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/StageProfile"
              },
              {
                "type": "null"
              }
            ],
            "description": "Stage terrain profile (cycling)."
          },
          "weather": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/RaceWeather"
              },
              {
                "type": "null"
              }
            ],
            "description": "Weather conditions, available after the session has run."
          },
          "trackCondition": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TrackCondition"
              },
              {
                "type": "null"
              }
            ],
            "description": "Whether the track was dry or wet."
          },
          "airTemperatureC": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Measured air temperature, in degrees Celsius. Unit: celsius."
          },
          "trackTemperatureC": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Measured track-surface temperature in degrees Celsius (motorsport). Unit: celsius."
          },
          "humidityPercent": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Humidity as a relative percentage (0–100). Unit: percent."
          },
          "safetyCar": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "`true` if the safety car was deployed; null if this was not reported."
          },
          "winner": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Winner of the session (the quickest in practice / qualifying), set only after the session ends."
          },
          "parts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RaceSessionPart"
            },
            "description": "For knock-out qualifying and sprint qualifying sessions, the individual segments (Q1, Q2…) in run order. Every other session — and any where our data source lists none — has an empty array."
          }
        },
        "required": [
          "id",
          "name",
          "type",
          "status",
          "startTime",
          "laps",
          "lapsCompleted",
          "distanceMeters",
          "departureCity",
          "arrivalCity",
          "profile",
          "weather",
          "trackCondition",
          "airTemperatureC",
          "trackTemperatureC",
          "humidityPercent",
          "safetyCar",
          "winner",
          "parts"
        ]
      },
      "RaceSessionPart": {
        "type": "object",
        "description": "One segment (MotoGP Q1 / Q2, Formula 1 Q1–Q3) of a knock-out qualifying session; segments are listed in run order.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Id of the segment; use it as session= on /v2/races/{id}/results to fetch only that segment’s results."
          },
          "name": {
            "type": "string",
            "description": "Label in the series’ own convention, numbered by run order: \"Q1\", \"Q2\", \"Q3\" in qualifying, \"SQ1\"… in sprint qualifying."
          },
          "status": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/StatusType"
              },
              {
                "type": "null"
              }
            ],
            "description": "State of the segment; null when our data source gives none (Formula 1 segments)."
          },
          "startTime": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Planned start time in UTC; null if our data source gives none."
          }
        },
        "required": [
          "id",
          "name",
          "status",
          "startTime"
        ]
      },
      "RaceResult": {
        "type": "object",
        "description": "A single competitor’s entry in the classification of a session or race.",
        "properties": {
          "position": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Finishing position; null for a competitor who is not classified (check `state`)."
          },
          "competitor": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Who raced: a driver or rider, represented as a TeamRef with kind individual."
          },
          "team": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Constructor or cycling team the competitor belongs to."
          },
          "state": {
            "$ref": "#/components/schemas/RaceResultState",
            "description": "Whether the competitor is classified, and if not, the reason."
          },
          "outReason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Reason for being out, in our data source’s wording (\"Retired\"); null for classified competitors."
          },
          "carNumber": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Race number on the car or bike (motorsport)."
          },
          "gridPosition": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Grid slot at the start (races); null for a pit-lane start or when unknown."
          },
          "startedFromPitLane": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "Set to `true` for a pit-lane start."
          },
          "laps": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Lap count according to our data source."
          },
          "lapsBehind": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "How many laps down on the winner (for lapped cars); null if on the lead lap."
          },
          "lapsLed": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of laps spent in the lead."
          },
          "pitStops": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of pit stops made."
          },
          "timeMs": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Overall time in ms for a race or stage, or the best lap in practice and qualifying. Null for lapped and non-classified competitors, and for a classified rider without a time in our data source. Unit: milliseconds."
          },
          "gapMs": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Gap to the winner. Null for the winner itself, for lapped or non-classified competitors, and for a classified rider with no time logged by our data source. Unit: milliseconds."
          },
          "intervalMs": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Gap to the competitor immediately in front; null for the winner, for lapped and non-classified competitors, and for a classified rider without a time in our data source. Unit: milliseconds."
          },
          "bestLapMs": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Quickest lap this competitor set, in ms (races). Unit: milliseconds."
          },
          "bestLapNumber": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of the lap on which that best time came."
          },
          "fastestLap": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "`true` if this was the quickest lap of the whole session."
          },
          "points": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Championship points earned from this result."
          },
          "tyreStints": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TyreStint"
            },
            "description": "Sequence of tyre stints (Formula 1 races only; empty elsewhere)."
          },
          "currentTyre": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CurrentTyre"
              },
              {
                "type": "null"
              }
            ],
            "description": "The set of tyres currently fitted (Formula 1 sessions while running, then the final set once over); null if our data source does not report it. Available since 2026-11-09."
          },
          "inPit": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "Whether the car is currently in the pit lane during a live session (`true`); null if our data source does not report it. Available since 2026-11-09."
          },
          "cycling": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CyclingStanding"
              },
              {
                "type": "null"
              }
            ],
            "description": "Secondary classifications, present on the overall result of a cycling stage race; null elsewhere."
          },
          "part": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "When the classification is stitched together from qualifying segments (MotoGP qualifying, for which our data source has no combined table), the segment this entry was taken from (\"Q2\", \"Q1\"); timeMs / gapMs / intervalMs then refer to that segment. Null otherwise."
          }
        },
        "required": [
          "position",
          "competitor",
          "team",
          "state",
          "outReason",
          "carNumber",
          "gridPosition",
          "startedFromPitLane",
          "laps",
          "lapsBehind",
          "lapsLed",
          "pitStops",
          "timeMs",
          "gapMs",
          "intervalMs",
          "bestLapMs",
          "bestLapNumber",
          "fastestLap",
          "points",
          "tyreStints",
          "currentTyre",
          "inPit",
          "cycling",
          "part"
        ]
      },
      "TyreStint": {
        "type": "object",
        "description": "A run on a single set of tyres.",
        "properties": {
          "compound": {
            "$ref": "#/components/schemas/TyreCompound",
            "description": "Tyre compound used."
          },
          "laps": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of laps completed on this set."
          }
        },
        "required": [
          "compound",
          "laps"
        ]
      },
      "CyclingStanding": {
        "type": "object",
        "description": "Secondary-classification standings for one rider within a stage race’s overall result.",
        "properties": {
          "jersey": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CyclingJersey"
              },
              {
                "type": "null"
              }
            ],
            "description": "Leader’s jersey worn by this rider, if there is one."
          },
          "pointsPosition": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Where the rider sits in the points classification."
          },
          "points": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Points tallied in the points classification."
          },
          "mountainsPosition": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Where the rider sits in the mountains classification."
          },
          "mountainsPoints": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Points tallied in the mountains classification."
          },
          "youngRiderPosition": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Where the rider sits in the young-rider classification."
          },
          "youngRiderTimeMs": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Time on which the young-rider classification is based (total, in ms). Unit: milliseconds."
          }
        },
        "required": [
          "jersey",
          "pointsPosition",
          "points",
          "mountainsPosition",
          "mountainsPoints",
          "youngRiderPosition",
          "youngRiderTimeMs"
        ]
      },
      "SeriesStandingsRow": {
        "type": "object",
        "description": "A single entry in a series championship table.",
        "properties": {
          "position": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Position in the championship."
          },
          "competitor": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "The ranked entity — a driver or rider with `type=competitors`, a team with `type=teams`."
          },
          "team": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "For drivers and riders, the team they race for; null in the teams table."
          },
          "points": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Points in the championship."
          },
          "wins": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of races won."
          },
          "podiums": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of podium finishes."
          },
          "polePositions": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of pole positions."
          },
          "fastestLaps": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of fastest laps."
          },
          "racesStarted": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of races started."
          },
          "racesWithPoints": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of races finished in the points."
          }
        },
        "required": [
          "position",
          "competitor",
          "team",
          "points",
          "wins",
          "podiums",
          "polePositions",
          "fastestLaps",
          "racesStarted",
          "racesWithPoints"
        ]
      },
      "WinProbability": {
        "type": "object",
        "description": "DataSportsAPI’s in-house in-play win-probability model for football fixtures (explained in the docs). Its starting point is pre-match expected goals — which v2 builds from each team’s recent results in every competition, its domestic table and our league-strength coefficients, then mixes with the competition’s own table and form — and then adjusts for time remaining, score, red cards and momentum. It is an analytical indicator, not betting advice, and uses no bookmaker odds.",
        "properties": {
          "fixtureId": {
            "type": "integer",
            "description": "The fixture’s id."
          },
          "model": {
            "$ref": "#/components/schemas/WinProbabilityModel",
            "description": "Version of the model, each described in the docs; new versions are announced in the changelog."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Time at which this estimate was calculated."
          },
          "prematch": {
            "$ref": "#/components/schemas/WinProbabilityPrematch",
            "description": "The estimate made before kick-off, with the inputs it was built from. Once computed it is fixed; later table updates do not touch it."
          },
          "current": {
            "$ref": "#/components/schemas/WinProbabilityState",
            "description": "Most recent estimate — equal to the pre-match figure before kick-off and to certainty (1 / 0 / 0) once the match is over."
          },
          "series": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/WinProbabilityPoint"
            },
            "description": "The probability curve, sorted oldest first by `at`. Points come at kick-off, at every match minute, and straight after each goal or red card, each start or end of a period and each big missed chance; before kick-off it is empty. Each point becomes permanent at two minutes old (or when the match ends) and is never edited after that, which keeps the curve faithful to what the model said in the moment. Passing `?since=` returns only the points after that instant."
          },
          "inputs": {
            "type": "object",
            "properties": {
              "shotmap": {
                "type": "boolean"
              },
              "momentum": {
                "type": "boolean"
              },
              "events": {
                "type": "boolean"
              }
            },
            "required": [
              "shotmap",
              "momentum",
              "events"
            ],
            "description": "Live inputs that the in-play estimate drew on."
          }
        },
        "required": [
          "fixtureId",
          "model",
          "updatedAt",
          "prematch",
          "current",
          "series",
          "inputs"
        ]
      },
      "WinProbabilityPrematch": {
        "type": "object",
        "description": "The estimate made before kick-off, with the inputs it was built from. Once computed it is fixed; later table updates do not touch it.",
        "properties": {
          "home": {
            "type": "number",
            "description": "Likelihood of a home win before kick-off, from 0 to 1. Unit: ratio."
          },
          "draw": {
            "type": "number",
            "description": "Likelihood of a draw before kick-off, from 0 to 1. Unit: ratio."
          },
          "away": {
            "type": "number",
            "description": "Likelihood of an away win before kick-off, from 0 to 1. Unit: ratio."
          },
          "homeExpectedGoals": {
            "type": "number",
            "description": "Expected goals the model assigns to the home side for the full match (λ home)."
          },
          "awayExpectedGoals": {
            "type": "number",
            "description": "Expected goals the model assigns to the away side for the full match (λ away)."
          },
          "standings": {
            "type": "boolean",
            "description": "`true` if the league table (attack / defence ratings) could be used; `false` means league or global averages stood in."
          },
          "form": {
            "type": "boolean",
            "description": "`true` if a pre-match form guide could be used."
          },
          "allCompetitions": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "Model v2 only: `true` if the teams’ recent matches across all competitions could be used (strength derived from as many as their last 20 results, weighted by how old each is and by opponent strength). Null for model v1."
          },
          "domesticTables": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "Model v2 only: `true` if the teams’ domestic league tables could be used (in a cup or European tie, each side’s own league table, made comparable with our league-strength coefficients). Model v1 leaves it null."
          }
        },
        "required": [
          "home",
          "draw",
          "away",
          "homeExpectedGoals",
          "awayExpectedGoals",
          "standings",
          "form",
          "allCompetitions",
          "domesticTables"
        ]
      },
      "WinProbabilityState": {
        "type": "object",
        "description": "A snapshot of the predicted outcome: home / draw / away probabilities at a given point in the match.",
        "properties": {
          "home": {
            "type": "number",
            "description": "Chance, from 0 to 1, that the home side finishes the match with more goals on the scoreboard. Unit: ratio."
          },
          "draw": {
            "type": "number",
            "description": "Chance, from 0 to 1, that the scoreboard is level at the end (a penalty shoot-out does not count). home + draw + away = 1. Unit: ratio."
          },
          "away": {
            "type": "number",
            "description": "Chance, from 0 to 1, that the away side finishes the match with more goals on the scoreboard. Unit: ratio."
          },
          "minute": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Minute of the match this estimate refers to, counted like incidents: a goal in the 23rd minute gives 23, and 45+2 becomes minute 45 with addedMinute 2. Before kick-off it is null. Unit: minutes."
          },
          "addedMinute": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "How far into added time, in minutes; null outside added time. Unit: minutes."
          },
          "homeScore": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Goals the home side had at that point. Null before kick-off."
          },
          "awayScore": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Goals the away side had at that point. Null before kick-off."
          },
          "at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "The UTC instant the estimate is tied to. On a curve point it marks the match moment the point stands for — the close of that minute, or the goal or whistle itself — read from the running match clock or, when the clock is stopped, estimated from kick-off, allowing 15 minutes for half-time. On `current` it is when the estimate was computed (before kick-off and in play) or when the match ended (once finished). Along the series it only ever goes up. Null only for points saved before 2026-10-22 without a known kick-off time."
          }
        },
        "required": [
          "home",
          "draw",
          "away",
          "minute",
          "addedMinute",
          "homeScore",
          "awayScore",
          "at"
        ]
      },
      "WinProbabilityPoint": {
        "type": "object",
        "description": "One point on the win-probability curve: the estimate together with the reason it was recorded.",
        "properties": {
          "home": {
            "type": "number",
            "description": "Chance, from 0 to 1, that the home side finishes the match with more goals on the scoreboard. Unit: ratio."
          },
          "draw": {
            "type": "number",
            "description": "Chance, from 0 to 1, that the scoreboard is level at the end (a penalty shoot-out does not count). home + draw + away = 1. Unit: ratio."
          },
          "away": {
            "type": "number",
            "description": "Chance, from 0 to 1, that the away side finishes the match with more goals on the scoreboard. Unit: ratio."
          },
          "minute": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Minute of the match this estimate refers to, counted like incidents: a goal in the 23rd minute gives 23, and 45+2 becomes minute 45 with addedMinute 2. Before kick-off it is null. Unit: minutes."
          },
          "addedMinute": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "How far into added time, in minutes; null outside added time. Unit: minutes."
          },
          "homeScore": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Goals the home side had at that point. Null before kick-off."
          },
          "awayScore": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Goals the away side had at that point. Null before kick-off."
          },
          "at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "The UTC instant the estimate is tied to. On a curve point it marks the match moment the point stands for — the close of that minute, or the goal or whistle itself — read from the running match clock or, when the clock is stopped, estimated from kick-off, allowing 15 minutes for half-time. On `current` it is when the estimate was computed (before kick-off and in play) or when the match ended (once finished). Along the series it only ever goes up. Null only for points saved before 2026-10-22 without a known kick-off time."
          },
          "reason": {
            "$ref": "#/components/schemas/WinProbabilityReason",
            "description": "What triggered this point on the curve."
          }
        },
        "required": [
          "home",
          "draw",
          "away",
          "minute",
          "addedMinute",
          "homeScore",
          "awayScore",
          "at",
          "reason"
        ]
      },
      "Commentary": {
        "type": "object",
        "description": "Automated match commentary for a football fixture, produced by DataSportsAPI AI using nothing but our own data. Goals, red cards, missed penalties, VAR decisions, the start and end of each period, big chances and lasting momentum shifts each get a short entry, and there are summaries at half-time and full time. Each entry is generated a single time and served identically to all clients.",
        "properties": {
          "fixtureId": {
            "type": "integer",
            "description": "The fixture’s id."
          },
          "entries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CommentaryEntry"
            },
            "description": "Entries ordered oldest first by `seq`, as in every timeline list. Empty until the first entry exists: commentary is only produced while someone is following the match (via this endpoint or the fixture:{id} channel; featured matches on datasportsapi.com always get it), so a match with no followers has none."
          }
        },
        "required": [
          "fixtureId",
          "entries"
        ]
      },
      "CommentaryEntry": {
        "type": "object",
        "description": "A single entry of AI commentary.",
        "properties": {
          "seq": {
            "type": "integer",
            "description": "Sequence number within the fixture’s commentary — 1, 2, 3, … in writing order. A number is never reused."
          },
          "kind": {
            "$ref": "#/components/schemas/CommentaryKind",
            "description": "The subject of the entry; if it covers several events, the most significant one."
          },
          "minute": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Minute of the latest event the entry covers, counted as incidents are (45+2 is minute 45 with addedMinute 2). For summaries it is the whistle: 45 for halfTime, 90 for fullTime (120 after extra time); null on fullTime entries written before 2026-10-23. Unit: minutes."
          },
          "addedMinute": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "How far into added time, in minutes; null outside added time. Unit: minutes."
          },
          "text": {
            "type": "string",
            "description": "Plain-text commentary of one or two English sentences (up to three for summaries), written by DataSportsAPI AI from our own match data alone (score, clock, events, statistics and our win-probability model). It contains no betting language."
          },
          "model": {
            "type": "string",
            "description": "Identifier of the generating model: \"datasportsapi-ai\" (DataSportsAPI AI). Entries served before 2026-11-02 carried the name of the underlying provider model instead."
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "Time the entry was generated."
          }
        },
        "required": [
          "seq",
          "kind",
          "minute",
          "addedMinute",
          "text",
          "model",
          "createdAt"
        ]
      },
      "PlayByPlay": {
        "type": "object",
        "description": "Our data source’s play-by-play text, with an entry for each action (football, basketball, …). The source’s data provider writes it, not DataSportsAPI — see /commentary for our own AI commentary.",
        "properties": {
          "entries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PlayByPlayEntry"
            },
            "description": "Entries in chronological order, oldest first, as in every timeline list."
          }
        },
        "required": [
          "entries"
        ]
      },
      "PlayByPlayEntry": {
        "type": "object",
        "description": "A single play-by-play line from our data source’s text commentary.",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/PlayByPlayType",
            "description": "The kind of action the entry describes."
          },
          "side": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Side that `player` belongs to (or the team the entry concerns); null for entries about the match as a whole (kick-off, period ends, delays)."
          },
          "period": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PeriodKey"
              },
              {
                "type": "null"
              }
            ],
            "description": "Period in which the action took place; null when our data source gives none (football’s final whistle)."
          },
          "minute": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Football: the match minute, with added time held separately (45+6 → minute 45, addedMinute 6). Null for clock sports (basketball uses `periodSecond`) and when our data source gives no time. Unit: minutes."
          },
          "addedMinute": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Added-time minutes in football (45+6 → 6); other cases give null. Unit: minutes."
          },
          "periodSecond": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Basketball and other clock sports: elapsed seconds in the current period. Football gives null. Unit: seconds."
          },
          "periodSecondsLeft": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Basketball and other clock sports: the game clock, counting down the seconds left in the period. Football gives null. Unit: seconds."
          },
          "at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "UTC time the action was logged, where our data source timestamps it (basketball); null elsewhere."
          },
          "text": {
            "type": "string",
            "description": "The English commentary text, verbatim from our data source."
          },
          "player": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "The player the line concerns — the shooter, scorer, booked or fouling player, rebounder, and so on."
          },
          "assist": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Player credited with the assist, if our data source names one (basketball baskets)."
          },
          "playerIn": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "substitution: the incoming player."
          },
          "playerOut": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "substitution: the outgoing player."
          },
          "drawnBy": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "foul (basketball): the fouled player."
          },
          "stolenBy": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "possessionChange (basketball): who made the steal."
          },
          "goalkeeper": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Goalkeeper our data source links to a shot (football). The source also fills it on a handful of basketball shots; what it means there has not been verified."
          },
          "homeScore": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "scoreChange / penaltyScored: the home side’s score once the action is counted; null on all other entries."
          },
          "awayScore": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "scoreChange / penaltyScored: the away side’s score once the action is counted; null on all other entries."
          },
          "scoreType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayByPlayScoreType"
              },
              {
                "type": "null"
              }
            ],
            "description": "scoreChange (basketball): how many points the basket counted for; null in football and on every other entry."
          },
          "position": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CourtPosition"
              },
              {
                "type": "null"
              }
            ],
            "description": "Basketball only: court location of the action, or null if our data source has none."
          },
          "zone": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CourtZone"
              },
              {
                "type": "null"
              }
            ],
            "description": "Basketball: the area of the court; null when our data source provides none."
          }
        },
        "required": [
          "type",
          "side",
          "period",
          "minute",
          "addedMinute",
          "periodSecond",
          "periodSecondsLeft",
          "at",
          "text",
          "player",
          "assist",
          "playerIn",
          "playerOut",
          "drawnBy",
          "stolenBy",
          "goalkeeper",
          "homeScore",
          "awayScore",
          "scoreType",
          "position",
          "zone"
        ]
      },
      "CourtPosition": {
        "type": "object",
        "description": "Court location of a basketball action, expressed in our data source’s court units.",
        "properties": {
          "x": {
            "type": "number",
            "description": "Position on the horizontal axis, measured in our data source’s court units."
          },
          "y": {
            "type": "number",
            "description": "Position on the vertical axis, measured in our data source’s court units."
          }
        },
        "required": [
          "x",
          "y"
        ]
      },
      "LeagueDetail": {
        "type": "object",
        "description": "Full league profile from /v2/leagues/{id}: everything in LeagueRef, plus the league’s level, current champion, record title-holders and the divisions directly above and below. Host countries are given per season (/v2/leagues/{id}/seasons/{seasonId}).",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The league’s id."
          },
          "name": {
            "type": "string",
            "description": "Name of the league or competition."
          },
          "slug": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Slug for use in URLs."
          },
          "sport": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Slug of the sport, matching /v2/sports."
          },
          "category": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "How our data source groups the league: by country (\"England\"), region (\"International\", \"North America\", \"World\"), tour (\"ATP\", \"WTA\") or game (esports: \"Counter Strike\"). It is not necessarily a country; use `country` for that."
          },
          "country": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Country"
              },
              {
                "type": "null"
              }
            ],
            "description": "Set when the league’s category is a country (that country); null for regions, tours and games."
          },
          "image": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ],
            "description": "CDN URL of the league logo; null if the league has none."
          },
          "priority": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Our data source’s prominence score for the competition, handy for sorting leagues: a higher value means a bigger competition (for example 719 for the Champions League, 704 for the Premier League, 702 for LaLiga, 519 for Primeira Liga), and 0 means unranked. It is filled only where the source supplies it: on the league embedded in a fixture and in the /v2/fixtures?date&sport day lists. Everywhere else — league profiles, directories, search — it is null, as it is on rows saved before 2026-11-04. Available since 2026-11-04."
          },
          "tier": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tier within the national league pyramid: 1 for the top flight (Premier League), 2 for the second level (Championship); null for cups, international competitions and anything outside a pyramid."
          },
          "gender": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamGender"
              },
              {
                "type": "null"
              }
            ],
            "description": "Whether the competition is for men or women; null if our data source does not specify."
          },
          "titleHolder": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Current title holder — the winner of the most recent completed season — if our data source names one."
          },
          "titleHolderTitles": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Total number of times the current title holder has won this competition."
          },
          "mostTitles": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Highest number of titles any single team has won."
          },
          "mostTitlesTeams": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TeamRef"
            },
            "description": "Team or teams holding that record (more than one if tied); [] if our data source names none."
          },
          "upperDivisions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LeagueRef"
            },
            "description": "Leagues directly above — the destination of promoted teams; [] for a top flight or a cup."
          },
          "lowerDivisions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LeagueRef"
            },
            "description": "Leagues directly below — the destination of relegated teams; [] if none is listed."
          },
          "currentSeasonStart": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Start date of the current (or next) season, in UTC."
          },
          "currentSeasonEnd": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Planned end date of the current season, in UTC."
          }
        },
        "required": [
          "id",
          "name",
          "slug",
          "sport",
          "category",
          "country",
          "image",
          "priority",
          "tier",
          "gender",
          "titleHolder",
          "titleHolderTitles",
          "mostTitles",
          "mostTitlesTeams",
          "upperDivisions",
          "lowerDivisions",
          "currentSeasonStart",
          "currentSeasonEnd"
        ]
      },
      "RefereeProfile": {
        "type": "object",
        "description": "Referee profile from /v2/referees/{id}, with career totals across all competitions our data source covers (`games`, cards) and a breakdown per competition.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The referee’s id."
          },
          "name": {
            "type": "string",
            "description": "Full name of the referee."
          },
          "slug": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Slug for use in URLs."
          },
          "country": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Country"
              },
              {
                "type": "null"
              }
            ],
            "description": "Country of the referee, if our data source provides it."
          },
          "games": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of matches our data source has logged with this referee officiating, across the whole career and all competitions."
          },
          "yellowCards": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Bookings (yellow cards) handed out across those matches; null where the sport has no cards (cricket)."
          },
          "redCards": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Straight red cards handed out across those matches; null where the sport has no cards."
          },
          "yellowRedCards": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Dismissals for a second yellow in those matches; null for sports that have no cards."
          },
          "image": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ],
            "description": "CDN URL of the referee’s photo; null if there is no image or it has not been uploaded yet. Available since 2026-11-04."
          },
          "sport": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Slug of the sport."
          },
          "competitions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RefereeCompetition"
            },
            "description": "Per-competition breakdown of the career, ordered as our data source lists it; [] when there is none."
          }
        },
        "required": [
          "id",
          "name",
          "slug",
          "country",
          "games",
          "yellowCards",
          "redCards",
          "yellowRedCards",
          "image",
          "sport",
          "competitions"
        ]
      },
      "RefereeCompetition": {
        "type": "object",
        "description": "Career numbers for a referee within a single competition; divide by `appearances` to get per-match rates.",
        "properties": {
          "league": {
            "$ref": "#/components/schemas/LeagueRef",
            "description": "Competition these figures relate to."
          },
          "appearances": {
            "type": "integer",
            "description": "Number of matches officiated in this competition."
          },
          "yellowCards": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Bookings (yellow cards) handed out in those matches."
          },
          "redCards": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Direct red cards handed out."
          },
          "yellowRedCards": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Dismissals for a second yellow."
          },
          "penalties": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of penalties given."
          }
        },
        "required": [
          "league",
          "appearances",
          "yellowCards",
          "redCards",
          "yellowRedCards",
          "penalties"
        ]
      },
      "ManagerProfile": {
        "type": "object",
        "description": "Profile of a manager or head coach from /v2/managers/{id}, including the career record and the individual jobs that make it up.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The manager’s id — identical to the ManagerRef id on fixtures and teams."
          },
          "name": {
            "type": "string",
            "description": "Full name."
          },
          "slug": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Slug for use in URLs."
          },
          "shortName": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Abbreviated name, such as \"J. Mourinho\"."
          },
          "image": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ],
            "description": "CDN URL of the manager’s photo; null if there is no image or it has not been uploaded yet. Available since 2026-11-04."
          },
          "sport": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Slug of the sport."
          },
          "country": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Country"
              },
              {
                "type": "null"
              }
            ],
            "description": "Country of nationality."
          },
          "dateOfBirth": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Birth date."
          },
          "preferredFormation": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Football: the formation they favour, in our data source’s notation (\"4-2-3-1\")."
          },
          "team": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Team currently under their management; null if they are out of work."
          },
          "career": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ManagerRecord"
              },
              {
                "type": "null"
              }
            ],
            "description": "Overall career results across all jobs our data source covers."
          },
          "stints": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ManagerStint"
            },
            "description": "Their positions, most recent first (as in transfer lists); [] if our data source has no history."
          }
        },
        "required": [
          "id",
          "name",
          "slug",
          "shortName",
          "image",
          "sport",
          "country",
          "dateOfBirth",
          "preferredFormation",
          "team",
          "career",
          "stints"
        ]
      },
      "ManagerRecord": {
        "type": "object",
        "description": "Results for a manager over a span of time — an entire career or a single job. Points per game is points / games.",
        "properties": {
          "games": {
            "type": "integer",
            "description": "Number of matches in charge."
          },
          "wins": {
            "type": "integer",
            "description": "Matches won."
          },
          "draws": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Matches drawn; null for sports with no draws."
          },
          "losses": {
            "type": "integer",
            "description": "Matches lost."
          },
          "scoresFor": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Goals (or points, …) their teams scored; null if our data source does not provide them."
          },
          "scoresAgainst": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Goals (or points, …) their teams conceded."
          },
          "points": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "League points earned (in football, 3 per win and 1 per draw); null if our data source does not provide them."
          }
        },
        "required": [
          "games",
          "wins",
          "draws",
          "losses",
          "scoresFor",
          "scoresAgainst",
          "points"
        ]
      },
      "ManagerStint": {
        "type": "object",
        "description": "A single position held during a manager’s career.",
        "properties": {
          "team": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Team they were in charge of."
          },
          "from": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date they took charge (UTC)."
          },
          "to": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Final day in charge (UTC). For their present job our data source supplies a FUTURE date — the contract end date it holds — rather than null."
          },
          "record": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ManagerRecord"
              },
              {
                "type": "null"
              }
            ],
            "description": "Win / draw / loss record for that job; null when our data source has none (youth teams, older spells)."
          }
        },
        "required": [
          "team",
          "from",
          "to",
          "record"
        ]
      },
      "Trophy": {
        "type": "object",
        "description": "An entry in a team’s trophy cabinet, representing one competition.",
        "properties": {
          "league": {
            "$ref": "#/components/schemas/LeagueRef",
            "description": "Competition the trophy is for."
          },
          "competitionType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CompetitionType"
              },
              {
                "type": "null"
              }
            ],
            "description": "Type of competition: national league, national cup or international."
          },
          "major": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "`true` if our data source treats it as a major honour (a league or cup, as opposed to a super cup)."
          },
          "count": {
            "type": "integer",
            "description": "Number of times the team has won it."
          },
          "seasons": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TrophySeason"
            },
            "description": "Seasons in which it was won, most recent first (as in season lists). Can contain fewer items than `count` when our data source has no date for very old titles."
          }
        },
        "required": [
          "league",
          "competitionType",
          "major",
          "count",
          "seasons"
        ]
      },
      "TrophySeason": {
        "type": "object",
        "description": "A season in which a trophy was won. Our data source supplies only the label, not a season id.",
        "properties": {
          "year": {
            "type": "string",
            "description": "Season label in our data source’s format (\"23/24\", \"1932/1933\", \"2026\")."
          },
          "startYear": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Starting year of the season; null if the label cannot be parsed."
          },
          "endYear": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Ending year of the season."
          }
        },
        "required": [
          "year",
          "startYear",
          "endYear"
        ]
      },
      "PositionHistoryPoint": {
        "type": "object",
        "description": "A team’s league position as it stood at the close of a given week in the season.",
        "properties": {
          "week": {
            "type": "integer",
            "description": "Week number within the season, starting at 1 (following our data source’s weekly buckets)."
          },
          "from": {
            "type": "string",
            "format": "date",
            "description": "Opening day of the week (UTC)."
          },
          "to": {
            "type": "string",
            "format": "date",
            "description": "Final day of the week, inclusive (UTC)."
          },
          "position": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Where the team was placed in the league when the week ended."
          },
          "fixtureIds": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "Fixture ids of the team’s matches in this competition during the week — typically one, and none in a blank week."
          }
        },
        "required": [
          "week",
          "from",
          "to",
          "position",
          "fixtureIds"
        ]
      },
      "FighterCareerStatistics": {
        "type": "object",
        "description": "Career statistics for an MMA fighter, calculated by our data source from the fights it holds detailed data on (which may not be the full career). Includes per-round and per-15-minute rates, 0–100 shares and time spent in each position. Keys take the match-statistics names (`significantStrikesHeadLanded`, `takedownsSucceeded`, …) and add the rate as a suffix. Null means the source has no figure.",
        "properties": {
          "strikesLandedPerRound": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Average strikes landed per round, counting every strike."
          },
          "strikesDistanceLandedPerRound": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Average strikes landed per round while at distance."
          },
          "strikesDistancePercentage": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Strikes landed at distance as a share of all their landed strikes, 0–100. Unit: percent."
          },
          "strikesClinchLandedPerRound": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Average strikes landed per round from the clinch."
          },
          "strikesClinchPercentage": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Clinch strikes as a share of all their landed strikes, 0–100. Unit: percent."
          },
          "strikesGroundLandedPerRound": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Average strikes landed per round on the ground."
          },
          "strikesGroundPercentage": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Ground strikes as a share of all their landed strikes, 0–100. Unit: percent."
          },
          "strikesReceivedPerRound": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Average strikes taken from opponents per round."
          },
          "significantStrikesLandedPerRound": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Per-round average of significant strikes landed."
          },
          "significantStrikesPercentage": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Significant strikes as a share of all their landed strikes, 0–100. Unit: percent."
          },
          "significantStrikesHeadLandedPerRound": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Per-round average of significant strikes landed to the head."
          },
          "significantStrikesHeadPercentage": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Head strikes as a share of their significant strikes, 0–100. Unit: percent."
          },
          "significantStrikesBodyLandedPerRound": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Per-round average of significant strikes landed to the body."
          },
          "significantStrikesBodyPercentage": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Body strikes as a share of their significant strikes, 0–100. Unit: percent."
          },
          "significantStrikesLegsLandedPerRound": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Per-round average of significant strikes landed to the legs."
          },
          "significantStrikesLegsPercentage": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Leg strikes as a share of their significant strikes, 0–100. Unit: percent."
          },
          "significantStrikesDistanceLandedPerRound": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Per-round average of significant strikes landed at distance."
          },
          "significantStrikesDistancePercentage": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Significant strikes at distance as a share of all their significant strikes, 0–100. Unit: percent."
          },
          "significantStrikesClinchLandedPerRound": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Per-round average of significant strikes landed in the clinch."
          },
          "significantStrikesClinchPercentage": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Significant strikes in the clinch as a share of all their significant strikes, 0–100. Unit: percent."
          },
          "significantStrikesGroundLandedPerRound": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Per-round average of significant strikes landed on the ground."
          },
          "significantStrikesGroundPercentage": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Significant strikes on the ground as a share of all their significant strikes, 0–100. Unit: percent."
          },
          "significantStrikesReceivedPerRound": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Average significant strikes taken from opponents per round."
          },
          "takedownsAttemptedPer15Min": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of takedowns they attempt per 15 minutes."
          },
          "takedownsSucceededPer15Min": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Successful takedowns per 15 minutes."
          },
          "takedownsSucceededPercentage": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Share of their takedown attempts that succeed (landed / attempted), 0–100. Unit: percent."
          },
          "takedownsReceivedPer15Min": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Takedown attempts made against them per 15 minutes."
          },
          "takedownsDefendedPer15Min": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Of those attempts, the number they stopped per 15 minutes."
          },
          "takedownsDefendedPercentage": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Takedown defence rate — attempts stopped divided by attempts against them, 0–100. Unit: percent."
          },
          "transitionsSucceededPer15Min": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Ground advances (positional transitions) they completed per 15 minutes."
          },
          "transitionsReceivedPer15Min": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Positional transitions completed against them per 15 minutes."
          },
          "submissionsAttemptedPer15Min": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "How many submissions they attempt per 15 minutes."
          },
          "submissionsSucceededPer15Min": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "How many submissions they complete per 15 minutes."
          },
          "submissionsSucceededPercentage": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Submission success rate — completed divided by attempted, 0–100. Unit: percent."
          },
          "submissionsReceivedPer15Min": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "How many submissions opponents attempt on them per 15 minutes."
          },
          "submissionsDefendedPer15Min": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Of those attempts, how many they fended off per 15 minutes."
          },
          "submissionsDefendedPercentage": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Share of submission attempts against them that they defend, 0–100. Unit: percent."
          },
          "distanceSeconds": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Total career time spent fighting at distance. Unit: seconds."
          },
          "distanceSecondsPerRound": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Average time per round spent at distance. Unit: seconds."
          },
          "distancePercentage": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Per-round average of the proportion of fight time spent at distance, 0–100. This is our data source’s own number: it can exceed 100 slightly (100.2 has been observed), and the distance, clinch and ground shares do not necessarily sum to 100. Unit: percent."
          },
          "clinchSeconds": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Total career time spent in the clinch. Unit: seconds."
          },
          "clinchSecondsPerRound": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Average time per round spent in the clinch. Unit: seconds."
          },
          "clinchPercentage": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Per-round average of the proportion of fight time spent in the clinch, 0–100 (caveats as for `distancePercentage`). Unit: percent."
          },
          "clinchControlSeconds": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Total career time spent controlling an opponent in the clinch. Unit: seconds."
          },
          "clinchControlPercentage": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Clinch control as a share of total fight time, 0–100. Unit: percent."
          },
          "groundSeconds": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Total career time spent on the ground. Unit: seconds."
          },
          "groundSecondsPerRound": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Average time per round spent on the ground. Unit: seconds."
          },
          "groundPercentage": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Per-round average of the proportion of fight time spent on the ground, 0–100 (caveats as for `distancePercentage`). Unit: percent."
          },
          "groundControlSeconds": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Total career time spent in control on the ground. Unit: seconds."
          },
          "groundControlPercentage": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Ground control as a share of total fight time, 0–100. Unit: percent."
          }
        },
        "required": [
          "strikesLandedPerRound",
          "strikesDistanceLandedPerRound",
          "strikesDistancePercentage",
          "strikesClinchLandedPerRound",
          "strikesClinchPercentage",
          "strikesGroundLandedPerRound",
          "strikesGroundPercentage",
          "strikesReceivedPerRound",
          "significantStrikesLandedPerRound",
          "significantStrikesPercentage",
          "significantStrikesHeadLandedPerRound",
          "significantStrikesHeadPercentage",
          "significantStrikesBodyLandedPerRound",
          "significantStrikesBodyPercentage",
          "significantStrikesLegsLandedPerRound",
          "significantStrikesLegsPercentage",
          "significantStrikesDistanceLandedPerRound",
          "significantStrikesDistancePercentage",
          "significantStrikesClinchLandedPerRound",
          "significantStrikesClinchPercentage",
          "significantStrikesGroundLandedPerRound",
          "significantStrikesGroundPercentage",
          "significantStrikesReceivedPerRound",
          "takedownsAttemptedPer15Min",
          "takedownsSucceededPer15Min",
          "takedownsSucceededPercentage",
          "takedownsReceivedPer15Min",
          "takedownsDefendedPer15Min",
          "takedownsDefendedPercentage",
          "transitionsSucceededPer15Min",
          "transitionsReceivedPer15Min",
          "submissionsAttemptedPer15Min",
          "submissionsSucceededPer15Min",
          "submissionsSucceededPercentage",
          "submissionsReceivedPer15Min",
          "submissionsDefendedPer15Min",
          "submissionsDefendedPercentage",
          "distanceSeconds",
          "distanceSecondsPerRound",
          "distancePercentage",
          "clinchSeconds",
          "clinchSecondsPerRound",
          "clinchPercentage",
          "clinchControlSeconds",
          "clinchControlPercentage",
          "groundSeconds",
          "groundSecondsPerRound",
          "groundPercentage",
          "groundControlSeconds",
          "groundControlPercentage"
        ]
      },
      "FighterRecord": {
        "type": "object",
        "description": "The CAREER record (e.g. 28-0-4) of a fighter in MMA or boxing. It is not the same as /v2/fixtures/{id}/form, where our data source gives pre-fight form inside the event’s competition (8-0-3 for that fighter, for example).",
        "properties": {
          "wins": {
            "type": "integer",
            "description": "Professional wins across all promotions, per our data source’s career record."
          },
          "draws": {
            "type": "integer",
            "description": "Draws over the career."
          },
          "losses": {
            "type": "integer",
            "description": "Losses over the career."
          },
          "recent": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RecentFight"
            },
            "description": "The latest fights, at most five, each with its method, in chronological order. No career-wide breakdown by method is given, because our data source has none and only lists the recent fights it covers."
          }
        },
        "required": [
          "wins",
          "draws",
          "losses",
          "recent"
        ]
      },
      "RecentFight": {
        "type": "object",
        "description": "A recent fight as it appears in our data source’s record for the fighter.",
        "properties": {
          "result": {
            "$ref": "#/components/schemas/RecentFightResult",
            "description": "Outcome for this fighter: win, draw, loss or no contest."
          },
          "method": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FightMethod"
              },
              {
                "type": "null"
              }
            ],
            "description": "Finish method (KO, TKO, submission, decisions, …), or null when our data source does not record one."
          }
        },
        "required": [
          "result",
          "method"
        ]
      },
      "TeamOfTheWeek": {
        "type": "object",
        "description": "A line-up built from the highest-rated players of one round or week in a league season.",
        "properties": {
          "period": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamOfTheWeekPeriod"
              },
              {
                "type": "null"
              }
            ],
            "description": "Round or week the team covers; null only when the list of periods could not be loaded."
          },
          "formation": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Formation of the line-up — \"3-4-3\" in football, \"2-3\" in basketball, for instance."
          },
          "players": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TeamOfTheWeekPlayer"
            },
            "description": "Selected players, sorted by `order`."
          }
        },
        "required": [
          "period",
          "formation",
          "players"
        ]
      },
      "TeamOfTheWeekPeriod": {
        "type": "object",
        "description": "A season round or week that has a team of the week attached.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Period identifier, used as the `period` parameter of /v2/leagues/{id}/team-of-the-week."
          },
          "kind": {
            "$ref": "#/components/schemas/TeamOfTheWeekPeriodKind",
            "description": "Whether the period is a round or a span of days."
          },
          "sequence": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Position of the period within the season, starting at 1 (equal to the round number in round-based leagues)."
          },
          "round": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "For kind round: the round covered, as listed by /v2/leagues/{id}/rounds; null for other kinds."
          },
          "roundName": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "For kind round: the round’s name in our data source’s wording; null for other kinds."
          },
          "from": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "For kind week / month: when the span begins; null for a round."
          },
          "to": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Exclusive end of the span; null for a round."
          },
          "publishedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Time our data source published this team of the week."
          }
        },
        "required": [
          "id",
          "kind",
          "sequence",
          "round",
          "roundName",
          "from",
          "to",
          "publishedAt"
        ]
      },
      "TeamOfTheWeekPlayer": {
        "type": "object",
        "description": "An individual selected for a team of the week.",
        "properties": {
          "order": {
            "type": "integer",
            "description": "Slot in the line-up: 1 is the goalkeeper (football), then numbering runs from defence to attack following the formation."
          },
          "player": {
            "$ref": "#/components/schemas/PlayerRef",
            "description": "The player, in the reference shape used by every other object."
          },
          "team": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Club they represented during the period."
          },
          "position": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Position"
              },
              {
                "type": "null"
              }
            ],
            "description": "Their position, as our data source’s code, interpreted per sport."
          },
          "rating": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Our data source’s match rating (0–10) that won them the spot."
          },
          "fixtureId": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Fixture id of the match the rating comes from."
          }
        },
        "required": [
          "order",
          "player",
          "team",
          "position",
          "rating",
          "fixtureId"
        ]
      },
      "PlayerAttributes": {
        "type": "object",
        "description": "Attribute ratings for a football player across the years, together with their strengths and weaknesses, all from our data source’s own scouting model.",
        "properties": {
          "current": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AttributeOverview"
              },
              {
                "type": "null"
              }
            ],
            "description": "Latest ratings (yearsAgo 0); null if our data source does not rate the player at all."
          },
          "history": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AttributeOverview"
            },
            "description": "All ratings our data source holds, starting with the current one (yearsAgo 0, 1, 2, …)."
          },
          "positionAverage": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AttributeOverview"
              },
              {
                "type": "null"
              }
            ],
            "description": "Average ratings for players in the same position, as a benchmark."
          },
          "strengths": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PlayerCharacteristic"
            },
            "description": "Strengths our data source attributes to the player, in the source’s order."
          },
          "weaknesses": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PlayerCharacteristic"
            },
            "description": "Weaknesses our data source attributes to the player."
          },
          "positions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DetailedPosition"
            },
            "description": "Detailed positions the player occupies, primary position first."
          }
        },
        "required": [
          "current",
          "history",
          "positionAverage",
          "strengths",
          "weaknesses",
          "positions"
        ]
      },
      "AttributeOverview": {
        "type": "object",
        "description": "A set of attribute ratings on a 0–100 scale from our data source’s own model. Outfield players are rated on attacking / technical / tactical / defending / creativity, goalkeepers on saves / anticipation / ballDistribution / aerial / tactical; keys belonging to the other group are null.",
        "properties": {
          "yearsAgo": {
            "type": "integer",
            "description": "How many years back the rating is: 0 for now, 1 for the year before, etc."
          },
          "position": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Position"
              },
              {
                "type": "null"
              }
            ],
            "description": "Which position the ratings are given for — outfield and goalkeeper ratings come with different keys."
          },
          "attacking": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Outfield players’ attacking rating on a 0–100 scale; goalkeepers get null."
          },
          "technical": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Outfield players’ technical rating, 0–100."
          },
          "tactical": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tactical rating on a 0–100 scale, given to outfield players and goalkeepers alike."
          },
          "defending": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Outfield players’ defending rating, 0–100."
          },
          "creativity": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Outfield players’ creativity rating, 0–100."
          },
          "saves": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Goalkeepers’ saves rating on a 0–100 scale; outfield players get null."
          },
          "anticipation": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Goalkeepers’ anticipation rating, 0–100."
          },
          "ballDistribution": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Goalkeepers’ ball-distribution rating, 0–100."
          },
          "aerial": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Goalkeepers’ aerial-play rating, 0–100."
          }
        },
        "required": [
          "yearsAgo",
          "position",
          "attacking",
          "technical",
          "tactical",
          "defending",
          "creativity",
          "saves",
          "anticipation",
          "ballDistribution",
          "aerial"
        ]
      },
      "VenueProfile": {
        "type": "object",
        "description": "Profile of a stadium or arena covering its location, capacity, resident teams and match record for each sport.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The venue’s id — the same one found on Fixture.venue, TeamDetail.venue and venue search results."
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Name of the stadium or arena."
          },
          "slug": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Slug for use in URLs."
          },
          "city": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "City where the venue is located."
          },
          "country": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Country"
              },
              {
                "type": "null"
              }
            ],
            "description": "Country where the venue is located."
          },
          "capacity": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of seats."
          },
          "latitude": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Geographic latitude (WGS 84, degrees)."
          },
          "longitude": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Geographic longitude (WGS 84, degrees)."
          },
          "image": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ],
            "description": "CDN URL of a venue photo; null if our data source has none or it has not been uploaded yet."
          },
          "teams": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TeamRef"
            },
            "description": "Teams that use the venue as their home ground."
          },
          "sports": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/VenueSportStatistics"
            },
            "description": "One entry per sport played at the venue, busiest first; the sport slug is the `sport` value accepted by /v2/venues/{id}/fixtures."
          }
        },
        "required": [
          "id",
          "name",
          "slug",
          "city",
          "country",
          "capacity",
          "latitude",
          "longitude",
          "image",
          "teams",
          "sports"
        ]
      },
      "VenueSportStatistics": {
        "type": "object",
        "description": "Aggregate results for a single sport at a venue, across all matches our data source holds for it.",
        "properties": {
          "sport": {
            "type": "string",
            "description": "Slug of the sport."
          },
          "matchCount": {
            "type": "integer",
            "description": "Number of matches in that sport our data source records at the venue."
          },
          "scored": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Total goals (or points, runs …) scored by both sides in those matches."
          },
          "homeWinPercentage": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "How often the home side won those matches, as a percentage (0–100). Unit: percent."
          },
          "drawPercentage": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "How often those matches ended in a draw, as a percentage (0–100). Unit: percent."
          }
        },
        "required": [
          "sport",
          "matchCount",
          "scored",
          "homeWinPercentage",
          "drawPercentage"
        ]
      },
      "NationalTeamRecord": {
        "type": "object",
        "description": "A player’s international record for a single national side.",
        "properties": {
          "team": {
            "$ref": "#/components/schemas/TeamRef",
            "description": "The national side, at senior or youth level."
          },
          "appearances": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Caps: international matches played for that side."
          },
          "goals": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Goals scored for that side in international matches."
          },
          "debut": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date of their debut for the side; our data source gives only the day, so the time is midnight UTC."
          }
        },
        "required": [
          "team",
          "appearances",
          "goals",
          "debut"
        ]
      },
      "SeasonHeatmap": {
        "type": "object",
        "description": "A player’s areas of activity across a league season (football, covered leagues), built by summing their per-match heatmaps.",
        "properties": {
          "points": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SeasonHeatPoint"
            },
            "description": "All points with their counts; draw them as a weighted density map."
          },
          "fixtureCount": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of matches feeding the heatmap, as counted by our data source."
          },
          "fixtureIds": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "Fixture ids of those matches, to the extent our data source lists them."
          }
        },
        "required": [
          "points",
          "fixtureCount",
          "fixtureIds"
        ]
      },
      "SeasonHeatPoint": {
        "type": "object",
        "description": "A single point on a season heatmap along with how many samples it holds.",
        "properties": {
          "x": {
            "type": "number",
            "description": "Lengthwise position on the pitch, 0–100, using the match heatmap’s scale. Unit: percent."
          },
          "y": {
            "type": "number",
            "description": "Position across the width of the pitch, 0–100. Unit: percent."
          },
          "count": {
            "type": "integer",
            "description": "Number of samples recorded at this point during the season; use it to weight the density."
          }
        },
        "required": [
          "x",
          "y",
          "count"
        ]
      },
      "PlayerRating": {
        "type": "object",
        "description": "The rating a player received in a single match of a season, forming one point on their rating chart.",
        "properties": {
          "fixtureId": {
            "type": "integer",
            "description": "Fixture id of the match."
          },
          "startTime": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Kick-off time of the match."
          },
          "rating": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Match rating from our data source (0–10)."
          },
          "side": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Side they represented in that match."
          },
          "opponent": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "The opposing team."
          }
        },
        "required": [
          "fixtureId",
          "startTime",
          "rating",
          "side",
          "opponent"
        ]
      },
      "PlayerCareerSeason": {
        "type": "object",
        "description": "One row of a player’s career table: their statistics for a single competition, season and type.",
        "properties": {
          "league": {
            "$ref": "#/components/schemas/LeagueRef",
            "description": "Competition the row covers."
          },
          "season": {
            "$ref": "#/components/schemas/Season",
            "description": "Season of this row. Its id goes into the `season` parameter of /v2/players/{id}/statistics, together with this league."
          },
          "team": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Club they represented in this competition, or a national side in international competitions."
          },
          "type": {
            "$ref": "#/components/schemas/SeasonStatsType",
            "description": "Which matches are included: overall, or regularSeason / playoffs in leagues that separate them."
          },
          "statistics": {
            "type": "object",
            "additionalProperties": {
              "type": "number"
            },
            "description": "Totals and averages for the season, keyed exactly as in /v2/players/{id}/statistics (naming conventions for season figures: `…PerMatch` is the total divided by matches, `…Per90` is per 90 minutes, `average…` is a season mean, `…Percentage` runs 0–100, and units are spelled out in the key). Ratings are rounded to two decimal places."
          }
        },
        "required": [
          "league",
          "season",
          "team",
          "type",
          "statistics"
        ]
      },
      "TeamRanking": {
        "type": "object",
        "description": "One row from /v2/rankings/{type}, showing a team’s or competitor’s position in that ranking table.",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/RankingTypeSlug",
            "description": "Which ranking table this is; fetch the full table with GET /v2/rankings/{type}."
          },
          "position": {
            "type": "integer",
            "description": "Current rank in the table (0 for MMA champions)."
          },
          "previousPosition": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Rank in the previous edition; null if our data source does not provide it."
          },
          "points": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Ranking points — for UTR, the Universal Tennis Rating value itself (e.g. 16.45). Rankings without points return null."
          },
          "previousPoints": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Previous edition’s points."
          },
          "bestPosition": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Best rank ever reached (tennis), if our data source provides it."
          },
          "bestPositionAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date the career-high rank was reached, if our data source provides it (which is rare)."
          },
          "tournamentsPlayed": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of tournaments that count towards the total (ATP / WTA); null for other rankings."
          }
        },
        "required": [
          "type",
          "position",
          "previousPosition",
          "points",
          "previousPoints",
          "bestPosition",
          "bestPositionAt",
          "tournamentsPlayed"
        ]
      },
      "PlayerOfTheSeason": {
        "type": "object",
        "description": "Our data source’s player of the season for a completed league season — the highest average rating among players who met the playing-time threshold.",
        "properties": {
          "player": {
            "$ref": "#/components/schemas/PlayerRef",
            "description": "The winning player."
          },
          "team": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Team they played for that season."
          },
          "rating": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Average match rating across the season, from our data source, rounded to two decimal places."
          },
          "appearances": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of matches in which they received a rating."
          }
        },
        "required": [
          "player",
          "team",
          "rating",
          "appearances"
        ]
      },
      "PlayerOfTheSeasonCandidate": {
        "type": "object",
        "description": "A candidate for player of the season; candidates are ordered by average rating, highest first.",
        "properties": {
          "player": {
            "$ref": "#/components/schemas/PlayerRef",
            "description": "The candidate."
          },
          "team": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Team they played for that season."
          },
          "rating": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Average match rating across the season, from our data source, rounded to two decimal places."
          },
          "appearances": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of matches in which they received a rating."
          },
          "playedEnough": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "`true` if they have played enough of the season to be eligible."
          }
        },
        "required": [
          "player",
          "team",
          "rating",
          "appearances",
          "playedEnough"
        ]
      },
      "Pitch": {
        "type": "object",
        "description": "A single pitch in a baseball at-bat, or a play that happens between pitches, with its type, speed, location, outcome, the resulting count, runners and fielders.",
        "properties": {
          "kind": {
            "$ref": "#/components/schemas/PitchEventKind",
            "description": "Whether this is a pitch or a play between pitches."
          },
          "number": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Pitch number within the at-bat, starting at 1; a play between pitches reuses the number of the preceding pitch (0 if no pitch has been thrown yet)."
          },
          "at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Time the pitch was delivered."
          },
          "pitcher": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Player on the mound."
          },
          "batter": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Player at the plate."
          },
          "pitcherHand": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Handedness"
              },
              {
                "type": "null"
              }
            ],
            "description": "Throwing hand of the pitcher."
          },
          "batterHand": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Handedness"
              },
              {
                "type": "null"
              }
            ],
            "description": "Side of the plate the batter hits from."
          },
          "pitchType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PitchType"
              },
              {
                "type": "null"
              }
            ],
            "description": "Kind of pitch; null for a play between pitches."
          },
          "pitchName": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Pitch name in our data source’s words (\"Four-Seam Fastball\"), intended for display only."
          },
          "speedKmh": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Speed of the ball at release. Unit: kilometersPerHour."
          },
          "zone": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Location where the ball crossed the plate, using MLB Statcast zones: 1–9 cover the strike zone as a 3 × 3 grid numbered from the top left from the catcher’s view, and 11–14 are the four quadrants outside it."
          },
          "outcome": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PitchOutcome"
              },
              {
                "type": "null"
              }
            ],
            "description": "Result of the pitch; null for a play between pitches."
          },
          "outcomeCode": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Raw outcome code from our data source (\"bB\", \"kKS\", \"oFO\", …), for outcomes that `other` leaves unnamed."
          },
          "endsAtBat": {
            "type": "boolean",
            "description": "`true` if the at-bat finished on this pitch."
          },
          "balls": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Ball count once the pitch is recorded."
          },
          "strikes": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Strike count once the pitch is recorded."
          },
          "outs": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Outs in the half-inning once the pitch is recorded."
          },
          "homeScore": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Home side’s runs once the pitch is recorded."
          },
          "awayScore": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Away side’s runs once the pitch is recorded."
          },
          "hit": {
            "type": "boolean",
            "description": "`true` if the pitch resulted in a base hit."
          },
          "bunt": {
            "type": "boolean",
            "description": "`true` if the batter bunted."
          },
          "wildPitch": {
            "type": "boolean",
            "description": "`true` if it was a wild pitch."
          },
          "passedBall": {
            "type": "boolean",
            "description": "`true` if it was a passed ball."
          },
          "doublePlay": {
            "type": "boolean",
            "description": "`true` if a double play resulted."
          },
          "triplePlay": {
            "type": "boolean",
            "description": "`true` if a triple play resulted."
          },
          "overturned": {
            "type": "boolean",
            "description": "`true` if the call was reversed after review."
          },
          "battedBall": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BattedBall"
              },
              {
                "type": "null"
              }
            ],
            "description": "Details of the ball put in play, if any."
          },
          "runners": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PitchRunner"
            },
            "description": "Runner movements on the play in the order listed, including the batter once they start running."
          },
          "fielders": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PitchFielder"
            },
            "description": "Fielders who received credit on the play."
          }
        },
        "required": [
          "kind",
          "number",
          "at",
          "pitcher",
          "batter",
          "pitcherHand",
          "batterHand",
          "pitchType",
          "pitchName",
          "speedKmh",
          "zone",
          "outcome",
          "outcomeCode",
          "endsAtBat",
          "balls",
          "strikes",
          "outs",
          "homeScore",
          "awayScore",
          "hit",
          "bunt",
          "wildPitch",
          "passedBall",
          "doublePlay",
          "triplePlay",
          "overturned",
          "battedBall",
          "runners",
          "fielders"
        ]
      },
      "PitchRunner": {
        "type": "object",
        "description": "Movement of one runner during a pitch or a play between pitches.",
        "properties": {
          "player": {
            "$ref": "#/components/schemas/PitchActor",
            "description": "Someone named on a pitch as a runner or a fielder."
          },
          "fromBase": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Starting base: 0 for the batter at the plate, 1–3 for first through third base."
          },
          "toBase": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Base reached: 1–3 for first through third, 4 for home (a run scored); null if they were put out."
          },
          "out": {
            "type": "boolean",
            "description": "`true` if the runner was retired on the play."
          }
        },
        "required": [
          "player",
          "fromBase",
          "toBase",
          "out"
        ]
      },
      "PitchActor": {
        "type": "object",
        "description": "Someone named on a pitch as a runner or a fielder.",
        "properties": {
          "id": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "The player’s id; null if our data source supplies none."
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Name in our data source’s listing."
          }
        },
        "required": [
          "id",
          "name"
        ]
      },
      "PitchFielder": {
        "type": "object",
        "description": "Credit given to a fielder on a play.",
        "properties": {
          "player": {
            "$ref": "#/components/schemas/PitchActor",
            "description": "Someone named on a pitch as a runner or a fielder."
          },
          "role": {
            "$ref": "#/components/schemas/FielderRole",
            "description": "The fielder’s part in the play."
          },
          "order": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Sequence within the play, where 1 is the first fielder to touch the ball."
          }
        },
        "required": [
          "player",
          "role",
          "order"
        ]
      },
      "BattedBall": {
        "type": "object",
        "description": "Details of a ball hit into play.",
        "properties": {
          "trajectory": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BattedBallTrajectory"
              },
              {
                "type": "null"
              }
            ],
            "description": "Flight path of the ball."
          },
          "hardness": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BattedBallHardness"
              },
              {
                "type": "null"
              }
            ],
            "description": "Strength of contact off the bat."
          }
        },
        "required": [
          "trajectory",
          "hardness"
        ]
      },
      "Highlight": {
        "type": "object",
        "description": "A match highlight video that lives on a third-party platform.",
        "properties": {
          "title": {
            "type": "string",
            "description": "Video title, for example \"Liverpool FC 0-1 Arsenal\"."
          },
          "subtitle": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Secondary title such as \"Full Highlights\", or the text of the post."
          },
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Link to the video on its platform (YouTube, X, …). DataSportsAPI does not host video, so link to or embed it from that platform."
          },
          "provider": {
            "$ref": "#/components/schemas/HighlightProvider",
            "description": "Platform hosting the video."
          },
          "thumbnailUrl": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ],
            "description": "Thumbnail hosted by the video platform itself (i.ytimg.com, pbs.twimg.com); any other platform gives null."
          },
          "main": {
            "type": "boolean",
            "description": "`true` if our data source marks this as the match’s primary highlight."
          },
          "countries": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Two-letter codes of the countries to which our data source restricts the video (broadcast rights); an empty list means it is available everywhere."
          },
          "publishedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Time our data source added the highlight."
          }
        },
        "required": [
          "title",
          "subtitle",
          "url",
          "provider",
          "thumbnailUrl",
          "main",
          "countries",
          "publishedAt"
        ]
      },
      "Durations": {
        "type": "object",
        "description": "Period lengths for sports played in sets or rounds (tennis, table tennis, badminton, volleyball, MMA, …), as timed by our data source.",
        "properties": {
          "periods": {
            "type": "object",
            "propertyNames": {
              "$ref": "#/components/schemas/PeriodKey"
            },
            "additionalProperties": {
              "type": "number"
            },
            "description": "Duration in seconds of every COMPLETED period, using the same keys as ScoreSide.periods (in tennis period1 is the first set; in MMA / boxing the keys are the rounds). The period under way is excluded; its start is clock.periodStartedAt."
          },
          "totalSeconds": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Adds up `periods`: once the match has ended this is its playing time, not counting breaks between periods. Null when `periods` is empty. Unit: seconds."
          }
        },
        "required": [
          "periods",
          "totalSeconds"
        ]
      },
      "SourceWinProbability": {
        "type": "object",
        "description": "In-game win probability published by our data source itself for a fixture. Only available for American football (NFL), the single sport the source provides it for (verified 2026-11-04). Served over REST only — no WebSocket frame includes it. It is an analytical indicator, not betting advice.",
        "properties": {
          "fixtureId": {
            "type": "integer",
            "description": "The fixture’s id."
          },
          "model": {
            "type": "string",
            "const": "source",
            "description": "Always \"source\", signalling that the estimate comes from the DATA SOURCE alongside its match data rather than from the football model we run ourselves, which lives at GET /v2/fixtures/{id}/win-probability (model values v1 to v3). Its methodology is unknown to us; no bookmaker odds are used on our side."
          },
          "periodLengthMinutes": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "How long a regulation period lasts — 15 in the NFL. Unit: minutes."
          },
          "periodCount": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of regulation periods (4 in the NFL)."
          },
          "overtimeLengthMinutes": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "How long an overtime period lasts — 10 in the NFL regular season. Unit: minutes."
          },
          "series": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SourceWinProbabilityPoint"
            },
            "description": "The probability curve, oldest point first, at about one point per minute of play (minutes can be missing, and the curve may start at 1). It grows as the game goes on; the last point is simply the source’s most recent estimate and need not be 0 or 1 when the game ends. Empty before kick-off and whenever the source has no data."
          }
        },
        "required": [
          "fixtureId",
          "model",
          "periodLengthMinutes",
          "periodCount",
          "overtimeLengthMinutes",
          "series"
        ]
      },
      "SourceWinProbabilityPoint": {
        "type": "object",
        "description": "A single data point (one game minute) on the win-probability curve our data source publishes.",
        "properties": {
          "minute": {
            "type": "integer",
            "description": "Minute of game time the estimate applies to — measured in playing time rather than wall-clock time (an NFL quarter is 15 minutes, and overtime carries on the count: 61, 62, …). Unit: minutes."
          },
          "home": {
            "type": "number",
            "description": "Our data source’s estimated chance of a home win, from 0 to 1. Unit: ratio."
          },
          "away": {
            "type": "number",
            "description": "Our data source’s estimated chance of an away win, from 0 to 1 (equal to 1 − home, since the source does not model a tie). Unit: ratio."
          }
        },
        "required": [
          "minute",
          "home",
          "away"
        ]
      },
      "FixtureCounts": {
        "type": "object",
        "description": "Fixture totals for a UTC day, broken down by sport (today only) or by category within one sport (any day), A client can use it to print something like “1,172 matches today, 45 live” without walking through every page of the day.",
        "properties": {
          "date": {
            "type": "string",
            "format": "date",
            "description": "Date (UTC, YYYY-MM-DD) the counts refer to."
          },
          "sport": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Sport being counted; null covers all sports, in which case only today can be requested."
          },
          "fixtureCount": {
            "type": "integer",
            "description": "All fixtures on the day regardless of state. With `sport`, this sums the per-category counts; without it, it sums the per-sport totals. For the same sport the two methods can disagree by a few percent, because the per-category list includes some matches carried over from late on the previous day."
          },
          "liveCount": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Fixtures currently live, taken from our live index (the same as /v2/sports); null unless `date` is today (UTC)."
          },
          "sports": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SportFixtureCount"
            },
            "description": "When `sport` is omitted: each sport we cover that has fixtures today, ordered by fixture count, highest first. Empty when `sport` is given."
          },
          "categories": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CategoryFixtureCount"
            },
            "description": "With `sport` set: every category (country, region, tour) that has fixtures on the day, sorted by fixture count, highest first, then by name. Empty when `sport` is omitted, and for race sports (motorsport, cycling — use /v2/races)."
          }
        },
        "required": [
          "date",
          "sport",
          "fixtureCount",
          "liveCount",
          "sports",
          "categories"
        ]
      },
      "SportFixtureCount": {
        "type": "object",
        "description": "Today’s fixture total for a single sport, along with the number currently live.",
        "properties": {
          "sport": {
            "type": "string",
            "description": "Slug of the sport, matching /v2/sports."
          },
          "fixtureCount": {
            "type": "integer",
            "description": "All fixtures on the UTC day regardless of state, taken from our data source’s per-sport daily counter."
          },
          "liveCount": {
            "type": "integer",
            "description": "Fixtures currently live according to our live index — the same number /v2/sports and /v2/livescores report."
          }
        },
        "required": [
          "sport",
          "fixtureCount",
          "liveCount"
        ]
      },
      "CategoryFixtureCount": {
        "type": "object",
        "description": "How many fixtures one category (a country, region or tour) has on a given day.",
        "properties": {
          "category": {
            "$ref": "#/components/schemas/Category",
            "description": "A bucket of leagues inside a sport, forming the top tier of the league directory."
          },
          "fixtureCount": {
            "type": "integer",
            "description": "All fixtures in the category’s leagues on the UTC day, regardless of state."
          },
          "leagueCount": {
            "type": "integer",
            "description": "Number of the category’s leagues that have one or more fixtures that day."
          }
        },
        "required": [
          "category",
          "fixtureCount",
          "leagueCount"
        ]
      },
      "Coverage": {
        "type": "object",
        "description": "The scope of the API in figures: how many entities carry a DataSportsAPI id, what each sport’s league directory holds and how far back its headline competitions go.",
        "properties": {
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Time these figures were computed (ISO 8601). The totals are refreshed every hour, the per-sport directories once a day."
          },
          "sports": {
            "type": "integer",
            "description": "Number of sports served — the same list as GET /v2/sports."
          },
          "totals": {
            "$ref": "#/components/schemas/CoverageTotals",
            "description": "Counts of the entities that have a DataSportsAPI id, each of which can be fetched by that id. The numbers only rise: an id, once issued, is never changed or withdrawn."
          },
          "history": {
            "$ref": "#/components/schemas/CoverageHistory",
            "description": "How deep the headline competitions of all sports go, taken together."
          },
          "bySport": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SportCoverage"
            },
            "description": "One entry per sport whose directory has been read, in the order of /v2/sports. Shortly after this endpoint is redeployed a sport can be absent until its directory has been read once."
          }
        },
        "required": [
          "updatedAt",
          "sports",
          "totals",
          "history",
          "bySport"
        ]
      },
      "CoverageTotals": {
        "type": "object",
        "description": "Counts of the entities that have a DataSportsAPI id, each of which can be fetched by that id. The numbers only rise: an id, once issued, is never changed or withdrawn.",
        "properties": {
          "leagues": {
            "type": "integer",
            "description": "Competitions and leagues that have a DataSportsAPI id."
          },
          "seasons": {
            "type": "integer",
            "description": "League seasons that have a DataSportsAPI id."
          },
          "teams": {
            "type": "integer",
            "description": "Teams that have a DataSportsAPI id: clubs and national sides, plus the individual competitors of one-on-one sports such as tennis, MMA, darts and snooker."
          },
          "players": {
            "type": "integer",
            "description": "Players that have a DataSportsAPI id."
          },
          "fixtures": {
            "type": "integer",
            "description": "Fixtures (matches), played and upcoming, that have a DataSportsAPI id."
          },
          "venues": {
            "type": "integer",
            "description": "Venues that have a DataSportsAPI id."
          },
          "managers": {
            "type": "integer",
            "description": "Managers and head coaches that have a DataSportsAPI id."
          },
          "referees": {
            "type": "integer",
            "description": "Referees that have a DataSportsAPI id."
          }
        },
        "required": [
          "leagues",
          "seasons",
          "teams",
          "players",
          "fixtures",
          "venues",
          "managers",
          "referees"
        ]
      },
      "CoverageHistory": {
        "type": "object",
        "description": "A summary of how deep the headline competitions of all sports go.",
        "properties": {
          "leagues": {
            "type": "integer",
            "description": "Number of headline competitions (the `headline` lists of every sport) whose firstSeason is known."
          },
          "medianYears": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Median number of years between those competitions’ first season and the current year; null when no first season is known."
          },
          "oldestSeason": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Earliest firstSeason among those competitions; null when none is known."
          }
        },
        "required": [
          "leagues",
          "medianYears",
          "oldestSeason"
        ]
      },
      "SportCoverage": {
        "type": "object",
        "description": "One sport’s league directory in numbers, and how far back its headline competitions go.",
        "properties": {
          "sport": {
            "type": "string",
            "description": "Slug of the sport, as listed by /v2/sports."
          },
          "kind": {
            "$ref": "#/components/schemas/SportKind",
            "description": "The endpoint family that serves this sport’s data."
          },
          "categories": {
            "type": "integer",
            "description": "Number of categories (countries, regions, tours or games) the sport’s league directory holds (GET /v2/categories?sport=)."
          },
          "leagues": {
            "type": "integer",
            "description": "Number of leagues across all those categories (GET /v2/leagues?category=); motorsport and cycling count series instead (GET /v2/series?category=)."
          },
          "historyFrom": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Earliest firstSeason found in `headline`; null if unknown."
          },
          "headline": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CoverageLeague"
            },
            "description": "Up to ten headline competitions for the sport: the popular international competitions in its directory or, failing those, the first leagues of the directory, in that order."
          }
        },
        "required": [
          "sport",
          "kind",
          "categories",
          "leagues",
          "historyFrom",
          "headline"
        ]
      },
      "CoverageLeague": {
        "type": "object",
        "description": "One headline competition of a sport, with the depth of its season list.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "League id issued by DataSportsAPI (for motorsport and cycling, a series id)."
          },
          "name": {
            "type": "string",
            "description": "Name of the league, competition or series."
          },
          "seasons": {
            "type": "integer",
            "description": "How many seasons its season list holds (GET /v2/leagues/{id}/seasons; motorsport and cycling use /v2/series/{id}/seasons)."
          },
          "firstSeason": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Start year of the oldest season in that list; null when no season label can be parsed. Older seasons carry less detail: results and tables usually reach further back than lineups and statistics."
          }
        },
        "required": [
          "id",
          "name",
          "seasons",
          "firstSeason"
        ]
      },
      "PlayerActions": {
        "type": "object",
        "description": "A player’s on-ball actions in one match, each placed on the pitch — the same actions our data source’s player rating is built from (football, covered leagues). When the source has none (the player did not play, the match has not started, or it is another sport) the response is 200 with empty lists.",
        "properties": {
          "passes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PlayerAction"
            },
            "description": "Passes and crosses in our data source’s order (no timestamps are provided)."
          },
          "dribbles": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PlayerAction"
            },
            "description": "Dribble attempts (take-ons)."
          },
          "defensive": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PlayerAction"
            },
            "description": "Defensive actions: tackles, interceptions, ball recoveries, clearances and blocks."
          },
          "ballCarries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PlayerAction"
            },
            "description": "Ball carries, i.e. runs made in possession."
          }
        },
        "required": [
          "passes",
          "dribbles",
          "defensive",
          "ballCarries"
        ]
      },
      "PlayerAction": {
        "type": "object",
        "description": "Describes one thing a player did on the ball in a match.",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/PlayerActionType",
            "description": "Kind of action."
          },
          "start": {
            "$ref": "#/components/schemas/ActionPoint",
            "description": "Player’s location when the action began."
          },
          "end": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ActionPoint"
              },
              {
                "type": "null"
              }
            ],
            "description": "End point: where the ball travelled to (passes, crosses, clearances) or where it was carried (ball carries). Null for other action types and when our data source has none."
          },
          "successful": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "Whether the action succeeded — a completed pass or cross, a take-on or tackle won. Our data source marks successes only, so anything else reads false (we checked this against accuratePass / wonContest / wonTackle in the lineups). Ball carries have no outcome and get null."
          },
          "keyPass": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "`true` for a pass or cross that set up a shot. Null for other action types."
          },
          "longBall": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "`true` when our data source counts it as a long ball (passes and crosses); these flags can add up to more than totalLongBalls in the lineups. Null for other action types."
          }
        },
        "required": [
          "type",
          "start",
          "end",
          "successful",
          "keyPass",
          "longBall"
        ]
      },
      "ActionPoint": {
        "type": "object",
        "description": "Pitch coordinates marking where an action began or finished.",
        "properties": {
          "x": {
            "type": "number",
            "description": "Position along the pitch, 0–100, oriented in the player’s attacking direction (0 at the player’s own goal line, 100 at the goal they are attacking). Both sides use this frame, the same as the match heatmap. Unit: percent."
          },
          "y": {
            "type": "number",
            "description": "Widthwise position on the pitch, 0–100, using the heatmap’s frame. Unit: percent."
          }
        },
        "required": [
          "x",
          "y"
        ]
      },
      "RaceLap": {
        "type": "object",
        "description": "Lap data for one competitor on one lap of a race session.",
        "properties": {
          "lap": {
            "type": "integer",
            "description": "Number of the lap; 0 represents the starting grid."
          },
          "position": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Position when the lap ended (on lap 0, the grid slot); null on the lap where the competitor retired."
          },
          "tyre": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TyreCompound"
              },
              {
                "type": "null"
              }
            ],
            "description": "Compound fitted during this lap (Formula 1)."
          },
          "pitStop": {
            "type": "boolean",
            "description": "`true` if the competitor pitted at the end of this lap (the new tyres appear from the next lap)."
          },
          "retired": {
            "type": "boolean",
            "description": "`true` if the competitor retired during this lap, making it their final one (`position` is null)."
          }
        },
        "required": [
          "lap",
          "position",
          "tyre",
          "pitStop",
          "retired"
        ]
      },
      "RaceCompetitorLaps": {
        "type": "object",
        "description": "A competitor’s race broken down lap by lap, showing position, tyre and pit stops for each lap.",
        "properties": {
          "competitor": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Driver for this record — a TeamRef of kind individual, resolvable via /v2/teams/{id}."
          },
          "team": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Constructor the driver races for."
          },
          "number": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Race number on the car."
          },
          "laps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RaceLap"
            },
            "description": "Starts with lap 0 (the grid), followed by each lap completed in sequence; for a competitor who retired, the list ends at that lap."
          }
        },
        "required": [
          "competitor",
          "team",
          "number",
          "laps"
        ]
      },
      "PlayerStatRanking": {
        "type": "object",
        "description": "A player’s league-season rank for a single statistic.",
        "properties": {
          "statistic": {
            "type": "string",
            "description": "Statistic being ranked, named as in /v2/players/{id}/statistics (goals, assists, rating, expectedGoals, …)."
          },
          "value": {
            "type": "number",
            "description": "Player’s value for this statistic across the league season."
          },
          "rank": {
            "type": "integer",
            "description": "The player’s rank for this statistic among all league players (1 = top). Equal values share the same rank, as in standard competition ranking."
          },
          "tiedCount": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "How many players hold that rank, including them (1 means no tie)."
          },
          "playerCount": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Size of the ranked field for this statistic in the league season."
          }
        },
        "required": [
          "statistic",
          "value",
          "rank",
          "tiedCount",
          "playerCount"
        ]
      },
      "GoalDistribution": {
        "type": "object",
        "description": "The timing of a team’s goals scored and conceded across a league season (football).",
        "properties": {
          "scope": {
            "$ref": "#/components/schemas/GoalDistributionScope",
            "description": "Set of matches included."
          },
          "fixtureCount": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of matches included."
          },
          "scored": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Goals the team scored in those matches."
          },
          "conceded": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Goals the team conceded in those matches."
          },
          "bands": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GoalDistributionBand"
            },
            "description": "Six bands of 15 minutes each, in chronological order."
          }
        },
        "required": [
          "scope",
          "fixtureCount",
          "scored",
          "conceded",
          "bands"
        ]
      },
      "GoalDistributionBand": {
        "type": "object",
        "description": "Goal counts for a single 15-minute slice of the match.",
        "properties": {
          "fromMinute": {
            "type": "integer",
            "description": "Minute at which the band starts (1, 16, 31, …). Unit: minutes."
          },
          "toMinute": {
            "type": "integer",
            "description": "Minute at which the band ends (15, 30, … 90). Stoppage time is counted in the band it is added to. Unit: minutes."
          },
          "scored": {
            "type": "integer",
            "description": "Goals scored by the team in this band."
          },
          "conceded": {
            "type": "integer",
            "description": "Goals conceded by the team in this band."
          }
        },
        "required": [
          "fromMinute",
          "toMinute",
          "scored",
          "conceded"
        ]
      },
      "TennisYearStatistics": {
        "type": "object",
        "description": "Figures for a tennis player covering one calendar year and one surface.",
        "properties": {
          "surface": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Surface"
              },
              {
                "type": "null"
              }
            ],
            "description": "Court surface the figures relate to."
          },
          "matches": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of matches played."
          },
          "wins": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of matches won."
          },
          "tournamentsPlayed": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of tournaments entered."
          },
          "tournamentsWon": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of tournaments won."
          },
          "aces": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Aces served."
          },
          "doubleFaults": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Double faults committed."
          },
          "servicePoints": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Total service points (= firstServesIn + secondServes)."
          },
          "firstServesIn": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "First serves that landed in."
          },
          "firstServePointsWon": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Service points won after landing the first serve."
          },
          "secondServes": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Service points that needed a second serve."
          },
          "secondServesIn": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Count of second serves that went in (= secondServes − doubleFaults)."
          },
          "secondServePointsWon": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Service points won when playing on a second serve."
          },
          "breakPointsConverted": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Break points they converted while returning serve."
          },
          "breakPointChances": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Break-point chances they created while returning serve."
          },
          "breakPointsFaced": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Break points they had to defend while serving."
          },
          "breakPointsLost": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Of the break points against them, how many the opponent won."
          },
          "tiebreaksWon": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of tie-breaks won."
          },
          "tiebreaksLost": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of tie-breaks lost."
          },
          "winners": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of winners struck."
          },
          "unforcedErrors": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of unforced errors made."
          }
        },
        "required": [
          "surface",
          "matches",
          "wins",
          "tournamentsPlayed",
          "tournamentsWon",
          "aces",
          "doubleFaults",
          "servicePoints",
          "firstServesIn",
          "firstServePointsWon",
          "secondServes",
          "secondServesIn",
          "secondServePointsWon",
          "breakPointsConverted",
          "breakPointChances",
          "breakPointsFaced",
          "breakPointsLost",
          "tiebreaksWon",
          "tiebreaksLost",
          "winners",
          "unforcedErrors"
        ]
      },
      "LeagueChampion": {
        "type": "object",
        "description": "The champion of a single league season.",
        "properties": {
          "seasonId": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Id of the season in question, matching a Season from /v2/leagues/{id}/seasons."
          },
          "year": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Year in which the season finished (2026 for 25/26)."
          },
          "team": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamRef"
              },
              {
                "type": "null"
              }
            ],
            "description": "Team that took the title."
          }
        },
        "required": [
          "seasonId",
          "year",
          "team"
        ]
      },
      "Odds": {
        "type": "object",
        "description": "Betting prices for a fixture from a single bookmaker, supplied via our data source; the prices carry no bookmaker identity. Pre-match and in-play, opening and current, plus settlement flags once the match is over. Available since 2026-11-04. Live updates arrive on the `odds:{fixtureId}` WebSocket channel (on Business and Enterprise). These are third-party prices shown for information only — they are neither advice nor an offer to bet.",
        "properties": {
          "fixtureId": {
            "type": "integer",
            "description": "The fixture’s id."
          },
          "updatedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Our last fetch or receipt of these prices (no timestamp comes from our data source itself); null when no prices exist."
          },
          "markets": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OddsMarket"
            },
            "description": "All markets the bookmaker offers on the fixture, in the bookmaker’s order. Empty when there are none — typically a minor league, a match far in the future, or a finished match whose odds have been removed."
          }
        },
        "required": [
          "fixtureId",
          "updatedAt",
          "markets"
        ]
      },
      "OddsMarket": {
        "type": "object",
        "description": "A market the bookmaker offers for a fixture.",
        "properties": {
          "key": {
            "type": "string",
            "description": "Identifier of the market that stays stable within its fixture. It is built from `kind`, followed by `:period` unless the market covers the whole match, `:line` if there is a line, and `:live` for in-play markets (\"result\", \"result:half1\", \"totalGoals:2.5\", \"asianHandicap:-1.25\", \"winner:live\"). For `other` markets the label is added (\"other:corners-1x2\"), and further markets sharing a key get `#2`, `#3`. The `:live` suffix exists because, once play starts, the bookmaker shows the in-play market alongside the closed pre-match one. When a line moves it gets a new key and the old key disappears. Use this key to merge WebSocket `odds` frames."
          },
          "kind": {
            "$ref": "#/components/schemas/OddsMarketKind",
            "description": "What the market is pricing."
          },
          "name": {
            "type": "string",
            "description": "Market name as the bookmaker labels it (\"Full time\", \"Match goals\", \"Asian handicap\")."
          },
          "period": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Portion of the match the market is settled on: \"match\" when it covers the whole match in the market’s own sense (see `kind`); otherwise a unit with a number — half1, half2, quarter1…4, period1…3 (ice hockey), set1…, inning1…, map1…, game1…, round1…. Whatever the sport’s division, a half always means half of the match (in basketball, half1 = quarters 1–2). null if our data source’s period label is not recognised (check `name`)."
          },
          "line": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Line value: the over / under threshold for a total, or the home side’s handicap for a handicap market. Null for markets without a line."
          },
          "live": {
            "type": "boolean",
            "description": "`true` for in-play prices — once the match has started and the bookmaker is trading it live."
          },
          "suspended": {
            "type": "boolean",
            "description": "`true` while a goal, red card, VAR check or similar has paused the market; the prices shown cannot be bet on at that moment."
          },
          "choices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OddsChoice"
            },
            "description": "Selections in the bookmaker’s order: home ahead of away, with draw / \"no goal\" between them."
          },
          "settledBy": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/OddsSettledBy"
              },
              {
                "type": "null"
              }
            ],
            "description": "Who set the `winning` flags of its choices: `source` (the bookmaker’s own flags) or `computed` (settled on our side from the final result, since the bookmaker never sends flags for it — football Asian handicaps on half lines, judged on the regular-time score, and total cards when every card of the match was a yellow one shown to a player on the pitch and the incidents agree with the statistics). Null while nobody has settled it. Since 2026-11-12."
          }
        },
        "required": [
          "key",
          "kind",
          "name",
          "period",
          "line",
          "live",
          "suspended",
          "choices",
          "settledBy"
        ]
      },
      "OddsChoice": {
        "type": "object",
        "description": "A single selection within a betting market, together with its price.",
        "properties": {
          "name": {
            "type": "string",
            "description": "Label the bookmaker uses for the selection, as passed on by our data source (\"1\", \"X\", \"Over\", \"(-0.5) Galatasaray\", a team name)."
          },
          "outcome": {
            "$ref": "#/components/schemas/OddsOutcome",
            "description": "What the selection is backing."
          },
          "fractional": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Current price in fractional form (\"19/20\" means 19 profit for every 20 staked). null while the bookmaker displays no price."
          },
          "decimal": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Decimal form of the current price (= 1 + fractional, which is the total paid back per unit staked), rounded to two decimal places. Null exactly when `fractional` is null."
          },
          "openingFractional": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Opening price of the market, in fractional form."
          },
          "openingDecimal": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Opening price of the market, in decimal form."
          },
          "change": {
            "$ref": "#/components/schemas/OddsChange",
            "description": "Direction of the price’s most recent movement."
          },
          "winning": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "Once settled, `true` if this selection won. Null before settlement, and on markets that nobody settles (see the market’s `settledBy`)."
          }
        },
        "required": [
          "name",
          "outcome",
          "fractional",
          "decimal",
          "openingFractional",
          "openingDecimal",
          "change",
          "winning"
        ]
      },
      "FeaturedOdds": {
        "type": "object",
        "description": "The headline market for a fixture in a daily odds list — the three-way result in sports that allow draws, otherwise the winner market.",
        "properties": {
          "fixtureId": {
            "type": "integer",
            "description": "The fixture’s id; GET /v2/fixtures/{id} returns the match and GET /v2/fixtures/{id}/odds returns all of its markets."
          },
          "market": {
            "$ref": "#/components/schemas/OddsMarket",
            "description": "A market the bookmaker offers for a fixture."
          }
        },
        "required": [
          "fixtureId",
          "market"
        ]
      },
      "WinningOdds": {
        "type": "object",
        "description": "Winning-odds figures for a fixture. It takes each side’s win price (from one bookmaker, via our data source) and gives the probability that price implies plus how often sides at that price have won in the past — both figures come from the data source. It is two-way only, so there is no draw entry. Available since 2026-11-06. The prices and statistics come from a third party and are for information only; they are not advice or an offer to bet.",
        "properties": {
          "fixtureId": {
            "type": "integer",
            "description": "The fixture’s id."
          },
          "updatedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Time we last fetched the figures (our data source supplies no timestamp of its own); null if there are no figures."
          },
          "home": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WinningOddsSide"
              },
              {
                "type": "null"
              }
            ],
            "description": "Figures for the home side; null if our data source has none for it (it may cover only one side)."
          },
          "away": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WinningOddsSide"
              },
              {
                "type": "null"
              }
            ],
            "description": "Figures for the away side; null if our data source has none for it."
          }
        },
        "required": [
          "fixtureId",
          "updatedAt",
          "home",
          "away"
        ]
      },
      "WinningOddsSide": {
        "type": "object",
        "description": "A side’s win price alongside the historical success rate of that price.",
        "properties": {
          "fractional": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The side’s win price that the figures are based on, fractional (\"33/20\"). Our data source chooses this pre-match price itself, so it may not match any current or opening price from GET /v2/fixtures/{id}/odds."
          },
          "decimal": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Decimal equivalent of that price (= 1 + fractional), rounded to two decimal places."
          },
          "expectedWinPercentage": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Implied probability of winning at this price, 0–100 (≈ 100 / decimal, rounded by our data source, with the bookmaker’s margin left in). Unit: percent."
          },
          "actualWinPercentage": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Historical win rate for sides at this price, 0–100, from the data source’s own records (it discloses neither the sample size nor the time span). Unit: percent."
          }
        },
        "required": [
          "fractional",
          "decimal",
          "expectedWinPercentage",
          "actualWinPercentage"
        ]
      },
      "LiveWireEvent": {
        "type": "object",
        "description": "What the `livescores` channel published, one change at a time, stored for 7 days: goals and other score changes, red cards, kick-offs, period starts, breaks and final whistles. Each comes with the score and status that followed it and both sides’ names, so a ticker has something to show before its socket delivers a frame.",
        "properties": {
          "fixtureId": {
            "type": "integer",
            "description": "The fixture’s id in our system (/v2/fixtures/{id})."
          },
          "sport": {
            "type": "string",
            "description": "The sport slug, as listed by /v2/sports."
          },
          "leagueId": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "The id we give the fixture’s league; null if it has none."
          },
          "kind": {
            "$ref": "#/components/schemas/LiveWireKind",
            "description": "What happened. A moment has exactly one kind: the first that fits, in the order score, redCard, finished, break, kickoff, period."
          },
          "at": {
            "type": "string",
            "format": "date-time",
            "description": "The time we published this change on the `livescores` channel."
          },
          "side": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "For score and redCard, the side whose count changed (null if both changed); null for every other kind."
          },
          "homeScore": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "The home side’s `current` score just after the change; null if the fixture had no score."
          },
          "awayScore": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "The away side’s `current` score just after the change."
          },
          "status": {
            "type": "object",
            "properties": {
              "type": {
                "$ref": "#/components/schemas/StatusType"
              },
              "phase": {
                "$ref": "#/components/schemas/StatusPhase"
              },
              "period": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/PeriodKey"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "type",
              "phase",
              "period"
            ],
            "description": "The fixture’s status just after the change (`type`, `phase` and `period`, as on Fixture)."
          },
          "home": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/LiveWireTeam"
              },
              {
                "type": "null"
              }
            ],
            "description": "The home side; null until it is known."
          },
          "away": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/LiveWireTeam"
              },
              {
                "type": "null"
              }
            ],
            "description": "The away side; null until it is known."
          }
        },
        "required": [
          "fixtureId",
          "sport",
          "leagueId",
          "kind",
          "at",
          "side",
          "homeScore",
          "awayScore",
          "status",
          "home",
          "away"
        ]
      },
      "LiveWireTeam": {
        "type": "object",
        "description": "One side of a live-wire moment, named as the fixture named it at that time.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The team’s id in our system."
          },
          "name": {
            "type": "string",
            "description": "The team’s name (in individual sports the player, or both players of a doubles pair)."
          }
        },
        "required": [
          "id",
          "name"
        ]
      },
      "TrackingSummary": {
        "type": "object",
        "description": "Which tracking data a fixture holds. In football: a ball track and events recorded live (goals, shots, cards, set pieces, the flow of play), completed after the final whistle by the full event list including passes and positions. In tennis: every serve and every point and the positions of ball and players, all live. In basketball: a live timeline with shot spots, and events read after the match. In ice hockey: a live timeline showing where the shots came from. In darts (since 2026-11-13): a live timeline of every dart and every visit. History starts on 2026-11-07 for every sport.",
        "properties": {
          "fixtureId": {
            "type": "integer",
            "description": "Fixture id issued by DataSportsAPI."
          },
          "sport": {
            "type": "string",
            "enum": [
              "football",
              "tennis",
              "basketball",
              "ice-hockey",
              "darts"
            ],
            "description": "One of the five sports with tracking data, as a slug (football, tennis, basketball, ice-hockey, darts); darts since 2026-11-13."
          },
          "coordinates": {
            "$ref": "#/components/schemas/TrackingCoordinates",
            "description": "The coordinate frame for this fixture, which depends on the sport; every x / y / z the tracking endpoints return is expressed in it."
          },
          "final": {
            "type": "boolean",
            "description": "True once the match is over — finished, or ended another way (canceled, postponed, interrupted, abandoned); no further ball frames will be added."
          },
          "complete": {
            "type": "boolean",
            "description": "True once the post-match data has been read, from a few minutes to an hour after the end; from then on the tracked events, the timeline and the player names are final. Until then football has only its live events — goals, shots, cards, substitutions, set pieces and the flow of play, with passes and most of the detail arriving in the post-match read — while basketball, ice hockey and darts have their live timeline (since 2026-11-13)."
          },
          "startedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Start of recording, close to kick-off."
          },
          "ballFrames": {
            "type": "integer",
            "description": "Count of ball frames recorded so far (see GET /v2/fixtures/{id}/tracking/ball): about 14 per minute of football play, about one per tennis shot. They are captured live only, so a frame missed during play never turns up later."
          },
          "events": {
            "type": "integer",
            "description": "Count of events served by GET /v2/fixtures/{id}/tracking/events so far."
          },
          "timelineEvents": {
            "type": "integer",
            "description": "How many timeline events exist (basketball, ice hockey and darts; GET /v2/fixtures/{id}/tracking/timeline)."
          },
          "players": {
            "type": "boolean",
            "description": "True if the match has player tracking (since 2026-11-13): the ball and every player on the court, five times per second (GET /v2/fixtures/{id}/tracking/players and the playerFrame frame). Only NBA games have it; it is false everywhere else."
          }
        },
        "required": [
          "fixtureId",
          "sport",
          "coordinates",
          "final",
          "complete",
          "startedAt",
          "ballFrames",
          "events",
          "timelineEvents",
          "players"
        ]
      },
      "TrackingSpot": {
        "type": "object",
        "description": "A spot expressed in the coordinate frame of the fixture (see TrackingSummary.coordinates).",
        "properties": {
          "x": {
            "type": "number",
            "description": "Position along the pitch, court or rink, in the fixture’s frame (TrackingCoordinates)."
          },
          "y": {
            "type": "number",
            "description": "Position across the pitch, court or rink, in that same frame."
          },
          "z": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Height of the tennis ball above the court in millimetres (tennis ball positions only); null elsewhere."
          }
        },
        "required": [
          "x",
          "y",
          "z"
        ]
      },
      "BallFrame": {
        "type": "object",
        "description": "One position from the live ball track (tennis and football).",
        "properties": {
          "at": {
            "type": "string",
            "format": "date-time",
            "description": "Moment the ball was recorded at this spot, to the millisecond."
          },
          "x": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Position along the pitch or court in the fixture’s frame (0–100 in football, millimetres in tennis); null when no position came from the source."
          },
          "y": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Position across it, in the same frame. In football it runs the same way as the tracked events’ position.y (since 2026-11-13)."
          }
        },
        "required": [
          "at",
          "x",
          "y"
        ]
      },
      "TrackedEvent": {
        "type": "object",
        "description": "One entry of the tracked play-by-play, with where it happened (football, tennis, basketball). Tennis and football are delivered live — football roughly 9 seconds after the moment (about 15 at most) for goals, shots, cards, substitutions, set pieces and the flow of play, while passes and most of the detail follow in the post-match read. Basketball events mostly come later, with the post-match read of the data.",
        "properties": {
          "key": {
            "type": "string",
            "description": "Key that identifies the event within the fixture and never changes; REST and WebSocket use the same key."
          },
          "type": {
            "type": "string",
            "description": "What happened, in camelCase. Football: goal, attemptAtGoal, pass, cross, dribble, corner, freeKick, throwIn, goalKick, penalty, foul, offside, duel, tackle, interception, clearance, block, save, yellowCard, secondYellowCard, redCard, substitution; flowAttack / flowDangerousAttack / flowBallSafe describe the flow of play (side is the team in possession, position is where the ball is — together, the live state of the match); possibleCorner / possibleGoal / possiblePenalty (and the matching …Cancelled types) mark a decision still pending; possessionChange has no side; also kickOff, periodStatus, injuryTime, injury, backFromInjury, interruptionStart / interruptionOver, videoReview and more. Tennis: serve, fault, let, point, challenge, ballSituation (where the ball is), playerSituation (where a player is) and more. Basketball: freeThrow, twoPointer, threePointer, rebound, steal, block, turnover, foul, possessionChange, substitutionIn / substitutionOut, timeoutStart, periodStatus and more. Further types may appear; ignore any you do not recognise, or show it as information only."
          },
          "at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Moment of the event."
          },
          "side": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Side credited with the event; null for neutral ones such as a period change or a loose ball."
          },
          "minute": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Football: match minute. Null for other sports. Unit: minutes."
          },
          "second": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Football: match clock in seconds. Null for other sports. Unit: seconds."
          },
          "period": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PeriodKey"
              },
              {
                "type": "null"
              }
            ],
            "description": "Basketball: period in which it happened (period1…period4, overtime). Null for other sports."
          },
          "set": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tennis: set number."
          },
          "game": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tennis: game number in the set."
          },
          "position": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TrackingSpot"
              },
              {
                "type": "null"
              }
            ],
            "description": "Location of the event: for football (pass origin, shot, foul, …) and basketball (shot, foul, rebound, …) on the 0–100 frame; for tennis ballSituation / playerSituation in millimetres, with z as the ball’s height. Null when the source gives no spot."
          },
          "endPosition": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TrackingSpot"
              },
              {
                "type": "null"
              }
            ],
            "description": "Football passes: the spot the ball was played to."
          },
          "player": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TrackedPlayer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Who performed it, if the source names someone the squad list contains."
          },
          "assist": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TrackedPlayer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Football goals: who provided the assist."
          },
          "playerIn": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TrackedPlayer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Football substitutions: who came on."
          },
          "playerOut": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TrackedPlayer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Football substitutions: who went off."
          },
          "outcome": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Result, in camelCase: complete / incomplete for passes; onTarget, offTarget, blocked, woodwork, deflectedOffTarget and more for shots; made / missed in basketball."
          },
          "goalType": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Football goals: how it was scored, in camelCase (shot, header, ownGoal, penalty, …)."
          },
          "serving": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tennis points: who was serving."
          },
          "gameScore": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TennisGameScore"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tennis points: the score in the game once the point was played."
          },
          "pointOutcome": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tennis points: how the point was won, in camelCase (standard, ace, doubleFault, …)."
          },
          "shots": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tennis points: number of shots in the rally, when provided."
          }
        },
        "required": [
          "key",
          "type",
          "at",
          "side",
          "minute",
          "second",
          "period",
          "set",
          "game",
          "position",
          "endPosition",
          "player",
          "assist",
          "playerIn",
          "playerOut",
          "outcome",
          "goalType",
          "serving",
          "gameScore",
          "pointOutcome",
          "shots"
        ]
      },
      "TrackedPlayer": {
        "type": "object",
        "description": "A player that a tracked event names, taken from the match squad. There is no id: tracked players are not linked to DataSportsAPI player ids.",
        "properties": {
          "name": {
            "type": "string",
            "description": "Name as displayed, given name first."
          },
          "shirtNumber": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number on their shirt in this match."
          },
          "side": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Which side the player is on."
          }
        },
        "required": [
          "name",
          "shirtNumber",
          "side"
        ]
      },
      "TennisGameScore": {
        "type": "object",
        "description": "The score within a tennis game after a point.",
        "properties": {
          "home": {
            "type": "string",
            "description": "Home side’s points in the current game — 0, 15, 30, 40 or A (advantage) — or the tie-break count."
          },
          "away": {
            "type": "string",
            "description": "Points of the away side in the game."
          }
        },
        "required": [
          "home",
          "away"
        ]
      },
      "TimelineEvent": {
        "type": "object",
        "description": "One entry of a match timeline in basketball, ice hockey or darts: shots with where they were taken, saves, penalties, goals and periods, and in darts each dart and each visit. Live since 2026-11-13, roughly 5 seconds after the moment (also pushed as timelineEvent frames on tracking:{id}); the source can still revise or withdraw an event afterwards. Events the source withdrew are not included.",
        "properties": {
          "key": {
            "type": "string",
            "description": "Key that identifies the event within the fixture and never changes."
          },
          "type": {
            "type": "string",
            "description": "Event type as the source names it, in camelCase. Basketball: goal (a made basket; points gives its value), attemptMissed, freeThrowsAwarded, rebound, block, stealBasket, turnoverBasket, foul, wonJumpBall, timeout, tvTimeoutStart / tvTimeoutStop, videoReview, periodStart, periodScore, matchStarted, matchEnded and more. Ice hockey: goal, canceledEvent (a goal that was taken back), shotOnTarget, goalkeeperSaved, shotOffTarget, shotBlocked, faceoff, giveaway, takeaway, hit, suspension (a penalty; penaltyMinutes gives its length), suspensionOver, delayedPenalty, emptyNet, emptyNetOver, playResumesAfterGoal, timeout, periodStart, periodBreak (an intermission, or the wait before overtime; period is null), periodScore, penalty (a shoot-out attempt, with homeScore / awayScore giving the shoot-out score once it is taken), penaltyRewarded / penaltyMissed (penalty shots) and more. Darts (since 2026-11-13; the detail is in darts): dartThrow (a single dart), visit (a turn at the board, at most three darts), checkout (the visit that closed out the leg), legWon (homeScore / awayScore count legs), setWon, matchWon, throwsFirst, periodStart, matchStarted, matchEnded. Other types may be added."
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The source’s English label for the event (“Goalie save”, “1st period”, “2 pt scored”)."
          },
          "at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Moment of the event."
          },
          "side": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Side credited with the event; null when neutral."
          },
          "minute": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Game minute. Unit: minutes."
          },
          "second": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Game clock, in seconds from the start. Unit: seconds."
          },
          "period": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "For periodStart / periodScore: the number of the period."
          },
          "position": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TrackingSpot"
              },
              {
                "type": "null"
              }
            ],
            "description": "Where the shot or event happened, 0–100, in a frame where home plays towards x = 100 and away towards x = 0 for the whole match (TrackingCoordinates court or rink). The source does not report attack direction, so for each side and period, when that side’s shots sit in the wrong half (x < 50 for home, x > 50 for away), all its positions in that period are mirrored (x → 100 − x, y → 100 − y); when a side has no shots in a period, it borrows the direction from the other side and from the adjacent periods. Null when the source gives no spot."
          },
          "player": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Name of the player involved (the scorer of a goal), with the first name first, if the source gives a name."
          },
          "assists": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Names of the players credited with assists on a goal, in order."
          },
          "points": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Basketball: what the shot was worth (1, 2 or 3)."
          },
          "penaltyMinutes": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Ice hockey suspensions: length of the penalty. Unit: minutes."
          },
          "homeScore": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Home side’s score once the event is applied (goals, period scores, end of match). On a shoot-out attempt in ice hockey (type penalty) it is the shoot-out tally after that attempt (since 2026-11-13)."
          },
          "awayScore": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Away side’s score once the event is applied."
          },
          "darts": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TimelineDarts"
              },
              {
                "type": "null"
              }
            ],
            "description": "Darts (since 2026-11-13): the dart or the visit. Null for other sports, and for darts events that are not a dart or a visit."
          }
        },
        "required": [
          "key",
          "type",
          "name",
          "at",
          "side",
          "minute",
          "second",
          "period",
          "position",
          "player",
          "assists",
          "points",
          "penaltyMinutes",
          "homeScore",
          "awayScore",
          "darts"
        ]
      },
      "TimelineDarts": {
        "type": "object",
        "description": "Darts detail on a timeline entry (since 2026-11-13): either one dart (dartThrow) or one visit together with what it settled (visit, checkout, setWon, matchWon); any field that does not apply is null. Some competitions only report visits, without the individual darts.",
        "properties": {
          "score": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "dartThrow: points the dart scored (0 – 60). visit / checkout: total of the visit (0 – 180)."
          },
          "number": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "dartThrow: the segment number hit (1 – 20, or 25 for the bull); null when the dart missed."
          },
          "multiplier": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "dartThrow: 1 for a single, 2 for a double or the bullseye, 3 for a treble, 0 for a miss."
          },
          "ring": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DartsRing"
              },
              {
                "type": "null"
              }
            ],
            "description": "dartThrow: the part of the board it landed in."
          },
          "bed": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DartsBed"
              },
              {
                "type": "null"
              }
            ],
            "description": "dartThrow in a single (since 2026-11-13): which single bed it hit, inner (from the outer bull to the treble) or outer (from the treble to the double), as reported by the source. Null for any other ring, any other event type, and a single the source does not locate."
          },
          "doubleAttempt": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "dartThrow: true when the dart was aimed at a finishing double."
          },
          "dartsThrown": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "visit / checkout: how many darts the visit used (1 – 3)."
          },
          "checkoutDouble": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "checkout: the double that won the leg (16 means double 16, 25 the bullseye)."
          },
          "remaining": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DartsScore"
              },
              {
                "type": "null"
              }
            ],
            "description": "visit: points each side still needs in this leg once the visit is counted."
          },
          "legs": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DartsScore"
              },
              {
                "type": "null"
              }
            ],
            "description": "visit / checkout / setWon / matchWon: legs won so far, counted within the current set if the match uses sets."
          },
          "sets": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DartsScore"
              },
              {
                "type": "null"
              }
            ],
            "description": "visit / checkout / setWon / matchWon: number of sets won; a legs-only match counts as one single set."
          }
        },
        "required": [
          "score",
          "number",
          "multiplier",
          "ring",
          "bed",
          "doubleAttempt",
          "dartsThrown",
          "checkoutDouble",
          "remaining",
          "legs",
          "sets"
        ]
      },
      "DartsScore": {
        "type": "object",
        "description": "A darts figure for each side: points left, legs or sets.",
        "properties": {
          "home": {
            "type": "integer",
            "description": "Value for the home side."
          },
          "away": {
            "type": "integer",
            "description": "Value for the away side."
          }
        },
        "required": [
          "home",
          "away"
        ]
      },
      "TrackingSnapshot": {
        "type": "object",
        "description": "Snapshot of a tracking:{id} channel: the summary, the most recent ball frames, tracked events and timeline entries, together with the latest player frame; anything older is available over REST.",
        "properties": {
          "fixtureId": {
            "type": "integer",
            "description": "Fixture id issued by DataSportsAPI."
          },
          "tracking": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TrackingSummary"
              },
              {
                "type": "null"
              }
            ],
            "description": "What has been recorded for the fixture so far; null while nothing is recorded yet (an untracked match, or one that has not started)."
          },
          "ball": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BallFrame"
            },
            "description": "The latest ball frames, at most 100, oldest first."
          },
          "events": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TrackedEvent"
            },
            "description": "The latest tracked events, at most 100, oldest first."
          },
          "timeline": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TimelineEvent"
            },
            "description": "Since 2026-11-13: the latest timeline events, at most 100, oldest first, in basketball, ice hockey and darts; an empty list in other sports."
          },
          "playerFrame": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerFrame"
              },
              {
                "type": "null"
              }
            ],
            "description": "The most recent player frame, for NBA games (since 2026-11-13); null when the match has no player tracking. Every playerFrame frame replaces it."
          }
        },
        "required": [
          "fixtureId",
          "tracking",
          "ball",
          "events",
          "timeline",
          "playerFrame"
        ]
      },
      "PlayerFrame": {
        "type": "object",
        "description": "A single player-tracking frame, for basketball and only in NBA games (since 2026-11-13): the ball and all players on the court, five frames per second. Positions use the court frame with home attacking the x = 100 basket throughout; the teams change ends at half-time, the frame does not. Which way each team plays is worked out per period from where its shots go, so a live frame from the opening seconds of a match, before anyone has shot, may come mirrored; frames read again over REST are corrected. Half-time has no frames (warm-ups are dropped). Recorded live only: a game that was not captured live has no frames.",
        "properties": {
          "frame": {
            "type": "integer",
            "description": "Rising frame counter for the match (gaps are expected). It gives the order and is the paging cursor (after) of GET /v2/fixtures/{id}/tracking/players."
          },
          "at": {
            "type": "string",
            "format": "date-time",
            "description": "Time we received the frame, roughly 1–2 s later than the moment it depicts. Frames come in batches of five per second that share this time: show them in `frame` order with 0.2 s between them."
          },
          "period": {
            "type": "integer",
            "description": "Period number: 1–4 are the quarters, 5 is the first overtime, 6 the second, and so on."
          },
          "clock": {
            "type": "integer",
            "description": "Game clock: seconds remaining in the period. Unit: seconds."
          },
          "shotClock": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Shot clock in seconds; null while it is switched off. Unit: seconds."
          },
          "running": {
            "type": "boolean",
            "description": "True while the game clock is ticking."
          },
          "possession": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerFramePossession"
              },
              {
                "type": "null"
              }
            ],
            "description": "The side and player in possession; null when neither side has the ball."
          },
          "ball": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerFrameBall"
              },
              {
                "type": "null"
              }
            ],
            "description": "Ball position; null when the tracker cannot see it."
          },
          "players": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PlayerFramePlayer"
            },
            "description": "Everyone on the court (ten during play)."
          }
        },
        "required": [
          "frame",
          "at",
          "period",
          "clock",
          "shotClock",
          "running",
          "possession",
          "ball",
          "players"
        ]
      },
      "PlayerFramePossession": {
        "type": "object",
        "description": "Ball possession within a player frame.",
        "properties": {
          "side": {
            "$ref": "#/components/schemas/Side",
            "description": "Side in possession."
          },
          "player": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TrackedPlayer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Player holding the ball; null when nobody holds it (a shot in flight, a loose ball) or when the squad has no entry for them."
          }
        },
        "required": [
          "side",
          "player"
        ]
      },
      "PlayerFrameBall": {
        "type": "object",
        "description": "Ball position within a player frame.",
        "properties": {
          "x": {
            "type": "number",
            "description": "Along the court, 0–100 (TrackingCoordinates court, home shooting at x = 100)."
          },
          "y": {
            "type": "number",
            "description": "Across the court, 0–100."
          },
          "height": {
            "type": "number",
            "description": "Metres above the floor (the rim sits at 3.05)."
          }
        },
        "required": [
          "x",
          "y",
          "height"
        ]
      },
      "PlayerFramePlayer": {
        "type": "object",
        "description": "One player on the floor, as seen in a player frame. There is no id, because tracked players are not linked to DataSportsAPI player ids; within one match, name, shirt number and side tell them apart.",
        "properties": {
          "side": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "type": "null"
              }
            ],
            "description": "Which side the player is on; null if the match squad does not include them."
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Name as displayed, given name first; null if the match squad does not include them."
          },
          "shirtNumber": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number on their shirt in this match."
          },
          "x": {
            "type": "number",
            "description": "Position along the court on the 0–100 court frame; slightly beyond that range while the player has stepped off the floor (out of bounds, by the bench)."
          },
          "y": {
            "type": "number",
            "description": "Across the court, 0–100, in the same way."
          }
        },
        "required": [
          "side",
          "name",
          "shirtNumber",
          "x",
          "y"
        ]
      },
      "WsWelcome": {
        "type": "object",
        "description": "The server sends this frame first, as soon as the connection opens.",
        "properties": {
          "type": {
            "type": "string",
            "const": "welcome"
          },
          "protocol": {
            "type": "integer",
            "description": "Version of the protocol in use. It has been 4 since the evening of 2026-10-23 (from then on, a fixture joining a list channel is delivered as a `fixture` frame); it was 3 from 2026-10-23 and 2 from 2026-10-19. Channels and frame types are added without changing this number (odds:{id} on 2026-11-04, tracking:{id} on 2026-11-12, the timelineEvent and playerFrame frames on tracking:{id} on 2026-11-13), so skip any frame type you do not recognise."
          },
          "heartbeatMs": {
            "type": "integer",
            "description": "Interval between server pings. Reply to them (browsers do this automatically) or the connection is closed."
          },
          "maxChannels": {
            "type": "integer",
            "description": "Maximum number of channels this connection may subscribe to."
          },
          "replay": {
            "type": "boolean",
            "description": "True when your plan includes `lastSeq` replay."
          }
        },
        "required": [
          "type",
          "protocol",
          "heartbeatMs",
          "maxChannels",
          "replay"
        ]
      },
      "WsSnapshot": {
        "type": "object",
        "description": "The complete current state of a channel, delivered when you subscribe and again whenever you resync.",
        "properties": {
          "type": {
            "type": "string",
            "const": "snapshot"
          },
          "channel": {
            "type": "string"
          },
          "seq": {
            "type": "integer",
            "description": "Current sequence number of the channel. Treat it as an opaque, increasing counter that does not start at 0; the following delta carries seq + 1."
          },
          "ts": {
            "type": "integer",
            "description": "Server timestamp in Unix milliseconds."
          },
          "data": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Fixture"
                }
              },
              {
                "$ref": "#/components/schemas/Fixture"
              },
              {
                "$ref": "#/components/schemas/RaceSnapshot"
              },
              {
                "$ref": "#/components/schemas/Odds"
              },
              {
                "$ref": "#/components/schemas/TrackingSnapshot"
              },
              {
                "type": "null"
              }
            ],
            "description": "Depends on the channel. livescores / sport:{slug} / league:{id} / team:{id} carry a Fixture[]: for league:{id}, that league’s in-progress fixtures; for team:{id} (since 2026-11-04), that team’s in-progress fixtures, home and away. fixture:{id} carries a Fixture and race:{id} a RaceSnapshot; odds:{id} (since 2026-11-04) carries an Odds matching GET /v2/fixtures/{id}/odds, and tracking:{id} (since 2026-11-12) a TrackingSnapshot. Each of these four is null when there is no data."
          }
        },
        "required": [
          "type",
          "channel",
          "seq",
          "ts",
          "data"
        ]
      },
      "WsDelta": {
        "type": "object",
        "description": "Sent when a single fixture changes. On the four list channels (livescores, sport:{slug}, league:{id}, team:{id}), every delta concerns a fixture the channel already sent you, either in its snapshot or as a `fixture` frame, and a fixture that drops out of the channel (finished, canceled) receives one final delta reporting that. Deltas cover both live-feed updates and the corrections a board refresh produces. A score that goes DOWN (a goal disallowed, a basket corrected) arrives within 1.5 s of the source sending it; the delay lets us drop the brief flaps when the source re-sends an older score. A REST refetch of /fixtures/{id} may still be a few seconds ahead, so resync from time to time if you need exact values.",
        "properties": {
          "type": {
            "type": "string",
            "const": "delta"
          },
          "channel": {
            "type": "string"
          },
          "seq": {
            "type": "integer",
            "description": "One more than the previous seq on this channel. A gap means you lost a delta — send resync."
          },
          "ts": {
            "type": "integer",
            "description": "Server timestamp in Unix milliseconds."
          },
          "id": {
            "type": "integer",
            "description": "Fixture id assigned by DataSportsAPI."
          },
          "sport": {
            "type": "string",
            "description": "Slug of the fixture’s sport."
          },
          "changes": {
            "$ref": "#/components/schemas/FixturePatch",
            "description": "A partial Fixture that uses the same field names and nesting as the full object. Deep-merge it into the Fixture you store: objects are merged key by key, while every other value (null included) overwrites what you have. No fields beyond those listed for FixturePatch are ever sent."
          }
        },
        "required": [
          "type",
          "channel",
          "seq",
          "ts",
          "id",
          "sport",
          "changes"
        ]
      },
      "WsFixture": {
        "type": "object",
        "description": "On the four list channels (livescores, sport:{slug}, league:{id}, team:{id}): the channel’s set gained a fixture — after kick-off, or when the server first sees it. The frame carries the complete Fixture, exactly as a snapshot would contain it. Append it to your list and apply subsequent deltas to it. fixture:{id} channels never receive this frame.",
        "properties": {
          "type": {
            "type": "string",
            "const": "fixture"
          },
          "channel": {
            "type": "string"
          },
          "seq": {
            "type": "integer",
            "description": "One more than the previous seq on this channel; the counter is shared with deltas."
          },
          "ts": {
            "type": "integer",
            "description": "Server timestamp in Unix milliseconds."
          },
          "id": {
            "type": "integer",
            "description": "Fixture id assigned by DataSportsAPI."
          },
          "sport": {
            "type": "string",
            "description": "Slug of the fixture’s sport."
          },
          "data": {
            "$ref": "#/components/schemas/Fixture",
            "description": "A match, in the same shape used by every endpoint and by WebSocket snapshots."
          }
        },
        "required": [
          "type",
          "channel",
          "seq",
          "ts",
          "id",
          "sport",
          "data"
        ]
      },
      "WsSubscribed": {
        "type": "object",
        "description": "Acknowledges a subscribe that produced no snapshot: either a `lastSeq` replay (sent once the replayed frames have gone out) or a repeat subscribe to a channel you already hold.",
        "properties": {
          "type": {
            "type": "string",
            "const": "subscribed"
          },
          "channel": {
            "type": "string"
          },
          "seq": {
            "type": "integer",
            "description": "Current seq of the channel once the replay is done; the following delta carries seq + 1."
          },
          "ts": {
            "type": "integer",
            "description": "Server timestamp in Unix milliseconds."
          },
          "replayed": {
            "type": "integer",
            "description": "Number of frames the replay delivered. 0 means you missed nothing, or that you were already subscribed to the channel."
          }
        },
        "required": [
          "type",
          "channel",
          "seq",
          "ts",
          "replayed"
        ]
      },
      "WsWinProbability": {
        "type": "object",
        "description": "On fixture:{id} channels for football fixtures in play: the win-probability estimate shifted by one percentage point or more (evaluated whenever the fixture changes and once per minute). `point` matches the endpoint’s `current`, including why it moved, and `point.at` is the moment it was calculated. It is NOT a point on the stored curve, whose per-minute points fall at the end of each minute; for a chart, fetch GET /v2/fixtures/{id}/win-probability once and then refresh it with `?since=`.",
        "properties": {
          "type": {
            "type": "string",
            "const": "winProbability"
          },
          "channel": {
            "type": "string"
          },
          "seq": {
            "type": "integer",
            "description": "One more than the previous seq on this channel; the channel’s deltas use the same counter."
          },
          "ts": {
            "type": "integer",
            "description": "Server timestamp in Unix milliseconds."
          },
          "id": {
            "type": "integer",
            "description": "Fixture id assigned by DataSportsAPI."
          },
          "sport": {
            "type": "string",
            "const": "football",
            "description": "Slug of the fixture’s sport; win probability exists only for football."
          },
          "model": {
            "$ref": "#/components/schemas/WinProbabilityModel",
            "description": "Version of the model that produced the estimate. Each version is described in the docs, and new ones are announced in the changelog."
          },
          "point": {
            "$ref": "#/components/schemas/WinProbabilityPoint",
            "description": "One point on the win-probability curve: the estimate together with the reason it was produced."
          }
        },
        "required": [
          "type",
          "channel",
          "seq",
          "ts",
          "id",
          "sport",
          "model",
          "point"
        ]
      },
      "WsCommentary": {
        "type": "object",
        "description": "On fixture:{id} channels for football fixtures: a fresh AI commentary entry has been produced. Keep the two counters apart: the frame’s `seq` belongs to the channel (and is shared with deltas), whereas `entry.seq` numbers the entry within GET /v2/fixtures/{id}/commentary.",
        "properties": {
          "type": {
            "type": "string",
            "const": "commentary"
          },
          "channel": {
            "type": "string"
          },
          "seq": {
            "type": "integer",
            "description": "One more than the previous seq on this channel; the channel’s deltas use the same counter."
          },
          "ts": {
            "type": "integer",
            "description": "Server timestamp in Unix milliseconds."
          },
          "id": {
            "type": "integer",
            "description": "Fixture id assigned by DataSportsAPI."
          },
          "sport": {
            "type": "string",
            "const": "football",
            "description": "Slug of the fixture’s sport; commentary exists only for football."
          },
          "entry": {
            "$ref": "#/components/schemas/CommentaryEntry",
            "description": "A single AI-written commentary entry."
          }
        },
        "required": [
          "type",
          "channel",
          "seq",
          "ts",
          "id",
          "sport",
          "entry"
        ]
      },
      "WsEvents": {
        "type": "object",
        "description": "On fixture:{id} channels for fixtures in play: the list of match events (goals, cards, substitutions, VAR decisions, periods, …) has changed. Because the live feed contains no events, the server pulls them from REST: roughly 20 s and 45 s after every change of score, red cards or status (goals reach the source’s event list 18–33 s after the score changes), and every 30 s during play, since cards and substitutions trigger no signal. A frame goes out only when the list differs. A disallowed goal shows up in `changes.removed`, and only after REST has confirmed it. Each frame holds the complete list, so missing one does no harm; fetch GET /v2/fixtures/{id}/events for the state before the first frame arrives.",
        "properties": {
          "type": {
            "type": "string",
            "const": "events"
          },
          "channel": {
            "type": "string"
          },
          "seq": {
            "type": "integer",
            "description": "One more than the previous seq on this channel; the channel’s deltas use the same counter."
          },
          "ts": {
            "type": "integer",
            "description": "Server timestamp in Unix milliseconds."
          },
          "id": {
            "type": "integer",
            "description": "Fixture id assigned by DataSportsAPI."
          },
          "sport": {
            "type": "string",
            "description": "Slug of the fixture’s sport."
          },
          "events": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/KeyedIncident"
            },
            "description": "The FULL events list as it stands, in chronological order — the incidents GET /v2/fixtures/{id}/events returns, keys included. Replace your copy with it."
          },
          "changes": {
            "$ref": "#/components/schemas/IncidentChanges",
            "description": "The difference between this events frame and the one before it."
          }
        },
        "required": [
          "type",
          "channel",
          "seq",
          "ts",
          "id",
          "sport",
          "events",
          "changes"
        ]
      },
      "WsStatistics": {
        "type": "object",
        "description": "On fixture:{id} channels for fixtures in play: the match statistics have changed, and the frame carries the complete object as returned by GET /v2/fixtures/{id}/statistics. The server reads REST every 30 s while at least one client is subscribed, plus a final read after full time, and emits a frame only when the content differs. Figures typically trail the action by ~30–60 s.",
        "properties": {
          "type": {
            "type": "string",
            "const": "statistics"
          },
          "channel": {
            "type": "string"
          },
          "seq": {
            "type": "integer",
            "description": "One more than the previous seq on this channel; the channel’s deltas use the same counter."
          },
          "ts": {
            "type": "integer",
            "description": "Server timestamp in Unix milliseconds."
          },
          "id": {
            "type": "integer",
            "description": "Fixture id assigned by DataSportsAPI."
          },
          "sport": {
            "type": "string",
            "description": "Slug of the fixture’s sport."
          },
          "statistics": {
            "$ref": "#/components/schemas/Statistics",
            "description": "The match statistics, broken down by period."
          }
        },
        "required": [
          "type",
          "channel",
          "seq",
          "ts",
          "id",
          "sport",
          "statistics"
        ]
      },
      "WsLineups": {
        "type": "object",
        "description": "On fixture:{id} channels for fixtures in play: the lineups have changed. The frame carries the whole object that GET /v2/fixtures/{id}/lineups returns, including each player’s statistics. While someone is subscribed the server checks every 30 s, stopping once the lineups are confirmed and have stayed the same for 10 minutes. Substitutions are delivered as events instead.",
        "properties": {
          "type": {
            "type": "string",
            "const": "lineups"
          },
          "channel": {
            "type": "string"
          },
          "seq": {
            "type": "integer",
            "description": "One more than the previous seq on this channel; the channel’s deltas use the same counter."
          },
          "ts": {
            "type": "integer",
            "description": "Server timestamp in Unix milliseconds."
          },
          "id": {
            "type": "integer",
            "description": "Fixture id assigned by DataSportsAPI."
          },
          "sport": {
            "type": "string",
            "description": "Slug of the fixture’s sport."
          },
          "lineups": {
            "$ref": "#/components/schemas/Lineups",
            "description": "The lineups for each side."
          }
        },
        "required": [
          "type",
          "channel",
          "seq",
          "ts",
          "id",
          "sport",
          "lineups"
        ]
      },
      "WsPlayByPlay": {
        "type": "object",
        "description": "On fixture:{id} channels, for football and basketball matches in play: the source’s play-by-play commentary has new or changed text. While at least one client is subscribed the server re-reads REST every 20 s (the source’s own page updates every 15–20 s), and once more after full time. A frame is sent only when the list differs, and it starts at the first entry that changed. For the state before the first frame, call GET /v2/fixtures/{id}/play-by-play.",
        "properties": {
          "type": {
            "type": "string",
            "const": "playByPlay"
          },
          "channel": {
            "type": "string"
          },
          "seq": {
            "type": "integer",
            "description": "One more than the previous seq on this channel; the channel’s deltas use the same counter."
          },
          "ts": {
            "type": "integer",
            "description": "Server timestamp in Unix milliseconds."
          },
          "id": {
            "type": "integer",
            "description": "Fixture id assigned by DataSportsAPI."
          },
          "sport": {
            "type": "string",
            "description": "Slug of the fixture’s sport."
          },
          "start": {
            "type": "integer",
            "description": "0-based position, in the full list, of the first item in `entries`. Retain your first `start` entries, discard everything after them and append `entries`. Normally equal to the length of your list (new lines added at the end); lower when the source edited or deleted a line."
          },
          "total": {
            "type": "integer",
            "description": "Current length of the full list (start + entries.length). If `start` is beyond the end of your list, you are out of sync — reload GET /v2/fixtures/{id}/play-by-play."
          },
          "entries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PlayByPlayEntry"
            },
            "description": "Entries from position `start` onwards, oldest first, in the form GET /v2/fixtures/{id}/play-by-play returns them."
          }
        },
        "required": [
          "type",
          "channel",
          "seq",
          "ts",
          "id",
          "sport",
          "start",
          "total",
          "entries"
        ]
      },
      "WsMomentum": {
        "type": "object",
        "description": "On fixture:{id} channels for football fixtures in play: the momentum graph has changed. The frame holds the complete object as returned by GET /v2/fixtures/{id}/momentum; with one point per minute, expect roughly one frame a minute. While anyone is subscribed the server checks every 30 s (and once more after full time) and only sends a frame if something changed.",
        "properties": {
          "type": {
            "type": "string",
            "const": "momentum"
          },
          "channel": {
            "type": "string"
          },
          "seq": {
            "type": "integer",
            "description": "One more than the previous seq on this channel; the channel’s deltas use the same counter."
          },
          "ts": {
            "type": "integer",
            "description": "Server timestamp in Unix milliseconds."
          },
          "id": {
            "type": "integer",
            "description": "Fixture id assigned by DataSportsAPI."
          },
          "sport": {
            "type": "string",
            "description": "Slug of the fixture’s sport."
          },
          "momentum": {
            "$ref": "#/components/schemas/Momentum",
            "description": "The momentum graph: a value per game in tennis, or per minute in football, basketball, handball, ice hockey and the like."
          }
        },
        "required": [
          "type",
          "channel",
          "seq",
          "ts",
          "id",
          "sport",
          "momentum"
        ]
      },
      "WsShotmap": {
        "type": "object",
        "description": "On fixture:{id} channels for football fixtures in play: the shot map has changed, through either a new shot or a correction by the source. While anyone is subscribed the server checks every 30 s (and once more after full time) and only sends a frame if something changed. Shots typically appear ~30–60 s after they happen.",
        "properties": {
          "type": {
            "type": "string",
            "const": "shotmap"
          },
          "channel": {
            "type": "string"
          },
          "seq": {
            "type": "integer",
            "description": "One more than the previous seq on this channel; the channel’s deltas use the same counter."
          },
          "ts": {
            "type": "integer",
            "description": "Server timestamp in Unix milliseconds."
          },
          "id": {
            "type": "integer",
            "description": "Fixture id assigned by DataSportsAPI."
          },
          "sport": {
            "type": "string",
            "description": "Slug of the fixture’s sport."
          },
          "shots": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Shot"
            },
            "description": "The current shot map in FULL, oldest first, as returned by GET /v2/fixtures/{id}/shotmap. Overwrite your copy with it."
          }
        },
        "required": [
          "type",
          "channel",
          "seq",
          "ts",
          "id",
          "sport",
          "shots"
        ]
      },
      "WsRace": {
        "type": "object",
        "description": "On race:{id}: something about the race changed, such as a session starting or finishing, or a status or schedule update. The frame carries the complete Race as returned by GET /v2/races/{id}. Since the live feed has no data for race sports, the server reads REST every 60 s while a session is running or due to begin within 15 minutes.",
        "properties": {
          "type": {
            "type": "string",
            "const": "race"
          },
          "channel": {
            "type": "string"
          },
          "seq": {
            "type": "integer",
            "description": "One more than the previous seq on this channel."
          },
          "ts": {
            "type": "integer",
            "description": "Server timestamp in Unix milliseconds."
          },
          "id": {
            "type": "integer",
            "description": "Race id assigned by DataSportsAPI."
          },
          "sport": {
            "type": "string",
            "description": "Slug of the race’s sport (motorsport, cycling)."
          },
          "data": {
            "$ref": "#/components/schemas/Race",
            "description": "A race: a motorsport weekend with practice, qualifying, sprint and race, or a cycling event — one-day or stage race."
          }
        },
        "required": [
          "type",
          "channel",
          "seq",
          "ts",
          "id",
          "sport",
          "data"
        ]
      },
      "WsRaceResults": {
        "type": "object",
        "description": "On race:{id}: the classification of a session has changed. The server checks every 30 s while the session is running and one last time when it finishes, and sends a frame only when something differs.",
        "properties": {
          "type": {
            "type": "string",
            "const": "raceResults"
          },
          "channel": {
            "type": "string"
          },
          "seq": {
            "type": "integer",
            "description": "One more than the previous seq on this channel."
          },
          "ts": {
            "type": "integer",
            "description": "Server timestamp in Unix milliseconds."
          },
          "id": {
            "type": "integer",
            "description": "Race id assigned by DataSportsAPI."
          },
          "sport": {
            "type": "string",
            "description": "Slug of the race’s sport."
          },
          "session": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "The session this classification belongs to."
          },
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RaceResult"
            },
            "description": "The full classification of the session, as returned by /v2/races/{id}/results?session=."
          }
        },
        "required": [
          "type",
          "channel",
          "seq",
          "ts",
          "id",
          "sport",
          "session",
          "results"
        ]
      },
      "WsOdds": {
        "type": "object",
        "description": "On odds:{fixtureId}: prices have moved (available since 2026-11-04). Price changes, both in-play and pre-match, come from the source’s live odds feed and reach you within roughly a second. Suspensions, newly added markets and settlement flags rely on a REST re-read, every 30 s during the match and every 2 minutes beforehand. Hold on to the snapshot (an Odds, as returned by GET /v2/fixtures/{id}/odds) and merge every frame into it by market `key`. Odds travel exclusively on `odds:{id}`; no other channel includes them.",
        "properties": {
          "type": {
            "type": "string",
            "const": "odds"
          },
          "channel": {
            "type": "string"
          },
          "seq": {
            "type": "integer",
            "description": "One more than the previous seq on this channel."
          },
          "ts": {
            "type": "integer",
            "description": "Server timestamp in Unix milliseconds."
          },
          "id": {
            "type": "integer",
            "description": "Fixture id assigned by DataSportsAPI."
          },
          "sport": {
            "type": "string",
            "description": "Slug of the fixture’s sport."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Time at which these prices came in."
          },
          "markets": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OddsMarket"
            },
            "description": "Markets that changed, each sent in FULL with all its choices. Swap out your market with the matching `key`, or add it if you do not have one yet."
          },
          "removed": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Keys of markets the bookmaker has withdrawn (for example a handicap line that moved, or a closed market). Remove them from your copy."
          }
        },
        "required": [
          "type",
          "channel",
          "seq",
          "ts",
          "id",
          "sport",
          "updatedAt",
          "markets",
          "removed"
        ]
      },
      "WsBall": {
        "type": "object",
        "description": "On tracking:{fixtureId} (since 2026-11-12): one new position of the live ball track — about 14 a minute of football play, about one per tennis shot — sent within roughly a second after the source records it. Add it to the end of the ball list you got with the snapshot.",
        "properties": {
          "type": {
            "type": "string",
            "const": "ball"
          },
          "channel": {
            "type": "string"
          },
          "seq": {
            "type": "integer",
            "description": "One more than the previous seq on this channel."
          },
          "ts": {
            "type": "integer",
            "description": "Server timestamp in Unix milliseconds."
          },
          "id": {
            "type": "integer",
            "description": "Fixture id assigned by DataSportsAPI."
          },
          "sport": {
            "type": "string",
            "enum": [
              "football",
              "tennis",
              "basketball",
              "ice-hockey",
              "darts"
            ],
            "description": "Slug of the fixture’s sport."
          },
          "frame": {
            "$ref": "#/components/schemas/BallFrame",
            "description": "The new position of the ball (football, tennis)."
          }
        },
        "required": [
          "type",
          "channel",
          "seq",
          "ts",
          "id",
          "sport",
          "frame"
        ]
      },
      "WsTrackedEvent": {
        "type": "object",
        "description": "On tracking:{fixtureId} (since 2026-11-12): one more tracked event. Tennis sends each serve, point, ball position and player position live. Football sends, live and about 18 a minute, its goals, shots, cards, substitutions, set pieces and the flow-of-play types (possessionChange, flowAttack, flowDangerousAttack, flowBallSafe), then the passes in one burst with the post-match read. Basketball events come mostly in that burst. Keep events keyed by key; receiving a key you already have means the same event again.",
        "properties": {
          "type": {
            "type": "string",
            "const": "trackedEvent"
          },
          "channel": {
            "type": "string"
          },
          "seq": {
            "type": "integer",
            "description": "One more than the previous seq on this channel."
          },
          "ts": {
            "type": "integer",
            "description": "Server timestamp in Unix milliseconds."
          },
          "id": {
            "type": "integer",
            "description": "Fixture id assigned by DataSportsAPI."
          },
          "sport": {
            "type": "string",
            "enum": [
              "football",
              "tennis",
              "basketball",
              "ice-hockey",
              "darts"
            ],
            "description": "Slug of the fixture’s sport."
          },
          "event": {
            "$ref": "#/components/schemas/TrackedEvent",
            "description": "A tracked play-by-play event and where on the pitch or court it happened (football, tennis, basketball). Tennis events are sent live; football ones too, usually some 9 seconds behind play and rarely past 15 (flow of play, set pieces, shots, goals, cards, substitutions, while passes and finer detail follow with the post-match read). Basketball events mostly come with the post-match read."
          }
        },
        "required": [
          "type",
          "channel",
          "seq",
          "ts",
          "id",
          "sport",
          "event"
        ]
      },
      "WsTimelineEvent": {
        "type": "object",
        "description": "On tracking:{fixtureId} (since 2026-11-13): one basketball, ice hockey or darts timeline event, roughly 5 seconds after the moment (about 4 – 8 a minute in basketball, about 25 – 30 in darts). With upsert, add it or overwrite the one under the same key (a revision; earlier positions in a period can shift once its shots show which way the side attacks); with remove, the source has withdrawn it. Start from the snapshot’s timeline and apply every frame by key.",
        "properties": {
          "type": {
            "type": "string",
            "const": "timelineEvent"
          },
          "channel": {
            "type": "string"
          },
          "seq": {
            "type": "integer",
            "description": "One more than the previous seq on this channel."
          },
          "ts": {
            "type": "integer",
            "description": "Server timestamp in Unix milliseconds."
          },
          "id": {
            "type": "integer",
            "description": "Fixture id assigned by DataSportsAPI."
          },
          "sport": {
            "type": "string",
            "enum": [
              "football",
              "tennis",
              "basketball",
              "ice-hockey",
              "darts"
            ],
            "description": "Slug of the fixture’s sport."
          },
          "op": {
            "$ref": "#/components/schemas/TimelineOp",
            "description": "How this frame changes the timeline you keep."
          },
          "key": {
            "type": "string",
            "description": "Key of the event (TimelineEvent.key) to add, overwrite or delete."
          },
          "event": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TimelineEvent"
              },
              {
                "type": "null"
              }
            ],
            "description": "For upsert, the event; null for remove."
          }
        },
        "required": [
          "type",
          "channel",
          "seq",
          "ts",
          "id",
          "sport",
          "op",
          "key",
          "event"
        ]
      },
      "WsPlayerFrame": {
        "type": "object",
        "description": "On tracking:{fixtureId}, NBA games only (since 2026-11-13): one player frame with the ball and every player, five per second, about 1–2 seconds behind play and delivered in batches of five each second. Unlike every other frame it has NO seq and is never replayed: it samples the current state and the newest frame wins. Replace the snapshot’s playerFrame with it, and show the frames of one batch in `frame` order, spacing them 0.2 s. A connection that lags behind receives the newer frames and misses the older ones.",
        "properties": {
          "type": {
            "type": "string",
            "const": "playerFrame"
          },
          "channel": {
            "type": "string"
          },
          "ts": {
            "type": "integer",
            "description": "Server timestamp in Unix milliseconds."
          },
          "id": {
            "type": "integer",
            "description": "Fixture id assigned by DataSportsAPI."
          },
          "sport": {
            "type": "string",
            "enum": [
              "football",
              "tennis",
              "basketball",
              "ice-hockey",
              "darts"
            ],
            "description": "Slug of the fixture’s sport (basketball)."
          },
          "frame": {
            "$ref": "#/components/schemas/PlayerFrame",
            "description": "One player-tracking frame (basketball, NBA games only; since 2026-11-13): the ball and every player on the court, five frames a second, in a court frame where the home side attacks x = 100 in every period, although the teams swap baskets at half-time. Each team’s direction is read per period from where its shots go up, so a live frame from the first seconds, before any shot, can arrive mirrored (a later REST read is corrected). No frames during half-time, and none for a game that was not recorded live."
          }
        },
        "required": [
          "type",
          "channel",
          "ts",
          "id",
          "sport",
          "frame"
        ]
      },
      "WsTrackingStatus": {
        "type": "object",
        "description": "On tracking:{fixtureId} (since 2026-11-12): sent when the match ends (final) and again when its post-match data has been read (complete).",
        "properties": {
          "type": {
            "type": "string",
            "const": "trackingStatus"
          },
          "channel": {
            "type": "string"
          },
          "seq": {
            "type": "integer",
            "description": "One more than the previous seq on this channel."
          },
          "ts": {
            "type": "integer",
            "description": "Server timestamp in Unix milliseconds."
          },
          "id": {
            "type": "integer",
            "description": "Fixture id assigned by DataSportsAPI."
          },
          "sport": {
            "type": "string",
            "enum": [
              "football",
              "tennis",
              "basketball",
              "ice-hockey",
              "darts"
            ],
            "description": "Slug of the fixture’s sport."
          },
          "final": {
            "type": "boolean",
            "description": "The match has ended; the ball track is closed."
          },
          "complete": {
            "type": "boolean",
            "description": "The post-match data has been read: call the REST tracking endpoints again to get the settled events, timeline and player names."
          }
        },
        "required": [
          "type",
          "channel",
          "seq",
          "ts",
          "id",
          "sport",
          "final",
          "complete"
        ]
      },
      "WsUnsubscribed": {
        "type": "object",
        "description": "Acknowledges that you have left a channel.",
        "properties": {
          "type": {
            "type": "string",
            "const": "unsubscribed"
          },
          "channel": {
            "type": "string"
          },
          "ts": {
            "type": "integer",
            "description": "Server timestamp in Unix milliseconds."
          }
        },
        "required": [
          "type",
          "channel",
          "ts"
        ]
      },
      "WsPing": {
        "type": "object",
        "description": "Heartbeat at the application level, emitted every heartbeatMs alongside the protocol-level ping. You do not need to answer it.",
        "properties": {
          "type": {
            "type": "string",
            "const": "ping"
          },
          "ts": {
            "type": "integer",
            "description": "Server timestamp in Unix milliseconds."
          }
        },
        "required": [
          "type",
          "ts"
        ]
      },
      "WsPong": {
        "type": "object",
        "description": "The server’s answer to a { \"type\": \"ping\" } you sent.",
        "properties": {
          "type": {
            "type": "string",
            "const": "pong"
          },
          "ts": {
            "type": "integer",
            "description": "Server timestamp in Unix milliseconds."
          }
        },
        "required": [
          "type",
          "ts"
        ]
      },
      "WsError": {
        "type": "object",
        "description": "The server rejected a frame you sent. Your connection remains open.",
        "properties": {
          "type": {
            "type": "string",
            "const": "error"
          },
          "code": {
            "$ref": "#/components/schemas/WsErrorCode",
            "description": "Machine-readable code of the WebSocket error."
          },
          "message": {
            "type": "string"
          },
          "channel": {
            "type": "string"
          },
          "ts": {
            "type": "integer",
            "description": "Server timestamp in Unix milliseconds."
          }
        },
        "required": [
          "type",
          "code",
          "message",
          "ts"
        ]
      },
      "Side": {
        "type": "string",
        "enum": [
          "home",
          "away"
        ],
        "description": "One of the two sides in a fixture.",
        "x-enumDescriptions": {
          "home": "The side listed as home in the fixture.",
          "away": "The side listed as away in the fixture."
        }
      },
      "Winner": {
        "type": "string",
        "enum": [
          "home",
          "away",
          "draw"
        ],
        "description": "Outcome of a fixture that has finished.",
        "x-enumDescriptions": {
          "home": "Victory for the home side.",
          "away": "Victory for the away side.",
          "draw": "Neither side won; the fixture was drawn."
        }
      },
      "StatusType": {
        "type": "string",
        "enum": [
          "notstarted",
          "inprogress",
          "interrupted",
          "willcontinue",
          "postponed",
          "canceled",
          "finished"
        ],
        "description": "High-level state of a match, meant for filtering.",
        "x-enumDescriptions": {
          "notstarted": "Has not begun yet: still scheduled, or its start has been delayed.",
          "inprogress": "Under way, breaks included (for example half-time, or a fight waiting for its decision).",
          "interrupted": "Halted partway through (weather, crowd, …); play is expected to restart.",
          "willcontinue": "A match spread over several days, currently between days (for cricket Tests, the end of day N).",
          "postponed": "Rescheduled for a later date; the fixture id stays the same.",
          "canceled": "The match is not going to be played (canceled, abandoned or removed).",
          "finished": "Completed and has a result."
        }
      },
      "StatusPhase": {
        "type": "string",
        "enum": [
          "notstarted",
          "delayed",
          "inprogress",
          "break",
          "awaitingResult",
          "interrupted",
          "suspended",
          "willcontinue",
          "postponed",
          "canceled",
          "abandoned",
          "finished"
        ],
        "description": "Detailed match state, as a scoreboard would display it.",
        "x-enumDescriptions": {
          "notstarted": "Scheduled and not yet under way.",
          "delayed": "The start time has passed but play has been delayed.",
          "inprogress": "A period is in play; status.period identifies which one.",
          "break": "A planned stoppage within the match, such as half-time, the gap between sets, waiting for extra time or penalties, or a cricket lunch / tea / drinks interval.",
          "awaitingResult": "Play has ended but the result has not been announced yet (for example a combat-sports judges’ decision).",
          "interrupted": "Halted unexpectedly; play should restart.",
          "suspended": "Halted by the organiser and possibly resumed on another day.",
          "willcontinue": "A match lasting several days, currently paused between days.",
          "postponed": "Rescheduled for a later date.",
          "canceled": "Called off before the start, or removed.",
          "abandoned": "Began but was stopped for good without a result.",
          "finished": "Completed; status.finish explains how the result was reached."
        }
      },
      "FinishType": {
        "type": "string",
        "enum": [
          "regular",
          "overtime",
          "penalties",
          "goldenSet",
          "walkover",
          "retired",
          "defaulted"
        ],
        "description": "The way a completed match was settled.",
        "x-enumDescriptions": {
          "regular": "Settled in regulation time; this is also the normal ending for any sport played in sets, frames or games.",
          "overtime": "Settled in overtime, extra time or extra innings (shown upstream as “AET”).",
          "penalties": "Settled by a penalty shoot-out (shown upstream as “AP”).",
          "goldenSet": "Settled by a golden set, in volleyball.",
          "walkover": "Result awarded with no match played.",
          "retired": "A side withdrew partway through the match (tennis).",
          "defaulted": "A side was defaulted or disqualified."
        }
      },
      "FightMethod": {
        "type": "string",
        "enum": [
          "ko",
          "tko",
          "submission",
          "unanimousDecision",
          "splitDecision",
          "majorityDecision",
          "technicalDecision",
          "pointsDecision",
          "disqualification",
          "noContest",
          "other"
        ],
        "description": "The way a fight was decided.",
        "x-enumDescriptions": {
          "ko": "Knockout (KO).",
          "tko": "Technical knockout: the referee or the doctor stopped the fight.",
          "submission": "Win by submission.",
          "unanimousDecision": "A decision on which every judge agreed.",
          "splitDecision": "A decision on which the judges were divided.",
          "majorityDecision": "A majority decision: two judges favour the winner and the third scores it even. Paired with `winner: \"draw\"` it is a majority draw instead, with two judges scoring a draw (observed in real boxing data on 2026-10-19).",
          "technicalDecision": "Decided on the scorecards following a stoppage.",
          "pointsDecision": "Boxing: a decision on points (PTS in the source), scored solely by the referee as in British small-hall bouts. A drawn bout carries `winner: \"draw\"`.",
          "disqualification": "One fighter was disqualified.",
          "noContest": "Ruled a no contest.",
          "other": "A method we do not classify yet; we log the source’s code."
        }
      },
      "MatchDiscipline": {
        "type": "string",
        "enum": [
          "singles",
          "doubles"
        ],
        "description": "Tennis: whether a match is singles or doubles.",
        "x-enumDescriptions": {
          "singles": "A single player per side.",
          "doubles": "Two players on each side (men’s, women’s or mixed, as the league indicates)."
        }
      },
      "FightDiscipline": {
        "type": "string",
        "enum": [
          "mma",
          "boxing",
          "kickboxing",
          "muayThai",
          "grappling",
          "other"
        ],
        "description": "Which combat sport a fight belongs to.",
        "x-enumDescriptions": {
          "mma": "Mixed martial arts (MMA).",
          "boxing": "A boxing bout.",
          "kickboxing": "A kickboxing bout.",
          "muayThai": "A Muay Thai bout.",
          "grappling": "A submission grappling match.",
          "other": "A discipline without a mapping yet; we log the source’s value."
        }
      },
      "SurfaceType": {
        "type": "string",
        "enum": [
          "hard",
          "clay",
          "grass",
          "carpet",
          "other"
        ],
        "description": "Surface of a tennis court.",
        "x-enumDescriptions": {
          "hard": "A hard court.",
          "clay": "A clay court, red or green.",
          "grass": "A grass court.",
          "carpet": "Carpet, a synthetic indoor surface.",
          "other": "A surface we do not classify yet; `name` holds the source’s text."
        }
      },
      "TossDecision": {
        "type": "string",
        "enum": [
          "bat",
          "bowl"
        ],
        "description": "The choice made by the side that won a cricket toss.",
        "x-enumDescriptions": {
          "bat": "Elected to bat first.",
          "bowl": "Elected to bowl (field) first."
        }
      },
      "FightCardSection": {
        "type": "string",
        "enum": [
          "mainCard",
          "prelims",
          "earlyPrelims",
          "other"
        ],
        "description": "Which section of a fight card a bout belongs to.",
        "x-enumDescriptions": {
          "mainCard": "Part of the main card.",
          "prelims": "Part of the preliminary card.",
          "earlyPrelims": "Part of the early preliminary card.",
          "other": "A section without a mapping yet; we log the source’s value."
        }
      },
      "DownPlayType": {
        "type": "string",
        "enum": [
          "scrimmage",
          "kickoff",
          "conversion",
          "other"
        ],
        "description": "American football: what type of play the ball is spotted for.",
        "x-enumDescriptions": {
          "scrimmage": "A scrimmage play, for which downs count.",
          "kickoff": "A kickoff, which uses no down.",
          "conversion": "The try after a touchdown — a kick for the extra point or a two-point attempt — with no down in play.",
          "other": "Any play type missing from this list."
        }
      },
      "LiveWireKind": {
        "type": "string",
        "enum": [
          "score",
          "redCard",
          "kickoff",
          "period",
          "break",
          "finished"
        ],
        "description": "What happened at a live-wire moment. Each moment has exactly one kind: the first that fits, in the order score, redCard, finished, break, kickoff, period.",
        "x-enumDescriptions": {
          "score": "A side’s `current` score moved, up for a goal, basket, set or run, or down when a correction removed one.",
          "redCard": "A side’s red-card count changed (football and the other sports that keep one).",
          "kickoff": "The match began: it joined the live lists in play.",
          "period": "A new period started (second half, next quarter, a set, an inning …).",
          "break": "Play stopped for a scheduled break (half-time, between periods).",
          "finished": "The match ended."
        }
      },
      "Position": {
        "type": "string",
        "enum": [
          "goalkeeper",
          "defender",
          "midfielder",
          "forward",
          "guard",
          "center",
          "guardForward",
          "forwardCenter",
          "goalie",
          "defenseman",
          "leftWing",
          "rightWing",
          "leftBack",
          "rightBack",
          "centreBack",
          "pivot",
          "quarterback",
          "runningBack",
          "wideReceiver",
          "tightEnd",
          "offensiveLineman",
          "offensiveTackle",
          "offensiveGuard",
          "defensiveTackle",
          "defensiveEnd",
          "defensiveLineman",
          "linebacker",
          "cornerback",
          "safety",
          "defensiveBack",
          "kicker",
          "punter",
          "longSnapper",
          "pitcher",
          "startingPitcher",
          "reliefPitcher",
          "catcher",
          "firstBase",
          "secondBase",
          "thirdBase",
          "shortstop",
          "leftField",
          "centerField",
          "rightField",
          "infielder",
          "outfielder",
          "designatedHitter",
          "batter",
          "bowler",
          "allRounder",
          "wicketKeeper",
          "back",
          "other"
        ],
        "description": "Where a player plays, defined per sport; `positionCode` keeps the source’s letter code.",
        "x-enumDescriptions": {
          "goalkeeper": "Football, futsal and handball: goalkeeper.",
          "defender": "Football and futsal: defender.",
          "midfielder": "Football and futsal: midfielder.",
          "forward": "Football, futsal, basketball, ice hockey and rugby: forward.",
          "guard": "Basketball: guard.",
          "center": "Basketball, ice hockey and American football: center.",
          "guardForward": "Basketball: guard-forward.",
          "forwardCenter": "Basketball: forward-center.",
          "goalie": "Ice hockey: goalie.",
          "defenseman": "Ice hockey: defenseman.",
          "leftWing": "Ice hockey and handball: left wing.",
          "rightWing": "Ice hockey and handball: right wing.",
          "leftBack": "Handball: left back.",
          "rightBack": "Handball: right back.",
          "centreBack": "Handball: centre back.",
          "pivot": "Handball: pivot, also called line player.",
          "quarterback": "American football: quarterback.",
          "runningBack": "American football: running back or fullback.",
          "wideReceiver": "American football: wide receiver.",
          "tightEnd": "American football: tight end.",
          "offensiveLineman": "American football: offensive lineman.",
          "offensiveTackle": "American football: offensive tackle.",
          "offensiveGuard": "American football: offensive guard.",
          "defensiveTackle": "American football: defensive tackle or nose tackle.",
          "defensiveEnd": "American football: defensive end.",
          "defensiveLineman": "American football: defensive lineman.",
          "linebacker": "American football: linebacker.",
          "cornerback": "American football: cornerback.",
          "safety": "American football: safety.",
          "defensiveBack": "American football: defensive back.",
          "kicker": "American football: kicker.",
          "punter": "American football: punter.",
          "longSnapper": "American football: long snapper.",
          "pitcher": "Baseball: pitcher.",
          "startingPitcher": "Baseball: starting pitcher.",
          "reliefPitcher": "Baseball: relief pitcher.",
          "catcher": "Baseball: catcher.",
          "firstBase": "Baseball: first baseman.",
          "secondBase": "Baseball: second baseman.",
          "thirdBase": "Baseball: third baseman.",
          "shortstop": "Baseball: shortstop.",
          "leftField": "Baseball: left fielder.",
          "centerField": "Baseball: center fielder.",
          "rightField": "Baseball: right fielder.",
          "infielder": "Baseball: infielder.",
          "outfielder": "Baseball: outfielder.",
          "designatedHitter": "Baseball: designated hitter.",
          "batter": "Cricket: batter.",
          "bowler": "Cricket: bowler.",
          "allRounder": "Cricket: all-rounder.",
          "wicketKeeper": "Cricket: wicket-keeper.",
          "back": "Rugby: one of the backs, without saying which (the source does not specify).",
          "other": "A code that has no mapping for this sport; the raw value stays in `positionCode`."
        }
      },
      "Availability": {
        "type": "string",
        "enum": [
          "out",
          "doubtful"
        ],
        "description": "Tells whether an absent player is definitely out or only doubtful.",
        "x-enumDescriptions": {
          "out": "Will not play in this fixture.",
          "doubtful": "Could miss this fixture."
        }
      },
      "MissingReason": {
        "type": "string",
        "enum": [
          "injury",
          "illness",
          "suspension",
          "absent",
          "yellowCardSuspension",
          "yellowRedCardSuspension",
          "redCardSuspension",
          "onLoan",
          "other"
        ],
        "description": "The reason a player is unavailable.",
        "x-enumDescriptions": {
          "injury": "An injury; when known, `description` gives it (e.g. \"Hamstring Injury\").",
          "illness": "Illness.",
          "suspension": "A suspension that is not a card ban.",
          "absent": "Away for some other reason (personal matters, international duty, …).",
          "yellowCardSuspension": "A ban after accumulating yellow cards.",
          "yellowRedCardSuspension": "A ban following a sending-off for a second yellow card.",
          "redCardSuspension": "A ban following a straight red card.",
          "onLoan": "Loaned out and ineligible to face the parent club.",
          "other": "A reason from the source that DataSportsAPI has not classified yet."
        }
      },
      "StatKind": {
        "type": "string",
        "enum": [
          "value",
          "ratio",
          "time"
        ],
        "description": "Explains how a statistic’s value and total should be interpreted.",
        "x-enumDescriptions": {
          "value": "`value` holds the displayed number (for \"57%\" it is 57, for \"2.04\" it is 2.04) and `total` is null.",
          "ratio": "`value` successful attempts out of `total` (\"33/53 (62%)\" gives 33 and 53). A display that shows only a percentage, such as \"42%\", is still expressed as value / total.",
          "time": "`value` is a number of seconds and `total` the seconds that were available (the length of the period); time spent in the lead is one example."
        }
      },
      "HigherIs": {
        "type": "string",
        "enum": [
          "better",
          "worse"
        ],
        "description": "Tells whether a larger figure is an advantage.",
        "x-enumDescriptions": {
          "better": "Larger numbers favour the side (shots, possession).",
          "worse": "Larger numbers count against the side (fouls, turnovers, errors)."
        }
      },
      "IncidentType": {
        "type": "string",
        "enum": [
          "goal",
          "card",
          "substitution",
          "period",
          "injuryTime",
          "varDecision",
          "inGamePenalty",
          "shootoutPenalty",
          "suspension"
        ],
        "description": "The kind of match event.",
        "x-enumDescriptions": {
          "goal": "Any score, whether a goal, basket, try, touchdown, …; `detail` gives the kind. Points are not listed for set sports (volleyball, table tennis, badminton); the end of each set appears as a `period` row instead.",
          "card": "A card shown to a team official or a player.",
          "substitution": "A substitution in which playerIn comes on for playerOut.",
          "period": "The end of a period, and nothing else: since 2026-10-23 a period still in progress gets no row. `period` names the period just finished, and `text` holds its scoreboard label (FT, HT, Q2, 2. set, 3rd period, …). The scores show the match score at that moment — for volleyball, table tennis and badminton the sets won so far; the points inside each set are given by /points and by the fixture’s `periods`.",
          "injuryTime": "Announcement of added time: `addedMinute` extra minutes following `minute`.",
          "varDecision": "The outcome of a video review, described by `detail`; `confirmed` means the original call was upheld.",
          "inGamePenalty": "A penalty kick taken during play that did not result in a goal (`detail` missed). A converted penalty is recorded as a `goal` with detail `penalty`.",
          "shootoutPenalty": "A single kick in a penalty shoot-out. `shootoutSequence` is its position in the overall order (1, 2, 3, …, counting both sides) and `shootoutRound` is the round, i.e. the 1st, 2nd, … kick of the taker’s side.",
          "suspension": "A time-limited exclusion such as an ice hockey penalty or a handball two-minute suspension, with `durationSeconds` and `reason`."
        }
      },
      "IncidentDetail": {
        "type": "string",
        "enum": [
          "regular",
          "ownGoal",
          "penalty",
          "powerPlay",
          "shortHanded",
          "emptyNet",
          "onePoint",
          "twoPoints",
          "threePoints",
          "try",
          "touchdown",
          "extraPoint",
          "fieldGoal",
          "twoPointConversion",
          "safety",
          "yellow",
          "secondYellow",
          "red",
          "injury",
          "goalAwarded",
          "goalNotAwarded",
          "penaltyAwarded",
          "penaltyNotAwarded",
          "cardUpgrade",
          "cardDowngrade",
          "scored",
          "missed",
          "twoMinutes",
          "fiveMinutes",
          "tenMinutes",
          "fourMinutes",
          "awarded",
          "redCardGiven",
          "other"
        ],
        "description": "Refines an incident’s type into a more specific kind.",
        "x-enumDescriptions": {
          "regular": "For a goal, a standard goal; for a substitution, a tactical change.",
          "ownGoal": "goal: put into their own net by the conceding side; `side` is the team credited with it.",
          "penalty": "goal: a converted penalty kick or 7-metre throw.",
          "powerPlay": "goal (ice hockey): scored while the side had a man advantage.",
          "shortHanded": "goal (ice hockey): scored while the side was a man short.",
          "emptyNet": "goal (ice hockey): scored with no goalie in the net.",
          "onePoint": "goal (basketball): a made free throw.",
          "twoPoints": "goal: a 2-point field goal in basketball, or a conversion in rugby.",
          "threePoints": "goal: a 3-pointer in basketball, or a penalty goal or drop goal in rugby.",
          "try": "goal (rugby): try scored.",
          "touchdown": "goal (American football): touchdown scored.",
          "extraPoint": "goal (American football): extra point converted.",
          "fieldGoal": "goal (American football): field goal made.",
          "twoPointConversion": "goal (American football): successful two-point conversion.",
          "safety": "goal (American football): points from a safety.",
          "yellow": "card: a caution (yellow).",
          "secondYellow": "card: a second yellow, which means a sending-off.",
          "red": "card: a direct red.",
          "injury": "substitution: made because of an injury.",
          "goalAwarded": "varDecision: the review awarded a goal.",
          "goalNotAwarded": "varDecision: the review ruled a goal out.",
          "penaltyAwarded": "varDecision: the review awarded a penalty.",
          "penaltyNotAwarded": "varDecision: the review cancelled a penalty.",
          "cardUpgrade": "varDecision: the review raised a card (e.g. yellow → red).",
          "cardDowngrade": "varDecision: the review lowered a card.",
          "scored": "shootoutPenalty: the kick went in.",
          "missed": "shootoutPenalty / inGamePenalty: the kick failed, either missed or saved; `reason` tells which.",
          "twoMinutes": "suspension: minor penalty of two minutes.",
          "fiveMinutes": "suspension: major penalty of five minutes.",
          "tenMinutes": "suspension: misconduct penalty of ten minutes.",
          "fourMinutes": "suspension (ice hockey): double minor lasting four minutes. Available since 2026-11-09.",
          "awarded": "inGamePenalty: the referee gave a penalty kick; the kick is then logged separately (as `missed`, or as the goal). Available since 2026-11-09.",
          "redCardGiven": "varDecision: the review produced a red card. Available since 2026-11-09.",
          "other": "A kind supplied by the source that DataSportsAPI does not classify yet."
        }
      },
      "BodyPart": {
        "type": "string",
        "enum": [
          "rightFoot",
          "leftFoot",
          "head",
          "other"
        ],
        "description": "Football: the part of the body used for a shot.",
        "x-enumDescriptions": {
          "rightFoot": "Struck with the right foot.",
          "leftFoot": "Struck with the left foot.",
          "head": "Headed.",
          "other": "Some other part of the body."
        }
      },
      "GoalMouthLocation": {
        "type": "string",
        "enum": [
          "lowLeft",
          "lowCentre",
          "lowRight",
          "highLeft",
          "highCentre",
          "highRight",
          "left",
          "right",
          "high",
          "closeLeft",
          "closeRight",
          "closeHigh",
          "closeHighLeft",
          "closeHighRight",
          "other"
        ],
        "description": "Football: where a shot finished in relation to the goal.",
        "x-enumDescriptions": {
          "lowLeft": "On target, bottom left as seen by the shooter.",
          "lowCentre": "On target, bottom centre.",
          "lowRight": "On target, bottom right.",
          "highLeft": "On target, top left.",
          "highCentre": "On target, top centre.",
          "highRight": "On target, top right.",
          "left": "Missed to the left.",
          "right": "Missed to the right.",
          "high": "Went over the crossbar.",
          "closeLeft": "Narrowly wide to the left.",
          "closeRight": "Narrowly wide to the right.",
          "closeHigh": "Narrowly over the bar.",
          "closeHighLeft": "Narrowly over, to the left.",
          "closeHighRight": "Narrowly over, to the right.",
          "other": "A location we have not classified yet."
        }
      },
      "BuildUpAction": {
        "type": "string",
        "enum": [
          "pass",
          "cross",
          "throwIn",
          "freeKick",
          "carry",
          "touch",
          "tackle",
          "interception",
          "clearance",
          "savedShot",
          "missedShot",
          "post",
          "penaltySaved",
          "penaltyMissed",
          "goal",
          "other"
        ],
        "description": "The type of a single step in the move leading to a goal.",
        "x-enumDescriptions": {
          "pass": "A pass; `endPosition` marks where it was received.",
          "cross": "A cross; `endPosition` marks where it arrived.",
          "throwIn": "A throw-in; `endPosition` marks where it landed. Available since 2026-10-25.",
          "freeKick": "A free kick that fed into the move; `endPosition` marks where it arrived. Available since 2026-11-09.",
          "carry": "The player ran with the ball (ball-movement in the source), without an `endPosition`. Available since 2026-10-25.",
          "touch": "A block, deflection, goalkeeper’s parry or similar touch that kept the move going (ball-touch in the source). Available since 2026-10-25.",
          "tackle": "A ball-winning tackle from which the move begins or continues. Available since 2026-11-09.",
          "interception": "An intercepted pass from which the move begins or continues. Available since 2026-11-09.",
          "clearance": "Either team cleared the ball and play went on. Available since 2026-11-09.",
          "savedShot": "A shot saved by the goalkeeper, with play continuing from the rebound.",
          "missedShot": "An off-target shot after which play continued. Available since 2026-10-25.",
          "post": "A shot off the woodwork after which play continued. Available since 2026-11-09.",
          "penaltySaved": "A saved penalty kick, with play continuing from the rebound. Available since 2026-11-09.",
          "penaltyMissed": "A missed penalty kick after which play continued. Available since 2026-11-09.",
          "goal": "The scoring shot, always the final step.",
          "other": "An action without a mapping yet; we log the source’s value."
        }
      },
      "BestPlayerLabel": {
        "type": "string",
        "enum": [
          "rating",
          "points",
          "goals",
          "yards",
          "other"
        ],
        "description": "The metric behind a best-player value.",
        "x-enumDescriptions": {
          "rating": "The player’s match rating (football, basketball, …).",
          "points": "Points; in ice hockey, goals plus assists.",
          "goals": "Goals scored (handball).",
          "yards": "Yardage (American football).",
          "other": "A metric we have not classified yet."
        }
      },
      "BestPlayerRole": {
        "type": "string",
        "enum": [
          "pitcher",
          "batter"
        ],
        "description": "Baseball: the reason a top performer was selected.",
        "x-enumDescriptions": {
          "pitcher": "Chosen for pitching; the statistics use pitching keys.",
          "batter": "Chosen for batting; the statistics use batting keys."
        }
      },
      "ShotOutcome": {
        "type": "string",
        "enum": [
          "goal",
          "save",
          "miss",
          "block",
          "post"
        ],
        "description": "The result of a shot.",
        "x-enumDescriptions": {
          "goal": "Went in (in basketball, a made field goal).",
          "save": "On target but kept out by the goalkeeper / goalie.",
          "miss": "Missed the target (in basketball, a missed field goal).",
          "block": "Stopped by an outfield player / skater, goal-line clearances included (in basketball, a blocked field goal).",
          "post": "Struck the woodwork (football)."
        }
      },
      "ShotTechnique": {
        "type": "string",
        "enum": [
          "wrist",
          "snap",
          "slap",
          "backhand",
          "tipIn",
          "deflected",
          "wrapAround",
          "poke",
          "bat",
          "other"
        ],
        "description": "Ice hockey: the type of shot.",
        "x-enumDescriptions": {
          "wrist": "A wrist shot.",
          "snap": "A snap shot.",
          "slap": "A slap shot.",
          "backhand": "A backhand shot.",
          "tipIn": "A tip-in.",
          "deflected": "A deflected shot.",
          "wrapAround": "A wrap-around attempt.",
          "poke": "A poke shot.",
          "bat": "A batted puck.",
          "other": "A shot type we have not classified yet."
        }
      },
      "ShotSituation": {
        "type": "string",
        "enum": [
          "regular",
          "assisted",
          "corner",
          "setPiece",
          "fastBreak",
          "freeKick",
          "throwInSetPiece",
          "penalty",
          "shootout",
          "other"
        ],
        "description": "Football: the phase of play that produced a shot.",
        "x-enumDescriptions": {
          "regular": "From open play, with no assist.",
          "assisted": "From open play, set up by a team-mate’s pass.",
          "corner": "Following a corner kick.",
          "setPiece": "Following some other set piece.",
          "fastBreak": "During a counter-attack.",
          "freeKick": "Taken directly from a free kick.",
          "throwInSetPiece": "Following a throw-in set play.",
          "penalty": "A penalty kick taken during play.",
          "shootout": "A kick in a penalty shoot-out; `shootoutSequence` gives the overall kick order and `shootoutRound` the round for the taker’s side.",
          "other": "A situation we have not classified yet."
        }
      },
      "ShotGoalType": {
        "type": "string",
        "enum": [
          "regular",
          "ownGoal",
          "penalty"
        ],
        "description": "The type of goal a shot produced.",
        "x-enumDescriptions": {
          "regular": "A standard goal.",
          "ownGoal": "An own goal; the value matches the incident detail of the same name.",
          "penalty": "A penalty that was scored, either during play or in the shoot-out."
        }
      },
      "ShotStrength": {
        "type": "string",
        "enum": [
          "even",
          "powerPlay",
          "shortHanded"
        ],
        "description": "Ice hockey: the player-strength situation when the shot was taken.",
        "x-enumDescriptions": {
          "even": "Both teams at equal strength (ice hockey).",
          "powerPlay": "The shooting team had a man advantage (ice hockey).",
          "shortHanded": "The shooting team was a man short (ice hockey)."
        }
      },
      "FormResult": {
        "type": "string",
        "enum": [
          "win",
          "draw",
          "loss"
        ],
        "description": "A single result within a form guide.",
        "x-enumDescriptions": {
          "win": "A win.",
          "draw": "A draw.",
          "loss": "A loss."
        }
      },
      "RecentFightResult": {
        "type": "string",
        "enum": [
          "win",
          "draw",
          "loss",
          "noContest"
        ],
        "description": "How a fight ended for the fighter, as shown in their record.",
        "x-enumDescriptions": {
          "win": "A win.",
          "draw": "A draw.",
          "loss": "A loss.",
          "noContest": "A no contest: the fight was declared void with no winner. Listed since 2026-11-09; earlier, such fights were omitted."
        }
      },
      "StreakSide": {
        "type": "string",
        "enum": [
          "home",
          "away",
          "both"
        ],
        "description": "Which side the streak belongs to.",
        "x-enumDescriptions": {
          "home": "The streak belongs to the home side of the fixture.",
          "away": "The streak belongs to the away side of the fixture.",
          "both": "Shared by both sides; for head-to-head streaks it covers their meetings with each other."
        }
      },
      "StreakKind": {
        "type": "string",
        "enum": [
          "inARow",
          "ofLast",
          "average"
        ],
        "description": "How to read a streak’s figure: consecutive matches, x out of the last y, or an average.",
        "x-enumDescriptions": {
          "inARow": "Consecutive matches: `count` of them in a row (\"5\").",
          "ofLast": "`count` out of the most recent `outOf` matches (\"7/8\").",
          "average": "A mean across recent matches, held in `average` (\"83\" points per game); `count` and `outOf` are both null."
        }
      },
      "PointsFormat": {
        "type": "string",
        "enum": [
          "tennis",
          "rally",
          "cricket",
          "baseball",
          "darts"
        ],
        "description": "The structure a fixture’s point-by-point data follows.",
        "x-enumDescriptions": {
          "tennis": "Tennis, nested as sets → games → points (`sets[].games`).",
          "rally": "Badminton, table tennis and volleyball, nested as sets → points (`sets[].points`).",
          "cricket": "Cricket, nested as innings → overs → balls (`innings`).",
          "baseball": "Baseball, one at-bat at a time (`atBats`), with the pitcher, the batter and the win probability before / after every at-bat.",
          "darts": "Darts, nested as sets → legs → visits (`darts`), giving the score of every visit and what both players still have remaining."
        }
      },
      "TennisPointDescription": {
        "type": "string",
        "enum": [
          "ace",
          "doubleFault",
          "other"
        ],
        "description": "How a tennis point was decided, when the source provides it.",
        "x-enumDescriptions": {
          "ace": "An ace, meaning the server took the point with the serve itself.",
          "doubleFault": "A double fault, handing the point to the receiver.",
          "other": "A description without a mapping yet; we log the source’s code."
        }
      },
      "TennisPointType": {
        "type": "string",
        "enum": [
          "won",
          "none",
          "breakPoint",
          "setPoint",
          "miniBreak",
          "other"
        ],
        "description": "The significance of a tennis point for one side.",
        "x-enumDescriptions": {
          "won": "The side took the point and nothing else needs flagging.",
          "none": "Nothing to flag for this side, usually because it lost the point (the final point of a tie-break may be `none` for both sides).",
          "breakPoint": "Following this point the receiving side holds a break point, one point away from breaking serve.",
          "setPoint": "The side now has set point (and match point too, should that set be the decider — the source treats both alike). Takes precedence over breakPoint and miniBreak.",
          "miniBreak": "Tie-break point won against the opponent’s serve.",
          "other": "A type without a mapping yet; we log the source’s code."
        }
      },
      "BallOutcome": {
        "type": "string",
        "enum": [
          "dot",
          "runs",
          "four",
          "six",
          "wicket",
          "wide",
          "noBall",
          "legBye",
          "bye",
          "other"
        ],
        "description": "The result of a single cricket delivery.",
        "x-enumDescriptions": {
          "dot": "A dot ball, with no run scored.",
          "runs": "Runs off the bat that are not a boundary (1, 2, 3, …).",
          "four": "A boundary worth four.",
          "six": "A boundary worth six.",
          "wicket": "A wicket was taken; see `dismissal`.",
          "wide": "A wide, which counts as an extra and must be bowled again.",
          "noBall": "A no-ball, which counts as an extra and must be bowled again.",
          "legBye": "Leg byes: extras that come off the batter’s body.",
          "bye": "Byes: extras that get past the wicket-keeper.",
          "other": "A delivery without a mapping yet; we log the source’s code."
        }
      },
      "Dismissal": {
        "type": "string",
        "enum": [
          "caught",
          "caughtAndBowled",
          "bowled",
          "lbw",
          "runOut",
          "stumped",
          "hitWicket",
          "retired",
          "obstructingTheField",
          "timedOut",
          "other"
        ],
        "description": "The way a batter was dismissed.",
        "x-enumDescriptions": {
          "caught": "Caught by a fielder who is not the bowler.",
          "caughtAndBowled": "Caught by the bowler off their own delivery.",
          "bowled": "Out bowled.",
          "lbw": "Leg before wicket (LBW).",
          "runOut": "A run-out.",
          "stumped": "Stumped by the wicket-keeper.",
          "hitWicket": "Out hit wicket.",
          "retired": "Retired, whether hurt or out.",
          "obstructingTheField": "Out for obstructing the field.",
          "timedOut": "Out timed out.",
          "other": "A dismissal without a mapping yet; we log the source’s text."
        }
      },
      "CricketShotZone": {
        "type": "string",
        "enum": [
          "squareLeg",
          "fineLeg",
          "behindWicket",
          "thirdMan",
          "point",
          "coverPoint",
          "cover",
          "longOff",
          "straight",
          "longOn",
          "midWicket",
          "other"
        ],
        "description": "Cricket: the wagon-wheel sector a shot was played into, named after the fielding positions for a right-handed batter.",
        "x-enumDescriptions": {
          "squareLeg": "Square leg or backward square leg, roughly 350°–20°.",
          "fineLeg": "Fine leg, roughly 20°–65°.",
          "behindWicket": "Fine, directly behind the wicket-keeper, roughly 65°–115°.",
          "thirdMan": "Third man, roughly 115°–155°.",
          "point": "Point or backward point, roughly 155°–172°.",
          "coverPoint": "Cover point or deep cover, roughly 173°–189°.",
          "cover": "Cover or extra cover, roughly 190°–229°.",
          "longOff": "Mid-off or long-off, roughly 230°–254°.",
          "straight": "Back past the bowler, straight down the ground, roughly 255°–284°.",
          "longOn": "Mid-on or long-on, roughly 285°–309°.",
          "midWicket": "Mid-wicket or cow corner, roughly 310°–349°.",
          "other": "A sector code without a mapping yet (we log the source’s code); `angle` still gives the direction."
        }
      },
      "UmpirePosition": {
        "type": "string",
        "enum": [
          "homePlate",
          "firstBase",
          "secondBase",
          "thirdBase",
          "leftField",
          "rightField",
          "other"
        ],
        "description": "Where a baseball umpire is stationed.",
        "x-enumDescriptions": {
          "homePlate": "Umpire behind home plate, who calls balls and strikes.",
          "firstBase": "Umpire stationed at first base.",
          "secondBase": "Umpire stationed at second base.",
          "thirdBase": "Umpire stationed at third base.",
          "leftField": "Umpire along the left-field line, used by six-man postseason crews.",
          "rightField": "Umpire along the right-field line, used by six-man postseason crews.",
          "other": "Any assignment missing from this list."
        }
      },
      "WeatherCondition": {
        "type": "string",
        "enum": [
          "clear",
          "cloudy",
          "fog",
          "rain",
          "snow",
          "storm",
          "other"
        ],
        "description": "A short description of the weather.",
        "x-enumDescriptions": {
          "clear": "Sunny or clear skies.",
          "cloudy": "Overcast or cloudy.",
          "fog": "Misty or foggy.",
          "rain": "Showers or rain.",
          "snow": "Sleet or snow.",
          "storm": "Thunderstorms.",
          "other": "A condition missing from this list; `description` keeps the source’s wording."
        }
      },
      "EsportsRole": {
        "type": "string",
        "enum": [
          "top",
          "jungle",
          "mid",
          "bottom",
          "support",
          "carry",
          "offlane",
          "softSupport",
          "hardSupport",
          "other"
        ],
        "description": "The role a player fills in an esports title.",
        "x-enumDescriptions": {
          "top": "League of Legends: top lane.",
          "jungle": "League of Legends: jungle.",
          "mid": "Mid lane in League of Legends; position 2 in Dota 2.",
          "bottom": "League of Legends: bottom-lane carry (AD carry).",
          "support": "League of Legends: support.",
          "carry": "Dota 2 position 1: the safe-lane carry.",
          "offlane": "Dota 2 position 3: offlane.",
          "softSupport": "Dota 2 position 4: soft support.",
          "hardSupport": "Dota 2 position 5: hard support.",
          "other": "A role missing from this list, or a game that has no roles (Counter-Strike)."
        }
      },
      "CsRoundOutcome": {
        "type": "string",
        "enum": [
          "elimination",
          "bombDefused",
          "bombExploded",
          "timeExpired",
          "other"
        ],
        "description": "The way a Counter-Strike round was won.",
        "x-enumDescriptions": {
          "elimination": "The winning side wiped out every opponent.",
          "bombDefused": "The Counter-Terrorists defused the bomb.",
          "bombExploded": "The bomb went off, giving the round to the T side.",
          "timeExpired": "The clock expired without a bomb plant, giving the round to the CT side.",
          "other": "Any other kind of round ending."
        }
      },
      "CsSide": {
        "type": "string",
        "enum": [
          "ct",
          "t"
        ],
        "description": "Which side a team plays in Counter-Strike.",
        "x-enumDescriptions": {
          "ct": "Counter-Terrorists, who defend the bomb sites.",
          "t": "Terrorists, who plant the bomb."
        }
      },
      "BatterState": {
        "type": "string",
        "enum": [
          "out",
          "notOut",
          "batting",
          "didNotBat",
          "retiredHurt",
          "other"
        ],
        "description": "The current status of a batter’s innings.",
        "x-enumDescriptions": {
          "out": "Out; `dismissal` gives the details.",
          "notOut": "Batted and remained not out at the close of the innings.",
          "batting": "Currently at the crease while the innings is in progress.",
          "didNotBat": "Has not batted, or not yet if the innings is still in progress.",
          "retiredHurt": "Retired hurt: walked off injured without being dismissed.",
          "other": "A state without a mapping yet; we log the source’s code."
        }
      },
      "TeamGender": {
        "type": "string",
        "enum": [
          "male",
          "female",
          "mixed"
        ],
        "description": "Tells whether a team or competitor is men’s, women’s or mixed.",
        "x-enumDescriptions": {
          "male": "Men’s team, or a male competitor.",
          "female": "Women’s team, or a female competitor.",
          "mixed": "Mixed team, as in mixed doubles."
        }
      },
      "TeamKind": {
        "type": "string",
        "enum": [
          "team",
          "individual",
          "pair"
        ],
        "description": "What a team object represents: an actual team, a single competitor in an individual sport, or a doubles pair.",
        "x-enumDescriptions": {
          "team": "A club or team, national sides included.",
          "individual": "One competitor in an individual sport — a tennis player, fighter or darts player; see `person` for details.",
          "pair": "A doubles pair of two players (badminton, beach volleyball, table tennis, tennis)."
        }
      },
      "Handedness": {
        "type": "string",
        "enum": [
          "right",
          "left",
          "ambidextrous"
        ],
        "description": "Which hand a player uses.",
        "x-enumDescriptions": {
          "right": "Plays right-handed.",
          "left": "Plays left-handed.",
          "ambidextrous": "Uses either hand (ambidextrous)."
        }
      },
      "DetailedPosition": {
        "type": "string",
        "enum": [
          "goalkeeper",
          "leftBack",
          "centreBack",
          "rightBack",
          "defensiveMidfielder",
          "leftMidfielder",
          "centralMidfielder",
          "rightMidfielder",
          "attackingMidfielder",
          "leftWinger",
          "rightWinger",
          "striker",
          "other"
        ],
        "description": "Football: a fine-grained playing position derived from the source’s position codes.",
        "x-enumDescriptions": {
          "goalkeeper": "Goalkeeper; source code GK.",
          "leftBack": "Left back or left wing-back; code DL.",
          "centreBack": "Centre back; code DC.",
          "rightBack": "Right back or right wing-back; code DR.",
          "defensiveMidfielder": "Defensive midfielder; code DM.",
          "leftMidfielder": "Left midfielder; code ML.",
          "centralMidfielder": "Central midfielder; code MC.",
          "rightMidfielder": "Right midfielder; code MR.",
          "attackingMidfielder": "Attacking midfielder; code AM.",
          "leftWinger": "Left winger; code LW.",
          "rightWinger": "Right winger; code RW.",
          "striker": "Striker or centre forward; code ST.",
          "other": "A code without a mapping yet; we log the source’s code."
        }
      },
      "InjuryStatus": {
        "type": "string",
        "enum": [
          "out",
          "outForSeason",
          "dayToDay",
          "doubtful",
          "other"
        ],
        "description": "The effect an ongoing injury has on selection.",
        "x-enumDescriptions": {
          "out": "Unavailable until the expected return date.",
          "outForSeason": "Sidelined for the remainder of the season (outForSeason in the source, observed on NBA squads on 2026-10-25).",
          "dayToDay": "Day to day; could feature in the next match.",
          "doubtful": "A doubt for the next match.",
          "other": "A status without a mapping yet; we log the source’s value."
        }
      },
      "TransferType": {
        "type": "string",
        "enum": [
          "transfer",
          "loan",
          "loanEnd",
          "signed",
          "released",
          "waived",
          "claimed",
          "traded",
          "draft",
          "contractExpired",
          "tenDayContract",
          "secondTenDayContract",
          "retired",
          "deceased",
          "other"
        ],
        "description": "The nature of a player move.",
        "x-enumDescriptions": {
          "transfer": "A permanent move to another team — paid, free or with an undisclosed fee (see `fee` and `freeTransfer`).",
          "loan": "Sent on loan to another team.",
          "loanEnd": "A loan has ended and the player returns to the parent team.",
          "signed": "Joined the team, usually as a free agent, in which case `from` is null.",
          "released": "Let go after the contract was terminated.",
          "waived": "US leagues: placed on waivers or released by the team; `to` is null.",
          "claimed": "Picked up off waivers by a different team.",
          "traded": "US leagues: dealt to another team in a trade.",
          "draft": "Selected in a draft; `draft` gives the round and pick when available.",
          "contractExpired": "The contract reached its end.",
          "tenDayContract": "NBA: a 10-day contract.",
          "secondTenDayContract": "NBA: a further 10-day contract, the second with the same team.",
          "retired": "The player retired.",
          "deceased": "The player has passed away.",
          "other": "A move supplied by the source that DataSportsAPI does not classify yet."
        }
      },
      "StandingsScoreUnit": {
        "type": "string",
        "enum": [
          "goals",
          "points",
          "runs",
          "sets",
          "maps",
          "frames",
          "legs"
        ],
        "description": "The unit counted by a table’s scoresFor / scoresAgainst / scoreDifference.",
        "x-enumDescriptions": {
          "goals": "Goals — bandy, floorball, football, futsal, handball, ice hockey, minifootball, water polo.",
          "points": "Points, used in basketball, rugby and American football.",
          "runs": "Runs, used in baseball.",
          "sets": "Sets won and lost, not the rally points inside them (padel, volleyball).",
          "maps": "Maps won and lost, used in esports.",
          "frames": "Frames, used in snooker.",
          "legs": "Legs, used in darts."
        }
      },
      "SearchType": {
        "type": "string",
        "enum": [
          "team",
          "player",
          "league",
          "manager",
          "referee",
          "series",
          "race",
          "fixture",
          "venue"
        ],
        "description": "The kind of entity a search result is, which also tells you which endpoint accepts its id.",
        "x-enumDescriptions": {
          "team": "A team, or a competitor in an individual sport (tennis player, fighter, driver); use /v2/teams/{id}.",
          "player": "A team-sport player; use /v2/players/{id}.",
          "league": "A league or competition; use /v2/leagues/{id}.",
          "manager": "A manager or head coach; use /v2/managers/{id}.",
          "referee": "A match referee; use /v2/referees/{id}.",
          "series": "A racing series such as Formula 1 or MotoGP; use /v2/series/{id}.",
          "race": "A Grand Prix, a cycling race or any other single race in a racing series; look it up with /v2/races/{id}.",
          "fixture": "A match or fixture (since 2026-11-04); use /v2/fixtures/{id}. `fixture` holds its teams, league, start time and status.",
          "venue": "A stadium or arena (since 2026-11-04); use /v2/venues/{id}, the same id found in Fixture.venue and TeamDetail.venue. `venue` holds its city, country and capacity."
        }
      },
      "CompetitionType": {
        "type": "string",
        "enum": [
          "domesticLeague",
          "domesticCup",
          "internationalCup",
          "other"
        ],
        "description": "The category a competition falls into.",
        "x-enumDescriptions": {
          "domesticLeague": "A league within one country, e.g. LaLiga.",
          "domesticCup": "A cup or super cup within one country, e.g. Copa del Rey or Supercopa.",
          "internationalCup": "A cross-border competition for clubs or national teams, e.g. Champions League or UEFA Super Cup.",
          "other": "A type without a mapping yet; we log the source’s value."
        }
      },
      "TeamOfTheWeekPeriodKind": {
        "type": "string",
        "enum": [
          "round",
          "week",
          "month",
          "other"
        ],
        "description": "The span a team-of-the-week period refers to.",
        "x-enumDescriptions": {
          "round": "A single competition round, identified by `round` / `roundName`.",
          "week": "Roughly one calendar week (`from` / `to`), used by competitions that have no rounds (NBA).",
          "month": "One calendar month, bounded by `from` / `to`.",
          "other": "Some other kind of period; we log the source’s value."
        }
      },
      "PlayerCharacteristic": {
        "type": "string",
        "enum": [
          "anchorPlay",
          "penaltyTaking",
          "directFreeKicks",
          "longShots",
          "finishing",
          "passing",
          "playmaking",
          "tackling",
          "ballInterception",
          "consistency",
          "crossing",
          "longBalls",
          "ballControl",
          "groundDuels",
          "aerialDuels",
          "errorProneness",
          "discipline",
          "penaltySaving",
          "reflexes",
          "runsOut",
          "highClaims",
          "ballHandling",
          "longShotsSaving",
          "positioning",
          "highPressing",
          "other"
        ],
        "description": "Something a player is notably good or weak at.",
        "x-enumDescriptions": {
          "anchorPlay": "Anchoring midfield as a screen in front of the back line.",
          "penaltyTaking": "Taking penalties.",
          "directFreeKicks": "Taking direct free kicks.",
          "longShots": "Long-range shooting.",
          "finishing": "Converting chances into goals.",
          "passing": "Passing ability.",
          "playmaking": "Setting up chances for team-mates.",
          "tackling": "Tackling ability.",
          "ballInterception": "Cutting out opposition passes.",
          "consistency": "Delivering a steady level of performance from one match to the next.",
          "crossing": "Delivering crosses.",
          "longBalls": "Playing long balls.",
          "ballControl": "Controlling the ball.",
          "groundDuels": "Contesting ground duels.",
          "aerialDuels": "Contesting aerial duels.",
          "errorProneness": "Committing errors; listed as a weakness, it marks the player as error-prone.",
          "discipline": "Discipline; listed as a weakness, it points to cards and fouls.",
          "penaltySaving": "Goalkeepers: stopping penalties.",
          "reflexes": "Goalkeepers: making reflex saves.",
          "runsOut": "Goalkeepers: rushing off the line.",
          "highClaims": "Goalkeepers: collecting high balls.",
          "ballHandling": "Goalkeepers: ball handling.",
          "longShotsSaving": "Goalkeepers: stopping long-range shots.",
          "positioning": "Positional sense.",
          "highPressing": "Pressing opponents high up the field.",
          "other": "A characteristic without a mapping yet; we log the source’s number."
        }
      },
      "SeasonStatsType": {
        "type": "string",
        "enum": [
          "overall",
          "home",
          "away",
          "regularSeason",
          "playoffs"
        ],
        "description": "The set of matches season statistics are based on. If you omit `type`, the endpoints fall back to the first type listed for the season (`overall`, otherwise `regularSeason`).",
        "x-enumDescriptions": {
          "overall": "All matches in the season (football, handball, rugby, European basketball, …).",
          "home": "Only matches played at home.",
          "away": "Only matches played away.",
          "regularSeason": "Regular-season matches, used by North American leagues (NBA, NHL, …) that have no `overall` type.",
          "playoffs": "Playoff matches only."
        }
      },
      "WinProbabilityModel": {
        "type": "string",
        "enum": [
          "v1",
          "v2",
          "v3"
        ],
        "description": "Versions of the win-probability model. Each version is explained below, and any new one is announced in the changelog.",
        "x-enumDescriptions": {
          "v1": "The original model (2026-10-22). Its pre-match estimate relies solely on the current competition’s table and form. Fixtures whose pre-match estimate was locked in before v2 still use it, since the estimate is kept once a match starts.",
          "v2": "Live since 2026-10-22. Before kick-off it combines each team’s recent results in every competition, its domestic league table and our league-strength coefficients (which make teams from different leagues comparable), and gives the current competition’s table more weight as the season goes on. In-play behaviour matches v1. Fixtures whose pre-match estimate was locked in before v3 still use it.",
          "v3": "Live since 2026-10-25. Pre-match it reuses v2, with two changes: a league match with a newcomer — a team that came into the competition by promotion or relegation, early in the season — uses only the current table and form, and the Turkish 1.Lig is now part of the league-strength coefficients. In play it applies v2’s formula plus a calibration step, phased in across the first 15 minutes, that makes the curve slightly less certain to correct a mild over-confidence."
        }
      },
      "WinProbabilityReason": {
        "type": "string",
        "enum": [
          "kickoff",
          "minute",
          "goal",
          "redCard",
          "periodStart",
          "periodEnd",
          "bigChance",
          "final"
        ],
        "description": "What triggered a win-probability point.",
        "x-enumDescriptions": {
          "kickoff": "Kick-off: the pre-match estimate, placed at minute 0.",
          "minute": "The routine point emitted every minute; the estimate shifts as time runs down even if nothing else occurs.",
          "goal": "Emitted immediately after a goal; an own goal counts for the side it is credited to.",
          "redCard": "Emitted immediately after a red card, second yellows included.",
          "periodStart": "Start of a period: the second half or either half of extra time.",
          "periodEnd": "End of a period: half-time, the close of regulation or the close of extra time.",
          "bigChance": "Inserted just after a missed big chance (a shot worth at least 0.3 expected goals) so the moment is visible on the curve. Neither v1 nor v2 uses live expected goals in the estimate.",
          "final": "Full time: the final result expressed as certainty (1 / 0 / 0)."
        }
      },
      "OddsMarketKind": {
        "type": "string",
        "enum": [
          "result",
          "winner",
          "doubleChance",
          "drawNoBet",
          "bothTeamsToScore",
          "firstToScore",
          "totalGoals",
          "totalCards",
          "totalCorners",
          "total",
          "asianHandicap",
          "handicap",
          "nextGoal",
          "tossWinner",
          "mostSixes",
          "centuryInMatch",
          "fiftyInMatch",
          "other"
        ],
        "description": "The proposition a betting market offers prices on.",
        "x-enumDescriptions": {
          "result": "Three-way market (\"1X2\") on a home win, a draw or an away win when `period` ends; only regular time counts, not extra time or shoot-outs.",
          "winner": "Who wins the match or `period`, as a two-way market without a draw. Where a sport has overtime, settlement follows the bookmaker, whose rules usually count overtime.",
          "doubleChance": "Backs two of the three outcomes: 1X (home or draw), 12 (home or away) or X2 (draw or away).",
          "drawNoBet": "Back a home or away win; if the match is drawn the bet is void and stakes are refunded.",
          "bothTeamsToScore": "Yes / no on whether each side scores at least once.",
          "firstToScore": "The side that opens the scoring, or no goal at all.",
          "totalGoals": "Total goals scored by both teams, over or under `line`.",
          "totalCards": "Total cards in the match, over or under `line`; the bookmaker’s own rules decide how a second yellow counts.",
          "totalCorners": "Number of corner kicks, over or under `line`.",
          "total": "The total in the sport’s own scoring unit, over or under `line` — goals in handball and ice hockey, runs in baseball, games or sets in tennis, points in American football and basketball.",
          "asianHandicap": "Asian handicap: the home side starts `line` goals up (down, if the value is negative) and the away side gets the opposite. On quarter lines (±0.25, ±0.75) the stake is split over the two neighbouring lines; on whole lines a push returns the stake.",
          "handicap": "Handicap or point spread: `line` is applied to the home side’s score, and its opposite to the away side’s, before the bet is settled.",
          "nextGoal": "In-play market on who scores the next goal, or whether no more goals follow (`none`). Available since 2026-11-09.",
          "tossWinner": "Cricket: the side that wins the toss. Available since 2026-11-09; before that it was returned as winner.",
          "mostSixes": "Cricket: the side hitting more sixes in the match (`draw` when level). Available since 2026-11-09; before that it was returned as result.",
          "centuryInMatch": "Cricket: yes / no on any batter reaching a hundred in the match. Available since 2026-11-09.",
          "fiftyInMatch": "Cricket: yes / no on any batter reaching fifty in the match. Available since 2026-11-09.",
          "other": "A market we have not classified yet. `name` carries the bookmaker’s label, and we log the source’s value so the market can be added."
        }
      },
      "OddsOutcome": {
        "type": "string",
        "enum": [
          "home",
          "draw",
          "away",
          "homeOrDraw",
          "drawOrAway",
          "homeOrAway",
          "yes",
          "no",
          "over",
          "under",
          "none",
          "other"
        ],
        "description": "The outcome a betting choice stands for.",
        "x-enumDescriptions": {
          "home": "The home side, including the market’s handicap where there is one.",
          "draw": "A drawn result.",
          "away": "The away side, with the reverse handicap where there is one.",
          "homeOrDraw": "Double chance 1X: home win or draw.",
          "drawOrAway": "Double chance X2: draw or away win.",
          "homeOrAway": "Double chance 12: either side wins, i.e. anything but a draw.",
          "yes": "The proposition happens (e.g. both teams score).",
          "no": "The proposition does not happen.",
          "over": "The final total is higher than `line`.",
          "under": "The final total is lower than `line`.",
          "none": "Neither side — for example when nobody scores in a first-to-score market.",
          "other": "An unclassified choice; `name` carries the bookmaker’s label."
        }
      },
      "OddsChange": {
        "type": "string",
        "enum": [
          "up",
          "down",
          "none"
        ],
        "description": "Direction of a price’s most recent movement.",
        "x-enumDescriptions": {
          "up": "The price went up the last time it moved: the outcome is seen as less likely and pays out more.",
          "down": "The price went down the last time it moved: the outcome is seen as more likely and pays out less.",
          "none": "No movement since the price opened, or the direction is unknown."
        }
      },
      "OddsSettledBy": {
        "type": "string",
        "enum": [
          "source",
          "computed"
        ],
        "description": "Where the settlement of a betting market came from.",
        "x-enumDescriptions": {
          "source": "Settlement flags set by the bookmaker and passed on unchanged by our data source.",
          "computed": "Settled by us from the final result, for markets where the bookmaker never sends flags: total cards and football Asian handicaps on half lines. We do it only when the result leaves no room for doubt, and never against a flag the bookmaker did send. Whether a real bet won is still up to the bookmaker’s own rules."
        }
      },
      "GoalDistributionScope": {
        "type": "string",
        "enum": [
          "overall",
          "home",
          "away",
          "other"
        ],
        "description": "The set of matches a goal distribution is built from.",
        "x-enumDescriptions": {
          "overall": "All of the team’s matches in the league season.",
          "home": "Only the team’s home matches.",
          "away": "Only the team’s away matches.",
          "other": "Any other kind of split."
        }
      },
      "PlayerActionType": {
        "type": "string",
        "enum": [
          "pass",
          "cross",
          "dribble",
          "ballCarry",
          "tackle",
          "interception",
          "ballRecovery",
          "clearance",
          "block",
          "other"
        ],
        "description": "The type of a single on-ball action by a player.",
        "x-enumDescriptions": {
          "pass": "A pass; crosses have their own type.",
          "cross": "A crossed ball.",
          "dribble": "A take-on, i.e. trying to get past an opponent with the ball (counted in the lineups’ `totalContest` / `wonContest`).",
          "ballCarry": "A ball carry by the player, from `start` to `end`.",
          "tackle": "A tackle; successful is true when it was won.",
          "interception": "A pass cut out by the player.",
          "ballRecovery": "Possession regained from a loose ball.",
          "clearance": "A clearance; `end` shows where the ball went when the source provides it.",
          "block": "A shot or pass that the player blocked.",
          "other": "Any other kind of action."
        }
      },
      "CommentaryKind": {
        "type": "string",
        "enum": [
          "kickoff",
          "goal",
          "redCard",
          "missedPenalty",
          "varDecision",
          "bigChance",
          "momentum",
          "periodStart",
          "periodEnd",
          "halfTime",
          "fullTime",
          "update",
          "correction"
        ],
        "description": "The subject of a commentary entry.",
        "x-enumDescriptions": {
          "kickoff": "The match has started.",
          "goal": "A goal, including own goals and penalties.",
          "redCard": "A sending-off, from a straight red card or a second yellow.",
          "missedPenalty": "A penalty taken during the match that was missed or saved; a converted one appears as a goal entry.",
          "varDecision": "The outcome of a video review: a goal or penalty awarded / overturned, or a card changed.",
          "bigChance": "A big chance not taken — a shot worth 0.3 expected goals or more.",
          "momentum": "One side has kept up pressure for several minutes, according to the attack-momentum graph.",
          "periodStart": "Play got under way in the second half or in a half of extra time.",
          "periodEnd": "Regulation or the first half of extra time is over, with more play to come.",
          "halfTime": "A recap at half-time.",
          "fullTime": "A recap at full time.",
          "update": "A catch-up on the match to date, produced when commentary begins while the match is already in progress.",
          "correction": "The source reassigned an already-covered goal to a different player, so a single line names the scorer it now credits; earlier entries are left as written. Available since 2026-10-27."
        }
      },
      "PlayByPlayType": {
        "type": "string",
        "enum": [
          "matchStarted",
          "matchEnded",
          "endFirstHalf",
          "endSecondHalf",
          "periodStart",
          "periodEnd",
          "addedTime",
          "scoreChange",
          "shotSaved",
          "shotOffTarget",
          "shotBlocked",
          "post",
          "cornerKick",
          "freeKickWon",
          "freeKickLost",
          "offside",
          "yellowCard",
          "redCard",
          "substitution",
          "startDelay",
          "endDelay",
          "foul",
          "freeThrowMissed",
          "rebound",
          "possessionChange",
          "jumpBall",
          "lineupChange",
          "timeout",
          "stoppage",
          "review",
          "penaltyAwarded",
          "penaltyConceded",
          "penaltyScored",
          "penaltyMissed",
          "penaltySaved",
          "violation",
          "other"
        ],
        "description": "The event a play-by-play entry describes.",
        "x-enumDescriptions": {
          "matchStarted": "Football: kick-off of a half, halves of extra time included.",
          "matchEnded": "Football: the match has ended.",
          "endFirstHalf": "Football: end of the first half.",
          "endSecondHalf": "Football: end of the second half.",
          "periodStart": "Basketball and other timed sports: start of a period; the opening tip also counts as periodStart.",
          "periodEnd": "Basketball and other timed sports: end of a period.",
          "addedTime": "Football: the fourth official has signalled added time; `text` gives the minutes.",
          "scoreChange": "The score moved, through a goal or basketball points (`scoreType` identifies which); `homeScore` / `awayScore` show the new score.",
          "shotSaved": "Football: an on-target shot kept out by a save.",
          "shotOffTarget": "A missed shot: off target in football, a missed field goal in basketball.",
          "shotBlocked": "Football: a defender blocked a shot.",
          "post": "Football: a shot struck the post or crossbar and play continued. Available since 2026-11-09; before that it was reported as other.",
          "cornerKick": "Football: a corner kick. `player` is the defender who gave it away and `side` is that defender’s side, so the corner went to the opposing team.",
          "freeKickWon": "Football: a free kick earned; `player` is the one who was fouled.",
          "freeKickLost": "Football: a foul committed; `player` is the one who committed it.",
          "offside": "Football: a player flagged for offside.",
          "yellowCard": "Football: a yellow card is shown.",
          "redCard": "Football: a red card is shown, second yellows included.",
          "substitution": "A player change, with `playerIn` / `playerOut`.",
          "startDelay": "Football: play halted, for example for an injury or a delay.",
          "endDelay": "Football: play restarted following a delay.",
          "foul": "Basketball: a foul; `player` committed it and `drawnBy` drew it.",
          "freeThrowMissed": "Basketball: a free throw that did not go in.",
          "rebound": "Basketball: a rebound; `text` tells whether it was offensive or defensive.",
          "possessionChange": "Basketball: a turnover; if it came from a steal, `stolenBy` names the player who took the ball.",
          "jumpBall": "Basketball: a jump-ball situation.",
          "lineupChange": "Basketball: a side changed its five on the floor; `text` lists the names.",
          "timeout": "A timeout was called.",
          "stoppage": "Basketball: a clock stoppage (out of bounds, …).",
          "review": "A video review; `text` gives the outcome (a VAR decision, in football).",
          "penaltyAwarded": "Football: a penalty kick given; `player` is the one fouled and `side` is that player’s side.",
          "penaltyConceded": "Football: a penalty kick given away; `player` is the one responsible and `side` is that player’s side.",
          "penaltyScored": "Football: a penalty kick converted during play. Because the source provides no score on this entry, `homeScore` / `awayScore` are derived by counting on from the previous goal in the list; they are null in a penalty shoot-out, since that leaves the match score unchanged.",
          "penaltyMissed": "Football: a penalty kick that went off target.",
          "penaltySaved": "Football: a penalty kick stopped by the goalkeeper.",
          "violation": "Basketball: a violation such as a kicked ball or goaltending; `text` gives the kind.",
          "other": "Any other kind of entry — a value the source introduced later; `text` has the details."
        }
      },
      "PlayByPlayScoreType": {
        "type": "string",
        "enum": [
          "freeThrow",
          "twoPointer",
          "threePointer",
          "other"
        ],
        "description": "The value of a basketball scoring play.",
        "x-enumDescriptions": {
          "freeThrow": "A successful free throw, worth 1 point.",
          "twoPointer": "A successful two-point field goal.",
          "threePointer": "A successful three-point field goal.",
          "other": "Any other type of score."
        }
      },
      "CourtZone": {
        "type": "string",
        "enum": [
          "underBasket",
          "inThePaint",
          "insideLeft",
          "insideRight",
          "insideCenter",
          "insideLeftWing",
          "insideRightWing",
          "outsideLeft",
          "outsideRight",
          "outsideCenter",
          "outsideLeftWing",
          "outsideRightWing",
          "backcourt",
          "other"
        ],
        "description": "The area of the basketball court where an action took place.",
        "x-enumDescriptions": {
          "underBasket": "Directly beneath the basket.",
          "inThePaint": "Inside the paint (the lane) but not right at the basket.",
          "insideLeft": "Within the three-point arc, on the left baseline side.",
          "insideRight": "Within the three-point arc, on the right baseline side.",
          "insideCenter": "Within the three-point arc, straight in front of the basket (central mid-range).",
          "insideLeftWing": "Within the three-point arc, on the left wing.",
          "insideRightWing": "Within the three-point arc, on the right wing.",
          "outsideLeft": "Behind the three-point arc, in the left corner.",
          "outsideRight": "Behind the three-point arc, in the right corner.",
          "outsideCenter": "Behind the three-point arc, at the top of the key.",
          "outsideLeftWing": "Behind the three-point arc, on the left wing.",
          "outsideRightWing": "Behind the three-point arc, on the right wing.",
          "backcourt": "In the backcourt, i.e. the other half of the floor.",
          "other": "Some other zone, a value the source introduced later."
        }
      },
      "RankingTypeSlug": {
        "type": "string",
        "enum": [
          "fifa-men",
          "uefa-countries",
          "uefa-clubs",
          "world-rugby-men",
          "atp",
          "wta",
          "atp-live",
          "wta-live",
          "utr-men",
          "utr-women",
          "padel-men",
          "padel-women",
          "ufc-flyweight",
          "ufc-bantamweight",
          "ufc-featherweight",
          "ufc-lightweight",
          "ufc-welterweight",
          "ufc-middleweight",
          "ufc-light-heavyweight",
          "ufc-heavyweight",
          "ufc-womens-strawweight",
          "ufc-womens-flyweight",
          "ufc-womens-bantamweight",
          "fnc-bantamweight",
          "fnc-featherweight",
          "fnc-lightweight",
          "fnc-welterweight",
          "fnc-middleweight",
          "fnc-light-heavyweight",
          "fnc-heavyweight"
        ],
        "description": "A ranking table available from DataSportsAPI; GET /v2/rankings returns the full list with names.",
        "x-enumDescriptions": {
          "fifa-men": "Football: FIFA World Ranking (men).",
          "uefa-countries": "Football: UEFA country coefficients.",
          "uefa-clubs": "Football: UEFA club coefficients.",
          "world-rugby-men": "Rugby: World Rugby Rankings (men).",
          "atp": "Tennis: ATP singles ranking.",
          "wta": "Tennis: WTA singles ranking.",
          "atp-live": "Tennis: ATP live singles ranking, which shifts while tournaments are played.",
          "wta-live": "Tennis: WTA live singles ranking, which shifts while tournaments are played.",
          "utr-men": "Tennis: UTR rating (men). Here `points` holds the Universal Tennis Rating value itself (e.g. 16.45) rather than ranking points.",
          "utr-women": "Tennis: UTR rating (women). Here `points` holds the Universal Tennis Rating value itself (e.g. 12.97) rather than ranking points.",
          "padel-men": "Padel: world ranking (men).",
          "padel-women": "Padel: world ranking (women).",
          "ufc-flyweight": "MMA: UFC flyweight rankings.",
          "ufc-bantamweight": "MMA: UFC bantamweight rankings.",
          "ufc-featherweight": "MMA: UFC featherweight rankings.",
          "ufc-lightweight": "MMA: UFC lightweight rankings.",
          "ufc-welterweight": "MMA: UFC welterweight rankings.",
          "ufc-middleweight": "MMA: UFC middleweight rankings.",
          "ufc-light-heavyweight": "MMA: UFC light heavyweight rankings.",
          "ufc-heavyweight": "MMA: UFC heavyweight rankings.",
          "ufc-womens-strawweight": "MMA: UFC women’s strawweight rankings.",
          "ufc-womens-flyweight": "MMA: UFC women’s flyweight rankings.",
          "ufc-womens-bantamweight": "MMA: UFC women’s bantamweight rankings.",
          "fnc-bantamweight": "MMA: FNC bantamweight rankings.",
          "fnc-featherweight": "MMA: FNC featherweight rankings.",
          "fnc-lightweight": "MMA: FNC lightweight rankings.",
          "fnc-welterweight": "MMA: FNC welterweight rankings.",
          "fnc-middleweight": "MMA: FNC middleweight rankings.",
          "fnc-light-heavyweight": "MMA: FNC light heavyweight rankings.",
          "fnc-heavyweight": "MMA: FNC heavyweight rankings."
        }
      },
      "RankingEntry": {
        "type": "string",
        "enum": [
          "team",
          "competitor",
          "country"
        ],
        "description": "What a single ranking row represents.",
        "x-enumDescriptions": {
          "team": "A national side or club; `team` is populated.",
          "competitor": "One competitor in an individual sport — a tennis player or fighter — modelled as a team object with kind `individual`; `team` is filled.",
          "country": "A country ranked on the results of its clubs; `country` and `league` (its top league) are populated and `team` is null."
        }
      },
      "PlayerStatisticsGroup": {
        "type": "string",
        "enum": [
          "summary",
          "attack",
          "defense",
          "passing",
          "goalkeeping",
          "other"
        ],
        "description": "The set of statistics returned on a player-statistics page. Every group additionally includes appearances, minutesPlayed and the sort key.",
        "x-enumDescriptions": {
          "summary": "Headline figures: rating, goals, assists, expected goals, pass accuracy, dribbles and tackles.",
          "attack": "Shooting and finishing: goal conversion, shots (on / off target, blocked), goals by body part and by area, penalties, set pieces, woodwork and offsides.",
          "defense": "Defensive work: tackles, interceptions, clearances, blocks, errors, own goals, times dribbled past, clean sheets and penalties conceded.",
          "passing": "Distribution: big chances created, assists, passes with their accuracy by area, key passes, crosses and long balls.",
          "goalkeeping": "Goalkeeper figures: clean sheets, saves (inside / outside the box), goals conceded by area, penalties faced and saved, high claims, punches and runs out.",
          "other": "Everything else: cards, duels (ground, aerial, total), minutes, fouls committed and suffered, dispossessions, possession lost, appearances and starts."
        }
      },
      "SportKind": {
        "type": "string",
        "enum": [
          "fixtures",
          "races"
        ],
        "description": "The group of endpoints that serves a sport’s data.",
        "x-enumDescriptions": {
          "fixtures": "Head-to-head matches between two sides, served by /v2/fixtures, /v2/livescores, /v2/leagues/… .",
          "races": "Events in which a whole field competes (motorsport, cycling), served by /v2/races, /v2/series/… . Fixture endpoints return nothing for these sports."
        }
      },
      "RaceSessionType": {
        "type": "string",
        "enum": [
          "practice",
          "qualifying",
          "sprintQualifying",
          "sprint",
          "race",
          "stage",
          "other"
        ],
        "description": "The type of a race session.",
        "x-enumDescriptions": {
          "practice": "Motorsport practice session.",
          "qualifying": "Qualifying, which sets the race’s starting grid (motorsport). It also marks a qualifying segment like Q1 that the source lists as a separate session.",
          "sprintQualifying": "Formula 1 sprint qualifying, which decides the sprint’s starting grid.",
          "sprint": "Sprint: a short race of its own that awards points (Formula 1, MotoGP).",
          "race": "The main event: the Grand Prix / main race in motorsport, or a one-day race in cycling.",
          "stage": "A single stage of a cycling stage race, e.g. stage 5 of the Tour de France.",
          "other": "Any other kind of session."
        }
      },
      "RaceResultState": {
        "type": "string",
        "enum": [
          "classified",
          "didNotFinish",
          "didNotStart",
          "disqualified",
          "notClassified"
        ],
        "description": "A competitor’s status within a classification.",
        "x-enumDescriptions": {
          "classified": "Included in the classification, whether lapped or not; `position` is filled unless the source left a gap there.",
          "didNotFinish": "Took the start but failed to finish (retired, crashed out); has no position.",
          "didNotStart": "Was entered but never started; has no position.",
          "disqualified": "Excluded by disqualification; has no position.",
          "notClassified": "Left out of the classification for some other reason (the source flags the row as out without explanation); has no position."
        }
      },
      "TyreCompound": {
        "type": "string",
        "enum": [
          "soft",
          "medium",
          "hard",
          "intermediate",
          "wet",
          "other"
        ],
        "description": "Formula 1 tyre compound.",
        "x-enumDescriptions": {
          "soft": "The soft slick, \"S\" in the source.",
          "medium": "The medium slick, \"M\".",
          "hard": "The hard slick, \"H\".",
          "intermediate": "The intermediate, used on a damp track, \"I\".",
          "wet": "The full wet tyre, \"W\".",
          "other": "Any compound letter missing from this list."
        }
      },
      "CyclingJersey": {
        "type": "string",
        "enum": [
          "general",
          "points",
          "mountains",
          "young",
          "other"
        ],
        "description": "A jersey worn by a classification leader in a cycling stage race.",
        "x-enumDescriptions": {
          "general": "General classification leader; the yellow jersey at the Tour.",
          "points": "Points classification leader; green at the Tour.",
          "mountains": "Mountains classification leader; polka dot at the Tour.",
          "young": "Top young rider; white at the Tour.",
          "other": "Any jersey missing from this list."
        }
      },
      "StageProfile": {
        "type": "string",
        "enum": [
          "flat",
          "hilly",
          "intermediate",
          "mountain",
          "highMountain",
          "timeTrial",
          "teamTimeTrial",
          "other"
        ],
        "description": "The kind of terrain a cycling stage or one-day race covers.",
        "x-enumDescriptions": {
          "flat": "Flat terrain, suited to sprinters.",
          "hilly": "Hilly terrain.",
          "intermediate": "Rolling terrain or medium mountains.",
          "mountain": "Mountainous terrain.",
          "highMountain": "High mountains, typically ending with a summit finish.",
          "timeTrial": "A time trial ridden individually.",
          "teamTimeTrial": "A time trial ridden by teams.",
          "other": "Any profile missing from this list."
        }
      },
      "RaceWeather": {
        "type": "string",
        "enum": [
          "sunny",
          "hot",
          "cloudy",
          "lightRain",
          "rain",
          "night",
          "other"
        ],
        "description": "Session weather, using the source’s own wording.",
        "x-enumDescriptions": {
          "sunny": "Sunshine.",
          "hot": "Hot conditions.",
          "cloudy": "Cloudy skies.",
          "lightRain": "Light rainfall.",
          "rain": "Rainfall.",
          "night": "Held at night; the source supplies no further weather term for it.",
          "other": "Any weather term missing from this list."
        }
      },
      "TrackCondition": {
        "type": "string",
        "enum": [
          "dry",
          "partlyWet",
          "wet",
          "other"
        ],
        "description": "State of the track / road surface in a session.",
        "x-enumDescriptions": {
          "dry": "The track / road is dry.",
          "partlyWet": "Partly wet, either drying out or wet in some places. Available since 2026-11-09.",
          "wet": "The track / road is wet.",
          "other": "Any condition missing from this list."
        }
      },
      "SeriesStandingsType": {
        "type": "string",
        "enum": [
          "competitors",
          "teams"
        ],
        "description": "Which championship a standings table covers.",
        "x-enumDescriptions": {
          "competitors": "Championship for drivers / riders.",
          "teams": "Championship for teams (constructors)."
        }
      },
      "FielderRole": {
        "type": "string",
        "enum": [
          "putout",
          "assist",
          "error",
          "other"
        ],
        "description": "What a fielder contributed to a play.",
        "x-enumDescriptions": {
          "putout": "Recorded the putout by catching the ball or by tagging or forcing the runner.",
          "assist": "Helped on the out by throwing to the fielder who recorded the putout.",
          "error": "Was charged with an error on the play.",
          "other": "Any role missing from this list."
        }
      },
      "BattedBallTrajectory": {
        "type": "string",
        "enum": [
          "groundBall",
          "lineDrive",
          "flyBall",
          "popup",
          "other"
        ],
        "description": "The path a batted ball took.",
        "x-enumDescriptions": {
          "groundBall": "A ball hit along the ground.",
          "lineDrive": "A line drive.",
          "flyBall": "A fly ball.",
          "popup": "A pop-up.",
          "other": "Any trajectory missing from this list."
        }
      },
      "BattedBallHardness": {
        "type": "string",
        "enum": [
          "soft",
          "medium",
          "hard",
          "other"
        ],
        "description": "The strength of contact on a batted ball.",
        "x-enumDescriptions": {
          "soft": "Weak, soft contact.",
          "medium": "Moderate contact.",
          "hard": "Solid, hard contact.",
          "other": "Any value missing from this list."
        }
      },
      "PitchEventKind": {
        "type": "string",
        "enum": [
          "pitch",
          "steal",
          "other"
        ],
        "description": "The type of a row within an at-bat.",
        "x-enumDescriptions": {
          "pitch": "A pitch delivered to the batter.",
          "steal": "Action involving a runner between pitches, such as a stolen-base attempt or a pickoff. It carries no pitch type, speed or outcome; check `runners`.",
          "other": "Any other kind of row."
        }
      },
      "PitchType": {
        "type": "string",
        "enum": [
          "fourSeamFastball",
          "sinker",
          "cutter",
          "slider",
          "sweeper",
          "slurve",
          "curveball",
          "knuckleCurve",
          "slowCurve",
          "changeup",
          "splitter",
          "forkball",
          "screwball",
          "knuckleball",
          "eephus",
          "fastball",
          "pitchout",
          "intentionalBall",
          "other"
        ],
        "description": "Pitch classification, following MLB Statcast.",
        "x-enumDescriptions": {
          "fourSeamFastball": "FF: four-seam fastball.",
          "sinker": "SI: sinker, also called two-seam fastball.",
          "cutter": "FC: cut fastball.",
          "slider": "SL: slider.",
          "sweeper": "ST: sweeper, a slider with extra horizontal break.",
          "slurve": "SV: slurve.",
          "curveball": "CU: curveball.",
          "knuckleCurve": "KC: knuckle curve.",
          "slowCurve": "CS: slow curve.",
          "changeup": "CH: changeup.",
          "splitter": "FS: split-finger fastball.",
          "forkball": "FO: forkball.",
          "screwball": "SC: screwball.",
          "knuckleball": "KN: knuckleball.",
          "eephus": "EP: eephus.",
          "fastball": "FA: a fastball with no more specific classification.",
          "pitchout": "PO: pitchout.",
          "intentionalBall": "IN: intentional ball.",
          "other": "Any pitch type missing from this list; `pitchName` holds the source’s text."
        }
      },
      "PitchOutcome": {
        "type": "string",
        "enum": [
          "ball",
          "calledStrike",
          "swingingStrike",
          "foul",
          "foulTip",
          "single",
          "double",
          "triple",
          "homeRun",
          "hitByPitch",
          "reachedOnError",
          "flyOut",
          "groundOut",
          "lineOut",
          "popOut",
          "sacrificeFly",
          "sacrificeBunt",
          "fieldersChoice",
          "other"
        ],
        "description": "What a pitch resulted in.",
        "x-enumDescriptions": {
          "ball": "A ball, including pitches in the dirt and intentional balls.",
          "calledStrike": "A called strike, i.e. strike looking.",
          "swingingStrike": "A swinging strike.",
          "foul": "A foul ball.",
          "foulTip": "A foul tip, caught and therefore a strike.",
          "single": "A single: ball put in play and the batter reaches first safely.",
          "double": "A double.",
          "triple": "A triple.",
          "homeRun": "A home run.",
          "hitByPitch": "Hit by pitch: the batter is awarded first base.",
          "reachedOnError": "The batter got on base because of a fielding error.",
          "flyOut": "Out on a fly ball.",
          "groundOut": "Out on a ground ball.",
          "lineOut": "Out on a line drive.",
          "popOut": "Out on a pop-up.",
          "sacrificeFly": "A sacrifice fly: the batter is out while a runner scores.",
          "sacrificeBunt": "A sacrifice bunt.",
          "fieldersChoice": "Fielder’s choice: the batter reached base while a different runner was put out (see `runners`).",
          "other": "Any outcome missing from this list; `outcomeCode` holds the source’s code."
        }
      },
      "HighlightProvider": {
        "type": "string",
        "enum": [
          "youtube",
          "x",
          "other"
        ],
        "description": "The platform hosting a highlight.",
        "x-enumDescriptions": {
          "youtube": "Video hosted on YouTube.",
          "x": "A video embedded in a post on X (Twitter).",
          "other": "Some other hosting platform."
        }
      },
      "StandingsSource": {
        "type": "string",
        "enum": [
          "upstream",
          "computed"
        ],
        "description": "Origin of a standings table, reported in `meta.source` of /standings.",
        "x-enumDescriptions": {
          "upstream": "The table exactly as our data source publishes it.",
          "computed": "Built by DataSportsAPI from the season’s completed fixtures because the source does not publish this table (NBA and NHL home / away tables). It has the same columns as the source’s total table; tied teams are ordered by our own rules rather than head-to-head."
        }
      },
      "SeriesFiguresSource": {
        "type": "string",
        "enum": [
          "upstream",
          "computed"
        ],
        "description": "Origin of the wins / podiums / polePositions / racesStarted / racesWithPoints figures in a series table, reported in `meta.figuresSource` of /series/{id}/standings.",
        "x-enumDescriptions": {
          "upstream": "Taken as published by our data source; null where it provides none.",
          "computed": "Derived by DataSportsAPI from the main race of each completed championship round, since the source only publishes positions and points (MotoGP). wins counts 1st places, podiums top-3 finishes, polePositions starts from grid position 1, racesStarted the races started (for a team, races where at least one of its entries started) and racesWithPoints the races in which points were scored; a team’s figures include all its entries. Sprints are excluded. fastestLaps stays null if the races do not report it."
        }
      },
      "TrackingCoordinates": {
        "type": "string",
        "enum": [
          "pitch",
          "tennisCourt",
          "court",
          "rink",
          "none"
        ],
        "description": "Coordinate frame used for a fixture’s positions; each sport has its own. Every x / y / z returned by the tracking endpoints uses it.",
        "x-enumDescriptions": {
          "pitch": "Football: 0–100 along the pitch (x) and across it (y). Home plays towards x = 100 and away towards x = 0 for both halves; the frame does not turn after the break.",
          "tennisCourt": "Tennis: millimetres from the middle of the net. x follows the length of the court (around ±11,900 at each baseline), y its width (around ±4,100 at the doubles sidelines), and z gives how high the ball is above the court surface.",
          "court": "Basketball: 0–100 along the court (x) and across it (y). Home shoots at the x = 100 basket and away at the x = 0 one for the whole game; where the source swaps baskets at half-time, timeline positions are converted into this frame.",
          "rink": "Ice hockey: 0–100 along the rink (x) and across it (y). Home attacks the x = 100 goal and away the x = 0 goal in every period. Which end each team really defended changes by period and the source does not report it, so since 2026-11-12 each side’s positions are mirrored per period according to where its shots went.",
          "none": "Darts (since 2026-11-13): there are no positions at all, so every position is null. Each throw tells you which bed it hit instead (TimelineEvent.darts)."
        }
      },
      "DartsRing": {
        "type": "string",
        "enum": [
          "single",
          "double",
          "treble",
          "outerBull",
          "bull",
          "miss"
        ],
        "description": "Which scoring area of the board a dart hit.",
        "x-enumDescriptions": {
          "single": "A single bed: the segment’s number counts once.",
          "double": "The narrow outer ring: the number counts twice. Every leg has to be finished on a double.",
          "treble": "The narrow inner ring: the number counts three times.",
          "outerBull": "The ring around the bullseye, worth 25.",
          "bull": "The bullseye itself, worth 50; it counts as a double.",
          "miss": "Scores 0: the dart landed outside the scoring area or bounced out."
        }
      },
      "DartsBed": {
        "type": "string",
        "enum": [
          "inner",
          "outer"
        ],
        "description": "For a dart in a single, which of the two single beds it hit.",
        "x-enumDescriptions": {
          "inner": "The single bed nearer the centre, from the outer bull out to the treble ring.",
          "outer": "The single bed nearer the edge, from the treble ring out to the double ring."
        }
      },
      "TimelineOp": {
        "type": "string",
        "enum": [
          "upsert",
          "remove"
        ],
        "description": "How a timelineEvent frame changes the timeline you keep.",
        "x-enumDescriptions": {
          "upsert": "Insert the event, or overwrite the one you already hold under that key, because the source corrected it or because its position was flipped into the home → x = 100 frame after more shots of that period came in.",
          "remove": "Delete the event with this key, because the source took it back (a goal that was chalked off, a shot logged twice)."
        }
      },
      "WsErrorCode": {
        "type": "string",
        "enum": [
          "bad_frame",
          "unknown_channel",
          "channel_forbidden",
          "unknown_league",
          "unknown_fixture",
          "unknown_race",
          "unknown_team",
          "not_subscribed",
          "too_many_channels",
          "snapshot_failed",
          "rate_limited"
        ],
        "description": "Codes that a WebSocket `error` frame can carry.",
        "x-enumDescriptions": {
          "bad_frame": "The frame is not valid JSON, does not match any known shape, or is missing a required field; `message` names that field (e.g. \"channel: required\").",
          "unknown_channel": "The channel name is not one we offer, or its sport slug is unknown.",
          "channel_forbidden": "Your plan’s tier does not include this channel.",
          "unknown_league": "league:{id} refers to a league id DataSportsAPI never issued (take ids from /v2/leagues or from a fixture’s league). The REST API returns 404 not_found for the same id.",
          "unknown_fixture": "The id in fixture:{id} — or in odds:{id} (from 2026-11-04) or tracking:{id} (from 2026-11-12) — is not a fixture DataSportsAPI issued; REST answers 404 not_found for that id. It does not count as one of your channels.",
          "unknown_race": "race:{id} does not point to a race: it is a season or session id, or an id DataSportsAPI never issued. /v2/races/{id} returns 404 for the same id. It does not count as one of your channels.",
          "unknown_team": "team:{id} refers to a team id DataSportsAPI never issued (take ids from a fixture’s home / away or from /v2/teams). The REST API returns 404 not_found for the same id. Available since 2026-11-04.",
          "not_subscribed": "A resync / unsubscribe targeted a channel this connection has not joined.",
          "too_many_channels": "This connection has reached its maxChannels limit.",
          "snapshot_failed": "Building the snapshot failed; retry with resync. For league:{id}, this also happens when the league id could not be verified at that moment, in which case subscribe again.",
          "rate_limited": "This connection sent over 60 frames within 10 seconds; further frames are discarded until the window resets."
        }
      },
      "PeriodKey": {
        "type": "string",
        "pattern": "^(?:period[1-9][0-9]*|inning[1-9][0-9]*|extra[12]|overtime|penalties)$",
        "description": "periodN: Regulation period number N. What a period is depends on the sport: a half in football, rugby, handball, futsal, minifootball and bandy; a quarter in basketball, American football and water polo; a period in ice hockey and floorball; a set in tennis, volleyball, table tennis, badminton and padel; an inning in baseball; a round in combat sports; a map / game in esports; a leg / frame block in darts and snooker. inningN: Cricket only: innings number N. extra1: Football and futsal: the opening half of extra time. extra2: Football and futsal: the closing half of extra time. overtime: Every overtime period summed into one value (American football, basketball, handball, ice hockey, water polo, …). In baseball it holds the runs scored in extra innings, and only when the source provides no inning-by-inning split (period10, …). penalties: The penalty shoot-out, which appears only as a `status.period` value; its score is kept in ScoreSide.penalties, not under a `periods` key."
      },
      "Export": {
        "type": "object",
        "description": "A season export (Business and up). Poll it until status is ready or failed.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The export's id, for polling."
          },
          "league": {
            "type": "integer",
            "description": "Our league id, as you sent it."
          },
          "season": {
            "type": "integer",
            "description": "The season id, as you sent it."
          },
          "format": {
            "type": "string",
            "enum": [
              "json",
              "csv",
              "parquet"
            ],
            "description": "The format you asked for."
          },
          "status": {
            "type": "string",
            "enum": [
              "pending",
              "running",
              "ready",
              "failed"
            ],
            "description": "Where the build stands."
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Why a failed export failed or, on a ready one, which parts could not be read (e.g. \"not included: topPlayers\")."
          },
          "fixtureCount": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "How many fixtures the export holds, once it is ready."
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "When you started it."
          },
          "finishedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "When it became ready or failed."
          },
          "files": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ExportFile"
            },
            "description": "One entry per file; empty until the export is ready."
          },
          "linksExpireAt": {
            "type": "string",
            "format": "date-time",
            "description": "When the url values in files stop working: an hour after you read them."
          }
        },
        "required": [
          "id",
          "league",
          "season",
          "format",
          "status",
          "files"
        ]
      },
      "ExportFile": {
        "type": "object",
        "description": "One file of a ready export.",
        "properties": {
          "name": {
            "type": "string",
            "description": "File name, e.g. fixtures.parquet or season.json."
          },
          "bytes": {
            "type": "integer",
            "description": "Size in bytes."
          },
          "contentType": {
            "type": "string",
            "description": "MIME type of the file."
          },
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Signed download link; no API key needed, valid until linksExpireAt."
          }
        },
        "required": [
          "name",
          "bytes",
          "contentType",
          "url"
        ]
      },
      "Error": {
        "type": "object",
        "description": "The body of every failed request. Branch on error.code; the message may be reworded.",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string",
                "description": "Stable, snake_case code, e.g. not_found. Part of the contract."
              },
              "message": {
                "type": "string",
                "description": "A readable sentence for logs; never parse it."
              },
              "historyFrom": {
                "type": "string",
                "format": "date",
                "description": "history_not_in_plan only: the first day your plan can read."
              }
            },
            "required": [
              "code",
              "message"
            ]
          }
        },
        "required": [
          "error"
        ]
      }
    }
  }
}
