@ufcalendar/sdk 0.9.1 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -145,8 +145,11 @@ interface FightResult {
145
145
  winner_fighter_id: number | null;
146
146
  method: string | null;
147
147
  method_normalized: MethodNormalized | null;
148
- /** "Rear-Naked Choke", "Doctor's Stoppage", … when the source states it. */
148
+ /** One spelling per technique on a finish ("Rear-Naked Choke", "Head Kick",
149
+ * "Doctor Stoppage"); the decision type on a decision ("Unanimous"). */
149
150
  finish_detail: string | null;
151
+ /** Where a finish happened when recorded ("bottom guard", "mount", "distance"). */
152
+ finish_position: string | null;
150
153
  round: number | null;
151
154
  /** "m:ss" as the source printed it. */
152
155
  time: string | null;
@@ -1442,6 +1445,266 @@ interface OrgCoverage {
1442
1445
  /** Newest first. */
1443
1446
  years: CoverageYear[];
1444
1447
  }
1448
+ /** Why the referee stopped the action, as the log labels it. `eye_poke` and
1449
+ * `low_blow` are fouls; `doctor` is a doctor check; `generic` is everything
1450
+ * else — a lost mouthpiece, a replay, but also any foul the log has no label
1451
+ * for. A `generic` stoppage is a foul only when `is_foul` says so. */
1452
+ type StoppageReason = 'eye_poke' | 'low_blow' | 'doctor' | 'generic';
1453
+ /** What the foul was. `eye_poke` and `low_blow` come labelled from the log;
1454
+ * the rest are read from the commission's deduction reason or the official
1455
+ * result detail: `illegal_knee` (a knee to a grounded opponent),
1456
+ * `illegal_kick` (an upkick, a soccer kick or a stomp), `headbutt`,
1457
+ * `illegal_strike` (back of the head, spine, 12-6 elbow), `fence` (grabbing
1458
+ * the fence or cage), `biting`, and `other` when the record names no foul
1459
+ * this vocabulary covers. */
1460
+ type FoulKind = 'eye_poke' | 'low_blow' | 'illegal_knee' | 'illegal_kick' | 'headbutt' | 'illegal_strike' | 'fence' | 'biting' | 'other';
1461
+ /** Which record confirms the foul: `log` = the in-fight log's own eye-poke /
1462
+ * low-blow row; `deduction` = the athletic commission took a point for it;
1463
+ * `result` = the bout ended on it (a disqualification, or a "could not
1464
+ * continue" / no contest whose official detail describes a foul). */
1465
+ type FoulBasis = 'log' | 'deduction' | 'result';
1466
+ /** The fighter who committed the foul. */
1467
+ interface FoulCommitter {
1468
+ fighter_id: number;
1469
+ corner: 'a' | 'b' | null;
1470
+ }
1471
+ /** One row of the official in-fight log. */
1472
+ interface TimelineAction {
1473
+ /** The log's own action name (open vocabulary): `round_start`, `round_end`,
1474
+ * `takedown`, `takedown_attempt`, `knockdown`, `submission_attempt`,
1475
+ * `reversal`, `round_pause`, `pause_reason_eye_poke`, `round_unpause` … */
1476
+ type: string;
1477
+ round: number | null;
1478
+ /** Seconds elapsed in the round. */
1479
+ elapsed_sec: number | null;
1480
+ at: string | null;
1481
+ /** On a `pause_reason_eye_poke` / `pause_reason_low_blow` row: the fighter
1482
+ * who COMMITTED the foul. */
1483
+ fighter_id: number | null;
1484
+ corner: 'a' | 'b' | null;
1485
+ }
1486
+ /** One referee stoppage: the pause, its reason and the resume, paired — and,
1487
+ * when a record confirms it, the foul behind it. */
1488
+ interface TimelineStoppage {
1489
+ round: number | null;
1490
+ /** Seconds elapsed in the round when the action was stopped. */
1491
+ elapsed_sec: number | null;
1492
+ at: string | null;
1493
+ /** null when the bout never resumed. */
1494
+ resumed_at: string | null;
1495
+ /** Real seconds stopped (the fight clock is stopped). */
1496
+ duration_sec: number | null;
1497
+ /** null = logged before reasons were recorded (before 2018-12-08). */
1498
+ reason: StoppageReason | null;
1499
+ /** true when a record confirms this stoppage was for a foul: a labelled
1500
+ * `eye_poke` / `low_blow`, or a `generic` / unlabelled stoppage tied to a
1501
+ * commission point deduction or to the foul the bout ended on. A `generic`
1502
+ * stoppage with no such record is false. */
1503
+ is_foul: boolean;
1504
+ /** The confirmed foul; null when `is_foul` is false. */
1505
+ foul: FoulKind | null;
1506
+ /** null when `is_foul` is false. */
1507
+ foul_basis: FoulBasis | null;
1508
+ /** The fighter who committed the foul. null when it is not a foul, or when
1509
+ * no record names the fighter (an accidental clash of heads). */
1510
+ committed_by: FoulCommitter | null;
1511
+ /** Points the commission deducted for this foul; 0 when none. */
1512
+ points_deducted: number;
1513
+ /** true when the bout ended on this foul (a disqualification or a "could
1514
+ * not continue"). */
1515
+ ended_bout: boolean;
1516
+ }
1517
+ /** One confirmed foul. A foul is listed once: a deduction for a logged low
1518
+ * blow adds its points to that foul, and a result that names a foul already
1519
+ * listed marks it `ended_bout`. */
1520
+ interface FoulIncident {
1521
+ foul: FoulKind;
1522
+ basis: FoulBasis;
1523
+ /** null when no record names the fighter. */
1524
+ committed_by: FoulCommitter | null;
1525
+ round: number | null;
1526
+ /** Seconds elapsed in the round. null when no stoppage in the log is tied
1527
+ * to the foul (a point deducted for grabbing the fence with no pause
1528
+ * logged). */
1529
+ elapsed_sec: number | null;
1530
+ /** Real seconds the bout was stopped for it; null when unmeasured. */
1531
+ stoppage_sec: number | null;
1532
+ points_deducted: number;
1533
+ ended_bout: boolean;
1534
+ }
1535
+ /** Fouls one corner COMMITTED in the bout. A recorded foul is not a ruling
1536
+ * on intent. */
1537
+ interface FoulTally {
1538
+ fighter_id: number | null;
1539
+ /** Eye pokes this fighter committed that stopped the action. */
1540
+ eye_pokes: number;
1541
+ /** Low blows this fighter committed that stopped the action. */
1542
+ low_blows: number;
1543
+ /** Every other confirmed foul this fighter committed (see `FoulKind`). */
1544
+ other: number;
1545
+ /** `eye_pokes` + `low_blows` + `other`. */
1546
+ total: number;
1547
+ /** Points the commission took from this fighter in the bout. */
1548
+ points_deducted: number;
1549
+ /** Real seconds the bout was stopped for this fighter's fouls. */
1550
+ stoppage_sec: number;
1551
+ }
1552
+ /** `GET /v1/fights/{id}/timeline`. `lastMeta.has_stoppage_reasons` is false
1553
+ * on a card before 2018-12-08. */
1554
+ interface FightTimeline {
1555
+ /** Round length in seconds (300 for MMA) — the scale `elapsed_sec` runs on. */
1556
+ round_seconds: number;
1557
+ /** Every logged action, in the order it happened. */
1558
+ actions: TimelineAction[];
1559
+ /** Referee stoppages, in order. */
1560
+ stoppages: TimelineStoppage[];
1561
+ /** Every confirmed foul of the bout in fight order — including fouls with
1562
+ * no stoppage in the log and fouls nobody is named for. */
1563
+ incidents: FoulIncident[];
1564
+ fouls: {
1565
+ a: FoulTally;
1566
+ b: FoulTally;
1567
+ };
1568
+ }
1569
+ interface StrikeCount {
1570
+ landed: number | null;
1571
+ attempted: number | null;
1572
+ }
1573
+ interface StrikesByTarget {
1574
+ head: StrikeCount;
1575
+ body: StrikeCount;
1576
+ leg: StrikeCount;
1577
+ }
1578
+ /** One fighter's position stats for a bout or a round. `null` = not tracked
1579
+ * for that bout; `0` = a real zero. */
1580
+ interface PositionStatLine {
1581
+ fighter_id: number | null;
1582
+ corner: 'a' | 'b' | null;
1583
+ /** Shared by both fighters: standing = distance + clinch; standing + ground = fight time. */
1584
+ time: {
1585
+ standing_sec: number | null;
1586
+ distance_sec: number | null;
1587
+ clinch_sec: number | null;
1588
+ ground_sec: number | null;
1589
+ neutral_sec: number | null;
1590
+ };
1591
+ /** THIS fighter's control: total = clinch + ground; ground = back + mount + side + half guard + guard + misc. */
1592
+ control: {
1593
+ total_sec: number | null;
1594
+ clinch_sec: number | null;
1595
+ ground_sec: number | null;
1596
+ back_sec: number | null;
1597
+ mount_sec: number | null;
1598
+ side_sec: number | null;
1599
+ half_guard_sec: number | null;
1600
+ guard_sec: number | null;
1601
+ misc_ground_sec: number | null;
1602
+ };
1603
+ /** Significant strikes by position, then target. */
1604
+ sig_strikes: {
1605
+ distance: StrikesByTarget;
1606
+ clinch: StrikesByTarget;
1607
+ ground: StrikesByTarget;
1608
+ };
1609
+ total_strikes: {
1610
+ head: StrikeCount;
1611
+ body: StrikeCount;
1612
+ leg: StrikeCount;
1613
+ clinch: StrikeCount;
1614
+ ground: StrikeCount;
1615
+ };
1616
+ }
1617
+ /** `GET /v1/fights/{id}/positions`. `lastMeta.official` is true once every
1618
+ * line is the official post-fight figure. */
1619
+ interface FightPositions {
1620
+ /** The whole bout: corner a, then b. Empty when positions were not tracked. */
1621
+ totals: PositionStatLine[];
1622
+ rounds: Array<{
1623
+ round: number;
1624
+ fighters: PositionStatLine[];
1625
+ }>;
1626
+ }
1627
+ interface FoulCounts {
1628
+ /** `eye_pokes` + `low_blows` + `other`. */
1629
+ total: number;
1630
+ eye_pokes: number;
1631
+ low_blows: number;
1632
+ /** Every other confirmed foul (see `FoulKind`). */
1633
+ other: number;
1634
+ }
1635
+ interface DisciplineIncident {
1636
+ fight_id: number;
1637
+ date: string;
1638
+ event: {
1639
+ slug: string;
1640
+ title: string;
1641
+ };
1642
+ opponent: {
1643
+ slug: string | null;
1644
+ name: string | null;
1645
+ };
1646
+ /** `committed` = by this fighter; `drawn` = by the opponent. */
1647
+ role: 'committed' | 'drawn';
1648
+ /** What the foul was. */
1649
+ reason: FoulKind;
1650
+ basis: FoulBasis;
1651
+ round: number | null;
1652
+ /** Seconds elapsed in the round; null when no stoppage in the log is tied
1653
+ * to the foul. */
1654
+ elapsed_sec: number | null;
1655
+ /** Real seconds the bout was stopped; null if it never resumed or was not
1656
+ * timed. */
1657
+ stoppage_sec: number | null;
1658
+ /** Points the commission deducted for it; 0 when none. */
1659
+ points_deducted: number;
1660
+ /** true when the bout ended on this foul. */
1661
+ ended_bout: boolean;
1662
+ }
1663
+ /** `GET /v1/fighters/{slug}/discipline` — confirmed fouls in a fighter's UFC
1664
+ * bouts: the log's eye pokes and low blows, plus any other foul a commission
1665
+ * point deduction or the official result confirms. A recorded foul is not a
1666
+ * ruling on intent. */
1667
+ interface FighterDiscipline {
1668
+ /** Settled UFC bouts since the coverage date that carry an in-fight log. */
1669
+ tracked_fights: number;
1670
+ /** Seconds fought across those bouts. */
1671
+ cage_seconds: number;
1672
+ committed: FoulCounts;
1673
+ drawn: FoulCounts;
1674
+ /** Points the commission has taken from THIS fighter across those bouts. */
1675
+ points_deducted: number;
1676
+ /** Real seconds bouts were stopped for THIS fighter's fouls. */
1677
+ stoppage_sec: number;
1678
+ /** Fouls committed per 15 minutes of cage time. null under 5 tracked bouts
1679
+ * or 30 minutes of cage time. */
1680
+ fouls_per_15: number | null;
1681
+ /** Every confirmed foul this fighter committed or drew, most recent first. */
1682
+ incidents: DisciplineIncident[];
1683
+ }
1684
+ type ControlPosition = 'back' | 'mount' | 'side' | 'half_guard' | 'guard' | 'clinch';
1685
+ /** `GET /v1/fighters/{slug}/positions` — where a fighter's bouts happen. */
1686
+ interface FighterPositions {
1687
+ tracked_fights: number;
1688
+ cage_seconds: number;
1689
+ time: {
1690
+ distance_sec: number;
1691
+ clinch_sec: number;
1692
+ ground_sec: number;
1693
+ /** Shares of `cage_seconds`, 0–1. */
1694
+ distance_share: number | null;
1695
+ clinch_share: number | null;
1696
+ ground_share: number | null;
1697
+ };
1698
+ control: {
1699
+ for_sec: number;
1700
+ against_sec: number;
1701
+ by_position: Array<{
1702
+ position: ControlPosition;
1703
+ for_sec: number;
1704
+ against_sec: number;
1705
+ }>;
1706
+ };
1707
+ }
1445
1708
 
1446
1709
  declare const DEFAULT_BASE_URL = "https://api.ufcalendar.com/v1";
1447
1710
  /** Default number of times a GET that hit the per-minute limit is retried. */
@@ -1628,6 +1891,41 @@ declare class FightAPI {
1628
1891
  * did not go to the judges.
1629
1892
  */
1630
1893
  fightScorecards(fightId: number | string): Promise<Scorecards>;
1894
+ /**
1895
+ * The official in-fight log of one settled UFC bout (Pro plans and up; a
1896
+ * lower plan throws `FightAPIError` 403 `tier_required`): every logged
1897
+ * action in order, the referee stoppages paired with their reason and
1898
+ * real length, and every confirmed foul of the bout.
1899
+ *
1900
+ * The log labels only two fouls, the eye poke and the low blow. Any other
1901
+ * foul (an illegal knee to a grounded opponent, an upkick, a headbutt, a
1902
+ * bite, a fence grab) reaches it as a `generic` stoppage naming nobody, so
1903
+ * a foul is reported only when a record confirms it (`foul_basis` /
1904
+ * `basis`): `log` (the labelled row), `deduction` (the athletic commission
1905
+ * took a point) or `result` (the bout ended on it: a disqualification or a
1906
+ * "could not continue"). On a stoppage, `is_foul` says whether a foul is
1907
+ * confirmed, `foul` what it was, `committed_by` who committed it (null
1908
+ * when no record names a fighter), `points_deducted` and `ended_bout`; a
1909
+ * `generic` stoppage with no record behind it has `is_foul: false`.
1910
+ * `incidents` lists every confirmed foul in fight order, including one
1911
+ * with no stoppage in the log; `fouls.a` / `fouls.b` count what each
1912
+ * corner committed (`eye_pokes`, `low_blows`, `other`, `total`,
1913
+ * `points_deducted`). A recorded foul is not a ruling on intent.
1914
+ *
1915
+ * Coverage: UFC bouts from June 2013, stoppage reasons
1916
+ * from 8 December 2018 (`lastMeta.has_stoppage_reasons`). A bout with no
1917
+ * log, or one not settled yet, resolves with empty lists and
1918
+ * `lastMeta.note`.
1919
+ */
1920
+ fightTimeline(fightId: number | string): Promise<FightTimeline>;
1921
+ /**
1922
+ * Position stats of one settled UFC bout (Pro plans and up): where it was
1923
+ * fought (`time`, shared by both fighters), each fighter's `control` by
1924
+ * position, and strikes by position and target — `totals` for the whole
1925
+ * bout, `rounds` per round. `null` means not tracked for that bout; `0`
1926
+ * is a real zero. Tracked reliably from 2007.
1927
+ */
1928
+ fightPositions(fightId: number | string): Promise<FightPositions>;
1631
1929
  /**
1632
1930
  * Completed bouts, filtered — newest first unless `order: 'oldest'`. At
1633
1931
  * least one narrowing filter is required (`titleOnly`, `method`,
@@ -1728,6 +2026,29 @@ declare class FightAPI {
1728
2026
  * complete (a long career is 900+ rows). */
1729
2027
  fighterRankings(idOrSlug: string | number): Promise<Record<string, unknown>[]>;
1730
2028
  fighterPowerIndex(idOrSlug: string | number): Promise<PowerIndex & Record<string, unknown>>;
2029
+ /**
2030
+ * The confirmed fouls in a fighter's UFC bouts since 8 December 2018 (Pro
2031
+ * plans and up), committed and drawn: eye pokes and low blows from the
2032
+ * official in-fight log, plus any other foul (an illegal knee to a
2033
+ * grounded opponent, an upkick, a headbutt, a bite, a fence grab)
2034
+ * confirmed by the athletic commission's point deduction or by the
2035
+ * official result. `committed` / `drawn` count `total`, `eye_pokes`,
2036
+ * `low_blows` and `other`; `points_deducted` is what the commission has
2037
+ * taken from this fighter; `incidents` lists every confirmed foul, most
2038
+ * recent first, with `reason` (the foul), `basis` (`log`, `deduction` or
2039
+ * `result`), `points_deducted` and `ended_bout`. A `generic` stoppage with
2040
+ * no record behind it is never counted. A recorded foul is not a ruling on
2041
+ * intent. Resolves `null` (with `lastMeta.note`) under 3 tracked bouts
2042
+ * with no recorded foul.
2043
+ */
2044
+ fighterDiscipline(idOrSlug: string | number): Promise<FighterDiscipline | null>;
2045
+ /**
2046
+ * A fighter's career position profile (Pro plans and up): the share of
2047
+ * cage time at distance, in the clinch and on the ground, and control
2048
+ * seconds for and against by position. Resolves `null` (with
2049
+ * `lastMeta.note`) under 3 bouts with tracked positions.
2050
+ */
2051
+ fighterPositions(idOrSlug: string | number): Promise<FighterPositions | null>;
1731
2052
  /**
1732
2053
  * Two fighters side by side (slugs or ids): bios with age, career stats,
1733
2054
  * strike mix, win streaks, previous meetings, common opponents, the booked
@@ -1889,7 +2210,7 @@ declare class FightAPI {
1889
2210
 
1890
2211
  /** Kept in lockstep with package.json and the User-Agent by
1891
2212
  * `apps/api/src/surfaces.test.ts`. Bump all three together. */
1892
- declare const VERSION = "0.9.1";
2213
+ declare const VERSION = "0.10.0";
1893
2214
 
1894
2215
  /**
1895
2216
  * This file was auto-generated by openapi-typescript.
@@ -2346,6 +2667,7 @@ interface paths {
2346
2667
  * "method": "KO/TKO",
2347
2668
  * "method_normalized": "ko_tko",
2348
2669
  * "finish_detail": null,
2670
+ * "finish_position": null,
2349
2671
  * "round": 4,
2350
2672
  * "time": "5:00",
2351
2673
  * "time_seconds": 300,
@@ -2458,7 +2780,7 @@ interface paths {
2458
2780
  query?: {
2459
2781
  /** @description Launch org slug: `ufc`, `pfl`, `oktagon`, `bkfc` or `rizin`. Staged orgs 400 until promoted. */
2460
2782
  org?: "ufc" | "pfl" | "oktagon" | "bkfc" | "rizin";
2461
- /** @description Filter on lifecycle status; `postponed` is accepted (2026-09-24). `upcoming` = everything not yet over (announced, scheduled or live), soonest first. */
2783
+ /** @description Filter on lifecycle status; `postponed` is accepted (2026-09-24). `upcoming` = everything not yet over (announced, scheduled or live), soonest first. `scheduled` = not started yet (`announced` or `scheduled`; upcoming cards are almost always stored as `announced`). */
2462
2784
  status?: components["schemas"]["EventStatusFilter"];
2463
2785
  /** @description First UTC calendar day, inclusive `YYYY-MM-DD`, matched against the event's `starts_at` (first bell, UTC) — not the venue's local date. Must be a real calendar day. */
2464
2786
  from?: string;
@@ -3911,6 +4233,7 @@ interface paths {
3911
4233
  * "method": "KO/TKO",
3912
4234
  * "method_normalized": "ko_tko",
3913
4235
  * "finish_detail": null,
4236
+ * "finish_position": null,
3914
4237
  * "round": 4,
3915
4238
  * "time": "5:00",
3916
4239
  * "time_seconds": 300,
@@ -4030,7 +4353,7 @@ interface paths {
4030
4353
  };
4031
4354
  /**
4032
4355
  * One bout
4033
- * @description Bout with corners (`FighterRef` with `country_code`), `sport` (bout override, else the org sport), `weight_class` + `division_slug`, result (raw `method` plus `method_normalized` / `finish_detail` / `round` / `time` / `time_seconds` / referee) and bonus flags, plus a compact `event`. `include=odds` adds `odds`: the current UFCalendar consensus line (`OddsPair`), or `null` when the bout is unpriced — information only, not betting advice; opening, closing and movement are on `/v1/fights/{id}/odds`.
4356
+ * @description Bout with corners (`FighterRef` with `country_code`), `sport` (bout override, else the org sport), `weight_class` + `division_slug`, result (raw `method` plus `method_normalized` / `finish_detail` / `finish_position` / `round` / `time` / `time_seconds` / referee) and bonus flags, plus a compact `event`. `include=odds` adds `odds`: the current UFCalendar consensus line (`OddsPair`), or `null` when the bout is unpriced — information only, not betting advice; opening, closing and movement are on `/v1/fights/{id}/odds`.
4034
4357
  */
4035
4358
  get: {
4036
4359
  parameters: {
@@ -4098,6 +4421,7 @@ interface paths {
4098
4421
  * "method": "Decision - Split",
4099
4422
  * "method_normalized": "decision_split",
4100
4423
  * "finish_detail": "Split",
4424
+ * "finish_position": null,
4101
4425
  * "round": 3,
4102
4426
  * "time": "5:00",
4103
4427
  * "time_seconds": 300,
@@ -5224,7 +5548,7 @@ interface paths {
5224
5548
  patch?: never;
5225
5549
  trace?: never;
5226
5550
  };
5227
- "/v1/scorecards/splits": {
5551
+ "/v1/fights/{id}/timeline": {
5228
5552
  parameters: {
5229
5553
  query?: never;
5230
5554
  header?: never;
@@ -5232,29 +5556,33 @@ interface paths {
5232
5556
  cookie?: never;
5233
5557
  };
5234
5558
  /**
5235
- * Split and majority decisions
5236
- * @description Completed bouts the judges decided on a split or majority (including majority and split draws), newest first, across the launch promotions or one of them, optionally in a date range. Each row is the bout (same shape as `/v1/fights/{id}`) plus its `event`, the `decision_type`, `official_winner_fighter_id` (`null` on a draw), every judge's card (`cards`, same objects as `/v1/fights/{id}/scorecards`) and `dissenting_judges` — the cards that disagree with the official result (`judge_id`, `judge_name`, `total_a`, `total_b`, `winner_fighter_id`, `is_draw`, `scores_known`). A card with no readable verdict is not counted as a dissent; an outcome-only card (`scores_known: false`) is, flagged. Commission records only — facts as filed, no verdict of our own; sources that publish no decision type are not listed. Up to 50 rows a page.
5559
+ * In-fight log: actions, stoppages and fouls (Pro+)
5560
+ * @description The official in-fight log of one settled UFC bout (Dana White's Contender Series included), from June 2013: every logged action in order, the referee stoppages paired with their reason and real length, and every confirmed foul of the bout. Requires a Pro or Business plan: a lower plan gets 403 `tier_required`, answered before the fight is looked up.
5561
+ *
5562
+ * `actions[]`: `type` is the log's own action name (an open vocabulary: `round_start`, `round_end`, `takedown`, `takedown_attempt`, `knockdown`, `submission_attempt`, `reversal`, `round_pause`, `pause_reason_eye_poke` / `pause_reason_low_blow` / `pause_reason_doctor` / `pause_reason_generic`, `round_unpause`, `fight_over`, plus ceremony and result rows such as `walkout`, `staredown` and `results`), `round`, `elapsed_sec` (seconds elapsed in the round), `at` (UTC) and, where the action belongs to a fighter, `fighter_id` + `corner`. A landed takedown is logged as a `takedown_attempt` followed by a `takedown`.
5563
+ *
5564
+ * `stoppages[]` pairs each `round_pause` with its reason and the `round_unpause` of the same round: `reason` is `eye_poke`, `low_blow`, `doctor`, `generic` or null; `duration_sec` is real time, because the fight clock is stopped; `doctor` is a doctor check and `generic` is everything else. Stoppage reasons are logged from 8 December 2018: on an earlier card `reason` is null and `meta.has_stoppage_reasons` is false — an unlabelled stoppage, never "no foul".
5565
+ *
5566
+ * **Fouls.** The log labels only two fouls, the eye poke and the low blow. Every other foul a referee stops a bout for — an illegal knee to a grounded opponent, an upkick, a headbutt, a bite, a fence grab — reaches the log as a `generic` stoppage with no fighter on it, and `generic` is also a lost mouthpiece. So a foul is reported only when a record confirms it (`foul_basis` / `basis`): `log` (the labelled row), `deduction` (the athletic commission took a point) or `result` (the bout ended on it: a disqualification, or a "could not continue" / no contest whose official detail describes a foul). On a stoppage, `is_foul` says whether one is confirmed, `foul` what it was (`eye_poke`, `low_blow`, `illegal_knee`, `illegal_kick`, `headbutt`, `illegal_strike`, `fence`, `biting`, `other`), `committed_by` who COMMITTED it (null when no record names a fighter), `points_deducted` and `ended_bout`. A `generic` stoppage with no record behind it has `is_foul: false`. `incidents[]` lists every confirmed foul in fight order, including one with no stoppage in the log (a point deducted for grabbing the fence: `elapsed_sec` is null). One incident is one foul: a deduction for a logged low blow adds its points to that foul. `fouls.a` / `fouls.b` count what each corner committed (`eye_pokes`, `low_blows`, `other`, `total`), the points deducted and the seconds the bout was stopped for it. A recorded foul is not a ruling on intent.
5567
+ *
5568
+ * Settled bouts only (`completed` or `no_contest`). A bout that is not settled yet, a bout of another promotion or one with no log answers 200 with empty lists and `meta.note`; 404 is reserved for an unknown fight. `meta.source` is `ufc-official`.
5569
+ *
5570
+ * For example, fight 59652 (Leon Edwards vs Kamaru Usman, UFC 286) logs 51 actions and four stoppages: round 1 at 246 s (`generic`, 13 s), round 2 at 54 s (`low_blow`, 13 s, committed by fighter 401 in corner `a`), round 3 at 90 s (`generic`, 48 s — the pause for the fence grab the commission deducted a point for, so `is_foul` true, `foul` `fence`, `foul_basis` `deduction`, `points_deducted` 1) and round 3 at 175 s (`low_blow`, 23 s, fighter 401 again). `fouls.a` reads `fighter_id` 401, `eye_pokes` 0, `low_blows` 2, `other` 1, `total` 3, `points_deducted` 1, `stoppage_sec` 84; `fouls.b` (fighter 1204) is all zeros. Fight 65762 (Petr Yan vs Aljamain Sterling, UFC 259) has one stoppage, `generic` at 270 s of round 4, never resumed: `is_foul` true, `foul` `illegal_knee`, `foul_basis` `result`, `committed_by` Yan, `ended_bout` true.
5571
+ *
5572
+ * The example is fight 59652 with `actions` cut to the 8 rows of round 2; `stoppages`, `incidents` and `fouls` are complete.
5237
5573
  */
5238
5574
  get: {
5239
5575
  parameters: {
5240
- query?: {
5241
- /** @description Launch org slug: `ufc`, `pfl`, `oktagon`, `bkfc` or `rizin`. Staged orgs 400 until promoted. */
5242
- org?: "ufc" | "pfl" | "oktagon" | "bkfc" | "rizin";
5243
- /** @description First UTC calendar day, inclusive `YYYY-MM-DD`, matched against the event's `starts_at` (first bell, UTC) — not the venue's local date. Must be a real calendar day. */
5244
- from?: string;
5245
- /** @description Last UTC calendar day, inclusive `YYYY-MM-DD`, matched against `starts_at` (UTC). An evening card in the Americas starts after midnight UTC, so it falls on the next UTC day: a Saturday-night Las Vegas card needs `to=` the Sunday. Must be a real calendar day. */
5246
- to?: string;
5247
- /** @description Opaque cursor from `meta.pagination.next_cursor`. */
5248
- cursor?: string;
5249
- limit?: number;
5250
- };
5576
+ query?: never;
5251
5577
  header?: never;
5252
- path?: never;
5578
+ path: {
5579
+ id: number;
5580
+ };
5253
5581
  cookie?: never;
5254
5582
  };
5255
5583
  requestBody?: never;
5256
5584
  responses: {
5257
- /** @description Split and majority decisions, newest first */
5585
+ /** @description The log, its stoppages and the foul counts */
5258
5586
  200: {
5259
5587
  headers: {
5260
5588
  /** @description Weak validator over the body, e.g. `W/"GKrimLo826WBqG27jbNFsW2ZHmA"`. Send it back as `If-None-Match` to get a 304. */
@@ -5274,143 +5602,947 @@ interface paths {
5274
5602
  content: {
5275
5603
  /**
5276
5604
  * @example {
5277
- * "data": [
5278
- * {
5279
- * "id": 184,
5280
- * "ordering": 11,
5281
- * "card_section": "main",
5282
- * "sport": "mma",
5283
- * "weight_class": "Women's Flyweight",
5284
- * "division_slug": "womens-flyweight",
5285
- * "is_title": false,
5286
- * "is_main": false,
5287
- * "scheduled_rounds": 3,
5288
- * "status": "completed",
5289
- * "fighter_a": {
5290
- * "id": 97,
5291
- * "slug": "jeisla-chaves",
5292
- * "name": "Jeisla Chaves",
5293
- * "nickname": "A Braba",
5294
- * "nationality": "Brazil",
5295
- * "country_code": "BR"
5605
+ * "data": {
5606
+ * "round_seconds": 300,
5607
+ * "actions": [
5608
+ * {
5609
+ * "type": "round_start",
5610
+ * "round": 2,
5611
+ * "elapsed_sec": 0,
5612
+ * "at": "2023-03-18T23:38:12.000Z",
5613
+ * "fighter_id": null,
5614
+ * "corner": null
5296
5615
  * },
5297
- * "fighter_b": {
5298
- * "id": 98,
5299
- * "slug": "yuneisy-duben",
5300
- * "name": "Yuneisy Duben",
5301
- * "nickname": null,
5302
- * "nationality": "Cuba",
5303
- * "country_code": "CU"
5616
+ * {
5617
+ * "type": "round_pause",
5618
+ * "round": 2,
5619
+ * "elapsed_sec": 54,
5620
+ * "at": "2023-03-18T23:39:06.000Z",
5621
+ * "fighter_id": null,
5622
+ * "corner": null
5304
5623
  * },
5305
- * "result": {
5306
- * "winner_fighter_id": 97,
5307
- * "method": "Decision - Split",
5308
- * "method_normalized": "decision_split",
5309
- * "finish_detail": "Split",
5624
+ * {
5625
+ * "type": "pause_reason_low_blow",
5626
+ * "round": 2,
5627
+ * "elapsed_sec": 54,
5628
+ * "at": "2023-03-18T23:39:06.000Z",
5629
+ * "fighter_id": 401,
5630
+ * "corner": "a"
5631
+ * },
5632
+ * {
5633
+ * "type": "round_unpause",
5634
+ * "round": 2,
5635
+ * "elapsed_sec": 54,
5636
+ * "at": "2023-03-18T23:39:19.000Z",
5637
+ * "fighter_id": null,
5638
+ * "corner": null
5639
+ * },
5640
+ * {
5641
+ * "type": "takedown_attempt",
5642
+ * "round": 2,
5643
+ * "elapsed_sec": 137,
5644
+ * "at": "2023-03-18T23:40:43.000Z",
5645
+ * "fighter_id": 1204,
5646
+ * "corner": "b"
5647
+ * },
5648
+ * {
5649
+ * "type": "takedown",
5650
+ * "round": 2,
5651
+ * "elapsed_sec": 139,
5652
+ * "at": "2023-03-18T23:40:44.000Z",
5653
+ * "fighter_id": 1204,
5654
+ * "corner": "b"
5655
+ * },
5656
+ * {
5657
+ * "type": "takedown_attempt",
5658
+ * "round": 2,
5659
+ * "elapsed_sec": 162,
5660
+ * "at": "2023-03-18T23:41:07.000Z",
5661
+ * "fighter_id": 401,
5662
+ * "corner": "a"
5663
+ * },
5664
+ * {
5665
+ * "type": "round_end",
5666
+ * "round": 2,
5667
+ * "elapsed_sec": 300,
5668
+ * "at": "2023-03-18T23:43:26.000Z",
5669
+ * "fighter_id": null,
5670
+ * "corner": null
5671
+ * }
5672
+ * ],
5673
+ * "stoppages": [
5674
+ * {
5675
+ * "round": 1,
5676
+ * "elapsed_sec": 246,
5677
+ * "at": "2023-03-18T23:35:58.000Z",
5678
+ * "resumed_at": "2023-03-18T23:36:11.000Z",
5679
+ * "duration_sec": 13,
5680
+ * "reason": "generic",
5681
+ * "is_foul": false,
5682
+ * "foul": null,
5683
+ * "foul_basis": null,
5684
+ * "committed_by": null,
5685
+ * "points_deducted": 0,
5686
+ * "ended_bout": false
5687
+ * },
5688
+ * {
5689
+ * "round": 2,
5690
+ * "elapsed_sec": 54,
5691
+ * "at": "2023-03-18T23:39:06.000Z",
5692
+ * "resumed_at": "2023-03-18T23:39:19.000Z",
5693
+ * "duration_sec": 13,
5694
+ * "reason": "low_blow",
5695
+ * "is_foul": true,
5696
+ * "foul": "low_blow",
5697
+ * "foul_basis": "log",
5698
+ * "committed_by": {
5699
+ * "fighter_id": 401,
5700
+ * "corner": "a"
5701
+ * },
5702
+ * "points_deducted": 0,
5703
+ * "ended_bout": false
5704
+ * },
5705
+ * {
5310
5706
  * "round": 3,
5311
- * "time": "5:00",
5312
- * "time_seconds": 300,
5313
- * "details": null
5707
+ * "elapsed_sec": 90,
5708
+ * "at": "2023-03-18T23:46:06.000Z",
5709
+ * "resumed_at": "2023-03-18T23:46:54.000Z",
5710
+ * "duration_sec": 48,
5711
+ * "reason": "generic",
5712
+ * "is_foul": true,
5713
+ * "foul": "fence",
5714
+ * "foul_basis": "deduction",
5715
+ * "committed_by": {
5716
+ * "fighter_id": 401,
5717
+ * "corner": "a"
5718
+ * },
5719
+ * "points_deducted": 1,
5720
+ * "ended_bout": false
5314
5721
  * },
5315
- * "referee": "Dan Miragliotta",
5316
- * "bonus": null,
5317
- * "event": {
5318
- * "id": 9,
5319
- * "slug": "ufc-fight-night-2026-06-06",
5320
- * "title": "UFC Fight Night: Muhammad vs Bonfim",
5321
- * "org": "ufc",
5322
- * "starts_at": "2026-06-06T21:00:00.000Z"
5722
+ * {
5723
+ * "round": 3,
5724
+ * "elapsed_sec": 175,
5725
+ * "at": "2023-03-18T23:48:19.000Z",
5726
+ * "resumed_at": "2023-03-18T23:48:42.000Z",
5727
+ * "duration_sec": 23,
5728
+ * "reason": "low_blow",
5729
+ * "is_foul": true,
5730
+ * "foul": "low_blow",
5731
+ * "foul_basis": "log",
5732
+ * "committed_by": {
5733
+ * "fighter_id": 401,
5734
+ * "corner": "a"
5735
+ * },
5736
+ * "points_deducted": 0,
5737
+ * "ended_bout": false
5738
+ * }
5739
+ * ],
5740
+ * "incidents": [
5741
+ * {
5742
+ * "foul": "low_blow",
5743
+ * "basis": "log",
5744
+ * "committed_by": {
5745
+ * "fighter_id": 401,
5746
+ * "corner": "a"
5747
+ * },
5748
+ * "round": 2,
5749
+ * "elapsed_sec": 54,
5750
+ * "stoppage_sec": 13,
5751
+ * "points_deducted": 0,
5752
+ * "ended_bout": false
5323
5753
  * },
5324
- * "decision_type": "split",
5325
- * "official_winner_fighter_id": 97,
5326
- * "cards": [
5327
- * {
5328
- * "judge_id": 42,
5329
- * "judge_name": "Ron McCarthy",
5330
- * "total_a": 29,
5331
- * "total_b": 28,
5332
- * "winner_fighter_id": 97,
5333
- * "is_draw": false,
5334
- * "scores_known": true,
5335
- * "rounds": [
5336
- * {
5337
- * "round": 1,
5338
- * "a": 10,
5339
- * "b": 9
5340
- * },
5341
- * {
5342
- * "round": 2,
5343
- * "a": 10,
5344
- * "b": 9
5345
- * },
5346
- * {
5347
- * "round": 3,
5348
- * "a": 9,
5349
- * "b": 10
5350
- * }
5351
- * ]
5754
+ * {
5755
+ * "foul": "fence",
5756
+ * "basis": "deduction",
5757
+ * "committed_by": {
5758
+ * "fighter_id": 401,
5759
+ * "corner": "a"
5352
5760
  * },
5353
- * {
5354
- * "judge_id": 35,
5355
- * "judge_name": "Tony Weeks",
5356
- * "total_a": 28,
5357
- * "total_b": 29,
5358
- * "winner_fighter_id": 98,
5359
- * "is_draw": false,
5360
- * "scores_known": true,
5361
- * "rounds": [
5362
- * {
5363
- * "round": 1,
5364
- * "a": 9,
5365
- * "b": 10
5366
- * },
5367
- * {
5368
- * "round": 2,
5369
- * "a": 10,
5370
- * "b": 9
5371
- * },
5372
- * {
5373
- * "round": 3,
5374
- * "a": 9,
5375
- * "b": 10
5376
- * }
5377
- * ]
5761
+ * "round": 3,
5762
+ * "elapsed_sec": 90,
5763
+ * "stoppage_sec": 48,
5764
+ * "points_deducted": 1,
5765
+ * "ended_bout": false
5766
+ * },
5767
+ * {
5768
+ * "foul": "low_blow",
5769
+ * "basis": "log",
5770
+ * "committed_by": {
5771
+ * "fighter_id": 401,
5772
+ * "corner": "a"
5378
5773
  * },
5379
- * {
5380
- * "judge_id": 29,
5381
- * "judge_name": "Clemens Werner",
5382
- * "total_a": 29,
5383
- * "total_b": 28,
5384
- * "winner_fighter_id": 97,
5385
- * "is_draw": false,
5386
- * "scores_known": true,
5387
- * "rounds": [
5388
- * {
5389
- * "round": 1,
5390
- * "a": 10,
5391
- * "b": 9
5392
- * },
5393
- * {
5394
- * "round": 2,
5395
- * "a": 10,
5396
- * "b": 9
5397
- * },
5398
- * {
5399
- * "round": 3,
5400
- * "a": 9,
5401
- * "b": 10
5402
- * }
5403
- * ]
5404
- * }
5405
- * ],
5406
- * "dissenting_judges": [
5407
- * {
5408
- * "judge_id": 35,
5409
- * "judge_name": "Tony Weeks",
5410
- * "total_a": 28,
5411
- * "total_b": 29,
5412
- * "winner_fighter_id": 98,
5413
- * "is_draw": false,
5774
+ * "round": 3,
5775
+ * "elapsed_sec": 175,
5776
+ * "stoppage_sec": 23,
5777
+ * "points_deducted": 0,
5778
+ * "ended_bout": false
5779
+ * }
5780
+ * ],
5781
+ * "fouls": {
5782
+ * "a": {
5783
+ * "fighter_id": 401,
5784
+ * "eye_pokes": 0,
5785
+ * "low_blows": 2,
5786
+ * "other": 1,
5787
+ * "total": 3,
5788
+ * "points_deducted": 1,
5789
+ * "stoppage_sec": 84
5790
+ * },
5791
+ * "b": {
5792
+ * "fighter_id": 1204,
5793
+ * "eye_pokes": 0,
5794
+ * "low_blows": 0,
5795
+ * "other": 0,
5796
+ * "total": 0,
5797
+ * "points_deducted": 0,
5798
+ * "stoppage_sec": 0
5799
+ * }
5800
+ * }
5801
+ * },
5802
+ * "meta": {
5803
+ * "fight_id": 59652,
5804
+ * "source": "ufc-official",
5805
+ * "has_stoppage_reasons": true
5806
+ * }
5807
+ * }
5808
+ */
5809
+ "application/json": components["schemas"]["FightTimelineResponse"];
5810
+ };
5811
+ };
5812
+ /** @description Not Modified — `If-None-Match` matched the current weak `ETag`. Empty body. */
5813
+ 304: {
5814
+ headers: {
5815
+ [name: string]: unknown;
5816
+ };
5817
+ content?: never;
5818
+ };
5819
+ /** @description Missing/invalid API key (`unauthorized`). */
5820
+ 401: {
5821
+ headers: {
5822
+ [name: string]: unknown;
5823
+ };
5824
+ content: {
5825
+ "application/json": components["schemas"]["Error"];
5826
+ };
5827
+ };
5828
+ /** @description Requires a Pro or Business plan (`tier_required`). Answered before the fight or fighter is looked up. */
5829
+ 403: {
5830
+ headers: {
5831
+ [name: string]: unknown;
5832
+ };
5833
+ content: {
5834
+ "application/json": components["schemas"]["Error"];
5835
+ };
5836
+ };
5837
+ /** @description Not found (`not_found`; staged-org data 404s until the org is promoted). */
5838
+ 404: {
5839
+ headers: {
5840
+ [name: string]: unknown;
5841
+ };
5842
+ content: {
5843
+ "application/json": components["schemas"]["Error"];
5844
+ };
5845
+ };
5846
+ /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
5847
+ 429: {
5848
+ headers: {
5849
+ [name: string]: unknown;
5850
+ };
5851
+ content: {
5852
+ "application/json": components["schemas"]["Error"];
5853
+ };
5854
+ };
5855
+ /** @description Something broke on our side (`internal_error`). It has been logged under the `request_id`. */
5856
+ 500: {
5857
+ headers: {
5858
+ [name: string]: unknown;
5859
+ };
5860
+ content: {
5861
+ "application/json": components["schemas"]["Error"];
5862
+ };
5863
+ };
5864
+ };
5865
+ };
5866
+ put?: never;
5867
+ post?: never;
5868
+ delete?: never;
5869
+ options?: never;
5870
+ head?: never;
5871
+ patch?: never;
5872
+ trace?: never;
5873
+ };
5874
+ "/v1/fights/{id}/positions": {
5875
+ parameters: {
5876
+ query?: never;
5877
+ header?: never;
5878
+ path?: never;
5879
+ cookie?: never;
5880
+ };
5881
+ /**
5882
+ * Position stats: time by range, control by position (Pro+)
5883
+ * @description Where one settled UFC bout was fought and who held control, from the official fight statistics (tracked reliably from 2007): `totals` is one line per fighter for the whole bout (corner `a`, then `b`) and `rounds` carries the same lines for each round. Requires a Pro or Business plan: a lower plan gets 403 `tier_required`, answered before the fight is looked up.
5884
+ *
5885
+ * Each line: `time` (`standing_sec`, `distance_sec`, `clinch_sec`, `ground_sec`, `neutral_sec`) is shared by both fighters — standing = distance + clinch, standing + ground = fight time, neutral = nobody in control. `control` is THIS fighter's control time: `total_sec` = `clinch_sec` + `ground_sec`, and the ground splits into `back_sec`, `mount_sec`, `side_sec`, `half_guard_sec`, `guard_sec` and `misc_ground_sec`. `sig_strikes` is significant strikes by position (`distance` / `clinch` / `ground`), then target (`head` / `body` / `leg`), each with `landed` and `attempted`; `total_strikes` is every strike by `head` / `body` / `leg` / `clinch` / `ground`. **null means not tracked for that bout; 0 is a real zero.** Times are whole seconds. `meta.official` is true once every line is the official post-fight figure.
5886
+ *
5887
+ * Settled bouts only (`completed` or `no_contest`). A bout that is not settled yet, a bout of another promotion or one whose positions were not tracked answers 200 with empty lists and `meta.note`; 404 is reserved for an unknown fight. `meta.source` is `ufc-official`.
5888
+ *
5889
+ * For example, in fight 59652 (Leon Edwards vs Kamaru Usman, UFC 286) the whole-bout line of fighter 401 carries `standing_sec` 1398, `distance_sec` 1147, `clinch_sec` 251, `ground_sec` 102 and `neutral_sec` 1197, every `control` field 0, and at distance 32 of 65 significant strikes to the head, 29 of 32 to the body and 50 of 53 to the leg. The example carries both whole-bout lines and round 1 of the five rounds.
5890
+ */
5891
+ get: {
5892
+ parameters: {
5893
+ query?: never;
5894
+ header?: never;
5895
+ path: {
5896
+ id: number;
5897
+ };
5898
+ cookie?: never;
5899
+ };
5900
+ requestBody?: never;
5901
+ responses: {
5902
+ /** @description Whole-bout lines and the per-round lines */
5903
+ 200: {
5904
+ headers: {
5905
+ /** @description Weak validator over the body, e.g. `W/"GKrimLo826WBqG27jbNFsW2ZHmA"`. Send it back as `If-None-Match` to get a 304. */
5906
+ ETag?: string;
5907
+ /** @description Always `private, no-cache`. */
5908
+ "Cache-Control"?: string;
5909
+ /** @description Monthly request quota of the plan. */
5910
+ "X-RateLimit-Limit"?: number;
5911
+ /** @description Requests left this month. */
5912
+ "X-RateLimit-Remaining"?: number;
5913
+ /** @description Unix seconds of the monthly reset. */
5914
+ "X-RateLimit-Reset"?: number;
5915
+ /** @description Quote it to support; the same id is in every error body. */
5916
+ "x-request-id"?: string;
5917
+ [name: string]: unknown;
5918
+ };
5919
+ content: {
5920
+ /**
5921
+ * @example {
5922
+ * "data": {
5923
+ * "totals": [
5924
+ * {
5925
+ * "fighter_id": 401,
5926
+ * "corner": "a",
5927
+ * "time": {
5928
+ * "standing_sec": 1398,
5929
+ * "distance_sec": 1147,
5930
+ * "clinch_sec": 251,
5931
+ * "ground_sec": 102,
5932
+ * "neutral_sec": 1197
5933
+ * },
5934
+ * "control": {
5935
+ * "total_sec": 0,
5936
+ * "clinch_sec": 0,
5937
+ * "ground_sec": 0,
5938
+ * "back_sec": 0,
5939
+ * "mount_sec": 0,
5940
+ * "side_sec": 0,
5941
+ * "half_guard_sec": 0,
5942
+ * "guard_sec": 0,
5943
+ * "misc_ground_sec": 0
5944
+ * },
5945
+ * "sig_strikes": {
5946
+ * "distance": {
5947
+ * "head": {
5948
+ * "landed": 32,
5949
+ * "attempted": 65
5950
+ * },
5951
+ * "body": {
5952
+ * "landed": 29,
5953
+ * "attempted": 32
5954
+ * },
5955
+ * "leg": {
5956
+ * "landed": 50,
5957
+ * "attempted": 53
5958
+ * }
5959
+ * },
5960
+ * "clinch": {
5961
+ * "head": {
5962
+ * "landed": 2,
5963
+ * "attempted": 4
5964
+ * },
5965
+ * "body": {
5966
+ * "landed": 7,
5967
+ * "attempted": 7
5968
+ * },
5969
+ * "leg": {
5970
+ * "landed": 0,
5971
+ * "attempted": 0
5972
+ * }
5973
+ * },
5974
+ * "ground": {
5975
+ * "head": {
5976
+ * "landed": 0,
5977
+ * "attempted": 0
5978
+ * },
5979
+ * "body": {
5980
+ * "landed": 0,
5981
+ * "attempted": 0
5982
+ * },
5983
+ * "leg": {
5984
+ * "landed": 0,
5985
+ * "attempted": 0
5986
+ * }
5987
+ * }
5988
+ * },
5989
+ * "total_strikes": {
5990
+ * "head": {
5991
+ * "landed": 36,
5992
+ * "attempted": 71
5993
+ * },
5994
+ * "body": {
5995
+ * "landed": 37,
5996
+ * "attempted": 40
5997
+ * },
5998
+ * "leg": {
5999
+ * "landed": 50,
6000
+ * "attempted": 53
6001
+ * },
6002
+ * "clinch": {
6003
+ * "landed": 12,
6004
+ * "attempted": 14
6005
+ * },
6006
+ * "ground": {
6007
+ * "landed": 0,
6008
+ * "attempted": 0
6009
+ * }
6010
+ * }
6011
+ * },
6012
+ * {
6013
+ * "fighter_id": 1204,
6014
+ * "corner": "b",
6015
+ * "time": {
6016
+ * "standing_sec": 1398,
6017
+ * "distance_sec": 1147,
6018
+ * "clinch_sec": 251,
6019
+ * "ground_sec": 102,
6020
+ * "neutral_sec": 1197
6021
+ * },
6022
+ * "control": {
6023
+ * "total_sec": 303,
6024
+ * "clinch_sec": 201,
6025
+ * "ground_sec": 102,
6026
+ * "back_sec": 8,
6027
+ * "mount_sec": 0,
6028
+ * "side_sec": 0,
6029
+ * "half_guard_sec": 32,
6030
+ * "guard_sec": 0,
6031
+ * "misc_ground_sec": 62
6032
+ * },
6033
+ * "sig_strikes": {
6034
+ * "distance": {
6035
+ * "head": {
6036
+ * "landed": 40,
6037
+ * "attempted": 140
6038
+ * },
6039
+ * "body": {
6040
+ * "landed": 19,
6041
+ * "attempted": 29
6042
+ * },
6043
+ * "leg": {
6044
+ * "landed": 6,
6045
+ * "attempted": 8
6046
+ * }
6047
+ * },
6048
+ * "clinch": {
6049
+ * "head": {
6050
+ * "landed": 16,
6051
+ * "attempted": 22
6052
+ * },
6053
+ * "body": {
6054
+ * "landed": 5,
6055
+ * "attempted": 5
6056
+ * },
6057
+ * "leg": {
6058
+ * "landed": 0,
6059
+ * "attempted": 0
6060
+ * }
6061
+ * },
6062
+ * "ground": {
6063
+ * "head": {
6064
+ * "landed": 1,
6065
+ * "attempted": 1
6066
+ * },
6067
+ * "body": {
6068
+ * "landed": 0,
6069
+ * "attempted": 0
6070
+ * },
6071
+ * "leg": {
6072
+ * "landed": 0,
6073
+ * "attempted": 0
6074
+ * }
6075
+ * }
6076
+ * },
6077
+ * "total_strikes": {
6078
+ * "head": {
6079
+ * "landed": 64,
6080
+ * "attempted": 171
6081
+ * },
6082
+ * "body": {
6083
+ * "landed": 36,
6084
+ * "attempted": 46
6085
+ * },
6086
+ * "leg": {
6087
+ * "landed": 13,
6088
+ * "attempted": 15
6089
+ * },
6090
+ * "clinch": {
6091
+ * "landed": 36,
6092
+ * "attempted": 43
6093
+ * },
6094
+ * "ground": {
6095
+ * "landed": 12,
6096
+ * "attempted": 12
6097
+ * }
6098
+ * }
6099
+ * }
6100
+ * ],
6101
+ * "rounds": [
6102
+ * {
6103
+ * "round": 1,
6104
+ * "fighters": [
6105
+ * {
6106
+ * "fighter_id": 401,
6107
+ * "corner": "a",
6108
+ * "time": {
6109
+ * "standing_sec": 300,
6110
+ * "distance_sec": 276,
6111
+ * "clinch_sec": 24,
6112
+ * "ground_sec": 0,
6113
+ * "neutral_sec": 281
6114
+ * },
6115
+ * "control": {
6116
+ * "total_sec": 0,
6117
+ * "clinch_sec": 0,
6118
+ * "ground_sec": 0,
6119
+ * "back_sec": 0,
6120
+ * "mount_sec": 0,
6121
+ * "side_sec": 0,
6122
+ * "half_guard_sec": 0,
6123
+ * "guard_sec": 0,
6124
+ * "misc_ground_sec": 0
6125
+ * },
6126
+ * "sig_strikes": {
6127
+ * "distance": {
6128
+ * "head": {
6129
+ * "landed": 5,
6130
+ * "attempted": 11
6131
+ * },
6132
+ * "body": {
6133
+ * "landed": 6,
6134
+ * "attempted": 6
6135
+ * },
6136
+ * "leg": {
6137
+ * "landed": 9,
6138
+ * "attempted": 9
6139
+ * }
6140
+ * },
6141
+ * "clinch": {
6142
+ * "head": {
6143
+ * "landed": 0,
6144
+ * "attempted": 0
6145
+ * },
6146
+ * "body": {
6147
+ * "landed": 0,
6148
+ * "attempted": 0
6149
+ * },
6150
+ * "leg": {
6151
+ * "landed": 0,
6152
+ * "attempted": 0
6153
+ * }
6154
+ * },
6155
+ * "ground": {
6156
+ * "head": {
6157
+ * "landed": 0,
6158
+ * "attempted": 0
6159
+ * },
6160
+ * "body": {
6161
+ * "landed": 0,
6162
+ * "attempted": 0
6163
+ * },
6164
+ * "leg": {
6165
+ * "landed": 0,
6166
+ * "attempted": 0
6167
+ * }
6168
+ * }
6169
+ * },
6170
+ * "total_strikes": {
6171
+ * "head": {
6172
+ * "landed": 5,
6173
+ * "attempted": 11
6174
+ * },
6175
+ * "body": {
6176
+ * "landed": 6,
6177
+ * "attempted": 6
6178
+ * },
6179
+ * "leg": {
6180
+ * "landed": 9,
6181
+ * "attempted": 9
6182
+ * },
6183
+ * "clinch": {
6184
+ * "landed": 0,
6185
+ * "attempted": 0
6186
+ * },
6187
+ * "ground": {
6188
+ * "landed": 0,
6189
+ * "attempted": 0
6190
+ * }
6191
+ * }
6192
+ * },
6193
+ * {
6194
+ * "fighter_id": 1204,
6195
+ * "corner": "b",
6196
+ * "time": {
6197
+ * "standing_sec": 300,
6198
+ * "distance_sec": 276,
6199
+ * "clinch_sec": 24,
6200
+ * "ground_sec": 0,
6201
+ * "neutral_sec": 281
6202
+ * },
6203
+ * "control": {
6204
+ * "total_sec": 19,
6205
+ * "clinch_sec": 19,
6206
+ * "ground_sec": 0,
6207
+ * "back_sec": 0,
6208
+ * "mount_sec": 0,
6209
+ * "side_sec": 0,
6210
+ * "half_guard_sec": 0,
6211
+ * "guard_sec": 0,
6212
+ * "misc_ground_sec": 0
6213
+ * },
6214
+ * "sig_strikes": {
6215
+ * "distance": {
6216
+ * "head": {
6217
+ * "landed": 5,
6218
+ * "attempted": 32
6219
+ * },
6220
+ * "body": {
6221
+ * "landed": 6,
6222
+ * "attempted": 8
6223
+ * },
6224
+ * "leg": {
6225
+ * "landed": 1,
6226
+ * "attempted": 2
6227
+ * }
6228
+ * },
6229
+ * "clinch": {
6230
+ * "head": {
6231
+ * "landed": 0,
6232
+ * "attempted": 0
6233
+ * },
6234
+ * "body": {
6235
+ * "landed": 0,
6236
+ * "attempted": 0
6237
+ * },
6238
+ * "leg": {
6239
+ * "landed": 0,
6240
+ * "attempted": 0
6241
+ * }
6242
+ * },
6243
+ * "ground": {
6244
+ * "head": {
6245
+ * "landed": 0,
6246
+ * "attempted": 0
6247
+ * },
6248
+ * "body": {
6249
+ * "landed": 0,
6250
+ * "attempted": 0
6251
+ * },
6252
+ * "leg": {
6253
+ * "landed": 0,
6254
+ * "attempted": 0
6255
+ * }
6256
+ * }
6257
+ * },
6258
+ * "total_strikes": {
6259
+ * "head": {
6260
+ * "landed": 5,
6261
+ * "attempted": 32
6262
+ * },
6263
+ * "body": {
6264
+ * "landed": 6,
6265
+ * "attempted": 8
6266
+ * },
6267
+ * "leg": {
6268
+ * "landed": 2,
6269
+ * "attempted": 3
6270
+ * },
6271
+ * "clinch": {
6272
+ * "landed": 1,
6273
+ * "attempted": 1
6274
+ * },
6275
+ * "ground": {
6276
+ * "landed": 0,
6277
+ * "attempted": 0
6278
+ * }
6279
+ * }
6280
+ * }
6281
+ * ]
6282
+ * }
6283
+ * ]
6284
+ * },
6285
+ * "meta": {
6286
+ * "fight_id": 59652,
6287
+ * "source": "ufc-official",
6288
+ * "official": true,
6289
+ * "note": "null means not tracked for this bout; 0 is a real zero. Time fields are whole seconds."
6290
+ * }
6291
+ * }
6292
+ */
6293
+ "application/json": components["schemas"]["FightPositionsResponse"];
6294
+ };
6295
+ };
6296
+ /** @description Not Modified — `If-None-Match` matched the current weak `ETag`. Empty body. */
6297
+ 304: {
6298
+ headers: {
6299
+ [name: string]: unknown;
6300
+ };
6301
+ content?: never;
6302
+ };
6303
+ /** @description Missing/invalid API key (`unauthorized`). */
6304
+ 401: {
6305
+ headers: {
6306
+ [name: string]: unknown;
6307
+ };
6308
+ content: {
6309
+ "application/json": components["schemas"]["Error"];
6310
+ };
6311
+ };
6312
+ /** @description Requires a Pro or Business plan (`tier_required`). Answered before the fight or fighter is looked up. */
6313
+ 403: {
6314
+ headers: {
6315
+ [name: string]: unknown;
6316
+ };
6317
+ content: {
6318
+ "application/json": components["schemas"]["Error"];
6319
+ };
6320
+ };
6321
+ /** @description Not found (`not_found`; staged-org data 404s until the org is promoted). */
6322
+ 404: {
6323
+ headers: {
6324
+ [name: string]: unknown;
6325
+ };
6326
+ content: {
6327
+ "application/json": components["schemas"]["Error"];
6328
+ };
6329
+ };
6330
+ /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
6331
+ 429: {
6332
+ headers: {
6333
+ [name: string]: unknown;
6334
+ };
6335
+ content: {
6336
+ "application/json": components["schemas"]["Error"];
6337
+ };
6338
+ };
6339
+ /** @description Something broke on our side (`internal_error`). It has been logged under the `request_id`. */
6340
+ 500: {
6341
+ headers: {
6342
+ [name: string]: unknown;
6343
+ };
6344
+ content: {
6345
+ "application/json": components["schemas"]["Error"];
6346
+ };
6347
+ };
6348
+ };
6349
+ };
6350
+ put?: never;
6351
+ post?: never;
6352
+ delete?: never;
6353
+ options?: never;
6354
+ head?: never;
6355
+ patch?: never;
6356
+ trace?: never;
6357
+ };
6358
+ "/v1/scorecards/splits": {
6359
+ parameters: {
6360
+ query?: never;
6361
+ header?: never;
6362
+ path?: never;
6363
+ cookie?: never;
6364
+ };
6365
+ /**
6366
+ * Split and majority decisions
6367
+ * @description Completed bouts the judges decided on a split or majority (including majority and split draws), newest first, across the launch promotions or one of them, optionally in a date range. Each row is the bout (same shape as `/v1/fights/{id}`) plus its `event`, the `decision_type`, `official_winner_fighter_id` (`null` on a draw), every judge's card (`cards`, same objects as `/v1/fights/{id}/scorecards`) and `dissenting_judges` — the cards that disagree with the official result (`judge_id`, `judge_name`, `total_a`, `total_b`, `winner_fighter_id`, `is_draw`, `scores_known`). A card with no readable verdict is not counted as a dissent; an outcome-only card (`scores_known: false`) is, flagged. Commission records only — facts as filed, no verdict of our own; sources that publish no decision type are not listed. Up to 50 rows a page.
6368
+ */
6369
+ get: {
6370
+ parameters: {
6371
+ query?: {
6372
+ /** @description Launch org slug: `ufc`, `pfl`, `oktagon`, `bkfc` or `rizin`. Staged orgs 400 until promoted. */
6373
+ org?: "ufc" | "pfl" | "oktagon" | "bkfc" | "rizin";
6374
+ /** @description First UTC calendar day, inclusive `YYYY-MM-DD`, matched against the event's `starts_at` (first bell, UTC) — not the venue's local date. Must be a real calendar day. */
6375
+ from?: string;
6376
+ /** @description Last UTC calendar day, inclusive `YYYY-MM-DD`, matched against `starts_at` (UTC). An evening card in the Americas starts after midnight UTC, so it falls on the next UTC day: a Saturday-night Las Vegas card needs `to=` the Sunday. Must be a real calendar day. */
6377
+ to?: string;
6378
+ /** @description Opaque cursor from `meta.pagination.next_cursor`. */
6379
+ cursor?: string;
6380
+ limit?: number;
6381
+ };
6382
+ header?: never;
6383
+ path?: never;
6384
+ cookie?: never;
6385
+ };
6386
+ requestBody?: never;
6387
+ responses: {
6388
+ /** @description Split and majority decisions, newest first */
6389
+ 200: {
6390
+ headers: {
6391
+ /** @description Weak validator over the body, e.g. `W/"GKrimLo826WBqG27jbNFsW2ZHmA"`. Send it back as `If-None-Match` to get a 304. */
6392
+ ETag?: string;
6393
+ /** @description Always `private, no-cache`. */
6394
+ "Cache-Control"?: string;
6395
+ /** @description Monthly request quota of the plan. */
6396
+ "X-RateLimit-Limit"?: number;
6397
+ /** @description Requests left this month. */
6398
+ "X-RateLimit-Remaining"?: number;
6399
+ /** @description Unix seconds of the monthly reset. */
6400
+ "X-RateLimit-Reset"?: number;
6401
+ /** @description Quote it to support; the same id is in every error body. */
6402
+ "x-request-id"?: string;
6403
+ [name: string]: unknown;
6404
+ };
6405
+ content: {
6406
+ /**
6407
+ * @example {
6408
+ * "data": [
6409
+ * {
6410
+ * "id": 184,
6411
+ * "ordering": 11,
6412
+ * "card_section": "main",
6413
+ * "sport": "mma",
6414
+ * "weight_class": "Women's Flyweight",
6415
+ * "division_slug": "womens-flyweight",
6416
+ * "is_title": false,
6417
+ * "is_main": false,
6418
+ * "scheduled_rounds": 3,
6419
+ * "status": "completed",
6420
+ * "fighter_a": {
6421
+ * "id": 97,
6422
+ * "slug": "jeisla-chaves",
6423
+ * "name": "Jeisla Chaves",
6424
+ * "nickname": "A Braba",
6425
+ * "nationality": "Brazil",
6426
+ * "country_code": "BR"
6427
+ * },
6428
+ * "fighter_b": {
6429
+ * "id": 98,
6430
+ * "slug": "yuneisy-duben",
6431
+ * "name": "Yuneisy Duben",
6432
+ * "nickname": null,
6433
+ * "nationality": "Cuba",
6434
+ * "country_code": "CU"
6435
+ * },
6436
+ * "result": {
6437
+ * "winner_fighter_id": 97,
6438
+ * "method": "Decision - Split",
6439
+ * "method_normalized": "decision_split",
6440
+ * "finish_detail": "Split",
6441
+ * "finish_position": null,
6442
+ * "round": 3,
6443
+ * "time": "5:00",
6444
+ * "time_seconds": 300,
6445
+ * "details": null
6446
+ * },
6447
+ * "referee": "Dan Miragliotta",
6448
+ * "bonus": null,
6449
+ * "event": {
6450
+ * "id": 9,
6451
+ * "slug": "ufc-fight-night-2026-06-06",
6452
+ * "title": "UFC Fight Night: Muhammad vs Bonfim",
6453
+ * "org": "ufc",
6454
+ * "starts_at": "2026-06-06T21:00:00.000Z"
6455
+ * },
6456
+ * "decision_type": "split",
6457
+ * "official_winner_fighter_id": 97,
6458
+ * "cards": [
6459
+ * {
6460
+ * "judge_id": 42,
6461
+ * "judge_name": "Ron McCarthy",
6462
+ * "total_a": 29,
6463
+ * "total_b": 28,
6464
+ * "winner_fighter_id": 97,
6465
+ * "is_draw": false,
6466
+ * "scores_known": true,
6467
+ * "rounds": [
6468
+ * {
6469
+ * "round": 1,
6470
+ * "a": 10,
6471
+ * "b": 9
6472
+ * },
6473
+ * {
6474
+ * "round": 2,
6475
+ * "a": 10,
6476
+ * "b": 9
6477
+ * },
6478
+ * {
6479
+ * "round": 3,
6480
+ * "a": 9,
6481
+ * "b": 10
6482
+ * }
6483
+ * ]
6484
+ * },
6485
+ * {
6486
+ * "judge_id": 35,
6487
+ * "judge_name": "Tony Weeks",
6488
+ * "total_a": 28,
6489
+ * "total_b": 29,
6490
+ * "winner_fighter_id": 98,
6491
+ * "is_draw": false,
6492
+ * "scores_known": true,
6493
+ * "rounds": [
6494
+ * {
6495
+ * "round": 1,
6496
+ * "a": 9,
6497
+ * "b": 10
6498
+ * },
6499
+ * {
6500
+ * "round": 2,
6501
+ * "a": 10,
6502
+ * "b": 9
6503
+ * },
6504
+ * {
6505
+ * "round": 3,
6506
+ * "a": 9,
6507
+ * "b": 10
6508
+ * }
6509
+ * ]
6510
+ * },
6511
+ * {
6512
+ * "judge_id": 29,
6513
+ * "judge_name": "Clemens Werner",
6514
+ * "total_a": 29,
6515
+ * "total_b": 28,
6516
+ * "winner_fighter_id": 97,
6517
+ * "is_draw": false,
6518
+ * "scores_known": true,
6519
+ * "rounds": [
6520
+ * {
6521
+ * "round": 1,
6522
+ * "a": 10,
6523
+ * "b": 9
6524
+ * },
6525
+ * {
6526
+ * "round": 2,
6527
+ * "a": 10,
6528
+ * "b": 9
6529
+ * },
6530
+ * {
6531
+ * "round": 3,
6532
+ * "a": 9,
6533
+ * "b": 10
6534
+ * }
6535
+ * ]
6536
+ * }
6537
+ * ],
6538
+ * "dissenting_judges": [
6539
+ * {
6540
+ * "judge_id": 35,
6541
+ * "judge_name": "Tony Weeks",
6542
+ * "total_a": 28,
6543
+ * "total_b": 29,
6544
+ * "winner_fighter_id": 98,
6545
+ * "is_draw": false,
5414
6546
  * "scores_known": true
5415
6547
  * }
5416
6548
  * ]
@@ -6349,6 +7481,7 @@ interface paths {
6349
7481
  * "method": "KO/TKO",
6350
7482
  * "method_normalized": "ko_tko",
6351
7483
  * "finish_detail": null,
7484
+ * "finish_position": null,
6352
7485
  * "round": 1,
6353
7486
  * "time": "2:59",
6354
7487
  * "time_seconds": 179,
@@ -7192,11 +8325,267 @@ interface paths {
7192
8325
  * }
7193
8326
  * ],
7194
8327
  * "meta": {
7195
- * "truncated": false
8328
+ * "truncated": false
8329
+ * }
8330
+ * }
8331
+ */
8332
+ "application/json": components["schemas"]["FighterHistoryResponse"];
8333
+ };
8334
+ };
8335
+ /** @description Not Modified — `If-None-Match` matched the current weak `ETag`. Empty body. */
8336
+ 304: {
8337
+ headers: {
8338
+ [name: string]: unknown;
8339
+ };
8340
+ content?: never;
8341
+ };
8342
+ /** @description The slug is a retired alias (the event or fighter was renamed). Follow `Location` to the canonical URL; the numeric-id form never redirects. */
8343
+ 308: {
8344
+ headers: {
8345
+ /** @description Canonical `/v1/...` path. */
8346
+ Location?: string;
8347
+ [name: string]: unknown;
8348
+ };
8349
+ content?: never;
8350
+ };
8351
+ /** @description Missing/invalid API key (`unauthorized`). */
8352
+ 401: {
8353
+ headers: {
8354
+ [name: string]: unknown;
8355
+ };
8356
+ content: {
8357
+ "application/json": components["schemas"]["Error"];
8358
+ };
8359
+ };
8360
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (100 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
8361
+ 403: {
8362
+ headers: {
8363
+ [name: string]: unknown;
8364
+ };
8365
+ content: {
8366
+ "application/json": components["schemas"]["Error"];
8367
+ };
8368
+ };
8369
+ /** @description Not found (`not_found`; staged-org data 404s until the org is promoted). */
8370
+ 404: {
8371
+ headers: {
8372
+ [name: string]: unknown;
8373
+ };
8374
+ content: {
8375
+ "application/json": components["schemas"]["Error"];
8376
+ };
8377
+ };
8378
+ /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
8379
+ 429: {
8380
+ headers: {
8381
+ [name: string]: unknown;
8382
+ };
8383
+ content: {
8384
+ "application/json": components["schemas"]["Error"];
8385
+ };
8386
+ };
8387
+ /** @description Something broke on our side (`internal_error`). It has been logged under the `request_id`. */
8388
+ 500: {
8389
+ headers: {
8390
+ [name: string]: unknown;
8391
+ };
8392
+ content: {
8393
+ "application/json": components["schemas"]["Error"];
8394
+ };
8395
+ };
8396
+ };
8397
+ };
8398
+ put?: never;
8399
+ post?: never;
8400
+ delete?: never;
8401
+ options?: never;
8402
+ head?: never;
8403
+ patch?: never;
8404
+ trace?: never;
8405
+ };
8406
+ "/v1/fighters/{idOrSlug}/stats": {
8407
+ parameters: {
8408
+ query?: never;
8409
+ header?: never;
8410
+ path?: never;
8411
+ cookie?: never;
8412
+ };
8413
+ /**
8414
+ * Career statistics
8415
+ * @description Raw per-source career rows, plus the readable split in `meta.records` / `meta.stats` (the same objects the fighter profile carries — read those unless you need the per-source rows). `data`: per-scope career stats (`pro-mma`, `amateur-mma`, …): record, strikes landed/absorbed per minute, accuracy/defense, takedown and submission averages, and `updated_at` (this route only). Exactly ONE row per scope; `source` names the publisher it came from: `public-records` (the complete multi-promotion career record) is preferred, then the promotion's own site (`ufc-stats`, `bkfc-official`, `one-official`, …), then `ufcalendar`. A `public-records` record is a point-in-time snapshot advanced by every settled bout UFCalendar tracked after it, so it matches the record on ufcalendar.com. A row's record and its stats cover the same bouts. `pro-mma` = the career record plus striking/grappling averages UFCalendar computes over EVERY settled MMA bout it holds per-fight totals for, in any promotion (Contender Series included); its stats are null when no such bout exists. Bouts of another sport are averaged on that sport's row (`pro-knuckle` for bare-knuckle boxing, `pro-muay-thai`, `pro-kickboxing`, `pro-boxing`; a stats-only row with a null record when the fighter has no such record row) and never enter `pro-mma`. Org-scoped rows (`ufc-only`, `bkfc-only`, `one-only`) are the fighter's record INSIDE that promotion, not a career record: `ufc-only` carries a record AND averages UFCalendar derives from the fighter's tracked UFC bouts only (Contender Series excluded, `W-L-D` plus ` (n NC)`; both null until a UFC bout is settled — a Contender-Series-only fighter has no UFC stats), while `bkfc-only` / `one-only` carry the promotion's own published record. ufcstats', OKTAGON's and ACA's header records are CAREER records and ship under `pro-mma` (the `public-records` row wins the scope when present, unless ufcstats counts more bouts).
8416
+ */
8417
+ get: {
8418
+ parameters: {
8419
+ query?: never;
8420
+ header?: never;
8421
+ path: {
8422
+ /** @description Numeric id or slug of the fighter. Stale slugs 308-redirect to the canonical URL. */
8423
+ idOrSlug: string;
8424
+ };
8425
+ cookie?: never;
8426
+ };
8427
+ requestBody?: never;
8428
+ responses: {
8429
+ /** @description Career stat rows */
8430
+ 200: {
8431
+ headers: {
8432
+ /** @description Weak validator over the body, e.g. `W/"GKrimLo826WBqG27jbNFsW2ZHmA"`. Send it back as `If-None-Match` to get a 304. */
8433
+ ETag?: string;
8434
+ /** @description Always `private, no-cache`. */
8435
+ "Cache-Control"?: string;
8436
+ /** @description Monthly request quota of the plan. */
8437
+ "X-RateLimit-Limit"?: number;
8438
+ /** @description Requests left this month. */
8439
+ "X-RateLimit-Remaining"?: number;
8440
+ /** @description Unix seconds of the monthly reset. */
8441
+ "X-RateLimit-Reset"?: number;
8442
+ /** @description Quote it to support; the same id is in every error body. */
8443
+ "x-request-id"?: string;
8444
+ [name: string]: unknown;
8445
+ };
8446
+ content: {
8447
+ "application/json": components["schemas"]["FighterStatsResponse"];
8448
+ };
8449
+ };
8450
+ /** @description Not Modified — `If-None-Match` matched the current weak `ETag`. Empty body. */
8451
+ 304: {
8452
+ headers: {
8453
+ [name: string]: unknown;
8454
+ };
8455
+ content?: never;
8456
+ };
8457
+ /** @description The slug is a retired alias (the event or fighter was renamed). Follow `Location` to the canonical URL; the numeric-id form never redirects. */
8458
+ 308: {
8459
+ headers: {
8460
+ /** @description Canonical `/v1/...` path. */
8461
+ Location?: string;
8462
+ [name: string]: unknown;
8463
+ };
8464
+ content?: never;
8465
+ };
8466
+ /** @description Missing/invalid API key (`unauthorized`). */
8467
+ 401: {
8468
+ headers: {
8469
+ [name: string]: unknown;
8470
+ };
8471
+ content: {
8472
+ "application/json": components["schemas"]["Error"];
8473
+ };
8474
+ };
8475
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (100 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
8476
+ 403: {
8477
+ headers: {
8478
+ [name: string]: unknown;
8479
+ };
8480
+ content: {
8481
+ "application/json": components["schemas"]["Error"];
8482
+ };
8483
+ };
8484
+ /** @description Not found (`not_found`; staged-org data 404s until the org is promoted). */
8485
+ 404: {
8486
+ headers: {
8487
+ [name: string]: unknown;
8488
+ };
8489
+ content: {
8490
+ "application/json": components["schemas"]["Error"];
8491
+ };
8492
+ };
8493
+ /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
8494
+ 429: {
8495
+ headers: {
8496
+ [name: string]: unknown;
8497
+ };
8498
+ content: {
8499
+ "application/json": components["schemas"]["Error"];
8500
+ };
8501
+ };
8502
+ /** @description Something broke on our side (`internal_error`). It has been logged under the `request_id`. */
8503
+ 500: {
8504
+ headers: {
8505
+ [name: string]: unknown;
8506
+ };
8507
+ content: {
8508
+ "application/json": components["schemas"]["Error"];
8509
+ };
8510
+ };
8511
+ };
8512
+ };
8513
+ put?: never;
8514
+ post?: never;
8515
+ delete?: never;
8516
+ options?: never;
8517
+ head?: never;
8518
+ patch?: never;
8519
+ trace?: never;
8520
+ };
8521
+ "/v1/fighters/{idOrSlug}/rankings": {
8522
+ parameters: {
8523
+ query?: never;
8524
+ header?: never;
8525
+ path?: never;
8526
+ cookie?: never;
8527
+ };
8528
+ /**
8529
+ * Ranking history
8530
+ * @description Official-board rows over time (`org`, `board` in the public vocabulary — `official` / `meta` — `division` slug, `snapshot_date`, `rank`, `is_champion`), newest snapshot first. Rank 0 = champion; a snapshot is valid until superseded. Cursor-paginated since 2026-09-24 (`limit` 1–500, default 100) — long careers exceed the old silent 500-row cap.
8531
+ */
8532
+ get: {
8533
+ parameters: {
8534
+ query?: {
8535
+ /** @description Opaque cursor from `meta.pagination.next_cursor`. */
8536
+ cursor?: string;
8537
+ limit?: number;
8538
+ };
8539
+ header?: never;
8540
+ path: {
8541
+ /** @description Numeric id or slug of the fighter. Stale slugs 308-redirect to the canonical URL. */
8542
+ idOrSlug: string;
8543
+ };
8544
+ cookie?: never;
8545
+ };
8546
+ requestBody?: never;
8547
+ responses: {
8548
+ /** @description Ranking rows */
8549
+ 200: {
8550
+ headers: {
8551
+ /** @description Weak validator over the body, e.g. `W/"GKrimLo826WBqG27jbNFsW2ZHmA"`. Send it back as `If-None-Match` to get a 304. */
8552
+ ETag?: string;
8553
+ /** @description Always `private, no-cache`. */
8554
+ "Cache-Control"?: string;
8555
+ /** @description Monthly request quota of the plan. */
8556
+ "X-RateLimit-Limit"?: number;
8557
+ /** @description Requests left this month. */
8558
+ "X-RateLimit-Remaining"?: number;
8559
+ /** @description Unix seconds of the monthly reset. */
8560
+ "X-RateLimit-Reset"?: number;
8561
+ /** @description Quote it to support; the same id is in every error body. */
8562
+ "x-request-id"?: string;
8563
+ [name: string]: unknown;
8564
+ };
8565
+ content: {
8566
+ /**
8567
+ * @example {
8568
+ * "data": [
8569
+ * {
8570
+ * "org": "ufc",
8571
+ * "board": "official",
8572
+ * "division": "heavyweight",
8573
+ * "snapshot_date": "2025-06-17",
8574
+ * "rank": 0,
8575
+ * "is_champion": true
8576
+ * }
8577
+ * ],
8578
+ * "meta": {
8579
+ * "note": "rank 0 = champion; a snapshot is valid until superseded",
8580
+ * "pagination": {
8581
+ * "next_cursor": "eyJpZCI6MTAwfQ",
8582
+ * "has_more": true,
8583
+ * "limit": 100
8584
+ * }
7196
8585
  * }
7197
8586
  * }
7198
8587
  */
7199
- "application/json": components["schemas"]["FighterHistoryResponse"];
8588
+ "application/json": components["schemas"]["FighterRankingsResponse"];
7200
8589
  };
7201
8590
  };
7202
8591
  /** @description Not Modified — `If-None-Match` matched the current weak `ETag`. Empty body. */
@@ -7215,6 +8604,15 @@ interface paths {
7215
8604
  };
7216
8605
  content?: never;
7217
8606
  };
8607
+ /** @description Invalid input (`invalid_cursor`). */
8608
+ 400: {
8609
+ headers: {
8610
+ [name: string]: unknown;
8611
+ };
8612
+ content: {
8613
+ "application/json": components["schemas"]["Error"];
8614
+ };
8615
+ };
7218
8616
  /** @description Missing/invalid API key (`unauthorized`). */
7219
8617
  401: {
7220
8618
  headers: {
@@ -7270,7 +8668,7 @@ interface paths {
7270
8668
  patch?: never;
7271
8669
  trace?: never;
7272
8670
  };
7273
- "/v1/fighters/{idOrSlug}/stats": {
8671
+ "/v1/fighters/{idOrSlug}/power-index": {
7274
8672
  parameters: {
7275
8673
  query?: never;
7276
8674
  header?: never;
@@ -7278,8 +8676,8 @@ interface paths {
7278
8676
  cookie?: never;
7279
8677
  };
7280
8678
  /**
7281
- * Career statistics
7282
- * @description Raw per-source career rows, plus the readable split in `meta.records` / `meta.stats` (the same objects the fighter profile carries — read those unless you need the per-source rows). `data`: per-scope career stats (`pro-mma`, `amateur-mma`, …): record, strikes landed/absorbed per minute, accuracy/defense, takedown and submission averages, and `updated_at` (this route only). Exactly ONE row per scope; `source` names the publisher it came from: `public-records` (the complete multi-promotion career record) is preferred, then the promotion's own site (`ufc-stats`, `bkfc-official`, `one-official`, …), then `ufcalendar`. A `public-records` record is a point-in-time snapshot advanced by every settled bout UFCalendar tracked after it, so it matches the record on ufcalendar.com. A row's record and its stats cover the same bouts. `pro-mma` = the career record plus striking/grappling averages UFCalendar computes over EVERY settled MMA bout it holds per-fight totals for, in any promotion (Contender Series included); its stats are null when no such bout exists. Bouts of another sport are averaged on that sport's row (`pro-knuckle` for bare-knuckle boxing, `pro-muay-thai`, `pro-kickboxing`, `pro-boxing`; a stats-only row with a null record when the fighter has no such record row) and never enter `pro-mma`. Org-scoped rows (`ufc-only`, `bkfc-only`, `one-only`) are the fighter's record INSIDE that promotion, not a career record: `ufc-only` carries a record AND averages UFCalendar derives from the fighter's tracked UFC bouts only (Contender Series excluded, `W-L-D` plus ` (n NC)`; both null until a UFC bout is settled — a Contender-Series-only fighter has no UFC stats), while `bkfc-only` / `one-only` carry the promotion's own published record. ufcstats', OKTAGON's and ACA's header records are CAREER records and ship under `pro-mma` (the `public-records` row wins the scope when present, unless ufcstats counts more bouts).
8679
+ * Power Index trajectory
8680
+ * @description Per-bout rating history from the UFCalendar Power Index engine (rating before/after, model win probability, `outcome` 1 / 0 / 0.5 and its word twin `result`). The NEWEST 500 points, served oldest-first; `meta.truncated` is true when an older tail was dropped.
7283
8681
  */
7284
8682
  get: {
7285
8683
  parameters: {
@@ -7293,7 +8691,7 @@ interface paths {
7293
8691
  };
7294
8692
  requestBody?: never;
7295
8693
  responses: {
7296
- /** @description Career stat rows */
8694
+ /** @description Rating points */
7297
8695
  200: {
7298
8696
  headers: {
7299
8697
  /** @description Weak validator over the body, e.g. `W/"GKrimLo826WBqG27jbNFsW2ZHmA"`. Send it back as `If-None-Match` to get a 304. */
@@ -7311,7 +8709,26 @@ interface paths {
7311
8709
  [name: string]: unknown;
7312
8710
  };
7313
8711
  content: {
7314
- "application/json": components["schemas"]["FighterStatsResponse"];
8712
+ /**
8713
+ * @example {
8714
+ * "data": [
8715
+ * {
8716
+ * "fought_at": "2008-04-12",
8717
+ * "rating_pre": 1500,
8718
+ * "rating_post": 1536,
8719
+ * "win_prob": 0.5535,
8720
+ * "outcome": 1,
8721
+ * "result": "win",
8722
+ * "opponent_fighter_id": 17571,
8723
+ * "fight_id": null
8724
+ * }
8725
+ * ],
8726
+ * "meta": {
8727
+ * "truncated": false
8728
+ * }
8729
+ * }
8730
+ */
8731
+ "application/json": components["schemas"]["FighterPowerIndexResponse"];
7315
8732
  };
7316
8733
  };
7317
8734
  /** @description Not Modified — `If-None-Match` matched the current weak `ETag`. Empty body. */
@@ -7385,7 +8802,7 @@ interface paths {
7385
8802
  patch?: never;
7386
8803
  trace?: never;
7387
8804
  };
7388
- "/v1/fighters/{idOrSlug}/rankings": {
8805
+ "/v1/fighters/{idOrSlug}/discipline": {
7389
8806
  parameters: {
7390
8807
  query?: never;
7391
8808
  header?: never;
@@ -7393,16 +8810,16 @@ interface paths {
7393
8810
  cookie?: never;
7394
8811
  };
7395
8812
  /**
7396
- * Ranking history
7397
- * @description Official-board rows over time (`org`, `board` in the public vocabulary — `official` / `meta` — `division` slug, `snapshot_date`, `rank`, `is_champion`), newest snapshot first. Rank 0 = champion; a snapshot is valid until superseded. Cursor-paginated since 2026-09-24 (`limit` 1–500, default 100) — long careers exceed the old silent 500-row cap.
8813
+ * Discipline: fouls committed and drawn (Pro+)
8814
+ * @description The confirmed fouls in a fighter's UFC bouts, both the ones the fighter committed and the ones committed against them (`drawn`): eye pokes and low blows from the official in-fight log, plus every other foul (an illegal knee to a grounded opponent, an upkick, a headbutt, a bite, a fence grab) that a commission point deduction or the official result confirms. Requires a Pro or Business plan: a lower plan gets 403 `tier_required`, answered before the fighter is looked up.
8815
+ *
8816
+ * `tracked_fights` and `cage_seconds` cover the fighter's settled UFC bouts (Dana White's Contender Series included) that carry a log since `meta.coverage_since` (2018-12-08, the first card whose stoppages carry a reason; earlier bouts are left out, never counted as foul-free). `committed` / `drawn` are `total`, `eye_pokes`, `low_blows` and `other`; `points_deducted` is what the commission has taken from this fighter; `stoppage_sec` is the real time bouts were stopped for this fighter's fouls; `fouls_per_15` is fouls committed per 15 minutes of cage time (null under 5 tracked bouts or 30 minutes). `incidents` lists every confirmed foul, most recent first: `fight_id`, `date`, `event`, `opponent`, `role` (`committed` or `drawn`), `reason` (the foul: `eye_poke`, `low_blow`, `illegal_knee`, `illegal_kick`, `headbutt`, `illegal_strike`, `fence`, `biting`, `other`), `basis` (`log`, `deduction` or `result` — which record confirms it), `round`, `elapsed_sec` (seconds elapsed in the round; null when no stoppage in the log is tied to it), `stoppage_sec`, `points_deducted` and `ended_bout`. `meta.weight_class` is the class the tracked bouts were most often fought at.
8817
+ *
8818
+ * It counts fouls on the record: a referee stoppage the log labels, a point the commission took, or the foul a bout ended on. A stoppage the log calls `generic` with no such record behind it is never counted, and a warning given in passing is in no record. **A recorded foul is not a ruling on intent.** Zero is a result: a fighter with tracked bouts and no fouls gets zeros. `data` is null (with `meta.note`) only under 3 tracked bouts with no recorded foul. `meta.source` is `ufc-official`. The example lists two of the fighter's seven incidents.
7398
8819
  */
7399
8820
  get: {
7400
8821
  parameters: {
7401
- query?: {
7402
- /** @description Opaque cursor from `meta.pagination.next_cursor`. */
7403
- cursor?: string;
7404
- limit?: number;
7405
- };
8822
+ query?: never;
7406
8823
  header?: never;
7407
8824
  path: {
7408
8825
  /** @description Numeric id or slug of the fighter. Stale slugs 308-redirect to the canonical URL. */
@@ -7412,7 +8829,7 @@ interface paths {
7412
8829
  };
7413
8830
  requestBody?: never;
7414
8831
  responses: {
7415
- /** @description Ranking rows */
8832
+ /** @description The discipline record, or null */
7416
8833
  200: {
7417
8834
  headers: {
7418
8835
  /** @description Weak validator over the body, e.g. `W/"GKrimLo826WBqG27jbNFsW2ZHmA"`. Send it back as `If-None-Match` to get a 304. */
@@ -7432,27 +8849,77 @@ interface paths {
7432
8849
  content: {
7433
8850
  /**
7434
8851
  * @example {
7435
- * "data": [
7436
- * {
7437
- * "org": "ufc",
7438
- * "board": "official",
7439
- * "division": "heavyweight",
7440
- * "snapshot_date": "2025-06-17",
7441
- * "rank": 0,
7442
- * "is_champion": true
7443
- * }
7444
- * ],
8852
+ * "data": {
8853
+ * "tracked_fights": 10,
8854
+ * "cage_seconds": 11549,
8855
+ * "committed": {
8856
+ * "total": 7,
8857
+ * "eye_pokes": 3,
8858
+ * "low_blows": 3,
8859
+ * "other": 1
8860
+ * },
8861
+ * "drawn": {
8862
+ * "total": 0,
8863
+ * "eye_pokes": 0,
8864
+ * "low_blows": 0,
8865
+ * "other": 0
8866
+ * },
8867
+ * "points_deducted": 1,
8868
+ * "stoppage_sec": 166,
8869
+ * "fouls_per_15": 0.546,
8870
+ * "incidents": [
8871
+ * {
8872
+ * "fight_id": 59652,
8873
+ * "date": "2023-03-18",
8874
+ * "event": {
8875
+ * "slug": "ufc-286-2023-03-18",
8876
+ * "title": "UFC 286: Edwards vs Usman 3"
8877
+ * },
8878
+ * "opponent": {
8879
+ * "slug": "kamaru-usman",
8880
+ * "name": "Kamaru Usman"
8881
+ * },
8882
+ * "role": "committed",
8883
+ * "reason": "fence",
8884
+ * "basis": "deduction",
8885
+ * "round": 3,
8886
+ * "elapsed_sec": 90,
8887
+ * "stoppage_sec": 48,
8888
+ * "points_deducted": 1,
8889
+ * "ended_bout": false
8890
+ * },
8891
+ * {
8892
+ * "fight_id": 59652,
8893
+ * "date": "2023-03-18",
8894
+ * "event": {
8895
+ * "slug": "ufc-286-2023-03-18",
8896
+ * "title": "UFC 286: Edwards vs Usman 3"
8897
+ * },
8898
+ * "opponent": {
8899
+ * "slug": "kamaru-usman",
8900
+ * "name": "Kamaru Usman"
8901
+ * },
8902
+ * "role": "committed",
8903
+ * "reason": "low_blow",
8904
+ * "basis": "log",
8905
+ * "round": 3,
8906
+ * "elapsed_sec": 175,
8907
+ * "stoppage_sec": 23,
8908
+ * "points_deducted": 0,
8909
+ * "ended_bout": false
8910
+ * }
8911
+ * ]
8912
+ * },
7445
8913
  * "meta": {
7446
- * "note": "rank 0 = champion; a snapshot is valid until superseded",
7447
- * "pagination": {
7448
- * "next_cursor": "eyJpZCI6MTAwfQ",
7449
- * "has_more": true,
7450
- * "limit": 100
7451
- * }
8914
+ * "fighter_id": 401,
8915
+ * "source": "ufc-official",
8916
+ * "coverage_since": "2018-12-08",
8917
+ * "weight_class": "Welterweight",
8918
+ * "note": "UFC bouts only. Counts fouls on the official record: eye pokes and low blows from the official in-fight log, plus any other foul (illegal knee, upkick, headbutt, fence grab, ...) confirmed by a commission point deduction or by the result the bout ended on. A recorded foul is not a ruling on intent. fouls_per_15 needs 5 tracked bouts and 30 minutes of cage time."
7452
8919
  * }
7453
8920
  * }
7454
8921
  */
7455
- "application/json": components["schemas"]["FighterRankingsResponse"];
8922
+ "application/json": components["schemas"]["FighterDisciplineResponse"];
7456
8923
  };
7457
8924
  };
7458
8925
  /** @description Not Modified — `If-None-Match` matched the current weak `ETag`. Empty body. */
@@ -7471,15 +8938,6 @@ interface paths {
7471
8938
  };
7472
8939
  content?: never;
7473
8940
  };
7474
- /** @description Invalid input (`invalid_cursor`). */
7475
- 400: {
7476
- headers: {
7477
- [name: string]: unknown;
7478
- };
7479
- content: {
7480
- "application/json": components["schemas"]["Error"];
7481
- };
7482
- };
7483
8941
  /** @description Missing/invalid API key (`unauthorized`). */
7484
8942
  401: {
7485
8943
  headers: {
@@ -7489,7 +8947,7 @@ interface paths {
7489
8947
  "application/json": components["schemas"]["Error"];
7490
8948
  };
7491
8949
  };
7492
- /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (100 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
8950
+ /** @description Requires a Pro or Business plan (`tier_required`). Answered before the fight or fighter is looked up. */
7493
8951
  403: {
7494
8952
  headers: {
7495
8953
  [name: string]: unknown;
@@ -7535,7 +8993,7 @@ interface paths {
7535
8993
  patch?: never;
7536
8994
  trace?: never;
7537
8995
  };
7538
- "/v1/fighters/{idOrSlug}/power-index": {
8996
+ "/v1/fighters/{idOrSlug}/positions": {
7539
8997
  parameters: {
7540
8998
  query?: never;
7541
8999
  header?: never;
@@ -7543,8 +9001,10 @@ interface paths {
7543
9001
  cookie?: never;
7544
9002
  };
7545
9003
  /**
7546
- * Power Index trajectory
7547
- * @description Per-bout rating history from the UFCalendar Power Index engine (rating before/after, model win probability, `outcome` 1 / 0 / 0.5 and its word twin `result`). The NEWEST 500 points, served oldest-first; `meta.truncated` is true when an older tail was dropped.
9004
+ * Career position profile: time by range, control for and against (Pro+)
9005
+ * @description Where a fighter's bouts happen, over their career: the share of cage time at distance, in the clinch and on the ground, and who held control in each position — the fighter (`for_sec`) against their opponents (`against_sec`). Computed over the fighter's settled bouts whose positions were tracked in the official UFC fight statistics (reliably from 2007). Requires a Pro or Business plan: a lower plan gets 403 `tier_required`, answered before the fighter is looked up.
9006
+ *
9007
+ * `tracked_fights` and `cage_seconds` say how much that is. `time` carries `distance_sec` / `clinch_sec` / `ground_sec` and their 0–1 shares of `cage_seconds`. `control.for_sec` / `against_sec` are total control time; `control.by_position` splits it into `back`, `mount`, `side`, `half_guard`, `guard` and `clinch` (a position with under 10 seconds either way is left out, and ground control outside the named positions is in the totals only). `data` is null (with `meta.note`) under 3 bouts with tracked positions. `meta.source` is `ufc-official`.
7548
9008
  */
7549
9009
  get: {
7550
9010
  parameters: {
@@ -7558,7 +9018,7 @@ interface paths {
7558
9018
  };
7559
9019
  requestBody?: never;
7560
9020
  responses: {
7561
- /** @description Rating points */
9021
+ /** @description The position profile, or null */
7562
9022
  200: {
7563
9023
  headers: {
7564
9024
  /** @description Weak validator over the body, e.g. `W/"GKrimLo826WBqG27jbNFsW2ZHmA"`. Send it back as `If-None-Match` to get a 304. */
@@ -7578,24 +9038,62 @@ interface paths {
7578
9038
  content: {
7579
9039
  /**
7580
9040
  * @example {
7581
- * "data": [
7582
- * {
7583
- * "fought_at": "2008-04-12",
7584
- * "rating_pre": 1500,
7585
- * "rating_post": 1536,
7586
- * "win_prob": 0.5535,
7587
- * "outcome": 1,
7588
- * "result": "win",
7589
- * "opponent_fighter_id": 17571,
7590
- * "fight_id": null
9041
+ * "data": {
9042
+ * "tracked_fights": 20,
9043
+ * "cage_seconds": 20136,
9044
+ * "time": {
9045
+ * "distance_sec": 9885,
9046
+ * "clinch_sec": 4171,
9047
+ * "ground_sec": 6080,
9048
+ * "distance_share": 0.491,
9049
+ * "clinch_share": 0.207,
9050
+ * "ground_share": 0.302
9051
+ * },
9052
+ * "control": {
9053
+ * "for_sec": 4226,
9054
+ * "against_sec": 5353,
9055
+ * "by_position": [
9056
+ * {
9057
+ * "position": "back",
9058
+ * "for_sec": 619,
9059
+ * "against_sec": 715
9060
+ * },
9061
+ * {
9062
+ * "position": "mount",
9063
+ * "for_sec": 51,
9064
+ * "against_sec": 293
9065
+ * },
9066
+ * {
9067
+ * "position": "side",
9068
+ * "for_sec": 10,
9069
+ * "against_sec": 133
9070
+ * },
9071
+ * {
9072
+ * "position": "half_guard",
9073
+ * "for_sec": 470,
9074
+ * "against_sec": 702
9075
+ * },
9076
+ * {
9077
+ * "position": "guard",
9078
+ * "for_sec": 387,
9079
+ * "against_sec": 437
9080
+ * },
9081
+ * {
9082
+ * "position": "clinch",
9083
+ * "for_sec": 1544,
9084
+ * "against_sec": 1957
9085
+ * }
9086
+ * ]
7591
9087
  * }
7592
- * ],
9088
+ * },
7593
9089
  * "meta": {
7594
- * "truncated": false
9090
+ * "fighter_id": 401,
9091
+ * "source": "ufc-official",
9092
+ * "note": "Whole-bout position stats over UFC-feed bouts whose positions were tracked (reliably from 2007). `control.for_sec` is this fighter in control, `against_sec` their opponents."
7595
9093
  * }
7596
9094
  * }
7597
9095
  */
7598
- "application/json": components["schemas"]["FighterPowerIndexResponse"];
9096
+ "application/json": components["schemas"]["FighterPositionsResponse"];
7599
9097
  };
7600
9098
  };
7601
9099
  /** @description Not Modified — `If-None-Match` matched the current weak `ETag`. Empty body. */
@@ -7623,7 +9121,7 @@ interface paths {
7623
9121
  "application/json": components["schemas"]["Error"];
7624
9122
  };
7625
9123
  };
7626
- /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (100 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
9124
+ /** @description Requires a Pro or Business plan (`tier_required`). Answered before the fight or fighter is looked up. */
7627
9125
  403: {
7628
9126
  headers: {
7629
9127
  [name: string]: unknown;
@@ -8913,7 +10411,7 @@ interface paths {
8913
10411
  };
8914
10412
  /**
8915
10413
  * One stat leaderboard
8916
- * @description One board from UFCalendar's Record Book rollup (rebuilt daily) for ONE promotion — `org` is required; there is no cross-promotion board on the API. `metric` picks the board; its `scope` decides what a row is: `career` rows are fighters, `single_fight` and `round` rows are PERFORMANCES (one fighter can hold several; `fight` names the bout and opponent, `round_number` the round), `event` rows are CARDS (`event`, no fighter), `division` rows are WEIGHT CLASSES (`division`, no fighter). `value` is in `meta.metric.unit` (`rate` is a 0–1 fraction; `seconds`, `per_minute`, `per_15_minutes` as named); `value_secondary` is the denominator or context named by `meta.metric.secondary` (e.g. attempts behind an accuracy, the round of a fastest finish); `sample_n` is the bouts (or fighters) behind the value. `direction` is the ranking order, not a verdict. `rank` is the rollup's own position; equal values are a tie — `display_rank` and `tied` say so. Narrow with `division`, `country` (ISO-2, fighters of that nationality; population `all` only — combining it with `population=active` 400s `invalid_filter`) or `population=active` (a bout in the last ~18 months). Boards need a minimum sample, so a narrow slice can 404. Errors: `invalid_org`, `invalid_metric`, `invalid_division`, `invalid_country`, `invalid_population`, `invalid_filter`.
10414
+ * @description One board from UFCalendar's Record Book rollup (rebuilt daily) for ONE promotion — `org` is required; there is no cross-promotion board on the API. `metric` picks the board; its `scope` decides what a row is: `career` rows are fighters, `single_fight` and `round` rows are PERFORMANCES (one fighter can hold several; `fight` names the bout and opponent, `round_number` the round), `event` rows are CARDS (`event`, no fighter), `division` rows are WEIGHT CLASSES (`division`, no fighter). `value` is in `meta.metric.unit` (`rate` is a 0–1 fraction; `seconds`, `per_minute`, `per_15_minutes` as named); `value_secondary` is the denominator or context named by `meta.metric.secondary` (e.g. attempts behind an accuracy, the round of a fastest finish); `sample_n` is the bouts (or fighters) behind the value. `direction` is the ranking order, not a verdict. `rank` is the rollup's own position; equal values are a tie — `display_rank` and `tied` say so. Narrow with `division`, `country` (ISO-2, fighters of that nationality; population `all` only — combining it with `population=active` 400s `invalid_filter`) or `population=active` (a bout in the last ~18 months). Boards need a minimum sample, so a narrow slice can 404. Errors: `invalid_org`, `invalid_metric`, `invalid_division`, `invalid_country`, `invalid_population`, `invalid_filter`. The `discipline` boards (confirmed fouls — eye pokes and low blows from the official in-fight log, plus any other foul a commission point deduction or the official result confirms — UFC only, December 2018 onward) need a Pro plan or higher: 403 `tier_required` below.
8917
10415
  */
8918
10416
  get: {
8919
10417
  parameters: {
@@ -8921,7 +10419,7 @@ interface paths {
8921
10419
  /** @description Launch org slug (required): `ufc`, `pfl`, `oktagon`, `bkfc` or `rizin`. */
8922
10420
  org: "ufc" | "pfl" | "oktagon" | "bkfc" | "rizin";
8923
10421
  /** @description Board metric slug. */
8924
- metric: "total_fights" | "wins" | "decision_wins" | "title_fight_wins" | "bonuses" | "finishes" | "win_streak" | "total_fight_seconds" | "avg_fight_seconds_short" | "avg_fight_seconds_long" | "control_time_sec" | "control_time_pct" | "sig_strikes_landed" | "total_strikes_landed" | "slpm" | "sapm" | "striking_differential" | "sig_strike_accuracy" | "sig_strike_defense" | "knockdowns" | "knockdowns_per_15" | "knockouts" | "takedowns_landed" | "td_avg" | "takedown_accuracy" | "takedown_defense" | "submission_attempts" | "sub_avg_per_15" | "submissions" | "fastest_finish" | "fastest_knockout" | "fastest_submission" | "longest_fight_seconds" | "most_sig_strikes_fight" | "most_takedowns_fight" | "most_knockdowns_fight" | "longest_control_fight" | "most_sig_strikes_round" | "most_takedowns_round" | "most_knockdowns_round" | "most_finishes_event" | "most_knockouts_event" | "shortest_card_seconds" | "finish_rate" | "ko_rate" | "sub_rate" | "decision_rate" | "avg_fight_seconds";
10422
+ metric: "total_fights" | "wins" | "decision_wins" | "title_fight_wins" | "bonuses" | "finishes" | "win_streak" | "total_fight_seconds" | "avg_fight_seconds_short" | "avg_fight_seconds_long" | "control_time_sec" | "control_time_pct" | "sig_strikes_landed" | "total_strikes_landed" | "slpm" | "sapm" | "striking_differential" | "sig_strike_accuracy" | "sig_strike_defense" | "knockdowns" | "knockdowns_per_15" | "knockouts" | "takedowns_landed" | "td_avg" | "takedown_accuracy" | "takedown_defense" | "submission_attempts" | "sub_avg_per_15" | "submissions" | "fastest_finish" | "fastest_knockout" | "fastest_submission" | "longest_fight_seconds" | "most_sig_strikes_fight" | "most_takedowns_fight" | "most_knockdowns_fight" | "longest_control_fight" | "most_sig_strikes_round" | "most_takedowns_round" | "most_knockdowns_round" | "fouls_committed" | "eye_pokes_committed" | "low_blows_committed" | "fouls_drawn" | "fouls_per_15" | "most_fouls_fight" | "longest_foul_stoppage_fight" | "most_fouls_event" | "most_finishes_event" | "most_knockouts_event" | "shortest_card_seconds" | "finish_rate" | "ko_rate" | "sub_rate" | "decision_rate" | "avg_fight_seconds" | "fouls_per_15_division";
8925
10423
  /** @description One weight class. */
8926
10424
  division?: "strawweight" | "flyweight" | "bantamweight" | "featherweight" | "lightweight" | "welterweight" | "super-welterweight" | "middleweight" | "light-heavyweight" | "heavyweight" | "super-heavyweight" | "womens-strawweight" | "womens-flyweight" | "womens-bantamweight" | "womens-featherweight" | "atomweight" | "ironweight";
8927
10425
  /** @description `active` = fighters with a bout in the last ~18 months. */
@@ -9040,7 +10538,7 @@ interface paths {
9040
10538
  "application/json": components["schemas"]["Error"];
9041
10539
  };
9042
10540
  };
9043
- /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (100 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
10541
+ /** @description Requires Pro or above (`tier_required`), or a plan bought directly rather than through RapidAPI (`direct_plan_required`). */
9044
10542
  403: {
9045
10543
  headers: {
9046
10544
  [name: string]: unknown;
@@ -9095,7 +10593,7 @@ interface paths {
9095
10593
  };
9096
10594
  /**
9097
10595
  * The Record Book
9098
- * @description Every leaderboard's top rows for ONE promotion in one call — `org` is required — grouped by category (`fights`, `time`, `striking`, `grappling`, `records`): `data` is `[{ category, boards: [{ metric, rows }] }]`, rows exactly as on `/v1/stats/leaders`. `top` rows per board (default 10, max 25). Same `division` / `country` / `population` narrowing as `/v1/stats/leaders`, plus `scope` for one kind of board (`career`, `single_fight`, `round`, `division`, `event`). A board appears only when it has at least 3 rows (or `top`, if smaller); inside one `division`, the division-ranking boards are left out. An empty slice returns `[]` with `meta.note`.
10596
+ * @description Every leaderboard's top rows for ONE promotion in one call — `org` is required — grouped by category (`fights`, `time`, `striking`, `grappling`, `discipline`, `records`; `discipline` is included on Pro plans and above and simply absent below, with `meta.plan_note`): `data` is `[{ category, boards: [{ metric, rows }] }]`, rows exactly as on `/v1/stats/leaders`. `top` rows per board (default 10, max 25). Same `division` / `country` / `population` narrowing as `/v1/stats/leaders`, plus `scope` for one kind of board (`career`, `single_fight`, `round`, `division`, `event`). A board appears only when it has at least 3 rows (or `top`, if smaller); inside one `division`, the division-ranking boards are left out. An empty slice returns `[]` with `meta.note`.
9099
10597
  */
9100
10598
  get: {
9101
10599
  parameters: {
@@ -10822,7 +12320,7 @@ interface paths {
10822
12320
  put?: never;
10823
12321
  /**
10824
12322
  * Register a webhook endpoint
10825
- * @description Pro+. Body: `{"url": "https://...", "events": ["event.announced", "fight.result", "card.changed", "event.completed", "odds.moved"]}`. Subscribe to `event.announced` and you do not need to poll `/v1/events` to discover new cards — it fires once, within a minute of a card first landing in our data, and carries the same event object the list endpoint returns. `fight.result` fires once per bout within a minute of the result, as `revision` 1, and again as the next revision (`corrected: true`, with the `previous` result) whenever the winner, method, round, time or status is corrected in the 72 h after it — upsert on `fight_id` and keep the highest `revision`. `odds.moved` fires when the UFCalendar consensus line on an upcoming bout moves at least 5 implied-probability points on corner a, or the favourite flips, measured against the last line we delivered for that bout (its opening line before the first delivery), so a slow drift arrives once, not per refresh: `data` is `{fight_id, event, fighter_a, fighter_b, odds: {consensus, opening, movement, updated_at}, previous, delta_points_a, direction, favourite_flipped, moved_at}`. Information only, not betting advice. The response contains the signing `secret` ONCE. Every delivery body is `{"id", "type", "data", "sent_at"}` (`WebhookDelivery` schema) — `id` is stable across retries, so deduplicate on it. Deliveries carry `X-UFCalendar-Signature: t=<unix>,v1=<hmac>` where the HMAC-SHA256 input is `"<t>.<rawBody>"`. **Verify the timestamp too**: reject anything where `|now - t|` exceeds 300 seconds, otherwise a captured delivery can be replayed at you forever with a valid HMAC. Delivery is at-least-once — expect a retry roughly every 60s until your endpoint returns 2xx. Endpoints auto-disable after 20 consecutive failures, and you may hold at most 3 active endpoints (409 `endpoint_limit`). Latency: results are dispatched within ~1 minute of the result being recorded. `event.announced` only fires for cards that have not started yet, so archive backfills never reach you as new-card noise. `card.changed` is filtered the same way: a change whose before and after read identically (a venue row re-minted for the same arena, a source dropping a sub-time it never knew) is never delivered, and when a source flip-flops a value we deliver the move and its undo once, not the twentieth repeat. Deliveries are free — they never count against your monthly request quota, only the calls you make to manage endpoints do.
12323
+ * @description Pro+. Body: `{"url": "https://...", "events": ["event.announced", "fight.result", "card.changed", "event.completed", "odds.moved"]}`. Subscribe to `event.announced` and you do not need to poll `/v1/events` to discover new cards — it fires once, within a minute of a card first landing in our data, and carries the same event object the list endpoint returns. `fight.result` fires once per bout within a minute of the result, as `revision` 1, and again as the next revision (`corrected: true`, with the `previous` result) whenever the winner, method, round, time or status is corrected in the 72 h after it — upsert on `fight_id` and keep the highest `revision`. `odds.moved` fires when the UFCalendar consensus line on an upcoming bout moves at least 5 implied-probability points on corner a, or the favourite flips, measured against the last line we delivered for that bout (its opening line before the first delivery), so a slow drift arrives once, not per refresh: `data` is `{fight_id, event, fighter_a, fighter_b, odds: {consensus, opening, movement, updated_at}, previous, delta_points_a, direction, favourite_flipped, moved_at}`. Information only, not betting advice. The response contains the signing `secret` ONCE. Every delivery body is `{"id", "type", "data", "sent_at"}` (`WebhookDelivery` schema) — `id` is stable across retries, so deduplicate on it. Deliveries carry `X-UFCalendar-Signature: t=<unix>,v1=<hmac>` where the HMAC-SHA256 input is `"<t>.<rawBody>"`. **Verify the timestamp too**: reject anything where `|now - t|` exceeds 300 seconds, otherwise a captured delivery can be replayed at you forever with a valid HMAC. Delivery is at-least-once — expect a retry roughly every 60s until your endpoint returns 2xx. Endpoints auto-disable after 20 consecutive failures, and you may hold at most 3 active endpoints (409 `endpoint_limit`). Latency: results are dispatched within ~1 minute of the result being recorded. `event.announced` only fires for cards that have not started yet, and `fight.result` / `event.completed` only for cards that started in the last 7 days, so archive backfills never reach you as new-card or new-result noise. `card.changed` is filtered the same way: a change whose before and after read identically (a venue row re-minted for the same arena, a source dropping a sub-time it never knew) is never delivered, and when a source flip-flops a value we deliver the move and its undo once, not the twentieth repeat. Deliveries are free — they never count against your monthly request quota, only the calls you make to manage endpoints do.
10826
12324
  */
10827
12325
  post: {
10828
12326
  parameters: {
@@ -11279,7 +12777,7 @@ interface components {
11279
12777
  */
11280
12778
  EventStatus: "announced" | "scheduled" | "live" | "completed" | "cancelled" | "postponed";
11281
12779
  /**
11282
- * @description What `?status=` accepts on the event lists: every `EventStatus`, plus `upcoming` = announced, scheduled or live cards that have not finished (the site's upcoming-or-live window: started under 6 h ago, or under 14 h ago with a bout still to fight). `upcoming` is a filter only — it never appears on an event.
12780
+ * @description What `?status=` accepts on the event lists: every `EventStatus`, plus `upcoming` = announced, scheduled or live cards that have not finished (the site's upcoming-or-live window: started under 6 h ago, or under 14 h ago with a bout still to fight). `upcoming` is a filter only — it never appears on an event. `scheduled` matches both pre-fight statuses (`announced` or `scheduled`).
11283
12781
  * @enum {string}
11284
12782
  */
11285
12783
  EventStatusFilter: "announced" | "scheduled" | "live" | "completed" | "cancelled" | "postponed" | "upcoming";
@@ -11452,8 +12950,11 @@ interface components {
11452
12950
  /** @description ISO-2 derived from `country`. */
11453
12951
  country_code: string | null;
11454
12952
  tz: string | null;
12953
+ /** @description Seating capacity when a source publishes it; null for most venues. */
11455
12954
  capacity: number | null;
12955
+ /** @description Latitude: the venue's own point when the promotion publishes it, else its city's centre. */
11456
12956
  lat: number | null;
12957
+ /** @description Longitude; same precision rule as `lat`. */
11457
12958
  lng: number | null;
11458
12959
  };
11459
12960
  /** @description Event-scoped broadcast row. */
@@ -11529,8 +13030,10 @@ interface components {
11529
13030
  /** @description Source spelling (`Decision - Split`, `KO/TKO`, `Submission (Rear-Naked Choke)`). */
11530
13031
  method: string | null;
11531
13032
  method_normalized: components["schemas"]["MethodNormalized"] | null;
11532
- /** @description The parenthesised / trailing detail of `method`, cleaned (`Rear-Naked Choke`, `Doctor's Stoppage`). */
13033
+ /** @description How the bout was finished. On a knockout, submission or disqualification: the technique in ONE spelling per move, whatever the source wrote (`Rear-Naked Choke` for "rear naked choke" / "RNC"; `Arm-Triangle Choke`; `D'Arce Choke` for "Brabo Choke"; `Punch`, `Punches`, `Head Kick`, `Doctor Stoppage`), with the position moved to `finish_position`. On a decision: its type from `method` (`Unanimous`, `Split`). Null when the source recorded neither. */
11533
13034
  finish_detail: string | null;
13035
+ /** @description Where a finish happened, when the source recorded it: `distance`, `clinch`, `ground`, `mount`, `back control`, `side control`, `half guard`, `bottom guard`, `bottom half guard`, `front headlock`, `crucifix`, `north-south`, `standing`, `after drop to guard` / `after drop to half guard` / `after drop to ground`. Null on a decision and when unrecorded. */
13036
+ finish_position: string | null;
11534
13037
  round: number | null;
11535
13038
  /** @description `m:ss` into the round. */
11536
13039
  time: string | null;
@@ -12457,6 +13960,292 @@ interface components {
12457
13960
  opponent_fighter_id: number | null;
12458
13961
  fight_id: number | null;
12459
13962
  };
13963
+ /** @description One row of the official in-fight log. */
13964
+ TimelineAction: {
13965
+ /** @description The official log's own action name, lower-cased. Open vocabulary — a new action lands as a new value: `fight_open`, `walkout`, `tale_of_the_tape`, `staredown`, `round_start`, `round_end`, `takedown`, `takedown_attempt`, `knockdown`, `submission_attempt`, `reversal`, `round_pause`, `pause_reason_eye_poke`, `pause_reason_low_blow`, `pause_reason_doctor`, `pause_reason_generic`, `round_unpause`, `fight_over`, `results`, `fight_complete`, `unofficial_winner_kotko`, `unofficial_winner_submission`, `unofficial_winner_decision`. */
13966
+ type: string;
13967
+ /** @description Round the action belongs to; null for actions outside a round (walkouts, results). */
13968
+ round: number | null;
13969
+ /** @description Seconds elapsed in the round (0 = the bell). Null when the log carries no round clock for the action. */
13970
+ elapsed_sec: number | null;
13971
+ /**
13972
+ * Format: date-time
13973
+ * @description When the action was logged (UTC).
13974
+ */
13975
+ at: string | null;
13976
+ /** @description The fighter the action belongs to; null for referee and broadcast actions. On a `pause_reason_eye_poke` / `pause_reason_low_blow` row it is the fighter who COMMITTED the foul. */
13977
+ fighter_id: number | null;
13978
+ /**
13979
+ * @description `a` = the bout's `fighter_a`, `b` = `fighter_b`; null with `fighter_id`.
13980
+ * @enum {string|null}
13981
+ */
13982
+ corner: "a" | "b" | null;
13983
+ };
13984
+ /**
13985
+ * @description Why the referee stopped the action, as the log labels it. `eye_poke` and `low_blow` are fouls; `doctor` is a doctor check; `generic` is everything else — a lost mouthpiece, a replay, but ALSO any foul the log has no label for (an illegal knee, an upkick, a bite). A `generic` stoppage is a foul only when `is_foul` says so.
13986
+ * @enum {string}
13987
+ */
13988
+ StoppageReason: "eye_poke" | "low_blow" | "doctor" | "generic";
13989
+ /**
13990
+ * @description What the foul was. `eye_poke` and `low_blow` come labelled from the log; the rest are read from the commission's deduction reason or the official result detail: `illegal_knee` (a knee to a grounded opponent), `illegal_kick` (an upkick, a soccer kick or a stomp), `headbutt`, `illegal_strike` (back of the head, spine, 12-6 elbow), `fence` (grabbing the fence or cage), `biting`, and `other` when the record names no foul this vocabulary covers.
13991
+ * @enum {string}
13992
+ */
13993
+ FoulKind: "eye_poke" | "low_blow" | "illegal_knee" | "illegal_kick" | "headbutt" | "illegal_strike" | "fence" | "biting" | "other";
13994
+ /**
13995
+ * @description Which record confirms the foul: `log` = the in-fight log's own eye-poke / low-blow row; `deduction` = the athletic commission took a point for it; `result` = the bout ended on it (a disqualification, or a "could not continue" / no contest whose official detail describes a foul).
13996
+ * @enum {string}
13997
+ */
13998
+ FoulBasis: "log" | "deduction" | "result";
13999
+ /** @description The fighter who committed the foul. */
14000
+ FoulCommitter: {
14001
+ fighter_id: number;
14002
+ /** @enum {string|null} */
14003
+ corner: "a" | "b" | null;
14004
+ };
14005
+ /** @description One referee stoppage: the pause, its reason and the resume, paired — and, when a record confirms it, the foul behind it. */
14006
+ TimelineStoppage: {
14007
+ round: number | null;
14008
+ /** @description Seconds elapsed in the round when the referee stopped the action. */
14009
+ elapsed_sec: number | null;
14010
+ /**
14011
+ * Format: date-time
14012
+ * @description When the action was stopped (UTC).
14013
+ */
14014
+ at: string | null;
14015
+ /**
14016
+ * Format: date-time
14017
+ * @description When it resumed (UTC); null when the bout never resumed.
14018
+ */
14019
+ resumed_at: string | null;
14020
+ /** @description Real seconds the bout was stopped (the fight clock is stopped, so this is wall-clock time). Null when the bout never resumed or the gap is implausible (over 15 minutes). */
14021
+ duration_sec: number | null;
14022
+ /** @description Null = a stoppage logged before reasons were recorded (before 2018-12-08): unlabelled, never "no foul". */
14023
+ reason: components["schemas"]["StoppageReason"] | null;
14024
+ /** @description true when a record confirms this stoppage was for a foul: a labelled `eye_poke` / `low_blow`, or a `generic` / unlabelled stoppage tied to a commission point deduction or to the foul the bout ended on. A `generic` stoppage with no such record is false. */
14025
+ is_foul: boolean;
14026
+ /** @description The confirmed foul; null when `is_foul` is false. */
14027
+ foul: components["schemas"]["FoulKind"] | null;
14028
+ /** @description Null when `is_foul` is false. */
14029
+ foul_basis: components["schemas"]["FoulBasis"] | null;
14030
+ /** @description The fighter who committed the foul. Null when it is not a foul, or when no record names the fighter (an accidental clash of heads). */
14031
+ committed_by: components["schemas"]["FoulCommitter"] | null;
14032
+ /** @description Points the commission deducted for this foul; 0 when none. */
14033
+ points_deducted: number;
14034
+ /** @description true when the bout ended on this foul (a disqualification or a "could not continue"). */
14035
+ ended_bout: boolean;
14036
+ };
14037
+ /** @description One confirmed foul. A foul is listed once: a deduction for a logged low blow adds its points to that foul, and a result that names a foul already listed marks it `ended_bout`. */
14038
+ FoulIncident: {
14039
+ foul: components["schemas"]["FoulKind"];
14040
+ basis: components["schemas"]["FoulBasis"];
14041
+ /** @description Null when no record names the fighter. */
14042
+ committed_by: components["schemas"]["FoulCommitter"] | null;
14043
+ round: number | null;
14044
+ /** @description Seconds elapsed in the round. Null when no stoppage in the log is tied to the foul (a point deducted for grabbing the fence with no pause logged). */
14045
+ elapsed_sec: number | null;
14046
+ /** @description Real seconds the bout was stopped for it; null when unmeasured. */
14047
+ stoppage_sec: number | null;
14048
+ points_deducted: number;
14049
+ ended_bout: boolean;
14050
+ };
14051
+ /** @description Fouls one corner COMMITTED in the bout. A recorded foul is not a ruling on intent. */
14052
+ FoulTally: {
14053
+ fighter_id: number | null;
14054
+ /** @description Eye pokes this fighter committed that stopped the action. */
14055
+ eye_pokes: number;
14056
+ /** @description Low blows this fighter committed that stopped the action. */
14057
+ low_blows: number;
14058
+ /** @description Every other confirmed foul this fighter committed (see `FoulKind`). */
14059
+ other: number;
14060
+ /** @description `eye_pokes` + `low_blows` + `other`. */
14061
+ total: number;
14062
+ /** @description Points the commission took from this fighter in the bout. */
14063
+ points_deducted: number;
14064
+ /** @description Real seconds the bout was stopped for this fighter's fouls. */
14065
+ stoppage_sec: number;
14066
+ };
14067
+ FightTimeline: {
14068
+ /** @description Round length for the bout's sport, in seconds (300 for MMA) — the scale `elapsed_sec` runs on. */
14069
+ round_seconds: number;
14070
+ /** @description Every logged action, in the order it happened. */
14071
+ actions: components["schemas"]["TimelineAction"][];
14072
+ /** @description Referee stoppages, in order. */
14073
+ stoppages: components["schemas"]["TimelineStoppage"][];
14074
+ /** @description Every confirmed foul of the bout in fight order — including fouls with no stoppage in the log and fouls nobody is named for. */
14075
+ incidents: components["schemas"]["FoulIncident"][];
14076
+ fouls: {
14077
+ a: components["schemas"]["FoulTally"];
14078
+ b: components["schemas"]["FoulTally"];
14079
+ };
14080
+ };
14081
+ StrikeCount: {
14082
+ landed: number | null;
14083
+ attempted: number | null;
14084
+ };
14085
+ /** @description Where the bout (or round) was fought, in whole seconds. Shared by both fighters: `standing_sec` + `ground_sec` = fight time. */
14086
+ PositionTime: {
14087
+ /** @description `distance_sec` + `clinch_sec`. */
14088
+ standing_sec: number | null;
14089
+ distance_sec: number | null;
14090
+ clinch_sec: number | null;
14091
+ ground_sec: number | null;
14092
+ /** @description Time nobody held control. */
14093
+ neutral_sec: number | null;
14094
+ };
14095
+ /** @description Seconds THIS fighter held control, by position. */
14096
+ PositionControl: {
14097
+ /** @description `clinch_sec` + `ground_sec`. */
14098
+ total_sec: number | null;
14099
+ clinch_sec: number | null;
14100
+ /** @description `back_sec` + `mount_sec` + `side_sec` + `half_guard_sec` + `guard_sec` + `misc_ground_sec`. */
14101
+ ground_sec: number | null;
14102
+ back_sec: number | null;
14103
+ mount_sec: number | null;
14104
+ side_sec: number | null;
14105
+ half_guard_sec: number | null;
14106
+ guard_sec: number | null;
14107
+ misc_ground_sec: number | null;
14108
+ };
14109
+ StrikesByTarget: {
14110
+ head: components["schemas"]["StrikeCount"];
14111
+ body: components["schemas"]["StrikeCount"];
14112
+ leg: components["schemas"]["StrikeCount"];
14113
+ };
14114
+ /** @description Significant strikes by position, then target. */
14115
+ PositionSigStrikes: {
14116
+ distance: components["schemas"]["StrikesByTarget"];
14117
+ clinch: components["schemas"]["StrikesByTarget"];
14118
+ ground: components["schemas"]["StrikesByTarget"];
14119
+ };
14120
+ /** @description Total strikes (significant or not) by target, plus the clinch and ground totals. */
14121
+ PositionTotalStrikes: {
14122
+ head: components["schemas"]["StrikeCount"];
14123
+ body: components["schemas"]["StrikeCount"];
14124
+ leg: components["schemas"]["StrikeCount"];
14125
+ clinch: components["schemas"]["StrikeCount"];
14126
+ ground: components["schemas"]["StrikeCount"];
14127
+ };
14128
+ /** @description One fighter's position stats for a bout or a round. null = not tracked for that bout; 0 = a real zero. */
14129
+ PositionStatLine: {
14130
+ fighter_id: number | null;
14131
+ /**
14132
+ * @description `a` = the bout's `fighter_a`, `b` = `fighter_b`.
14133
+ * @enum {string|null}
14134
+ */
14135
+ corner: "a" | "b" | null;
14136
+ time: components["schemas"]["PositionTime"];
14137
+ control: components["schemas"]["PositionControl"];
14138
+ sig_strikes: components["schemas"]["PositionSigStrikes"];
14139
+ total_strikes: components["schemas"]["PositionTotalStrikes"];
14140
+ };
14141
+ PositionRound: {
14142
+ round: number;
14143
+ /** @description Corner a, then b. */
14144
+ fighters: components["schemas"]["PositionStatLine"][];
14145
+ };
14146
+ FightPositions: {
14147
+ /** @description The whole bout: one line per fighter, corner a then b. Empty when positions were not tracked. */
14148
+ totals: components["schemas"]["PositionStatLine"][];
14149
+ /** @description The same lines per round, in round order. */
14150
+ rounds: components["schemas"]["PositionRound"][];
14151
+ };
14152
+ FoulCounts: {
14153
+ /** @description `eye_pokes` + `low_blows` + `other`. */
14154
+ total: number;
14155
+ eye_pokes: number;
14156
+ low_blows: number;
14157
+ /** @description Every other confirmed foul (see `FoulKind`). */
14158
+ other: number;
14159
+ };
14160
+ /**
14161
+ * @description `committed` = by this fighter; `drawn` = by the opponent, against this fighter.
14162
+ * @enum {string}
14163
+ */
14164
+ DisciplineRole: "committed" | "drawn";
14165
+ DisciplineEvent: {
14166
+ slug: string;
14167
+ title: string;
14168
+ };
14169
+ DisciplineOpponent: {
14170
+ slug: string | null;
14171
+ name: string | null;
14172
+ };
14173
+ DisciplineIncident: {
14174
+ fight_id: number;
14175
+ /**
14176
+ * Format: date
14177
+ * @description UTC day of the card's `starts_at`.
14178
+ */
14179
+ date: string;
14180
+ event: components["schemas"]["DisciplineEvent"];
14181
+ opponent: components["schemas"]["DisciplineOpponent"];
14182
+ role: components["schemas"]["DisciplineRole"];
14183
+ /** @description What the foul was. */
14184
+ reason: components["schemas"]["FoulKind"];
14185
+ basis: components["schemas"]["FoulBasis"];
14186
+ round: number | null;
14187
+ /** @description Seconds elapsed in the round; null when no stoppage in the log is tied to the foul. */
14188
+ elapsed_sec: number | null;
14189
+ /** @description Real seconds the bout was stopped; null if it never resumed or was not timed. */
14190
+ stoppage_sec: number | null;
14191
+ /** @description Points the commission deducted for it; 0 when none. */
14192
+ points_deducted: number;
14193
+ /** @description true when the bout ended on this foul. */
14194
+ ended_bout: boolean;
14195
+ };
14196
+ /** @description Confirmed fouls in a fighter's UFC bouts: the log's eye pokes and low blows, plus any other foul a commission point deduction or the official result confirms. A recorded foul is not a ruling on intent. */
14197
+ FighterDiscipline: {
14198
+ /** @description Settled UFC bouts since the coverage date that carry an in-fight log. */
14199
+ tracked_fights: number;
14200
+ /** @description Seconds fought across those bouts. */
14201
+ cage_seconds: number;
14202
+ committed: components["schemas"]["FoulCounts"];
14203
+ drawn: components["schemas"]["FoulCounts"];
14204
+ /** @description Points the commission has taken from THIS fighter across those bouts. */
14205
+ points_deducted: number;
14206
+ /** @description Real seconds bouts were stopped for THIS fighter's fouls. */
14207
+ stoppage_sec: number;
14208
+ /** @description Fouls committed per 15 minutes of cage time, to 3 places. Null under the sample floor (5 tracked bouts and 30 minutes). */
14209
+ fouls_per_15: number | null;
14210
+ /** @description Every confirmed foul this fighter committed or drew, most recent first. */
14211
+ incidents: components["schemas"]["DisciplineIncident"][];
14212
+ };
14213
+ /**
14214
+ * @description A position a fighter can hold control in.
14215
+ * @enum {string}
14216
+ */
14217
+ ControlPosition: "back" | "mount" | "side" | "half_guard" | "guard" | "clinch";
14218
+ ControlByPosition: {
14219
+ position: components["schemas"]["ControlPosition"];
14220
+ for_sec: number;
14221
+ against_sec: number;
14222
+ };
14223
+ FighterPositionTime: {
14224
+ distance_sec: number;
14225
+ clinch_sec: number;
14226
+ ground_sec: number;
14227
+ /** @description Share of `cage_seconds`, 0–1 to 3 places. */
14228
+ distance_share: number | null;
14229
+ clinch_share: number | null;
14230
+ ground_share: number | null;
14231
+ };
14232
+ FighterPositionControl: {
14233
+ /** @description Seconds this fighter held control. */
14234
+ for_sec: number;
14235
+ /** @description Seconds their opponents held control. */
14236
+ against_sec: number;
14237
+ /** @description Strongest ground position first, the clinch last; a position with under 10 seconds either way is left out. */
14238
+ by_position: components["schemas"]["ControlByPosition"][];
14239
+ };
14240
+ /** @description Where a fighter's bouts happen and who holds control, over their career. */
14241
+ FighterPositions: {
14242
+ /** @description Settled bouts whose positions were tracked. */
14243
+ tracked_fights: number;
14244
+ /** @description Seconds fought across those bouts (distance + clinch + ground). */
14245
+ cage_seconds: number;
14246
+ time: components["schemas"]["FighterPositionTime"];
14247
+ control: components["schemas"]["FighterPositionControl"];
14248
+ };
12460
14249
  RankedFighterRef: {
12461
14250
  id: number;
12462
14251
  slug: string | null;
@@ -12702,7 +14491,7 @@ interface components {
12702
14491
  * @description Record Book category.
12703
14492
  * @enum {string}
12704
14493
  */
12705
- MetricCategory: "fights" | "time" | "striking" | "grappling" | "records";
14494
+ MetricCategory: "fights" | "time" | "striking" | "grappling" | "discipline" | "records";
12706
14495
  /**
12707
14496
  * @description `rate` is a 0–1 fraction.
12708
14497
  * @enum {string}
@@ -12718,7 +14507,7 @@ interface components {
12718
14507
  * @description Board metric slug.
12719
14508
  * @enum {string}
12720
14509
  */
12721
- slug: "total_fights" | "wins" | "decision_wins" | "title_fight_wins" | "bonuses" | "finishes" | "win_streak" | "total_fight_seconds" | "avg_fight_seconds_short" | "avg_fight_seconds_long" | "control_time_sec" | "control_time_pct" | "sig_strikes_landed" | "total_strikes_landed" | "slpm" | "sapm" | "striking_differential" | "sig_strike_accuracy" | "sig_strike_defense" | "knockdowns" | "knockdowns_per_15" | "knockouts" | "takedowns_landed" | "td_avg" | "takedown_accuracy" | "takedown_defense" | "submission_attempts" | "sub_avg_per_15" | "submissions" | "fastest_finish" | "fastest_knockout" | "fastest_submission" | "longest_fight_seconds" | "most_sig_strikes_fight" | "most_takedowns_fight" | "most_knockdowns_fight" | "longest_control_fight" | "most_sig_strikes_round" | "most_takedowns_round" | "most_knockdowns_round" | "most_finishes_event" | "most_knockouts_event" | "shortest_card_seconds" | "finish_rate" | "ko_rate" | "sub_rate" | "decision_rate" | "avg_fight_seconds";
14510
+ slug: "total_fights" | "wins" | "decision_wins" | "title_fight_wins" | "bonuses" | "finishes" | "win_streak" | "total_fight_seconds" | "avg_fight_seconds_short" | "avg_fight_seconds_long" | "control_time_sec" | "control_time_pct" | "sig_strikes_landed" | "total_strikes_landed" | "slpm" | "sapm" | "striking_differential" | "sig_strike_accuracy" | "sig_strike_defense" | "knockdowns" | "knockdowns_per_15" | "knockouts" | "takedowns_landed" | "td_avg" | "takedown_accuracy" | "takedown_defense" | "submission_attempts" | "sub_avg_per_15" | "submissions" | "fastest_finish" | "fastest_knockout" | "fastest_submission" | "longest_fight_seconds" | "most_sig_strikes_fight" | "most_takedowns_fight" | "most_knockdowns_fight" | "longest_control_fight" | "most_sig_strikes_round" | "most_takedowns_round" | "most_knockdowns_round" | "fouls_committed" | "eye_pokes_committed" | "low_blows_committed" | "fouls_drawn" | "fouls_per_15" | "most_fouls_fight" | "longest_foul_stoppage_fight" | "most_fouls_event" | "most_finishes_event" | "most_knockouts_event" | "shortest_card_seconds" | "finish_rate" | "ko_rate" | "sub_rate" | "decision_rate" | "avg_fight_seconds" | "fouls_per_15_division";
12722
14511
  scope: components["schemas"]["MetricScope"];
12723
14512
  category: components["schemas"]["MetricCategory"];
12724
14513
  /**
@@ -13365,8 +15154,11 @@ interface components {
13365
15154
  region: string | null;
13366
15155
  country: string | null;
13367
15156
  country_code: string | null;
15157
+ /** @description Latitude: the venue's own point when the promotion publishes it, else its city's centre. */
13368
15158
  lat: number | null;
15159
+ /** @description Longitude; same precision rule as `lat`. */
13369
15160
  lng: number | null;
15161
+ /** @description Seating capacity when a source publishes it; null for most venues. */
13370
15162
  capacity: number | null;
13371
15163
  tz: string | null;
13372
15164
  };
@@ -13711,6 +15503,34 @@ interface components {
13711
15503
  ignored_params?: string[];
13712
15504
  };
13713
15505
  };
15506
+ /** @description `actions` is empty (and `meta.note` says why) when the bout has no log or is not settled yet; 404 only for an unknown fight. */
15507
+ FightTimelineResponse: {
15508
+ data: components["schemas"]["FightTimeline"];
15509
+ meta: {
15510
+ fight_id: number;
15511
+ /** @description Always `ufc-official`. */
15512
+ source: string;
15513
+ /** @description false on a card before 2018-12-08: its stoppages carry no reason. */
15514
+ has_stoppage_reasons: boolean;
15515
+ note?: string;
15516
+ /** @description Present only when the request carried query parameters this endpoint does not take — they were ignored. Same list as the `X-UFCalendar-Ignored-Params` header. Sorted, unique. */
15517
+ ignored_params?: string[];
15518
+ };
15519
+ };
15520
+ /** @description `totals` is empty (and `meta.note` says why) when positions were not tracked or the bout is not settled yet; 404 only for an unknown fight. */
15521
+ FightPositionsResponse: {
15522
+ data: components["schemas"]["FightPositions"];
15523
+ meta: {
15524
+ fight_id: number;
15525
+ /** @description Always `ufc-official`. */
15526
+ source: string;
15527
+ /** @description true once every line is the official post-fight figure; null when there are no lines. */
15528
+ official: boolean | null;
15529
+ note: string;
15530
+ /** @description Present only when the request carried query parameters this endpoint does not take — they were ignored. Same list as the `X-UFCalendar-Ignored-Params` header. Sorted, unique. */
15531
+ ignored_params?: string[];
15532
+ };
15533
+ };
13714
15534
  JudgesPageResponse: {
13715
15535
  data: components["schemas"]["Judge"][];
13716
15536
  meta: {
@@ -13855,6 +15675,37 @@ interface components {
13855
15675
  ignored_params?: string[];
13856
15676
  };
13857
15677
  };
15678
+ /** @description `data` is null (and `meta.note` says why) under 3 tracked bouts with no recorded foul. */
15679
+ FighterDisciplineResponse: {
15680
+ data: components["schemas"]["FighterDiscipline"] | null;
15681
+ meta: {
15682
+ fighter_id: number;
15683
+ /** @description Always `ufc-official`. */
15684
+ source: string;
15685
+ /**
15686
+ * Format: date
15687
+ * @description First card whose stoppages carry a reason (2018-12-08); earlier bouts are not counted.
15688
+ */
15689
+ coverage_since: string;
15690
+ /** @description The weight class the tracked bouts were most often fought at. */
15691
+ weight_class: string | null;
15692
+ note: string;
15693
+ /** @description Present only when the request carried query parameters this endpoint does not take — they were ignored. Same list as the `X-UFCalendar-Ignored-Params` header. Sorted, unique. */
15694
+ ignored_params?: string[];
15695
+ };
15696
+ };
15697
+ /** @description `data` is null (and `meta.note` says why) under 3 bouts with tracked positions. */
15698
+ FighterPositionsResponse: {
15699
+ data: components["schemas"]["FighterPositions"] | null;
15700
+ meta: {
15701
+ fighter_id: number;
15702
+ /** @description Always `ufc-official`. */
15703
+ source: string;
15704
+ note: string;
15705
+ /** @description Present only when the request carried query parameters this endpoint does not take — they were ignored. Same list as the `X-UFCalendar-Ignored-Params` header. Sorted, unique. */
15706
+ ignored_params?: string[];
15707
+ };
15708
+ };
13858
15709
  RankingsBoardResponse: {
13859
15710
  data: components["schemas"]["RankingsBoardSnapshot"];
13860
15711
  meta: {
@@ -14081,4 +15932,4 @@ interface components {
14081
15932
  }
14082
15933
  type operations = Record<string, never>;
14083
15934
 
14084
- export { type Article, type ArticleLocale, type ArticleSummary, type BonusAward, type BonusLedger, type Broadcast, type BroadcastRight, type CareerBout, type CareerStats, type Champion, type ChangeFeedEntry, type ChangeKind, type Compare, type CompareAggregates, type CompareBout, type CoverageCounts, type CoverageYear, type CredentialConfidence, DEFAULT_BASE_URL, DEFAULT_MAX_RETRIES, type DissentingJudge, type Envelope, type EventChange, type EventDetail, type EventHeadline, type EventInclude, type EventListInclude, type EventOdds, type EventOddsRow, type EventPickem, type EventRef, type EventStatus, type EventStorylines, type EventSummary, type EventWatch, type Fantasy, type FantasyBreakdown, type Fight, FightAPI, FightAPIError, type FightAPIOptions, type FightInclude, type FightOdds, type FightProps, type FightResult, type FightSearchMethod, type FightSearchRow, type FightStatLine, type Fighter, type FighterAffiliation, type FighterBout, type FighterCredential, type FighterCredentials, type FighterImage, type FighterInclude, type FighterRef, type FighterSummary, type HeadlineCorner, type Judge, type JudgeColleague, type JudgeLeague, type JudgeScorecardRow, type LeaderboardRow, MAX_RETRY_AFTER_SECONDS, type MatchmakerCorner, type MatchmakerTag, type Matchup, type Meta, type MethodNormalized, type OddsBlock, type OddsHistoryPoint, type OddsLine, type OddsMovement, type OddsPair, type Org, type OrgCoverage, type OrgDivision, type PickemSplit, type Plan, type Plans, type PowerIndex, type PowerIndexFighter, type PowerIndexMover, type PowerIndexRow, type PowerIndexView, type ProbabilitySource, type PropLine, type PropMethodCorner, type PropTotalRounds, type PublicSource, type Query, type QueryValue, type RankingDivision, type RankingEntry, type RankingsBoard, type RateLimit, type RecordBookSection, type RecordEntry, type Referee, type RefereeFightRow, type RightsSeries, type Scorecard, type ScorecardRound, type Scorecards, type SplitDecisionRow, type StatMetric, type StatScope, type StatsPanel, type StatsQuality, type StorylineCorner, type StorylineTag, type Usage, VERSION, type Venue, type WatchProvider, type WebhookEndpoint, type WhosNext, type YearStats, type operations, type paths };
15935
+ export { type Article, type ArticleLocale, type ArticleSummary, type BonusAward, type BonusLedger, type Broadcast, type BroadcastRight, type CareerBout, type CareerStats, type Champion, type ChangeFeedEntry, type ChangeKind, type Compare, type CompareAggregates, type CompareBout, type ControlPosition, type CoverageCounts, type CoverageYear, type CredentialConfidence, DEFAULT_BASE_URL, DEFAULT_MAX_RETRIES, type DisciplineIncident, type DissentingJudge, type Envelope, type EventChange, type EventDetail, type EventHeadline, type EventInclude, type EventListInclude, type EventOdds, type EventOddsRow, type EventPickem, type EventRef, type EventStatus, type EventStorylines, type EventSummary, type EventWatch, type Fantasy, type FantasyBreakdown, type Fight, FightAPI, FightAPIError, type FightAPIOptions, type FightInclude, type FightOdds, type FightPositions, type FightProps, type FightResult, type FightSearchMethod, type FightSearchRow, type FightStatLine, type FightTimeline, type Fighter, type FighterAffiliation, type FighterBout, type FighterCredential, type FighterCredentials, type FighterDiscipline, type FighterImage, type FighterInclude, type FighterPositions, type FighterRef, type FighterSummary, type FoulBasis, type FoulCommitter, type FoulCounts, type FoulIncident, type FoulKind, type FoulTally, type HeadlineCorner, type Judge, type JudgeColleague, type JudgeLeague, type JudgeScorecardRow, type LeaderboardRow, MAX_RETRY_AFTER_SECONDS, type MatchmakerCorner, type MatchmakerTag, type Matchup, type Meta, type MethodNormalized, type OddsBlock, type OddsHistoryPoint, type OddsLine, type OddsMovement, type OddsPair, type Org, type OrgCoverage, type OrgDivision, type PickemSplit, type Plan, type Plans, type PositionStatLine, type PowerIndex, type PowerIndexFighter, type PowerIndexMover, type PowerIndexRow, type PowerIndexView, type ProbabilitySource, type PropLine, type PropMethodCorner, type PropTotalRounds, type PublicSource, type Query, type QueryValue, type RankingDivision, type RankingEntry, type RankingsBoard, type RateLimit, type RecordBookSection, type RecordEntry, type Referee, type RefereeFightRow, type RightsSeries, type Scorecard, type ScorecardRound, type Scorecards, type SplitDecisionRow, type StatMetric, type StatScope, type StatsPanel, type StatsQuality, type StoppageReason, type StorylineCorner, type StorylineTag, type StrikeCount, type StrikesByTarget, type TimelineAction, type TimelineStoppage, type Usage, VERSION, type Venue, type WatchProvider, type WebhookEndpoint, type WhosNext, type YearStats, type operations, type paths };