@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/README.md +40 -2
- package/dist/index.cjs +67 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +2072 -221
- package/dist/index.d.ts +2072 -221
- package/dist/index.js +67 -1
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
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", "
|
|
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.
|
|
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/
|
|
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
|
-
*
|
|
5236
|
-
* @description
|
|
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
|
|
5578
|
+
path: {
|
|
5579
|
+
id: number;
|
|
5580
|
+
};
|
|
5253
5581
|
cookie?: never;
|
|
5254
5582
|
};
|
|
5255
5583
|
requestBody?: never;
|
|
5256
5584
|
responses: {
|
|
5257
|
-
/** @description
|
|
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
|
-
*
|
|
5280
|
-
*
|
|
5281
|
-
*
|
|
5282
|
-
*
|
|
5283
|
-
*
|
|
5284
|
-
*
|
|
5285
|
-
*
|
|
5286
|
-
*
|
|
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
|
-
*
|
|
5298
|
-
* "
|
|
5299
|
-
* "
|
|
5300
|
-
* "
|
|
5301
|
-
* "
|
|
5302
|
-
* "
|
|
5303
|
-
* "
|
|
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
|
-
*
|
|
5306
|
-
* "
|
|
5307
|
-
* "
|
|
5308
|
-
* "
|
|
5309
|
-
* "
|
|
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
|
-
* "
|
|
5312
|
-
* "
|
|
5313
|
-
* "
|
|
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
|
-
*
|
|
5316
|
-
*
|
|
5317
|
-
*
|
|
5318
|
-
* "
|
|
5319
|
-
* "
|
|
5320
|
-
* "
|
|
5321
|
-
* "
|
|
5322
|
-
* "
|
|
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
|
-
*
|
|
5325
|
-
*
|
|
5326
|
-
*
|
|
5327
|
-
* {
|
|
5328
|
-
* "
|
|
5329
|
-
* "
|
|
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
|
-
*
|
|
5355
|
-
*
|
|
5356
|
-
*
|
|
5357
|
-
*
|
|
5358
|
-
*
|
|
5359
|
-
*
|
|
5360
|
-
*
|
|
5361
|
-
*
|
|
5362
|
-
*
|
|
5363
|
-
*
|
|
5364
|
-
*
|
|
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
|
-
*
|
|
5381
|
-
*
|
|
5382
|
-
*
|
|
5383
|
-
*
|
|
5384
|
-
*
|
|
5385
|
-
*
|
|
5386
|
-
*
|
|
5387
|
-
*
|
|
5388
|
-
*
|
|
5389
|
-
*
|
|
5390
|
-
*
|
|
5391
|
-
*
|
|
5392
|
-
*
|
|
5393
|
-
*
|
|
5394
|
-
*
|
|
5395
|
-
*
|
|
5396
|
-
*
|
|
5397
|
-
*
|
|
5398
|
-
*
|
|
5399
|
-
*
|
|
5400
|
-
*
|
|
5401
|
-
*
|
|
5402
|
-
*
|
|
5403
|
-
*
|
|
5404
|
-
*
|
|
5405
|
-
*
|
|
5406
|
-
*
|
|
5407
|
-
*
|
|
5408
|
-
*
|
|
5409
|
-
*
|
|
5410
|
-
*
|
|
5411
|
-
*
|
|
5412
|
-
*
|
|
5413
|
-
|
|
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"]["
|
|
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}/
|
|
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
|
-
*
|
|
7282
|
-
* @description
|
|
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
|
|
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
|
-
|
|
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}/
|
|
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
|
-
*
|
|
7397
|
-
* @description
|
|
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
|
|
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
|
-
*
|
|
7438
|
-
*
|
|
7439
|
-
* "
|
|
7440
|
-
* "
|
|
7441
|
-
* "
|
|
7442
|
-
* "
|
|
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
|
-
* "
|
|
7447
|
-
* "
|
|
7448
|
-
*
|
|
7449
|
-
*
|
|
7450
|
-
*
|
|
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"]["
|
|
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
|
|
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}/
|
|
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
|
-
*
|
|
7547
|
-
* @description
|
|
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
|
|
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
|
-
*
|
|
7584
|
-
*
|
|
7585
|
-
* "
|
|
7586
|
-
* "
|
|
7587
|
-
* "
|
|
7588
|
-
* "
|
|
7589
|
-
* "
|
|
7590
|
-
* "
|
|
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
|
-
* "
|
|
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"]["
|
|
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
|
|
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
|
|
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
|
|
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 };
|