@ufcalendar/sdk 0.9.2 → 0.10.1
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 +2065 -230
- package/dist/index.d.ts +2065 -230
- package/dist/index.js +67 -1
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/dist/index.d.ts
CHANGED
|
@@ -1445,6 +1445,266 @@ interface OrgCoverage {
|
|
|
1445
1445
|
/** Newest first. */
|
|
1446
1446
|
years: CoverageYear[];
|
|
1447
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
|
+
}
|
|
1448
1708
|
|
|
1449
1709
|
declare const DEFAULT_BASE_URL = "https://api.ufcalendar.com/v1";
|
|
1450
1710
|
/** Default number of times a GET that hit the per-minute limit is retried. */
|
|
@@ -1631,6 +1891,41 @@ declare class FightAPI {
|
|
|
1631
1891
|
* did not go to the judges.
|
|
1632
1892
|
*/
|
|
1633
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>;
|
|
1634
1929
|
/**
|
|
1635
1930
|
* Completed bouts, filtered — newest first unless `order: 'oldest'`. At
|
|
1636
1931
|
* least one narrowing filter is required (`titleOnly`, `method`,
|
|
@@ -1731,6 +2026,29 @@ declare class FightAPI {
|
|
|
1731
2026
|
* complete (a long career is 900+ rows). */
|
|
1732
2027
|
fighterRankings(idOrSlug: string | number): Promise<Record<string, unknown>[]>;
|
|
1733
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>;
|
|
1734
2052
|
/**
|
|
1735
2053
|
* Two fighters side by side (slugs or ids): bios with age, career stats,
|
|
1736
2054
|
* strike mix, win streaks, previous meetings, common opponents, the booked
|
|
@@ -1892,7 +2210,7 @@ declare class FightAPI {
|
|
|
1892
2210
|
|
|
1893
2211
|
/** Kept in lockstep with package.json and the User-Agent by
|
|
1894
2212
|
* `apps/api/src/surfaces.test.ts`. Bump all three together. */
|
|
1895
|
-
declare const VERSION = "0.
|
|
2213
|
+
declare const VERSION = "0.10.1";
|
|
1896
2214
|
|
|
1897
2215
|
/**
|
|
1898
2216
|
* This file was auto-generated by openapi-typescript.
|
|
@@ -3445,7 +3763,7 @@ interface paths {
|
|
|
3445
3763
|
};
|
|
3446
3764
|
/**
|
|
3447
3765
|
* Consensus odds for one card
|
|
3448
|
-
* @description The UFCalendar consensus line for every non-cancelled bout on one card, in card order: `fights[]`, each with `fight_id`, `status`, both corners (`fighter_a`, `fighter_b`: `id`, `slug`, `name`), `consensus` (the latest point; the closing line once the bout is settled), `opening` (the first point we recorded), `closing` (settled bouts only: the last point at or before the event start), `movement` (opening → consensus in implied-probability points on corner a, with the `direction` the market moved), `points` and `updated_at`. Every point is `a` / `b` (`american`, `decimal`, raw `implied_probability`), `favourite`, `fair_probability_a` (margin removed), `sources` (how many sportsbooks backed it) and `recorded_at`. A bout nobody has priced stays on the list with nulls and `points: 0`; `meta.priced` / `meta.unpriced` count both. `meta.checked_at` is when we last checked the market, whether or not the line moved. Consensus is the mean across the sportsbooks we track, refreshed every 30 minutes in the 48 hours before a card and every 2 hours otherwise; book identities are never exposed. Each bout also carries `props` — method of victory per corner, total rounds over/under per line and goes the distance (`FightProps`, or null), described on `/v1/fights/{id}/odds`. Information only, not betting advice. An unknown event 404s.
|
|
3766
|
+
* @description The UFCalendar consensus line for every non-cancelled bout on one card, in card order: `fights[]`, each with `fight_id`, `status`, both corners (`fighter_a`, `fighter_b`: `id`, `slug`, `name`), `consensus` (the latest point; the closing line once the bout is settled), `opening` (the first point we recorded; on a settled bout from the archive that stores only its closing point, the mean of each sportsbook's own opening price with `recorded_at: null`), `closing` (settled bouts only: the last point at or before the start of the bout's own card section, or the event start when that time is not known), `movement` (opening → consensus in implied-probability points on corner a, with the `direction` the market moved), `points` and `updated_at`. Every point is `a` / `b` (`american`, `decimal`, raw `implied_probability`), `favourite`, `fair_probability_a` (margin removed), `sources` (how many sportsbooks backed it) and `recorded_at`. A bout nobody has priced stays on the list with nulls and `points: 0`; `meta.priced` / `meta.unpriced` count both. `meta.checked_at` is when we last checked the market, whether or not the line moved. Consensus is the mean across the sportsbooks we track, refreshed every 30 minutes in the 48 hours before a card and every 2 hours otherwise; book identities are never exposed. Each bout also carries `props` — method of victory per corner, total rounds over/under per line and goes the distance (`FightProps`, or null), described on `/v1/fights/{id}/odds`. Information only, not betting advice. An unknown event 404s.
|
|
3449
3767
|
*/
|
|
3450
3768
|
get: {
|
|
3451
3769
|
parameters: {
|
|
@@ -4748,9 +5066,9 @@ interface paths {
|
|
|
4748
5066
|
};
|
|
4749
5067
|
/**
|
|
4750
5068
|
* Consensus odds for one bout
|
|
4751
|
-
* @description The UFCalendar consensus line for one bout: `consensus` (the latest point; the closing line once the bout is settled), `opening` (the first point we recorded), `closing` (settled bouts only, `completed` or `no_contest`: the last point at or before the event start; null until then), `movement` (opening → consensus: `delta_points_a` in implied-probability points on corner a, `direction` = the corner the market moved toward, `since`), `points` (stored points) and `updated_at` (when the line last moved). Every point is `a` / `b` (`american`, `decimal`, raw `implied_probability`), `favourite`, `fair_probability_a` (margin removed) and `sources` (how many sportsbooks backed it). Consensus is the mean across the sportsbooks we track, in decimal space; book identities are never exposed. `meta.checked_at` is when we last checked the market, whether or not the line moved; `meta.history` is the movement series (Pro+). A bout nobody priced answers 200 with nulls and `points: 0`; 404 is reserved for an unknown fight.
|
|
5069
|
+
* @description The UFCalendar consensus line for one bout: `consensus` (the latest point; the closing line once the bout is settled), `opening` (the first point we recorded; on a settled bout from the archive that stores only its closing point, the mean of each sportsbook's own opening price with `recorded_at: null`), `closing` (settled bouts only, `completed` or `no_contest`: the last point at or before the start of the bout's own card section (main card, prelims or early prelims), or the event start when that time is not known; null until then), `movement` (opening → consensus: `delta_points_a` in implied-probability points on corner a, `direction` = the corner the market moved toward, `since`), `points` (stored points) and `updated_at` (when the line last moved). Every point is `a` / `b` (`american`, `decimal`, raw `implied_probability`), `favourite`, `fair_probability_a` (margin removed) and `sources` (how many sportsbooks backed it). Consensus is the mean across the sportsbooks we track, in decimal space; book identities are never exposed. `meta.checked_at` is when we last checked the market, whether or not the line moved; `meta.history` is the movement series (Pro+). A bout nobody priced answers 200 with nulls and `points: 0`; 404 is reserved for an unknown fight.
|
|
4752
5070
|
*
|
|
4753
|
-
* `props` carries the prop markets (`FightProps`, or null when no sportsbooks price them): `method` (per corner `a` / `b`: `ko`, `sub`, `dec` — each `yes` / `no` prices, `fair_probability` = its share of all six outcomes when all six are priced, `sources`), `total_rounds` (over/under per rounds line, ascending) and `distance` (goes the distance yes / no). Same consensus rule as the moneyline (the sportsbook mean; prediction markets excluded, a book far from the rest dropped, two sportsbooks minimum); prices are recorded until the
|
|
5071
|
+
* `props` carries the prop markets (`FightProps`, or null when no sportsbooks price them): `method` (per corner `a` / `b`: `ko`, `sub`, `dec` — each `yes` / `no` prices, `fair_probability` = its share of all six outcomes when all six are priced, `sources`), `total_rounds` (over/under per rounds line, ascending) and `distance` (goes the distance yes / no). Same consensus rule as the moneyline (the sportsbook mean; prediction markets excluded, a book far from the rest dropped, two sportsbooks minimum); prices are recorded until the bout's own card section starts, so a settled bout carries its closing props (`closing: true`). Props for 2021-2025 were backfilled as one closing consensus per market, with `recorded_at` set to the event start: that time is approximate, not when the price was observed. Books post props in fight week. Information only, not betting advice.
|
|
4754
5072
|
*/
|
|
4755
5073
|
get: {
|
|
4756
5074
|
parameters: {
|
|
@@ -5230,7 +5548,7 @@ interface paths {
|
|
|
5230
5548
|
patch?: never;
|
|
5231
5549
|
trace?: never;
|
|
5232
5550
|
};
|
|
5233
|
-
"/v1/
|
|
5551
|
+
"/v1/fights/{id}/timeline": {
|
|
5234
5552
|
parameters: {
|
|
5235
5553
|
query?: never;
|
|
5236
5554
|
header?: never;
|
|
@@ -5238,29 +5556,33 @@ interface paths {
|
|
|
5238
5556
|
cookie?: never;
|
|
5239
5557
|
};
|
|
5240
5558
|
/**
|
|
5241
|
-
*
|
|
5242
|
-
* @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.
|
|
5243
5573
|
*/
|
|
5244
5574
|
get: {
|
|
5245
5575
|
parameters: {
|
|
5246
|
-
query?:
|
|
5247
|
-
/** @description Launch org slug: `ufc`, `pfl`, `oktagon`, `bkfc` or `rizin`. Staged orgs 400 until promoted. */
|
|
5248
|
-
org?: "ufc" | "pfl" | "oktagon" | "bkfc" | "rizin";
|
|
5249
|
-
/** @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. */
|
|
5250
|
-
from?: string;
|
|
5251
|
-
/** @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. */
|
|
5252
|
-
to?: string;
|
|
5253
|
-
/** @description Opaque cursor from `meta.pagination.next_cursor`. */
|
|
5254
|
-
cursor?: string;
|
|
5255
|
-
limit?: number;
|
|
5256
|
-
};
|
|
5576
|
+
query?: never;
|
|
5257
5577
|
header?: never;
|
|
5258
|
-
path
|
|
5578
|
+
path: {
|
|
5579
|
+
id: number;
|
|
5580
|
+
};
|
|
5259
5581
|
cookie?: never;
|
|
5260
5582
|
};
|
|
5261
5583
|
requestBody?: never;
|
|
5262
5584
|
responses: {
|
|
5263
|
-
/** @description
|
|
5585
|
+
/** @description The log, its stoppages and the foul counts */
|
|
5264
5586
|
200: {
|
|
5265
5587
|
headers: {
|
|
5266
5588
|
/** @description Weak validator over the body, e.g. `W/"GKrimLo826WBqG27jbNFsW2ZHmA"`. Send it back as `If-None-Match` to get a 304. */
|
|
@@ -5280,143 +5602,946 @@ interface paths {
|
|
|
5280
5602
|
content: {
|
|
5281
5603
|
/**
|
|
5282
5604
|
* @example {
|
|
5283
|
-
* "data":
|
|
5284
|
-
*
|
|
5285
|
-
*
|
|
5286
|
-
*
|
|
5287
|
-
*
|
|
5288
|
-
*
|
|
5289
|
-
*
|
|
5290
|
-
*
|
|
5291
|
-
*
|
|
5292
|
-
*
|
|
5293
|
-
* "scheduled_rounds": 3,
|
|
5294
|
-
* "status": "completed",
|
|
5295
|
-
* "fighter_a": {
|
|
5296
|
-
* "id": 97,
|
|
5297
|
-
* "slug": "jeisla-chaves",
|
|
5298
|
-
* "name": "Jeisla Chaves",
|
|
5299
|
-
* "nickname": "A Braba",
|
|
5300
|
-
* "nationality": "Brazil",
|
|
5301
|
-
* "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
|
|
5302
5615
|
* },
|
|
5303
|
-
*
|
|
5304
|
-
* "
|
|
5305
|
-
* "
|
|
5306
|
-
* "
|
|
5307
|
-
* "
|
|
5308
|
-
* "
|
|
5309
|
-
* "
|
|
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
|
|
5310
5623
|
* },
|
|
5311
|
-
*
|
|
5312
|
-
* "
|
|
5313
|
-
* "
|
|
5314
|
-
* "
|
|
5315
|
-
* "
|
|
5316
|
-
* "
|
|
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
|
+
* {
|
|
5317
5706
|
* "round": 3,
|
|
5318
|
-
* "
|
|
5319
|
-
* "
|
|
5320
|
-
* "
|
|
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
|
|
5321
5721
|
* },
|
|
5322
|
-
*
|
|
5323
|
-
*
|
|
5324
|
-
*
|
|
5325
|
-
* "
|
|
5326
|
-
* "
|
|
5327
|
-
* "
|
|
5328
|
-
* "
|
|
5329
|
-
* "
|
|
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
|
|
5330
5753
|
* },
|
|
5331
|
-
*
|
|
5332
|
-
*
|
|
5333
|
-
*
|
|
5334
|
-
* {
|
|
5335
|
-
* "
|
|
5336
|
-
* "
|
|
5337
|
-
* "total_a": 29,
|
|
5338
|
-
* "total_b": 28,
|
|
5339
|
-
* "winner_fighter_id": 97,
|
|
5340
|
-
* "is_draw": false,
|
|
5341
|
-
* "scores_known": true,
|
|
5342
|
-
* "rounds": [
|
|
5343
|
-
* {
|
|
5344
|
-
* "round": 1,
|
|
5345
|
-
* "a": 10,
|
|
5346
|
-
* "b": 9
|
|
5347
|
-
* },
|
|
5348
|
-
* {
|
|
5349
|
-
* "round": 2,
|
|
5350
|
-
* "a": 10,
|
|
5351
|
-
* "b": 9
|
|
5352
|
-
* },
|
|
5353
|
-
* {
|
|
5354
|
-
* "round": 3,
|
|
5355
|
-
* "a": 9,
|
|
5356
|
-
* "b": 10
|
|
5357
|
-
* }
|
|
5358
|
-
* ]
|
|
5754
|
+
* {
|
|
5755
|
+
* "foul": "fence",
|
|
5756
|
+
* "basis": "deduction",
|
|
5757
|
+
* "committed_by": {
|
|
5758
|
+
* "fighter_id": 401,
|
|
5759
|
+
* "corner": "a"
|
|
5359
5760
|
* },
|
|
5360
|
-
*
|
|
5361
|
-
*
|
|
5362
|
-
*
|
|
5363
|
-
*
|
|
5364
|
-
*
|
|
5365
|
-
*
|
|
5366
|
-
*
|
|
5367
|
-
*
|
|
5368
|
-
*
|
|
5369
|
-
*
|
|
5370
|
-
*
|
|
5371
|
-
*
|
|
5372
|
-
* "b": 10
|
|
5373
|
-
* },
|
|
5374
|
-
* {
|
|
5375
|
-
* "round": 2,
|
|
5376
|
-
* "a": 10,
|
|
5377
|
-
* "b": 9
|
|
5378
|
-
* },
|
|
5379
|
-
* {
|
|
5380
|
-
* "round": 3,
|
|
5381
|
-
* "a": 9,
|
|
5382
|
-
* "b": 10
|
|
5383
|
-
* }
|
|
5384
|
-
* ]
|
|
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"
|
|
5385
5773
|
* },
|
|
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
|
-
*
|
|
5414
|
-
*
|
|
5415
|
-
*
|
|
5416
|
-
*
|
|
5417
|
-
*
|
|
5418
|
-
*
|
|
5419
|
-
*
|
|
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,
|
|
5420
6545
|
* "is_draw": false,
|
|
5421
6546
|
* "scores_known": true
|
|
5422
6547
|
* }
|
|
@@ -7200,11 +8325,267 @@ interface paths {
|
|
|
7200
8325
|
* }
|
|
7201
8326
|
* ],
|
|
7202
8327
|
* "meta": {
|
|
7203
|
-
* "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
|
+
* }
|
|
7204
8585
|
* }
|
|
7205
8586
|
* }
|
|
7206
8587
|
*/
|
|
7207
|
-
"application/json": components["schemas"]["
|
|
8588
|
+
"application/json": components["schemas"]["FighterRankingsResponse"];
|
|
7208
8589
|
};
|
|
7209
8590
|
};
|
|
7210
8591
|
/** @description Not Modified — `If-None-Match` matched the current weak `ETag`. Empty body. */
|
|
@@ -7223,6 +8604,15 @@ interface paths {
|
|
|
7223
8604
|
};
|
|
7224
8605
|
content?: never;
|
|
7225
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
|
+
};
|
|
7226
8616
|
/** @description Missing/invalid API key (`unauthorized`). */
|
|
7227
8617
|
401: {
|
|
7228
8618
|
headers: {
|
|
@@ -7278,7 +8668,7 @@ interface paths {
|
|
|
7278
8668
|
patch?: never;
|
|
7279
8669
|
trace?: never;
|
|
7280
8670
|
};
|
|
7281
|
-
"/v1/fighters/{idOrSlug}/
|
|
8671
|
+
"/v1/fighters/{idOrSlug}/power-index": {
|
|
7282
8672
|
parameters: {
|
|
7283
8673
|
query?: never;
|
|
7284
8674
|
header?: never;
|
|
@@ -7286,8 +8676,8 @@ interface paths {
|
|
|
7286
8676
|
cookie?: never;
|
|
7287
8677
|
};
|
|
7288
8678
|
/**
|
|
7289
|
-
*
|
|
7290
|
-
* @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.
|
|
7291
8681
|
*/
|
|
7292
8682
|
get: {
|
|
7293
8683
|
parameters: {
|
|
@@ -7301,7 +8691,7 @@ interface paths {
|
|
|
7301
8691
|
};
|
|
7302
8692
|
requestBody?: never;
|
|
7303
8693
|
responses: {
|
|
7304
|
-
/** @description
|
|
8694
|
+
/** @description Rating points */
|
|
7305
8695
|
200: {
|
|
7306
8696
|
headers: {
|
|
7307
8697
|
/** @description Weak validator over the body, e.g. `W/"GKrimLo826WBqG27jbNFsW2ZHmA"`. Send it back as `If-None-Match` to get a 304. */
|
|
@@ -7319,7 +8709,26 @@ interface paths {
|
|
|
7319
8709
|
[name: string]: unknown;
|
|
7320
8710
|
};
|
|
7321
8711
|
content: {
|
|
7322
|
-
|
|
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"];
|
|
7323
8732
|
};
|
|
7324
8733
|
};
|
|
7325
8734
|
/** @description Not Modified — `If-None-Match` matched the current weak `ETag`. Empty body. */
|
|
@@ -7393,7 +8802,7 @@ interface paths {
|
|
|
7393
8802
|
patch?: never;
|
|
7394
8803
|
trace?: never;
|
|
7395
8804
|
};
|
|
7396
|
-
"/v1/fighters/{idOrSlug}/
|
|
8805
|
+
"/v1/fighters/{idOrSlug}/discipline": {
|
|
7397
8806
|
parameters: {
|
|
7398
8807
|
query?: never;
|
|
7399
8808
|
header?: never;
|
|
@@ -7401,16 +8810,16 @@ interface paths {
|
|
|
7401
8810
|
cookie?: never;
|
|
7402
8811
|
};
|
|
7403
8812
|
/**
|
|
7404
|
-
*
|
|
7405
|
-
* @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.
|
|
7406
8819
|
*/
|
|
7407
8820
|
get: {
|
|
7408
8821
|
parameters: {
|
|
7409
|
-
query?:
|
|
7410
|
-
/** @description Opaque cursor from `meta.pagination.next_cursor`. */
|
|
7411
|
-
cursor?: string;
|
|
7412
|
-
limit?: number;
|
|
7413
|
-
};
|
|
8822
|
+
query?: never;
|
|
7414
8823
|
header?: never;
|
|
7415
8824
|
path: {
|
|
7416
8825
|
/** @description Numeric id or slug of the fighter. Stale slugs 308-redirect to the canonical URL. */
|
|
@@ -7420,7 +8829,7 @@ interface paths {
|
|
|
7420
8829
|
};
|
|
7421
8830
|
requestBody?: never;
|
|
7422
8831
|
responses: {
|
|
7423
|
-
/** @description
|
|
8832
|
+
/** @description The discipline record, or null */
|
|
7424
8833
|
200: {
|
|
7425
8834
|
headers: {
|
|
7426
8835
|
/** @description Weak validator over the body, e.g. `W/"GKrimLo826WBqG27jbNFsW2ZHmA"`. Send it back as `If-None-Match` to get a 304. */
|
|
@@ -7440,27 +8849,77 @@ interface paths {
|
|
|
7440
8849
|
content: {
|
|
7441
8850
|
/**
|
|
7442
8851
|
* @example {
|
|
7443
|
-
* "data":
|
|
7444
|
-
*
|
|
7445
|
-
*
|
|
7446
|
-
*
|
|
7447
|
-
* "
|
|
7448
|
-
* "
|
|
7449
|
-
* "
|
|
7450
|
-
* "
|
|
7451
|
-
* }
|
|
7452
|
-
*
|
|
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
|
+
* },
|
|
7453
8913
|
* "meta": {
|
|
7454
|
-
* "
|
|
7455
|
-
* "
|
|
7456
|
-
*
|
|
7457
|
-
*
|
|
7458
|
-
*
|
|
7459
|
-
* }
|
|
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."
|
|
7460
8919
|
* }
|
|
7461
8920
|
* }
|
|
7462
8921
|
*/
|
|
7463
|
-
"application/json": components["schemas"]["
|
|
8922
|
+
"application/json": components["schemas"]["FighterDisciplineResponse"];
|
|
7464
8923
|
};
|
|
7465
8924
|
};
|
|
7466
8925
|
/** @description Not Modified — `If-None-Match` matched the current weak `ETag`. Empty body. */
|
|
@@ -7479,15 +8938,6 @@ interface paths {
|
|
|
7479
8938
|
};
|
|
7480
8939
|
content?: never;
|
|
7481
8940
|
};
|
|
7482
|
-
/** @description Invalid input (`invalid_cursor`). */
|
|
7483
|
-
400: {
|
|
7484
|
-
headers: {
|
|
7485
|
-
[name: string]: unknown;
|
|
7486
|
-
};
|
|
7487
|
-
content: {
|
|
7488
|
-
"application/json": components["schemas"]["Error"];
|
|
7489
|
-
};
|
|
7490
|
-
};
|
|
7491
8941
|
/** @description Missing/invalid API key (`unauthorized`). */
|
|
7492
8942
|
401: {
|
|
7493
8943
|
headers: {
|
|
@@ -7497,7 +8947,7 @@ interface paths {
|
|
|
7497
8947
|
"application/json": components["schemas"]["Error"];
|
|
7498
8948
|
};
|
|
7499
8949
|
};
|
|
7500
|
-
/** @description
|
|
8950
|
+
/** @description Requires a Pro or Business plan (`tier_required`). Answered before the fight or fighter is looked up. */
|
|
7501
8951
|
403: {
|
|
7502
8952
|
headers: {
|
|
7503
8953
|
[name: string]: unknown;
|
|
@@ -7543,7 +8993,7 @@ interface paths {
|
|
|
7543
8993
|
patch?: never;
|
|
7544
8994
|
trace?: never;
|
|
7545
8995
|
};
|
|
7546
|
-
"/v1/fighters/{idOrSlug}/
|
|
8996
|
+
"/v1/fighters/{idOrSlug}/positions": {
|
|
7547
8997
|
parameters: {
|
|
7548
8998
|
query?: never;
|
|
7549
8999
|
header?: never;
|
|
@@ -7551,8 +9001,10 @@ interface paths {
|
|
|
7551
9001
|
cookie?: never;
|
|
7552
9002
|
};
|
|
7553
9003
|
/**
|
|
7554
|
-
*
|
|
7555
|
-
* @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`.
|
|
7556
9008
|
*/
|
|
7557
9009
|
get: {
|
|
7558
9010
|
parameters: {
|
|
@@ -7566,7 +9018,7 @@ interface paths {
|
|
|
7566
9018
|
};
|
|
7567
9019
|
requestBody?: never;
|
|
7568
9020
|
responses: {
|
|
7569
|
-
/** @description
|
|
9021
|
+
/** @description The position profile, or null */
|
|
7570
9022
|
200: {
|
|
7571
9023
|
headers: {
|
|
7572
9024
|
/** @description Weak validator over the body, e.g. `W/"GKrimLo826WBqG27jbNFsW2ZHmA"`. Send it back as `If-None-Match` to get a 304. */
|
|
@@ -7586,24 +9038,62 @@ interface paths {
|
|
|
7586
9038
|
content: {
|
|
7587
9039
|
/**
|
|
7588
9040
|
* @example {
|
|
7589
|
-
* "data":
|
|
7590
|
-
*
|
|
7591
|
-
*
|
|
7592
|
-
*
|
|
7593
|
-
* "
|
|
7594
|
-
* "
|
|
7595
|
-
* "
|
|
7596
|
-
* "
|
|
7597
|
-
* "
|
|
7598
|
-
* "
|
|
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
|
+
* ]
|
|
7599
9087
|
* }
|
|
7600
|
-
*
|
|
9088
|
+
* },
|
|
7601
9089
|
* "meta": {
|
|
7602
|
-
* "
|
|
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."
|
|
7603
9093
|
* }
|
|
7604
9094
|
* }
|
|
7605
9095
|
*/
|
|
7606
|
-
"application/json": components["schemas"]["
|
|
9096
|
+
"application/json": components["schemas"]["FighterPositionsResponse"];
|
|
7607
9097
|
};
|
|
7608
9098
|
};
|
|
7609
9099
|
/** @description Not Modified — `If-None-Match` matched the current weak `ETag`. Empty body. */
|
|
@@ -7631,7 +9121,7 @@ interface paths {
|
|
|
7631
9121
|
"application/json": components["schemas"]["Error"];
|
|
7632
9122
|
};
|
|
7633
9123
|
};
|
|
7634
|
-
/** @description
|
|
9124
|
+
/** @description Requires a Pro or Business plan (`tier_required`). Answered before the fight or fighter is looked up. */
|
|
7635
9125
|
403: {
|
|
7636
9126
|
headers: {
|
|
7637
9127
|
[name: string]: unknown;
|
|
@@ -8921,7 +10411,7 @@ interface paths {
|
|
|
8921
10411
|
};
|
|
8922
10412
|
/**
|
|
8923
10413
|
* One stat leaderboard
|
|
8924
|
-
* @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.
|
|
8925
10415
|
*/
|
|
8926
10416
|
get: {
|
|
8927
10417
|
parameters: {
|
|
@@ -8929,7 +10419,7 @@ interface paths {
|
|
|
8929
10419
|
/** @description Launch org slug (required): `ufc`, `pfl`, `oktagon`, `bkfc` or `rizin`. */
|
|
8930
10420
|
org: "ufc" | "pfl" | "oktagon" | "bkfc" | "rizin";
|
|
8931
10421
|
/** @description Board metric slug. */
|
|
8932
|
-
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";
|
|
8933
10423
|
/** @description One weight class. */
|
|
8934
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";
|
|
8935
10425
|
/** @description `active` = fighters with a bout in the last ~18 months. */
|
|
@@ -9048,7 +10538,7 @@ interface paths {
|
|
|
9048
10538
|
"application/json": components["schemas"]["Error"];
|
|
9049
10539
|
};
|
|
9050
10540
|
};
|
|
9051
|
-
/** @description
|
|
10541
|
+
/** @description Requires Pro or above (`tier_required`), or a plan bought directly rather than through RapidAPI (`direct_plan_required`). */
|
|
9052
10542
|
403: {
|
|
9053
10543
|
headers: {
|
|
9054
10544
|
[name: string]: unknown;
|
|
@@ -9103,7 +10593,7 @@ interface paths {
|
|
|
9103
10593
|
};
|
|
9104
10594
|
/**
|
|
9105
10595
|
* The Record Book
|
|
9106
|
-
* @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`.
|
|
9107
10597
|
*/
|
|
9108
10598
|
get: {
|
|
9109
10599
|
parameters: {
|
|
@@ -12470,6 +13960,292 @@ interface components {
|
|
|
12470
13960
|
opponent_fighter_id: number | null;
|
|
12471
13961
|
fight_id: number | null;
|
|
12472
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
|
+
};
|
|
12473
14249
|
RankedFighterRef: {
|
|
12474
14250
|
id: number;
|
|
12475
14251
|
slug: string | null;
|
|
@@ -12715,7 +14491,7 @@ interface components {
|
|
|
12715
14491
|
* @description Record Book category.
|
|
12716
14492
|
* @enum {string}
|
|
12717
14493
|
*/
|
|
12718
|
-
MetricCategory: "fights" | "time" | "striking" | "grappling" | "records";
|
|
14494
|
+
MetricCategory: "fights" | "time" | "striking" | "grappling" | "discipline" | "records";
|
|
12719
14495
|
/**
|
|
12720
14496
|
* @description `rate` is a 0–1 fraction.
|
|
12721
14497
|
* @enum {string}
|
|
@@ -12731,7 +14507,7 @@ interface components {
|
|
|
12731
14507
|
* @description Board metric slug.
|
|
12732
14508
|
* @enum {string}
|
|
12733
14509
|
*/
|
|
12734
|
-
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";
|
|
12735
14511
|
scope: components["schemas"]["MetricScope"];
|
|
12736
14512
|
category: components["schemas"]["MetricCategory"];
|
|
12737
14513
|
/**
|
|
@@ -13124,9 +14900,9 @@ interface components {
|
|
|
13124
14900
|
sources: number;
|
|
13125
14901
|
/**
|
|
13126
14902
|
* Format: date-time
|
|
13127
|
-
* @description When this consensus point was recorded.
|
|
14903
|
+
* @description When this consensus point was recorded. Null only on an `opening` from the archive before point-by-point tracking, where the time the line opened was never recorded.
|
|
13128
14904
|
*/
|
|
13129
|
-
recorded_at: string;
|
|
14905
|
+
recorded_at: string | null;
|
|
13130
14906
|
};
|
|
13131
14907
|
OddsMovement: {
|
|
13132
14908
|
/** @description Implied-probability points on corner a, opening → consensus (2 places). Positive = the market moved toward a. */
|
|
@@ -13138,9 +14914,9 @@ interface components {
|
|
|
13138
14914
|
direction: "a" | "b" | null;
|
|
13139
14915
|
/**
|
|
13140
14916
|
* Format: date-time
|
|
13141
|
-
* @description When the opening point was recorded.
|
|
14917
|
+
* @description When the opening point was recorded; null when the opening comes from the archive and its time is unknown.
|
|
13142
14918
|
*/
|
|
13143
|
-
since: string;
|
|
14919
|
+
since: string | null;
|
|
13144
14920
|
};
|
|
13145
14921
|
/** @description One prop market's consensus price: the mean, in decimal space, across the sportsbooks we track, converted back to American. */
|
|
13146
14922
|
PropLine: {
|
|
@@ -13178,7 +14954,7 @@ interface components {
|
|
|
13178
14954
|
/** @description This corner wins by decision. */
|
|
13179
14955
|
dec: components["schemas"]["PropLine"] | null;
|
|
13180
14956
|
};
|
|
13181
|
-
/** @description Prop-market consensus for one bout. Prediction markets and exchanges are excluded and a book far from the rest is dropped; a market needs at least two sportsbooks. Prices are recorded until the event
|
|
14957
|
+
/** @description Prop-market consensus for one bout. Prediction markets and exchanges are excluded and a book far from the rest is dropped; a market needs at least two sportsbooks. Prices are recorded until the bout's own card section starts (the event start when that time is not known). Props for 2021-2025 were backfilled as one closing consensus per market (three sportsbooks minimum), stamped at the event start: treat that time as approximate. Information only, not betting advice. */
|
|
13182
14958
|
FightProps: {
|
|
13183
14959
|
/** @description Method of victory per corner (oriented to the bout's `fighter_a` / `fighter_b`). */
|
|
13184
14960
|
method: {
|
|
@@ -13189,7 +14965,7 @@ interface components {
|
|
|
13189
14965
|
total_rounds: components["schemas"]["PropTotalRounds"][];
|
|
13190
14966
|
/** @description The fight goes the distance (yes) or ends inside it (no). */
|
|
13191
14967
|
distance: components["schemas"]["PropLine"] | null;
|
|
13192
|
-
/** @description True once the bout is settled: every price is the last
|
|
14968
|
+
/** @description True once the bout is settled: every price is the closing price. On bouts recorded live (2026 onward) that is the last price before the bout's own card section started, with its real timestamp; on bouts from 2021-2025 it was backfilled, and `recorded_at` is the event start, not the moment the price was observed. */
|
|
13193
14969
|
closing: boolean;
|
|
13194
14970
|
/**
|
|
13195
14971
|
* Format: date-time
|
|
@@ -13221,9 +14997,9 @@ interface components {
|
|
|
13221
14997
|
} | null;
|
|
13222
14998
|
/** @description The current consensus line: the latest point while the bout is upcoming, the closing line once it is settled (a finished bout never reports a post-bell price). Null when the bout was never priced. */
|
|
13223
14999
|
consensus: components["schemas"]["OddsPair"] | null;
|
|
13224
|
-
/** @description The first consensus point we recorded. */
|
|
15000
|
+
/** @description The opening line. On a bout tracked point by point: the first consensus point we recorded. On a settled bout from the archive that stores only its closing point (`points: 1`): the mean of each sportsbook's own opening price, with `recorded_at: null` because that time was never recorded. */
|
|
13225
15001
|
opening: components["schemas"]["OddsPair"] | null;
|
|
13226
|
-
/** @description Settled bouts only (`completed` / `no_contest`): the last point at or before the event start. Null until then. */
|
|
15002
|
+
/** @description Settled bouts only (`completed` / `no_contest`): the last point at or before the start of the bout's own card section (main card, prelims or early prelims; the event start when that time is not known). Null until then. */
|
|
13227
15003
|
closing: components["schemas"]["OddsPair"] | null;
|
|
13228
15004
|
movement: components["schemas"]["OddsMovement"] | null;
|
|
13229
15005
|
/** @description Stored consensus points (0 = never priced). The full series is `/v1/fights/{id}/odds/history` (Pro+). */
|
|
@@ -13252,9 +15028,9 @@ interface components {
|
|
|
13252
15028
|
} | null;
|
|
13253
15029
|
/** @description The current consensus line: the latest point while the bout is upcoming, the closing line once it is settled (a finished bout never reports a post-bell price). Null when the bout was never priced. */
|
|
13254
15030
|
consensus: components["schemas"]["OddsPair"] | null;
|
|
13255
|
-
/** @description The first consensus point we recorded. */
|
|
15031
|
+
/** @description The opening line. On a bout tracked point by point: the first consensus point we recorded. On a settled bout from the archive that stores only its closing point (`points: 1`): the mean of each sportsbook's own opening price, with `recorded_at: null` because that time was never recorded. */
|
|
13256
15032
|
opening: components["schemas"]["OddsPair"] | null;
|
|
13257
|
-
/** @description Settled bouts only (`completed` / `no_contest`): the last point at or before the event start. Null until then. */
|
|
15033
|
+
/** @description Settled bouts only (`completed` / `no_contest`): the last point at or before the start of the bout's own card section (main card, prelims or early prelims; the event start when that time is not known). Null until then. */
|
|
13258
15034
|
closing: components["schemas"]["OddsPair"] | null;
|
|
13259
15035
|
movement: components["schemas"]["OddsMovement"] | null;
|
|
13260
15036
|
/** @description Stored consensus points (0 = never priced). The full series is `/v1/fights/{id}/odds/history` (Pro+). */
|
|
@@ -13289,9 +15065,9 @@ interface components {
|
|
|
13289
15065
|
sources: number;
|
|
13290
15066
|
/**
|
|
13291
15067
|
* Format: date-time
|
|
13292
|
-
* @description When this consensus point was recorded.
|
|
15068
|
+
* @description When this consensus point was recorded. Null only on an `opening` from the archive before point-by-point tracking, where the time the line opened was never recorded.
|
|
13293
15069
|
*/
|
|
13294
|
-
recorded_at: string;
|
|
15070
|
+
recorded_at: string | null;
|
|
13295
15071
|
};
|
|
13296
15072
|
/** @description A per-event change entry plus its event (`/v1/changes`). */
|
|
13297
15073
|
ChangeFeedEntry: {
|
|
@@ -13727,6 +15503,34 @@ interface components {
|
|
|
13727
15503
|
ignored_params?: string[];
|
|
13728
15504
|
};
|
|
13729
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
|
+
};
|
|
13730
15534
|
JudgesPageResponse: {
|
|
13731
15535
|
data: components["schemas"]["Judge"][];
|
|
13732
15536
|
meta: {
|
|
@@ -13871,6 +15675,37 @@ interface components {
|
|
|
13871
15675
|
ignored_params?: string[];
|
|
13872
15676
|
};
|
|
13873
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
|
+
};
|
|
13874
15709
|
RankingsBoardResponse: {
|
|
13875
15710
|
data: components["schemas"]["RankingsBoardSnapshot"];
|
|
13876
15711
|
meta: {
|
|
@@ -14097,4 +15932,4 @@ interface components {
|
|
|
14097
15932
|
}
|
|
14098
15933
|
type operations = Record<string, never>;
|
|
14099
15934
|
|
|
14100
|
-
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 };
|