@ufcalendar/sdk 0.8.4 → 0.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +18 -1
- package/dist/index.cjs +109 -29
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +1228 -105
- package/dist/index.d.ts +1228 -105
- package/dist/index.js +107 -29
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/dist/index.d.cts
CHANGED
|
@@ -673,6 +673,9 @@ interface CareerBout {
|
|
|
673
673
|
time_seconds: number | null;
|
|
674
674
|
weight_class: string | null;
|
|
675
675
|
sport: string | null;
|
|
676
|
+
/** UFCalendar fantasy points for this fighter's corner — settled
|
|
677
|
+
* launch-promotion bouts with per-fight totals; null otherwise. */
|
|
678
|
+
fantasy_points: number | null;
|
|
676
679
|
[k: string]: unknown;
|
|
677
680
|
}
|
|
678
681
|
interface RankingEntry {
|
|
@@ -1340,8 +1343,115 @@ interface Article {
|
|
|
1340
1343
|
/** Delivered language: the translation when one exists, English otherwise. */
|
|
1341
1344
|
served_locale: ArticleLocale;
|
|
1342
1345
|
}
|
|
1346
|
+
/** Points per scoring category; a null category scored nothing. */
|
|
1347
|
+
interface FantasyBreakdown {
|
|
1348
|
+
/** Total strikes landed × 0.2. */
|
|
1349
|
+
strikes: number | null;
|
|
1350
|
+
/** Significant strikes landed × 0.2 (on top of the total-strike point). */
|
|
1351
|
+
sig_strikes: number | null;
|
|
1352
|
+
/** Control time × 0.03 per second. */
|
|
1353
|
+
control: number | null;
|
|
1354
|
+
/** Takedowns landed × 5. */
|
|
1355
|
+
takedowns: number | null;
|
|
1356
|
+
/** Reversals × 5. */
|
|
1357
|
+
reversals: number | null;
|
|
1358
|
+
/** Knockdowns × 10. */
|
|
1359
|
+
knockdowns: number | null;
|
|
1360
|
+
/** R1 finish 90 · R2 70 · R3 45 · R4/R5 40 · decision win 30; 0 for a loss, draw, NC or DQ win. */
|
|
1361
|
+
win_bonus: number | null;
|
|
1362
|
+
/** 25 for a finish inside the first 60 s of round 1. */
|
|
1363
|
+
quick_win_bonus: number | null;
|
|
1364
|
+
}
|
|
1365
|
+
/** UFCalendar fantasy points for one corner of one bout. */
|
|
1366
|
+
interface Fantasy {
|
|
1367
|
+
points: number;
|
|
1368
|
+
breakdown: FantasyBreakdown;
|
|
1369
|
+
/** false = a stat is missing or the bout is not settled; `points` is then a floor. */
|
|
1370
|
+
complete: boolean;
|
|
1371
|
+
}
|
|
1372
|
+
/** One corner's per-fight totals (`GET /v1/fights/{id}/stats`). */
|
|
1373
|
+
interface FightStatLine {
|
|
1374
|
+
fighter_id: number;
|
|
1375
|
+
fighter_position: number;
|
|
1376
|
+
corner: 'a' | 'b' | null;
|
|
1377
|
+
knockdowns: number | null;
|
|
1378
|
+
sig_strikes_landed: number | null;
|
|
1379
|
+
sig_strikes_attempted: number | null;
|
|
1380
|
+
total_strikes_landed: number | null;
|
|
1381
|
+
total_strikes_attempted: number | null;
|
|
1382
|
+
takedowns_landed: number | null;
|
|
1383
|
+
takedowns_attempted: number | null;
|
|
1384
|
+
submission_attempts: number | null;
|
|
1385
|
+
reversals: number | null;
|
|
1386
|
+
control_time_sec: number | null;
|
|
1387
|
+
fantasy: Fantasy;
|
|
1388
|
+
[k: string]: unknown;
|
|
1389
|
+
}
|
|
1390
|
+
/** `meta.quality` on `GET /v1/fights/{id}/stats` (read `lastMeta.quality`). */
|
|
1391
|
+
interface StatsQuality {
|
|
1392
|
+
has_totals: boolean;
|
|
1393
|
+
has_rounds: boolean;
|
|
1394
|
+
has_position_data: boolean;
|
|
1395
|
+
/** Round sums of sig strikes / takedowns / knockdowns equal the totals; null with no rounds. */
|
|
1396
|
+
rounds_sum_matches_totals: boolean | null;
|
|
1397
|
+
}
|
|
1398
|
+
interface Referee {
|
|
1399
|
+
/** A slug of the name — spelling variants fold together. */
|
|
1400
|
+
slug: string;
|
|
1401
|
+
name: string;
|
|
1402
|
+
bouts: number;
|
|
1403
|
+
orgs: string[];
|
|
1404
|
+
by_org: Array<{
|
|
1405
|
+
org: string;
|
|
1406
|
+
bouts: number;
|
|
1407
|
+
}>;
|
|
1408
|
+
first_bout: string | null;
|
|
1409
|
+
last_bout: string | null;
|
|
1410
|
+
/** (KO/TKO + submission) / bouts, 0–1. */
|
|
1411
|
+
finish_rate: number | null;
|
|
1412
|
+
methods: {
|
|
1413
|
+
ko_tko: number;
|
|
1414
|
+
submission: number;
|
|
1415
|
+
decision: number;
|
|
1416
|
+
other: number;
|
|
1417
|
+
};
|
|
1418
|
+
avg_fight_time_sec: number | null;
|
|
1419
|
+
}
|
|
1420
|
+
/** One row of `GET /v1/referees/{slug}/fights`: a bout plus its event. */
|
|
1421
|
+
type RefereeFightRow = FightSearchRow;
|
|
1422
|
+
interface CoverageCounts {
|
|
1423
|
+
events: number;
|
|
1424
|
+
fights_completed: number;
|
|
1425
|
+
fights_with_stats: number;
|
|
1426
|
+
fights_with_rounds: number;
|
|
1427
|
+
fights_with_scorecards: number;
|
|
1428
|
+
fights_with_odds: number;
|
|
1429
|
+
stats_rate: number | null;
|
|
1430
|
+
rounds_rate: number | null;
|
|
1431
|
+
scorecards_rate: number | null;
|
|
1432
|
+
odds_rate: number | null;
|
|
1433
|
+
}
|
|
1434
|
+
interface CoverageYear extends CoverageCounts {
|
|
1435
|
+
year: number;
|
|
1436
|
+
}
|
|
1437
|
+
/** One promotion's row of `GET /v1/coverage`. */
|
|
1438
|
+
interface OrgCoverage {
|
|
1439
|
+
org: string;
|
|
1440
|
+
last_result_at: string | null;
|
|
1441
|
+
totals: CoverageCounts;
|
|
1442
|
+
/** Newest first. */
|
|
1443
|
+
years: CoverageYear[];
|
|
1444
|
+
}
|
|
1343
1445
|
|
|
1344
1446
|
declare const DEFAULT_BASE_URL = "https://api.ufcalendar.com/v1";
|
|
1447
|
+
/** Default number of times a GET that hit the per-minute limit is retried. */
|
|
1448
|
+
declare const DEFAULT_MAX_RETRIES = 3;
|
|
1449
|
+
/**
|
|
1450
|
+
* A 429 whose `Retry-After` is longer than this is not waited out: the
|
|
1451
|
+
* per-minute limit always resets within a minute, anything longer is the
|
|
1452
|
+
* monthly quota (or something we do not understand) and must surface.
|
|
1453
|
+
*/
|
|
1454
|
+
declare const MAX_RETRY_AFTER_SECONDS = 60;
|
|
1345
1455
|
interface FightAPIOptions {
|
|
1346
1456
|
/** `ufcalendar_…` key from https://www.ufcalendar.com/account/api. Falls back
|
|
1347
1457
|
* to `UFCALENDAR_API_KEY` / `UFCAL_API_KEY` in the environment. Only
|
|
@@ -1355,6 +1465,15 @@ interface FightAPIOptions {
|
|
|
1355
1465
|
timeoutMs?: number;
|
|
1356
1466
|
/** Extra headers on every request. */
|
|
1357
1467
|
headers?: Record<string, string>;
|
|
1468
|
+
/**
|
|
1469
|
+
* How many times a GET that hit the per-minute limit (429 `rate_limited`
|
|
1470
|
+
* with `Retry-After` ≤ 60 s) is retried after waiting `Retry-After` plus a
|
|
1471
|
+
* little jitter. Default 3; `0` disables. The monthly quota
|
|
1472
|
+
* (`quota_exceeded`) and non-GET requests always throw at once.
|
|
1473
|
+
*/
|
|
1474
|
+
maxRetries?: number;
|
|
1475
|
+
/** Replace the wait between rate-limit retries (tests, custom schedulers). */
|
|
1476
|
+
sleep?: (ms: number) => Promise<void>;
|
|
1358
1477
|
}
|
|
1359
1478
|
/** An error response from the Fight API. */
|
|
1360
1479
|
declare class FightAPIError extends Error {
|
|
@@ -1369,6 +1488,8 @@ declare class FightAPI {
|
|
|
1369
1488
|
#private;
|
|
1370
1489
|
readonly baseUrl: string;
|
|
1371
1490
|
readonly apiKey: string | undefined;
|
|
1491
|
+
/** Retries of a GET that hit the per-minute limit (see `FightAPIOptions.maxRetries`). */
|
|
1492
|
+
readonly maxRetries: number;
|
|
1372
1493
|
/** `meta` of the most recent response (pagination cursor, generated_at …). */
|
|
1373
1494
|
lastMeta: Meta | null;
|
|
1374
1495
|
/** `X-RateLimit-*` of the most recent response. */
|
|
@@ -1488,8 +1609,12 @@ declare class FightAPI {
|
|
|
1488
1609
|
to?: string;
|
|
1489
1610
|
limit?: number;
|
|
1490
1611
|
}): AsyncGenerator<OddsHistoryPoint, void, void>;
|
|
1491
|
-
/**
|
|
1492
|
-
|
|
1612
|
+
/**
|
|
1613
|
+
* Per-fight totals for both corners, each with `fantasy` — UFCalendar
|
|
1614
|
+
* fantasy points with a per-category breakdown and `complete`. The
|
|
1615
|
+
* data-quality flags ride in `lastMeta.quality` (`StatsQuality`).
|
|
1616
|
+
*/
|
|
1617
|
+
fightStats(fightId: number | string): Promise<FightStatLine[]>;
|
|
1493
1618
|
/** Round-by-round stat lines for both corners. */
|
|
1494
1619
|
fightRounds(fightId: number | string): Promise<Record<string, unknown>[]>;
|
|
1495
1620
|
/**
|
|
@@ -1553,6 +1678,30 @@ declare class FightAPI {
|
|
|
1553
1678
|
judgeScorecards(judgeId: number | string, opts?: {
|
|
1554
1679
|
limit?: number;
|
|
1555
1680
|
}): AsyncGenerator<JudgeScorecardRow, void, void>;
|
|
1681
|
+
/**
|
|
1682
|
+
* Every referee who has worked a settled launch-org bout, busiest first:
|
|
1683
|
+
* bouts, promotions, finish rate, method mix and average fight time. The
|
|
1684
|
+
* id is a slug of the name; `q` is accent- and spacing-insensitive.
|
|
1685
|
+
*/
|
|
1686
|
+
referees(opts?: {
|
|
1687
|
+
q?: string;
|
|
1688
|
+
org?: string;
|
|
1689
|
+
limit?: number;
|
|
1690
|
+
}): AsyncGenerator<Referee, void, void>;
|
|
1691
|
+
/** One referee's career aggregates, e.g. `referee('herb-dean')`. */
|
|
1692
|
+
referee(slug: string): Promise<Referee>;
|
|
1693
|
+
/** Every settled bout one referee worked, newest first (the bout plus its `event`). */
|
|
1694
|
+
refereeFights(slug: string, opts?: {
|
|
1695
|
+
limit?: number;
|
|
1696
|
+
}): AsyncGenerator<RefereeFightRow, void, void>;
|
|
1697
|
+
/**
|
|
1698
|
+
* What the database holds per launch org per year: events, settled bouts
|
|
1699
|
+
* and how many carry stats, round stats, commission scorecards and a
|
|
1700
|
+
* consensus odds line, with `totals` and `last_result_at`.
|
|
1701
|
+
*/
|
|
1702
|
+
coverage(opts?: {
|
|
1703
|
+
org?: string;
|
|
1704
|
+
}): Promise<OrgCoverage[]>;
|
|
1556
1705
|
fighters(opts?: {
|
|
1557
1706
|
q?: string;
|
|
1558
1707
|
org?: string;
|
|
@@ -1740,7 +1889,7 @@ declare class FightAPI {
|
|
|
1740
1889
|
|
|
1741
1890
|
/** Kept in lockstep with package.json and the User-Agent by
|
|
1742
1891
|
* `apps/api/src/surfaces.test.ts`. Bump all three together. */
|
|
1743
|
-
declare const VERSION = "0.
|
|
1892
|
+
declare const VERSION = "0.9.0";
|
|
1744
1893
|
|
|
1745
1894
|
/**
|
|
1746
1895
|
* This file was auto-generated by openapi-typescript.
|
|
@@ -4067,6 +4216,10 @@ interface paths {
|
|
|
4067
4216
|
/**
|
|
4068
4217
|
* Per-fight totals
|
|
4069
4218
|
* @description Both corners: knockdowns, significant/total strikes, takedowns, submission attempts, reversals, control time, and target/position splits (head/body/leg, distance/clinch/ground) where the source provides them. Each line carries `corner` (`a` = the bout's `fighter_a`, `b` = `fighter_b`) beside the stored `fighter_position` (1/2). `distance_time_sec`, `clinch_time_sec`, `ground_time_sec` (integers, nullable) are seconds spent at distance / in the clinch / on the ground, and can appear alongside official strike counts on any org (position time is filled in even where the rest of the row comes from the official stats).
|
|
4219
|
+
*
|
|
4220
|
+
* **UFCalendar fantasy points** (`fantasy` on each line): a classic daily-fantasy-style MMA score for that corner — total strikes landed +0.2, significant strikes landed +0.2 (on top), control time +0.03 per second, takedown +5, reversal +5, knockdown +10; win bonus R1 finish +90, R2 finish +70, R3 finish +45, R4/R5 finish +40, decision win +30; quick-win bonus +25 for a finish inside the first 60 seconds of R1. A finish is KO/TKO or submission; a loss, draw, no contest or DQ win earns no bonus. `fantasy.breakdown` gives the points per category; a category the source does not publish is null and scores nothing, and `fantasy.complete` is then false (`points` is a floor, never a guess) — also false until the bout is settled. Reversals are the one exception: only some promotions publish them, so a missing reversal count never makes a line incomplete.
|
|
4221
|
+
*
|
|
4222
|
+
* **Data-quality flags** (`meta.quality`): `has_totals`, `has_rounds`, `has_position_data` (distance/clinch/ground splits or position time), and `rounds_sum_matches_totals` — per corner, do the round sums of significant strikes, takedowns and knockdowns equal the totals (null when there are no rounds or nothing comparable). Filter on it before charting.
|
|
4070
4223
|
*/
|
|
4071
4224
|
get: {
|
|
4072
4225
|
parameters: {
|
|
@@ -4097,6 +4250,109 @@ interface paths {
|
|
|
4097
4250
|
[name: string]: unknown;
|
|
4098
4251
|
};
|
|
4099
4252
|
content: {
|
|
4253
|
+
/**
|
|
4254
|
+
* @example {
|
|
4255
|
+
* "data": [
|
|
4256
|
+
* {
|
|
4257
|
+
* "fighter_id": 1665,
|
|
4258
|
+
* "fighter_position": 1,
|
|
4259
|
+
* "knockdowns": 1,
|
|
4260
|
+
* "sig_strikes_landed": 96,
|
|
4261
|
+
* "sig_strikes_attempted": 119,
|
|
4262
|
+
* "total_strikes_landed": 104,
|
|
4263
|
+
* "total_strikes_attempted": 128,
|
|
4264
|
+
* "takedowns_landed": 1,
|
|
4265
|
+
* "takedowns_attempted": 1,
|
|
4266
|
+
* "submission_attempts": 0,
|
|
4267
|
+
* "reversals": 0,
|
|
4268
|
+
* "control_time_sec": 231,
|
|
4269
|
+
* "distance_time_sec": 625,
|
|
4270
|
+
* "clinch_time_sec": 20,
|
|
4271
|
+
* "ground_time_sec": 230,
|
|
4272
|
+
* "head_landed": 70,
|
|
4273
|
+
* "head_attempted": 91,
|
|
4274
|
+
* "body_landed": 16,
|
|
4275
|
+
* "body_attempted": 18,
|
|
4276
|
+
* "leg_landed": 10,
|
|
4277
|
+
* "leg_attempted": 10,
|
|
4278
|
+
* "distance_landed": 54,
|
|
4279
|
+
* "distance_attempted": 70,
|
|
4280
|
+
* "clinch_landed": 2,
|
|
4281
|
+
* "clinch_attempted": 3,
|
|
4282
|
+
* "ground_landed": 40,
|
|
4283
|
+
* "ground_attempted": 46,
|
|
4284
|
+
* "corner": "a",
|
|
4285
|
+
* "fantasy": {
|
|
4286
|
+
* "points": 106.93,
|
|
4287
|
+
* "breakdown": {
|
|
4288
|
+
* "strikes": 20.8,
|
|
4289
|
+
* "sig_strikes": 19.2,
|
|
4290
|
+
* "control": 6.93,
|
|
4291
|
+
* "takedowns": 5,
|
|
4292
|
+
* "reversals": 0,
|
|
4293
|
+
* "knockdowns": 10,
|
|
4294
|
+
* "win_bonus": 45,
|
|
4295
|
+
* "quick_win_bonus": 0
|
|
4296
|
+
* },
|
|
4297
|
+
* "complete": true
|
|
4298
|
+
* }
|
|
4299
|
+
* },
|
|
4300
|
+
* {
|
|
4301
|
+
* "fighter_id": 1946,
|
|
4302
|
+
* "fighter_position": 2,
|
|
4303
|
+
* "knockdowns": 0,
|
|
4304
|
+
* "sig_strikes_landed": 37,
|
|
4305
|
+
* "sig_strikes_attempted": 89,
|
|
4306
|
+
* "total_strikes_landed": 42,
|
|
4307
|
+
* "total_strikes_attempted": 94,
|
|
4308
|
+
* "takedowns_landed": 0,
|
|
4309
|
+
* "takedowns_attempted": 0,
|
|
4310
|
+
* "submission_attempts": 0,
|
|
4311
|
+
* "reversals": 0,
|
|
4312
|
+
* "control_time_sec": 0,
|
|
4313
|
+
* "distance_time_sec": 625,
|
|
4314
|
+
* "clinch_time_sec": 20,
|
|
4315
|
+
* "ground_time_sec": 230,
|
|
4316
|
+
* "head_landed": 24,
|
|
4317
|
+
* "head_attempted": 75,
|
|
4318
|
+
* "body_landed": 7,
|
|
4319
|
+
* "body_attempted": 8,
|
|
4320
|
+
* "leg_landed": 6,
|
|
4321
|
+
* "leg_attempted": 6,
|
|
4322
|
+
* "distance_landed": 32,
|
|
4323
|
+
* "distance_attempted": 83,
|
|
4324
|
+
* "clinch_landed": 4,
|
|
4325
|
+
* "clinch_attempted": 5,
|
|
4326
|
+
* "ground_landed": 1,
|
|
4327
|
+
* "ground_attempted": 1,
|
|
4328
|
+
* "corner": "b",
|
|
4329
|
+
* "fantasy": {
|
|
4330
|
+
* "points": 15.8,
|
|
4331
|
+
* "breakdown": {
|
|
4332
|
+
* "strikes": 8.4,
|
|
4333
|
+
* "sig_strikes": 7.4,
|
|
4334
|
+
* "control": 0,
|
|
4335
|
+
* "takedowns": 0,
|
|
4336
|
+
* "reversals": 0,
|
|
4337
|
+
* "knockdowns": 0,
|
|
4338
|
+
* "win_bonus": 0,
|
|
4339
|
+
* "quick_win_bonus": 0
|
|
4340
|
+
* },
|
|
4341
|
+
* "complete": true
|
|
4342
|
+
* }
|
|
4343
|
+
* }
|
|
4344
|
+
* ],
|
|
4345
|
+
* "meta": {
|
|
4346
|
+
* "fight_id": 60381,
|
|
4347
|
+
* "quality": {
|
|
4348
|
+
* "has_totals": true,
|
|
4349
|
+
* "has_rounds": true,
|
|
4350
|
+
* "has_position_data": true,
|
|
4351
|
+
* "rounds_sum_matches_totals": true
|
|
4352
|
+
* }
|
|
4353
|
+
* }
|
|
4354
|
+
* }
|
|
4355
|
+
*/
|
|
4100
4356
|
"application/json": components["schemas"]["FightStatsResponse"];
|
|
4101
4357
|
};
|
|
4102
4358
|
};
|
|
@@ -5325,15 +5581,630 @@ interface paths {
|
|
|
5325
5581
|
* "split_rate": 0.2011,
|
|
5326
5582
|
* "lone_dissent_rate": 0.1023
|
|
5327
5583
|
* },
|
|
5328
|
-
* "pagination": {
|
|
5329
|
-
* "next_cursor": "eyJpZCI6NX0",
|
|
5330
|
-
* "has_more": true,
|
|
5331
|
-
* "limit": 25
|
|
5332
|
-
* }
|
|
5333
|
-
* }
|
|
5584
|
+
* "pagination": {
|
|
5585
|
+
* "next_cursor": "eyJpZCI6NX0",
|
|
5586
|
+
* "has_more": true,
|
|
5587
|
+
* "limit": 25
|
|
5588
|
+
* }
|
|
5589
|
+
* }
|
|
5590
|
+
* }
|
|
5591
|
+
*/
|
|
5592
|
+
"application/json": components["schemas"]["JudgesPageResponse"];
|
|
5593
|
+
};
|
|
5594
|
+
};
|
|
5595
|
+
/** @description Not Modified — `If-None-Match` matched the current weak `ETag`. Empty body. */
|
|
5596
|
+
304: {
|
|
5597
|
+
headers: {
|
|
5598
|
+
[name: string]: unknown;
|
|
5599
|
+
};
|
|
5600
|
+
content?: never;
|
|
5601
|
+
};
|
|
5602
|
+
/** @description Invalid input (`invalid_org`, `invalid_cursor`). */
|
|
5603
|
+
400: {
|
|
5604
|
+
headers: {
|
|
5605
|
+
[name: string]: unknown;
|
|
5606
|
+
};
|
|
5607
|
+
content: {
|
|
5608
|
+
"application/json": components["schemas"]["Error"];
|
|
5609
|
+
};
|
|
5610
|
+
};
|
|
5611
|
+
/** @description Missing/invalid API key (`unauthorized`). */
|
|
5612
|
+
401: {
|
|
5613
|
+
headers: {
|
|
5614
|
+
[name: string]: unknown;
|
|
5615
|
+
};
|
|
5616
|
+
content: {
|
|
5617
|
+
"application/json": components["schemas"]["Error"];
|
|
5618
|
+
};
|
|
5619
|
+
};
|
|
5620
|
+
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
|
|
5621
|
+
403: {
|
|
5622
|
+
headers: {
|
|
5623
|
+
[name: string]: unknown;
|
|
5624
|
+
};
|
|
5625
|
+
content: {
|
|
5626
|
+
"application/json": components["schemas"]["Error"];
|
|
5627
|
+
};
|
|
5628
|
+
};
|
|
5629
|
+
/** @description Not found (`not_found`; staged-org data 404s until the org is promoted). */
|
|
5630
|
+
404: {
|
|
5631
|
+
headers: {
|
|
5632
|
+
[name: string]: unknown;
|
|
5633
|
+
};
|
|
5634
|
+
content: {
|
|
5635
|
+
"application/json": components["schemas"]["Error"];
|
|
5636
|
+
};
|
|
5637
|
+
};
|
|
5638
|
+
/** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
|
|
5639
|
+
429: {
|
|
5640
|
+
headers: {
|
|
5641
|
+
[name: string]: unknown;
|
|
5642
|
+
};
|
|
5643
|
+
content: {
|
|
5644
|
+
"application/json": components["schemas"]["Error"];
|
|
5645
|
+
};
|
|
5646
|
+
};
|
|
5647
|
+
/** @description Something broke on our side (`internal_error`). It has been logged under the `request_id`. */
|
|
5648
|
+
500: {
|
|
5649
|
+
headers: {
|
|
5650
|
+
[name: string]: unknown;
|
|
5651
|
+
};
|
|
5652
|
+
content: {
|
|
5653
|
+
"application/json": components["schemas"]["Error"];
|
|
5654
|
+
};
|
|
5655
|
+
};
|
|
5656
|
+
};
|
|
5657
|
+
};
|
|
5658
|
+
put?: never;
|
|
5659
|
+
post?: never;
|
|
5660
|
+
delete?: never;
|
|
5661
|
+
options?: never;
|
|
5662
|
+
head?: never;
|
|
5663
|
+
patch?: never;
|
|
5664
|
+
trace?: never;
|
|
5665
|
+
};
|
|
5666
|
+
"/v1/judges/{id}": {
|
|
5667
|
+
parameters: {
|
|
5668
|
+
query?: never;
|
|
5669
|
+
header?: never;
|
|
5670
|
+
path?: never;
|
|
5671
|
+
cookie?: never;
|
|
5672
|
+
};
|
|
5673
|
+
/**
|
|
5674
|
+
* One judge
|
|
5675
|
+
* @description A single official's career aggregates. Same shape as a directory row.
|
|
5676
|
+
*/
|
|
5677
|
+
get: {
|
|
5678
|
+
parameters: {
|
|
5679
|
+
query?: never;
|
|
5680
|
+
header?: never;
|
|
5681
|
+
path: {
|
|
5682
|
+
id: number;
|
|
5683
|
+
};
|
|
5684
|
+
cookie?: never;
|
|
5685
|
+
};
|
|
5686
|
+
requestBody?: never;
|
|
5687
|
+
responses: {
|
|
5688
|
+
/** @description Judge */
|
|
5689
|
+
200: {
|
|
5690
|
+
headers: {
|
|
5691
|
+
/** @description Weak validator over the body, e.g. `W/"GKrimLo826WBqG27jbNFsW2ZHmA"`. Send it back as `If-None-Match` to get a 304. */
|
|
5692
|
+
ETag?: string;
|
|
5693
|
+
/** @description Always `private, no-cache`. */
|
|
5694
|
+
"Cache-Control"?: string;
|
|
5695
|
+
/** @description Monthly request quota of the plan. */
|
|
5696
|
+
"X-RateLimit-Limit"?: number;
|
|
5697
|
+
/** @description Requests left this month. */
|
|
5698
|
+
"X-RateLimit-Remaining"?: number;
|
|
5699
|
+
/** @description Unix seconds of the monthly reset. */
|
|
5700
|
+
"X-RateLimit-Reset"?: number;
|
|
5701
|
+
/** @description Quote it to support; the same id is in every error body. */
|
|
5702
|
+
"x-request-id"?: string;
|
|
5703
|
+
[name: string]: unknown;
|
|
5704
|
+
};
|
|
5705
|
+
content: {
|
|
5706
|
+
"application/json": components["schemas"]["JudgeResponse"];
|
|
5707
|
+
};
|
|
5708
|
+
};
|
|
5709
|
+
/** @description Not Modified — `If-None-Match` matched the current weak `ETag`. Empty body. */
|
|
5710
|
+
304: {
|
|
5711
|
+
headers: {
|
|
5712
|
+
[name: string]: unknown;
|
|
5713
|
+
};
|
|
5714
|
+
content?: never;
|
|
5715
|
+
};
|
|
5716
|
+
/** @description Missing/invalid API key (`unauthorized`). */
|
|
5717
|
+
401: {
|
|
5718
|
+
headers: {
|
|
5719
|
+
[name: string]: unknown;
|
|
5720
|
+
};
|
|
5721
|
+
content: {
|
|
5722
|
+
"application/json": components["schemas"]["Error"];
|
|
5723
|
+
};
|
|
5724
|
+
};
|
|
5725
|
+
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
|
|
5726
|
+
403: {
|
|
5727
|
+
headers: {
|
|
5728
|
+
[name: string]: unknown;
|
|
5729
|
+
};
|
|
5730
|
+
content: {
|
|
5731
|
+
"application/json": components["schemas"]["Error"];
|
|
5732
|
+
};
|
|
5733
|
+
};
|
|
5734
|
+
/** @description Not found (`not_found`; staged-org data 404s until the org is promoted). */
|
|
5735
|
+
404: {
|
|
5736
|
+
headers: {
|
|
5737
|
+
[name: string]: unknown;
|
|
5738
|
+
};
|
|
5739
|
+
content: {
|
|
5740
|
+
"application/json": components["schemas"]["Error"];
|
|
5741
|
+
};
|
|
5742
|
+
};
|
|
5743
|
+
/** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
|
|
5744
|
+
429: {
|
|
5745
|
+
headers: {
|
|
5746
|
+
[name: string]: unknown;
|
|
5747
|
+
};
|
|
5748
|
+
content: {
|
|
5749
|
+
"application/json": components["schemas"]["Error"];
|
|
5750
|
+
};
|
|
5751
|
+
};
|
|
5752
|
+
/** @description Something broke on our side (`internal_error`). It has been logged under the `request_id`. */
|
|
5753
|
+
500: {
|
|
5754
|
+
headers: {
|
|
5755
|
+
[name: string]: unknown;
|
|
5756
|
+
};
|
|
5757
|
+
content: {
|
|
5758
|
+
"application/json": components["schemas"]["Error"];
|
|
5759
|
+
};
|
|
5760
|
+
};
|
|
5761
|
+
};
|
|
5762
|
+
};
|
|
5763
|
+
put?: never;
|
|
5764
|
+
post?: never;
|
|
5765
|
+
delete?: never;
|
|
5766
|
+
options?: never;
|
|
5767
|
+
head?: never;
|
|
5768
|
+
patch?: never;
|
|
5769
|
+
trace?: never;
|
|
5770
|
+
};
|
|
5771
|
+
"/v1/judges/{id}/scorecards": {
|
|
5772
|
+
parameters: {
|
|
5773
|
+
query?: never;
|
|
5774
|
+
header?: never;
|
|
5775
|
+
path?: never;
|
|
5776
|
+
cookie?: never;
|
|
5777
|
+
};
|
|
5778
|
+
/**
|
|
5779
|
+
* Everything a judge has scored
|
|
5780
|
+
* @description This judge's card for every launch-org bout they worked, newest first — the bout, its event, the decision type, and their own card, with where it sat on the panel: `lone_dissent` (three known verdicts and this judge alone differs from both others), `split` (three known verdicts that do not all agree) — both `null` when the panel is not three judges or a verdict is unknown — and `colleagues`, the other judges' totals and verdicts (the full round-by-round panel is on `/v1/fights/{id}/scorecards`). Cursor-paginated.
|
|
5781
|
+
*/
|
|
5782
|
+
get: {
|
|
5783
|
+
parameters: {
|
|
5784
|
+
query?: {
|
|
5785
|
+
/** @description Opaque cursor from `meta.pagination.next_cursor`. */
|
|
5786
|
+
cursor?: string;
|
|
5787
|
+
limit?: number;
|
|
5788
|
+
};
|
|
5789
|
+
header?: never;
|
|
5790
|
+
path: {
|
|
5791
|
+
id: number;
|
|
5792
|
+
};
|
|
5793
|
+
cookie?: never;
|
|
5794
|
+
};
|
|
5795
|
+
requestBody?: never;
|
|
5796
|
+
responses: {
|
|
5797
|
+
/** @description Cards, newest first */
|
|
5798
|
+
200: {
|
|
5799
|
+
headers: {
|
|
5800
|
+
/** @description Weak validator over the body, e.g. `W/"GKrimLo826WBqG27jbNFsW2ZHmA"`. Send it back as `If-None-Match` to get a 304. */
|
|
5801
|
+
ETag?: string;
|
|
5802
|
+
/** @description Always `private, no-cache`. */
|
|
5803
|
+
"Cache-Control"?: string;
|
|
5804
|
+
/** @description Monthly request quota of the plan. */
|
|
5805
|
+
"X-RateLimit-Limit"?: number;
|
|
5806
|
+
/** @description Requests left this month. */
|
|
5807
|
+
"X-RateLimit-Remaining"?: number;
|
|
5808
|
+
/** @description Unix seconds of the monthly reset. */
|
|
5809
|
+
"X-RateLimit-Reset"?: number;
|
|
5810
|
+
/** @description Quote it to support; the same id is in every error body. */
|
|
5811
|
+
"x-request-id"?: string;
|
|
5812
|
+
[name: string]: unknown;
|
|
5813
|
+
};
|
|
5814
|
+
content: {
|
|
5815
|
+
/**
|
|
5816
|
+
* @example {
|
|
5817
|
+
* "data": [
|
|
5818
|
+
* {
|
|
5819
|
+
* "fight_id": 83379,
|
|
5820
|
+
* "event": {
|
|
5821
|
+
* "id": 2507,
|
|
5822
|
+
* "slug": "ufc-fight-night-2026-08-29",
|
|
5823
|
+
* "title": "UFC Fight Night: Nurmagomedov vs Song",
|
|
5824
|
+
* "org": "ufc",
|
|
5825
|
+
* "starts_at": "2026-08-29T07:00:00.000Z"
|
|
5826
|
+
* },
|
|
5827
|
+
* "fighter_a_id": 213,
|
|
5828
|
+
* "fighter_b_id": 1120,
|
|
5829
|
+
* "decision_type": "split",
|
|
5830
|
+
* "card": {
|
|
5831
|
+
* "judge_id": 36,
|
|
5832
|
+
* "judge_name": "Vito Paolillo",
|
|
5833
|
+
* "total_a": 28,
|
|
5834
|
+
* "total_b": 29,
|
|
5835
|
+
* "winner_fighter_id": 1120,
|
|
5836
|
+
* "is_draw": false,
|
|
5837
|
+
* "scores_known": true,
|
|
5838
|
+
* "rounds": [
|
|
5839
|
+
* {
|
|
5840
|
+
* "round": 1,
|
|
5841
|
+
* "a": 9,
|
|
5842
|
+
* "b": 10
|
|
5843
|
+
* }
|
|
5844
|
+
* ]
|
|
5845
|
+
* },
|
|
5846
|
+
* "lone_dissent": false,
|
|
5847
|
+
* "split": true,
|
|
5848
|
+
* "colleagues": [
|
|
5849
|
+
* {
|
|
5850
|
+
* "judge_id": 34,
|
|
5851
|
+
* "judge_name": "Clemens Werner",
|
|
5852
|
+
* "total_a": 29,
|
|
5853
|
+
* "total_b": 28,
|
|
5854
|
+
* "winner_fighter_id": 213,
|
|
5855
|
+
* "is_draw": false
|
|
5856
|
+
* },
|
|
5857
|
+
* {
|
|
5858
|
+
* "judge_id": 17,
|
|
5859
|
+
* "judge_name": "Cezary Wojciechowski",
|
|
5860
|
+
* "total_a": 28,
|
|
5861
|
+
* "total_b": 29,
|
|
5862
|
+
* "winner_fighter_id": 1120,
|
|
5863
|
+
* "is_draw": false
|
|
5864
|
+
* }
|
|
5865
|
+
* ]
|
|
5866
|
+
* }
|
|
5867
|
+
* ],
|
|
5868
|
+
* "meta": {
|
|
5869
|
+
* "judge": {
|
|
5870
|
+
* "id": 36,
|
|
5871
|
+
* "name": "Vito Paolillo",
|
|
5872
|
+
* "fights": 412,
|
|
5873
|
+
* "rounds_scored": 1290,
|
|
5874
|
+
* "wide_rounds": 40,
|
|
5875
|
+
* "split_fights": 88,
|
|
5876
|
+
* "three_judge_fights": 410,
|
|
5877
|
+
* "lone_dissents": 31,
|
|
5878
|
+
* "first_scored": "2014-05-31",
|
|
5879
|
+
* "last_scored": "2026-08-29",
|
|
5880
|
+
* "orgs": [
|
|
5881
|
+
* "oktagon",
|
|
5882
|
+
* "ufc"
|
|
5883
|
+
* ]
|
|
5884
|
+
* },
|
|
5885
|
+
* "pagination": {
|
|
5886
|
+
* "next_cursor": null,
|
|
5887
|
+
* "has_more": false,
|
|
5888
|
+
* "limit": 25
|
|
5889
|
+
* }
|
|
5890
|
+
* }
|
|
5891
|
+
* }
|
|
5892
|
+
*/
|
|
5893
|
+
"application/json": components["schemas"]["JudgeScorecardsResponse"];
|
|
5894
|
+
};
|
|
5895
|
+
};
|
|
5896
|
+
/** @description Not Modified — `If-None-Match` matched the current weak `ETag`. Empty body. */
|
|
5897
|
+
304: {
|
|
5898
|
+
headers: {
|
|
5899
|
+
[name: string]: unknown;
|
|
5900
|
+
};
|
|
5901
|
+
content?: never;
|
|
5902
|
+
};
|
|
5903
|
+
/** @description Invalid input (`invalid_cursor`). */
|
|
5904
|
+
400: {
|
|
5905
|
+
headers: {
|
|
5906
|
+
[name: string]: unknown;
|
|
5907
|
+
};
|
|
5908
|
+
content: {
|
|
5909
|
+
"application/json": components["schemas"]["Error"];
|
|
5910
|
+
};
|
|
5911
|
+
};
|
|
5912
|
+
/** @description Missing/invalid API key (`unauthorized`). */
|
|
5913
|
+
401: {
|
|
5914
|
+
headers: {
|
|
5915
|
+
[name: string]: unknown;
|
|
5916
|
+
};
|
|
5917
|
+
content: {
|
|
5918
|
+
"application/json": components["schemas"]["Error"];
|
|
5919
|
+
};
|
|
5920
|
+
};
|
|
5921
|
+
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
|
|
5922
|
+
403: {
|
|
5923
|
+
headers: {
|
|
5924
|
+
[name: string]: unknown;
|
|
5925
|
+
};
|
|
5926
|
+
content: {
|
|
5927
|
+
"application/json": components["schemas"]["Error"];
|
|
5928
|
+
};
|
|
5929
|
+
};
|
|
5930
|
+
/** @description Not found (`not_found`; staged-org data 404s until the org is promoted). */
|
|
5931
|
+
404: {
|
|
5932
|
+
headers: {
|
|
5933
|
+
[name: string]: unknown;
|
|
5934
|
+
};
|
|
5935
|
+
content: {
|
|
5936
|
+
"application/json": components["schemas"]["Error"];
|
|
5937
|
+
};
|
|
5938
|
+
};
|
|
5939
|
+
/** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
|
|
5940
|
+
429: {
|
|
5941
|
+
headers: {
|
|
5942
|
+
[name: string]: unknown;
|
|
5943
|
+
};
|
|
5944
|
+
content: {
|
|
5945
|
+
"application/json": components["schemas"]["Error"];
|
|
5946
|
+
};
|
|
5947
|
+
};
|
|
5948
|
+
/** @description Something broke on our side (`internal_error`). It has been logged under the `request_id`. */
|
|
5949
|
+
500: {
|
|
5950
|
+
headers: {
|
|
5951
|
+
[name: string]: unknown;
|
|
5952
|
+
};
|
|
5953
|
+
content: {
|
|
5954
|
+
"application/json": components["schemas"]["Error"];
|
|
5955
|
+
};
|
|
5956
|
+
};
|
|
5957
|
+
};
|
|
5958
|
+
};
|
|
5959
|
+
put?: never;
|
|
5960
|
+
post?: never;
|
|
5961
|
+
delete?: never;
|
|
5962
|
+
options?: never;
|
|
5963
|
+
head?: never;
|
|
5964
|
+
patch?: never;
|
|
5965
|
+
trace?: never;
|
|
5966
|
+
};
|
|
5967
|
+
"/v1/referees": {
|
|
5968
|
+
parameters: {
|
|
5969
|
+
query?: never;
|
|
5970
|
+
header?: never;
|
|
5971
|
+
path?: never;
|
|
5972
|
+
cookie?: never;
|
|
5973
|
+
};
|
|
5974
|
+
/**
|
|
5975
|
+
* Referee directory
|
|
5976
|
+
* @description Every referee who has worked a settled launch-promotion bout, busiest first, with their career shape: bouts, promotions (`by_org`), first and last bout, `finish_rate` (KO/TKO + submission share), the method breakdown (`methods`: `ko_tko`, `submission`, `decision`, `other` = draws, no contests, disqualifications) and `avg_fight_time_sec` (elapsed time over bouts with a readable final round and clock, at the sport's standard round length).
|
|
5977
|
+
*
|
|
5978
|
+
* The referee is named on the bout record, not in a table of its own, so the id is a **slug of the name** (the site's slug rule): spelling variants fold into one referee, and two officials who share a name share a slug. Filter with `q` (accent- and spacing-insensitive name match) and `org`.
|
|
5979
|
+
*/
|
|
5980
|
+
get: {
|
|
5981
|
+
parameters: {
|
|
5982
|
+
query?: {
|
|
5983
|
+
/** @description Name fragment, accent- and spacing-insensitive. */
|
|
5984
|
+
q?: string;
|
|
5985
|
+
/** @description Launch org slug: `ufc`, `pfl`, `oktagon`, `bkfc` or `rizin`. Staged orgs 400 until promoted. */
|
|
5986
|
+
org?: "ufc" | "pfl" | "oktagon" | "bkfc" | "rizin";
|
|
5987
|
+
/** @description Opaque cursor from `meta.pagination.next_cursor`. */
|
|
5988
|
+
cursor?: string;
|
|
5989
|
+
limit?: number;
|
|
5990
|
+
};
|
|
5991
|
+
header?: never;
|
|
5992
|
+
path?: never;
|
|
5993
|
+
cookie?: never;
|
|
5994
|
+
};
|
|
5995
|
+
requestBody?: never;
|
|
5996
|
+
responses: {
|
|
5997
|
+
/** @description Referees page */
|
|
5998
|
+
200: {
|
|
5999
|
+
headers: {
|
|
6000
|
+
/** @description Weak validator over the body, e.g. `W/"GKrimLo826WBqG27jbNFsW2ZHmA"`. Send it back as `If-None-Match` to get a 304. */
|
|
6001
|
+
ETag?: string;
|
|
6002
|
+
/** @description Always `private, no-cache`. */
|
|
6003
|
+
"Cache-Control"?: string;
|
|
6004
|
+
/** @description Monthly request quota of the plan. */
|
|
6005
|
+
"X-RateLimit-Limit"?: number;
|
|
6006
|
+
/** @description Requests left this month. */
|
|
6007
|
+
"X-RateLimit-Remaining"?: number;
|
|
6008
|
+
/** @description Unix seconds of the monthly reset. */
|
|
6009
|
+
"X-RateLimit-Reset"?: number;
|
|
6010
|
+
/** @description Quote it to support; the same id is in every error body. */
|
|
6011
|
+
"x-request-id"?: string;
|
|
6012
|
+
[name: string]: unknown;
|
|
6013
|
+
};
|
|
6014
|
+
content: {
|
|
6015
|
+
/**
|
|
6016
|
+
* @example {
|
|
6017
|
+
* "data": [
|
|
6018
|
+
* {
|
|
6019
|
+
* "slug": "herb-dean",
|
|
6020
|
+
* "name": "Herb Dean",
|
|
6021
|
+
* "bouts": 1383,
|
|
6022
|
+
* "orgs": [
|
|
6023
|
+
* "pfl",
|
|
6024
|
+
* "ufc"
|
|
6025
|
+
* ],
|
|
6026
|
+
* "by_org": [
|
|
6027
|
+
* {
|
|
6028
|
+
* "org": "ufc",
|
|
6029
|
+
* "bouts": 1373
|
|
6030
|
+
* },
|
|
6031
|
+
* {
|
|
6032
|
+
* "org": "pfl",
|
|
6033
|
+
* "bouts": 10
|
|
6034
|
+
* }
|
|
6035
|
+
* ],
|
|
6036
|
+
* "first_bout": "2004-04-02",
|
|
6037
|
+
* "last_bout": "2026-10-10",
|
|
6038
|
+
* "finish_rate": 0.5633,
|
|
6039
|
+
* "methods": {
|
|
6040
|
+
* "ko_tko": 503,
|
|
6041
|
+
* "submission": 276,
|
|
6042
|
+
* "decision": 581,
|
|
6043
|
+
* "other": 23
|
|
6044
|
+
* },
|
|
6045
|
+
* "avg_fight_time_sec": 642
|
|
6046
|
+
* }
|
|
6047
|
+
* ],
|
|
6048
|
+
* "meta": {
|
|
6049
|
+
* "total": 418,
|
|
6050
|
+
* "pagination": {
|
|
6051
|
+
* "next_cursor": "eyJpZCI6Im1hcmMtZ29kZGFyZCIsInAiOjJ9",
|
|
6052
|
+
* "has_more": true,
|
|
6053
|
+
* "limit": 3
|
|
6054
|
+
* }
|
|
6055
|
+
* }
|
|
6056
|
+
* }
|
|
6057
|
+
*/
|
|
6058
|
+
"application/json": components["schemas"]["RefereesPageResponse"];
|
|
6059
|
+
};
|
|
6060
|
+
};
|
|
6061
|
+
/** @description Not Modified — `If-None-Match` matched the current weak `ETag`. Empty body. */
|
|
6062
|
+
304: {
|
|
6063
|
+
headers: {
|
|
6064
|
+
[name: string]: unknown;
|
|
6065
|
+
};
|
|
6066
|
+
content?: never;
|
|
6067
|
+
};
|
|
6068
|
+
/** @description Invalid input (`invalid_org`, `invalid_cursor`). */
|
|
6069
|
+
400: {
|
|
6070
|
+
headers: {
|
|
6071
|
+
[name: string]: unknown;
|
|
6072
|
+
};
|
|
6073
|
+
content: {
|
|
6074
|
+
"application/json": components["schemas"]["Error"];
|
|
6075
|
+
};
|
|
6076
|
+
};
|
|
6077
|
+
/** @description Missing/invalid API key (`unauthorized`). */
|
|
6078
|
+
401: {
|
|
6079
|
+
headers: {
|
|
6080
|
+
[name: string]: unknown;
|
|
6081
|
+
};
|
|
6082
|
+
content: {
|
|
6083
|
+
"application/json": components["schemas"]["Error"];
|
|
6084
|
+
};
|
|
6085
|
+
};
|
|
6086
|
+
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
|
|
6087
|
+
403: {
|
|
6088
|
+
headers: {
|
|
6089
|
+
[name: string]: unknown;
|
|
6090
|
+
};
|
|
6091
|
+
content: {
|
|
6092
|
+
"application/json": components["schemas"]["Error"];
|
|
6093
|
+
};
|
|
6094
|
+
};
|
|
6095
|
+
/** @description Not found (`not_found`; staged-org data 404s until the org is promoted). */
|
|
6096
|
+
404: {
|
|
6097
|
+
headers: {
|
|
6098
|
+
[name: string]: unknown;
|
|
6099
|
+
};
|
|
6100
|
+
content: {
|
|
6101
|
+
"application/json": components["schemas"]["Error"];
|
|
6102
|
+
};
|
|
6103
|
+
};
|
|
6104
|
+
/** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
|
|
6105
|
+
429: {
|
|
6106
|
+
headers: {
|
|
6107
|
+
[name: string]: unknown;
|
|
6108
|
+
};
|
|
6109
|
+
content: {
|
|
6110
|
+
"application/json": components["schemas"]["Error"];
|
|
6111
|
+
};
|
|
6112
|
+
};
|
|
6113
|
+
/** @description Something broke on our side (`internal_error`). It has been logged under the `request_id`. */
|
|
6114
|
+
500: {
|
|
6115
|
+
headers: {
|
|
6116
|
+
[name: string]: unknown;
|
|
6117
|
+
};
|
|
6118
|
+
content: {
|
|
6119
|
+
"application/json": components["schemas"]["Error"];
|
|
6120
|
+
};
|
|
6121
|
+
};
|
|
6122
|
+
};
|
|
6123
|
+
};
|
|
6124
|
+
put?: never;
|
|
6125
|
+
post?: never;
|
|
6126
|
+
delete?: never;
|
|
6127
|
+
options?: never;
|
|
6128
|
+
head?: never;
|
|
6129
|
+
patch?: never;
|
|
6130
|
+
trace?: never;
|
|
6131
|
+
};
|
|
6132
|
+
"/v1/referees/{slug}": {
|
|
6133
|
+
parameters: {
|
|
6134
|
+
query?: never;
|
|
6135
|
+
header?: never;
|
|
6136
|
+
path?: never;
|
|
6137
|
+
cookie?: never;
|
|
6138
|
+
};
|
|
6139
|
+
/**
|
|
6140
|
+
* One referee
|
|
6141
|
+
* @description A single referee's career aggregates by slug (e.g. `herb-dean`). Same shape as a directory row. A spelling that folds to the same slug (`Herb Dean`) resolves too.
|
|
6142
|
+
*/
|
|
6143
|
+
get: {
|
|
6144
|
+
parameters: {
|
|
6145
|
+
query?: never;
|
|
6146
|
+
header?: never;
|
|
6147
|
+
path: {
|
|
6148
|
+
/** @description Referee slug from `/v1/referees`. */
|
|
6149
|
+
slug: string;
|
|
6150
|
+
};
|
|
6151
|
+
cookie?: never;
|
|
6152
|
+
};
|
|
6153
|
+
requestBody?: never;
|
|
6154
|
+
responses: {
|
|
6155
|
+
/** @description Referee */
|
|
6156
|
+
200: {
|
|
6157
|
+
headers: {
|
|
6158
|
+
/** @description Weak validator over the body, e.g. `W/"GKrimLo826WBqG27jbNFsW2ZHmA"`. Send it back as `If-None-Match` to get a 304. */
|
|
6159
|
+
ETag?: string;
|
|
6160
|
+
/** @description Always `private, no-cache`. */
|
|
6161
|
+
"Cache-Control"?: string;
|
|
6162
|
+
/** @description Monthly request quota of the plan. */
|
|
6163
|
+
"X-RateLimit-Limit"?: number;
|
|
6164
|
+
/** @description Requests left this month. */
|
|
6165
|
+
"X-RateLimit-Remaining"?: number;
|
|
6166
|
+
/** @description Unix seconds of the monthly reset. */
|
|
6167
|
+
"X-RateLimit-Reset"?: number;
|
|
6168
|
+
/** @description Quote it to support; the same id is in every error body. */
|
|
6169
|
+
"x-request-id"?: string;
|
|
6170
|
+
[name: string]: unknown;
|
|
6171
|
+
};
|
|
6172
|
+
content: {
|
|
6173
|
+
/**
|
|
6174
|
+
* @example {
|
|
6175
|
+
* "data": {
|
|
6176
|
+
* "slug": "herb-dean",
|
|
6177
|
+
* "name": "Herb Dean",
|
|
6178
|
+
* "bouts": 1383,
|
|
6179
|
+
* "orgs": [
|
|
6180
|
+
* "pfl",
|
|
6181
|
+
* "ufc"
|
|
6182
|
+
* ],
|
|
6183
|
+
* "by_org": [
|
|
6184
|
+
* {
|
|
6185
|
+
* "org": "ufc",
|
|
6186
|
+
* "bouts": 1373
|
|
6187
|
+
* },
|
|
6188
|
+
* {
|
|
6189
|
+
* "org": "pfl",
|
|
6190
|
+
* "bouts": 10
|
|
6191
|
+
* }
|
|
6192
|
+
* ],
|
|
6193
|
+
* "first_bout": "2004-04-02",
|
|
6194
|
+
* "last_bout": "2026-10-10",
|
|
6195
|
+
* "finish_rate": 0.5633,
|
|
6196
|
+
* "methods": {
|
|
6197
|
+
* "ko_tko": 503,
|
|
6198
|
+
* "submission": 276,
|
|
6199
|
+
* "decision": 581,
|
|
6200
|
+
* "other": 23
|
|
6201
|
+
* },
|
|
6202
|
+
* "avg_fight_time_sec": 642
|
|
6203
|
+
* },
|
|
6204
|
+
* "meta": {}
|
|
5334
6205
|
* }
|
|
5335
6206
|
*/
|
|
5336
|
-
"application/json": components["schemas"]["
|
|
6207
|
+
"application/json": components["schemas"]["RefereeResponse"];
|
|
5337
6208
|
};
|
|
5338
6209
|
};
|
|
5339
6210
|
/** @description Not Modified — `If-None-Match` matched the current weak `ETag`. Empty body. */
|
|
@@ -5343,15 +6214,6 @@ interface paths {
|
|
|
5343
6214
|
};
|
|
5344
6215
|
content?: never;
|
|
5345
6216
|
};
|
|
5346
|
-
/** @description Invalid input (`invalid_org`, `invalid_cursor`). */
|
|
5347
|
-
400: {
|
|
5348
|
-
headers: {
|
|
5349
|
-
[name: string]: unknown;
|
|
5350
|
-
};
|
|
5351
|
-
content: {
|
|
5352
|
-
"application/json": components["schemas"]["Error"];
|
|
5353
|
-
};
|
|
5354
|
-
};
|
|
5355
6217
|
/** @description Missing/invalid API key (`unauthorized`). */
|
|
5356
6218
|
401: {
|
|
5357
6219
|
headers: {
|
|
@@ -5407,7 +6269,7 @@ interface paths {
|
|
|
5407
6269
|
patch?: never;
|
|
5408
6270
|
trace?: never;
|
|
5409
6271
|
};
|
|
5410
|
-
"/v1/
|
|
6272
|
+
"/v1/referees/{slug}/fights": {
|
|
5411
6273
|
parameters: {
|
|
5412
6274
|
query?: never;
|
|
5413
6275
|
header?: never;
|
|
@@ -5415,21 +6277,26 @@ interface paths {
|
|
|
5415
6277
|
cookie?: never;
|
|
5416
6278
|
};
|
|
5417
6279
|
/**
|
|
5418
|
-
*
|
|
5419
|
-
* @description
|
|
6280
|
+
* Bouts a referee worked
|
|
6281
|
+
* @description Every settled launch-promotion bout this referee worked, newest first — the bout (same shape as `/v1/fights/{id}`) with its `event`. `meta.referee` repeats the referee's aggregates. Cursor-paginated (`limit` 1–100, default 25).
|
|
5420
6282
|
*/
|
|
5421
6283
|
get: {
|
|
5422
6284
|
parameters: {
|
|
5423
|
-
query?:
|
|
6285
|
+
query?: {
|
|
6286
|
+
/** @description Opaque cursor from `meta.pagination.next_cursor`. */
|
|
6287
|
+
cursor?: string;
|
|
6288
|
+
limit?: number;
|
|
6289
|
+
};
|
|
5424
6290
|
header?: never;
|
|
5425
6291
|
path: {
|
|
5426
|
-
|
|
6292
|
+
/** @description Referee slug from `/v1/referees`. */
|
|
6293
|
+
slug: string;
|
|
5427
6294
|
};
|
|
5428
6295
|
cookie?: never;
|
|
5429
6296
|
};
|
|
5430
6297
|
requestBody?: never;
|
|
5431
6298
|
responses: {
|
|
5432
|
-
/** @description
|
|
6299
|
+
/** @description Bouts, newest first */
|
|
5433
6300
|
200: {
|
|
5434
6301
|
headers: {
|
|
5435
6302
|
/** @description Weak validator over the body, e.g. `W/"GKrimLo826WBqG27jbNFsW2ZHmA"`. Send it back as `If-None-Match` to get a 304. */
|
|
@@ -5447,7 +6314,96 @@ interface paths {
|
|
|
5447
6314
|
[name: string]: unknown;
|
|
5448
6315
|
};
|
|
5449
6316
|
content: {
|
|
5450
|
-
|
|
6317
|
+
/**
|
|
6318
|
+
* @example {
|
|
6319
|
+
* "data": [
|
|
6320
|
+
* {
|
|
6321
|
+
* "id": 93271,
|
|
6322
|
+
* "ordering": 10,
|
|
6323
|
+
* "card_section": "prelims",
|
|
6324
|
+
* "sport": "mma",
|
|
6325
|
+
* "weight_class": "Heavyweight",
|
|
6326
|
+
* "division_slug": "heavyweight",
|
|
6327
|
+
* "is_title": false,
|
|
6328
|
+
* "is_main": false,
|
|
6329
|
+
* "scheduled_rounds": 3,
|
|
6330
|
+
* "status": "completed",
|
|
6331
|
+
* "fighter_a": {
|
|
6332
|
+
* "id": 343,
|
|
6333
|
+
* "slug": "allen-frye-jr",
|
|
6334
|
+
* "name": "Allen Frye Jr.",
|
|
6335
|
+
* "nickname": "AJ",
|
|
6336
|
+
* "nationality": "United States",
|
|
6337
|
+
* "country_code": "US"
|
|
6338
|
+
* },
|
|
6339
|
+
* "fighter_b": {
|
|
6340
|
+
* "id": 48658,
|
|
6341
|
+
* "slug": "rj-harris",
|
|
6342
|
+
* "name": "RJ Harris",
|
|
6343
|
+
* "nickname": "The Hammer",
|
|
6344
|
+
* "nationality": "United States",
|
|
6345
|
+
* "country_code": "US"
|
|
6346
|
+
* },
|
|
6347
|
+
* "result": {
|
|
6348
|
+
* "winner_fighter_id": 343,
|
|
6349
|
+
* "method": "KO/TKO",
|
|
6350
|
+
* "method_normalized": "ko_tko",
|
|
6351
|
+
* "finish_detail": null,
|
|
6352
|
+
* "round": 1,
|
|
6353
|
+
* "time": "2:59",
|
|
6354
|
+
* "time_seconds": 179,
|
|
6355
|
+
* "details": null
|
|
6356
|
+
* },
|
|
6357
|
+
* "referee": "Herb Dean",
|
|
6358
|
+
* "bonus": null,
|
|
6359
|
+
* "event": {
|
|
6360
|
+
* "id": 3527,
|
|
6361
|
+
* "slug": "ufc-fight-night-2026-10-11",
|
|
6362
|
+
* "title": "UFC Fight Night: Allen vs Duncan",
|
|
6363
|
+
* "org": "ufc",
|
|
6364
|
+
* "starts_at": "2026-10-10T21:00:00.000Z"
|
|
6365
|
+
* }
|
|
6366
|
+
* }
|
|
6367
|
+
* ],
|
|
6368
|
+
* "meta": {
|
|
6369
|
+
* "referee": {
|
|
6370
|
+
* "slug": "herb-dean",
|
|
6371
|
+
* "name": "Herb Dean",
|
|
6372
|
+
* "bouts": 1383,
|
|
6373
|
+
* "orgs": [
|
|
6374
|
+
* "pfl",
|
|
6375
|
+
* "ufc"
|
|
6376
|
+
* ],
|
|
6377
|
+
* "by_org": [
|
|
6378
|
+
* {
|
|
6379
|
+
* "org": "ufc",
|
|
6380
|
+
* "bouts": 1373
|
|
6381
|
+
* },
|
|
6382
|
+
* {
|
|
6383
|
+
* "org": "pfl",
|
|
6384
|
+
* "bouts": 10
|
|
6385
|
+
* }
|
|
6386
|
+
* ],
|
|
6387
|
+
* "first_bout": "2004-04-02",
|
|
6388
|
+
* "last_bout": "2026-10-10",
|
|
6389
|
+
* "finish_rate": 0.5633,
|
|
6390
|
+
* "methods": {
|
|
6391
|
+
* "ko_tko": 503,
|
|
6392
|
+
* "submission": 276,
|
|
6393
|
+
* "decision": 581,
|
|
6394
|
+
* "other": 23
|
|
6395
|
+
* },
|
|
6396
|
+
* "avg_fight_time_sec": 642
|
|
6397
|
+
* },
|
|
6398
|
+
* "pagination": {
|
|
6399
|
+
* "next_cursor": "eyJpZCI6OTMyMDB9",
|
|
6400
|
+
* "has_more": true,
|
|
6401
|
+
* "limit": 2
|
|
6402
|
+
* }
|
|
6403
|
+
* }
|
|
6404
|
+
* }
|
|
6405
|
+
*/
|
|
6406
|
+
"application/json": components["schemas"]["RefereeFightsResponse"];
|
|
5451
6407
|
};
|
|
5452
6408
|
};
|
|
5453
6409
|
/** @description Not Modified — `If-None-Match` matched the current weak `ETag`. Empty body. */
|
|
@@ -5457,6 +6413,15 @@ interface paths {
|
|
|
5457
6413
|
};
|
|
5458
6414
|
content?: never;
|
|
5459
6415
|
};
|
|
6416
|
+
/** @description Invalid input (`invalid_cursor`). */
|
|
6417
|
+
400: {
|
|
6418
|
+
headers: {
|
|
6419
|
+
[name: string]: unknown;
|
|
6420
|
+
};
|
|
6421
|
+
content: {
|
|
6422
|
+
"application/json": components["schemas"]["Error"];
|
|
6423
|
+
};
|
|
6424
|
+
};
|
|
5460
6425
|
/** @description Missing/invalid API key (`unauthorized`). */
|
|
5461
6426
|
401: {
|
|
5462
6427
|
headers: {
|
|
@@ -5512,7 +6477,7 @@ interface paths {
|
|
|
5512
6477
|
patch?: never;
|
|
5513
6478
|
trace?: never;
|
|
5514
6479
|
};
|
|
5515
|
-
"/v1/
|
|
6480
|
+
"/v1/coverage": {
|
|
5516
6481
|
parameters: {
|
|
5517
6482
|
query?: never;
|
|
5518
6483
|
header?: never;
|
|
@@ -5520,25 +6485,22 @@ interface paths {
|
|
|
5520
6485
|
cookie?: never;
|
|
5521
6486
|
};
|
|
5522
6487
|
/**
|
|
5523
|
-
*
|
|
5524
|
-
* @description
|
|
6488
|
+
* Data coverage per promotion
|
|
6489
|
+
* @description What the database actually holds, computed from it (refreshed every 30 minutes) rather than quoted from a marketing page: per launch promotion and per UTC year, the non-cancelled `events` that have started, the settled bouts (`fights_completed`: completed or no contest) and how many of them carry per-fight totals (`fights_with_stats`), round-by-round lines (`fights_with_rounds`), at least one official commission scorecard (`fights_with_scorecards` — a finish has no cards, so this tops out at the decision share) and a consensus odds line across the sportsbooks we track (`fights_with_odds`; information only, not betting advice), each with its 0–1 `*_rate`. `totals` sums every year; `last_result_at` is when the promotion's latest result was recorded. Pass `org` for one promotion.
|
|
5525
6490
|
*/
|
|
5526
6491
|
get: {
|
|
5527
6492
|
parameters: {
|
|
5528
6493
|
query?: {
|
|
5529
|
-
/** @description
|
|
5530
|
-
|
|
5531
|
-
limit?: number;
|
|
6494
|
+
/** @description Launch org slug: `ufc`, `pfl`, `oktagon`, `bkfc` or `rizin`. Staged orgs 400 until promoted. */
|
|
6495
|
+
org?: "ufc" | "pfl" | "oktagon" | "bkfc" | "rizin";
|
|
5532
6496
|
};
|
|
5533
6497
|
header?: never;
|
|
5534
|
-
path
|
|
5535
|
-
id: number;
|
|
5536
|
-
};
|
|
6498
|
+
path?: never;
|
|
5537
6499
|
cookie?: never;
|
|
5538
6500
|
};
|
|
5539
6501
|
requestBody?: never;
|
|
5540
6502
|
responses: {
|
|
5541
|
-
/** @description
|
|
6503
|
+
/** @description Coverage per promotion */
|
|
5542
6504
|
200: {
|
|
5543
6505
|
headers: {
|
|
5544
6506
|
/** @description Weak validator over the body, e.g. `W/"GKrimLo826WBqG27jbNFsW2ZHmA"`. Send it back as `If-None-Match` to get a 304. */
|
|
@@ -5560,81 +6522,58 @@ interface paths {
|
|
|
5560
6522
|
* @example {
|
|
5561
6523
|
* "data": [
|
|
5562
6524
|
* {
|
|
5563
|
-
* "
|
|
5564
|
-
* "
|
|
5565
|
-
*
|
|
5566
|
-
* "
|
|
5567
|
-
* "
|
|
5568
|
-
* "
|
|
5569
|
-
* "
|
|
5570
|
-
*
|
|
5571
|
-
*
|
|
5572
|
-
*
|
|
5573
|
-
*
|
|
5574
|
-
*
|
|
5575
|
-
* "
|
|
5576
|
-
* "judge_name": "Vito Paolillo",
|
|
5577
|
-
* "total_a": 28,
|
|
5578
|
-
* "total_b": 29,
|
|
5579
|
-
* "winner_fighter_id": 1120,
|
|
5580
|
-
* "is_draw": false,
|
|
5581
|
-
* "scores_known": true,
|
|
5582
|
-
* "rounds": [
|
|
5583
|
-
* {
|
|
5584
|
-
* "round": 1,
|
|
5585
|
-
* "a": 9,
|
|
5586
|
-
* "b": 10
|
|
5587
|
-
* }
|
|
5588
|
-
* ]
|
|
6525
|
+
* "org": "ufc",
|
|
6526
|
+
* "last_result_at": "2026-10-30T17:46:34.317Z",
|
|
6527
|
+
* "totals": {
|
|
6528
|
+
* "events": 889,
|
|
6529
|
+
* "fights_completed": 9467,
|
|
6530
|
+
* "fights_with_stats": 9441,
|
|
6531
|
+
* "fights_with_rounds": 9396,
|
|
6532
|
+
* "fights_with_scorecards": 4740,
|
|
6533
|
+
* "fights_with_odds": 6326,
|
|
6534
|
+
* "stats_rate": 0.9973,
|
|
6535
|
+
* "rounds_rate": 0.9925,
|
|
6536
|
+
* "scorecards_rate": 0.5007,
|
|
6537
|
+
* "odds_rate": 0.6682
|
|
5589
6538
|
* },
|
|
5590
|
-
* "
|
|
5591
|
-
* "split": true,
|
|
5592
|
-
* "colleagues": [
|
|
6539
|
+
* "years": [
|
|
5593
6540
|
* {
|
|
5594
|
-
* "
|
|
5595
|
-
* "
|
|
5596
|
-
* "
|
|
5597
|
-
* "
|
|
5598
|
-
* "
|
|
5599
|
-
* "
|
|
6541
|
+
* "year": 2026,
|
|
6542
|
+
* "events": 48,
|
|
6543
|
+
* "fights_completed": 526,
|
|
6544
|
+
* "fights_with_stats": 526,
|
|
6545
|
+
* "fights_with_rounds": 526,
|
|
6546
|
+
* "fights_with_scorecards": 342,
|
|
6547
|
+
* "fights_with_odds": 487,
|
|
6548
|
+
* "stats_rate": 1,
|
|
6549
|
+
* "rounds_rate": 1,
|
|
6550
|
+
* "scorecards_rate": 0.6502,
|
|
6551
|
+
* "odds_rate": 0.9259
|
|
5600
6552
|
* },
|
|
5601
6553
|
* {
|
|
5602
|
-
* "
|
|
5603
|
-
* "
|
|
5604
|
-
* "
|
|
5605
|
-
* "
|
|
5606
|
-
* "
|
|
5607
|
-
* "
|
|
6554
|
+
* "year": 2025,
|
|
6555
|
+
* "events": 53,
|
|
6556
|
+
* "fights_completed": 575,
|
|
6557
|
+
* "fights_with_stats": 572,
|
|
6558
|
+
* "fights_with_rounds": 571,
|
|
6559
|
+
* "fights_with_scorecards": 374,
|
|
6560
|
+
* "fights_with_odds": 454,
|
|
6561
|
+
* "stats_rate": 0.9948,
|
|
6562
|
+
* "rounds_rate": 0.993,
|
|
6563
|
+
* "scorecards_rate": 0.6504,
|
|
6564
|
+
* "odds_rate": 0.7896
|
|
5608
6565
|
* }
|
|
5609
6566
|
* ]
|
|
5610
6567
|
* }
|
|
5611
6568
|
* ],
|
|
5612
6569
|
* "meta": {
|
|
5613
|
-
* "
|
|
5614
|
-
*
|
|
5615
|
-
*
|
|
5616
|
-
* "fights": 412,
|
|
5617
|
-
* "rounds_scored": 1290,
|
|
5618
|
-
* "wide_rounds": 40,
|
|
5619
|
-
* "split_fights": 88,
|
|
5620
|
-
* "three_judge_fights": 410,
|
|
5621
|
-
* "lone_dissents": 31,
|
|
5622
|
-
* "first_scored": "2014-05-31",
|
|
5623
|
-
* "last_scored": "2026-08-29",
|
|
5624
|
-
* "orgs": [
|
|
5625
|
-
* "oktagon",
|
|
5626
|
-
* "ufc"
|
|
5627
|
-
* ]
|
|
5628
|
-
* },
|
|
5629
|
-
* "pagination": {
|
|
5630
|
-
* "next_cursor": null,
|
|
5631
|
-
* "has_more": false,
|
|
5632
|
-
* "limit": 25
|
|
5633
|
-
* }
|
|
6570
|
+
* "org": null,
|
|
6571
|
+
* "computed_at": "2026-10-31T13:09:12.785Z",
|
|
6572
|
+
* "note": "Settled bouts (completed or no contest) of non-cancelled events that have started, by UTC year of the first bell. A bout counts once per column when it has per-fight totals, round-by-round lines, at least one official commission scorecard, or a consensus odds line across the sportsbooks we track (information only, not betting advice). Rates are 0–1 fractions of fights_completed."
|
|
5634
6573
|
* }
|
|
5635
6574
|
* }
|
|
5636
6575
|
*/
|
|
5637
|
-
"application/json": components["schemas"]["
|
|
6576
|
+
"application/json": components["schemas"]["CoverageResponse"];
|
|
5638
6577
|
};
|
|
5639
6578
|
};
|
|
5640
6579
|
/** @description Not Modified — `If-None-Match` matched the current weak `ETag`. Empty body. */
|
|
@@ -5644,7 +6583,7 @@ interface paths {
|
|
|
5644
6583
|
};
|
|
5645
6584
|
content?: never;
|
|
5646
6585
|
};
|
|
5647
|
-
/** @description Invalid input (`
|
|
6586
|
+
/** @description Invalid input (`invalid_org`). */
|
|
5648
6587
|
400: {
|
|
5649
6588
|
headers: {
|
|
5650
6589
|
[name: string]: unknown;
|
|
@@ -6185,7 +7124,7 @@ interface paths {
|
|
|
6185
7124
|
};
|
|
6186
7125
|
/**
|
|
6187
7126
|
* Complete career timeline
|
|
6188
|
-
* @description The fighter's FULL multi-promotion career: native tracked bouts (richest data, `source: "native"`) merged with the wider multi-promotion career record (`source: "history"`). Spans every promotion they fought in — not just launch orgs. **Every key is present on every row** (null when unknown), and each row carries `status` (one vocabulary across both sources: `win`, `loss`, `draw`, `no_contest`, `cancelled`, `upcoming`, `unknown`), `method_normalized`, `time_seconds` and an `opponent` object (`{id, slug, name}`, ids only on native rows) beside the raw `result` / `method` / `time` strings. Newest first; `meta.truncated` is true when the history rows hit their 500-row cap. `source_slug` names the publisher: `ufcalendar` on native rows; on history rows an official publisher (`ufc-official`, `wikipedia`, a promotion's `*-official`), else `public-records`.
|
|
7127
|
+
* @description The fighter's FULL multi-promotion career: native tracked bouts (richest data, `source: "native"`) merged with the wider multi-promotion career record (`source: "history"`). Spans every promotion they fought in — not just launch orgs. **Every key is present on every row** (null when unknown), and each row carries `status` (one vocabulary across both sources: `win`, `loss`, `draw`, `no_contest`, `cancelled`, `upcoming`, `unknown`), `method_normalized`, `time_seconds` and an `opponent` object (`{id, slug, name}`, ids only on native rows) beside the raw `result` / `method` / `time` strings. `fantasy_points` is the fighter's UFCalendar fantasy points for that bout (the score `/v1/fights/{id}/stats` breaks down) on settled launch-promotion bouts with per-fight totals, null otherwise. Newest first; `meta.truncated` is true when the history rows hit their 500-row cap. `source_slug` names the publisher: `ufcalendar` on native rows; on history rows an official publisher (`ufc-official`, `wikipedia`, a promotion's `*-official`), else `public-records`.
|
|
6189
7128
|
*/
|
|
6190
7129
|
get: {
|
|
6191
7130
|
parameters: {
|
|
@@ -6248,7 +7187,8 @@ interface paths {
|
|
|
6248
7187
|
* "id": 1946,
|
|
6249
7188
|
* "slug": "stipe-miocic",
|
|
6250
7189
|
* "name": "Stipe Miocic"
|
|
6251
|
-
* }
|
|
7190
|
+
* },
|
|
7191
|
+
* "fantasy_points": 106.93
|
|
6252
7192
|
* }
|
|
6253
7193
|
* ],
|
|
6254
7194
|
* "meta": {
|
|
@@ -10660,7 +11600,7 @@ interface components {
|
|
|
10660
11600
|
/** @description The current UFCalendar consensus line, the closing line once the bout is settled (`/v1/fights/{id}?include=odds` only); null when the bout is unpriced. */
|
|
10661
11601
|
odds?: components["schemas"]["OddsPair"] | null;
|
|
10662
11602
|
};
|
|
10663
|
-
/** @description Per-fight totals for ONE corner. Target/position splits are null where the source does not log them. */
|
|
11603
|
+
/** @description Per-fight totals for ONE corner. Target/position splits are null where the source does not log them. `fantasy` is the corner's UFCalendar fantasy points. */
|
|
10664
11604
|
FightStatLine: {
|
|
10665
11605
|
fighter_id: number;
|
|
10666
11606
|
/** @description Stored corner encoding: 1 = `fighter_a`, 2 = `fighter_b`. Prefer `corner`. */
|
|
@@ -10699,6 +11639,45 @@ interface components {
|
|
|
10699
11639
|
clinch_attempted: number | null;
|
|
10700
11640
|
ground_landed: number | null;
|
|
10701
11641
|
ground_attempted: number | null;
|
|
11642
|
+
fantasy: components["schemas"]["Fantasy"];
|
|
11643
|
+
};
|
|
11644
|
+
/** @description Points per scoring category. A null category scored nothing. */
|
|
11645
|
+
FantasyBreakdown: {
|
|
11646
|
+
/** @description Total strikes landed × 0.2. Null when the source does not publish total strikes. */
|
|
11647
|
+
strikes: number | null;
|
|
11648
|
+
/** @description Significant strikes landed × 0.2 (on top of the total-strike point). */
|
|
11649
|
+
sig_strikes: number | null;
|
|
11650
|
+
/** @description Control time × 0.03 per second. */
|
|
11651
|
+
control: number | null;
|
|
11652
|
+
/** @description Takedowns landed × 5. */
|
|
11653
|
+
takedowns: number | null;
|
|
11654
|
+
/** @description Reversals × 5. */
|
|
11655
|
+
reversals: number | null;
|
|
11656
|
+
/** @description Knockdowns × 10. */
|
|
11657
|
+
knockdowns: number | null;
|
|
11658
|
+
/** @description R1 finish 90 · R2 finish 70 · R3 finish 45 · R4/R5 finish 40 · decision win 30; 0 for a loss, draw, no contest or a win by disqualification. Null when the bout is not settled or a win's method/round cannot be read. */
|
|
11659
|
+
win_bonus: number | null;
|
|
11660
|
+
/** @description 25 for a finish inside the first 60 seconds of round 1, else 0. Null when it cannot be read. */
|
|
11661
|
+
quick_win_bonus: number | null;
|
|
11662
|
+
};
|
|
11663
|
+
/** @description UFCalendar fantasy points for one corner of one bout — a classic daily-fantasy-style MMA score: total strikes landed +0.2, significant strikes landed +0.2, control +0.03/s, takedown +5, reversal +5, knockdown +10; win bonus R1 finish +90, R2 +70, R3 +45, R4/R5 +40, decision +30; quick win (finish in the first 60 s of R1) +25. No bonus for a loss, draw, no contest or DQ win. */
|
|
11664
|
+
Fantasy: {
|
|
11665
|
+
/** @description Sum of the breakdown (2 decimals). */
|
|
11666
|
+
points: number;
|
|
11667
|
+
breakdown: components["schemas"]["FantasyBreakdown"];
|
|
11668
|
+
/** @description false when a category is null (the source does not publish that stat, the bout is not settled, or the result cannot be read) — `points` is then a floor, never a guess. Reversals are the exception: only some promotions publish them, so a null `reversals` never makes the line incomplete. */
|
|
11669
|
+
complete: boolean;
|
|
11670
|
+
};
|
|
11671
|
+
/** @description Data-quality flags for one bout's statistics — read before charting. */
|
|
11672
|
+
StatsQuality: {
|
|
11673
|
+
/** @description Per-fight totals exist (`data` is non-empty). */
|
|
11674
|
+
has_totals: boolean;
|
|
11675
|
+
/** @description Round-by-round lines exist (`/v1/fights/{id}/rounds`). */
|
|
11676
|
+
has_rounds: boolean;
|
|
11677
|
+
/** @description Distance/clinch/ground strike splits or position time are present on the totals. */
|
|
11678
|
+
has_position_data: boolean;
|
|
11679
|
+
/** @description Per corner, the round sums of significant strikes, takedowns and knockdowns equal the totals (compared only where the total and every round carry the stat). Null when there are no rounds or nothing comparable. */
|
|
11680
|
+
rounds_sum_matches_totals: boolean | null;
|
|
10702
11681
|
};
|
|
10703
11682
|
/** @description One corner's line for one round. */
|
|
10704
11683
|
RoundStatLine: {
|
|
@@ -10897,6 +11876,105 @@ interface components {
|
|
|
10897
11876
|
/** @description Cards that disagree with the official result. */
|
|
10898
11877
|
dissenting_judges: components["schemas"]["DissentingJudge"][];
|
|
10899
11878
|
};
|
|
11879
|
+
/** @description How the bouts this referee worked ended. */
|
|
11880
|
+
RefereeMethods: {
|
|
11881
|
+
ko_tko: number;
|
|
11882
|
+
submission: number;
|
|
11883
|
+
decision: number;
|
|
11884
|
+
/** @description Draws, no contests, disqualifications and unreadable methods. */
|
|
11885
|
+
other: number;
|
|
11886
|
+
};
|
|
11887
|
+
RefereeOrgCount: {
|
|
11888
|
+
org: string;
|
|
11889
|
+
bouts: number;
|
|
11890
|
+
};
|
|
11891
|
+
/** @description One referee's career shape across the launch promotions. */
|
|
11892
|
+
Referee: {
|
|
11893
|
+
/** @description Stable id: the name through the site's slug rule, so spelling variants fold together. Two officials who share a name share a slug. */
|
|
11894
|
+
slug: string;
|
|
11895
|
+
/** @description The most-used spelling. */
|
|
11896
|
+
name: string;
|
|
11897
|
+
/** @description Settled launch-promotion bouts refereed. */
|
|
11898
|
+
bouts: number;
|
|
11899
|
+
/** @description Promotion slugs, alphabetical. */
|
|
11900
|
+
orgs: string[];
|
|
11901
|
+
/** @description Bouts per promotion, busiest first. */
|
|
11902
|
+
by_org: components["schemas"]["RefereeOrgCount"][];
|
|
11903
|
+
/**
|
|
11904
|
+
* Format: date
|
|
11905
|
+
* @description UTC date of the first bout's event.
|
|
11906
|
+
*/
|
|
11907
|
+
first_bout: string | null;
|
|
11908
|
+
/**
|
|
11909
|
+
* Format: date
|
|
11910
|
+
* @description UTC date of the latest bout's event.
|
|
11911
|
+
*/
|
|
11912
|
+
last_bout: string | null;
|
|
11913
|
+
/** @description (KO/TKO + submission) / bouts, 0–1. */
|
|
11914
|
+
finish_rate: number | null;
|
|
11915
|
+
methods: components["schemas"]["RefereeMethods"];
|
|
11916
|
+
/** @description Mean elapsed fight time over bouts with a readable final round and clock, assuming the sport's standard round length (5 min MMA, 2 min bare-knuckle). */
|
|
11917
|
+
avg_fight_time_sec: number | null;
|
|
11918
|
+
};
|
|
11919
|
+
/** @description Counts over settled bouts plus the share of them carrying each dataset. */
|
|
11920
|
+
CoverageCounts: {
|
|
11921
|
+
/** @description Non-cancelled events that have started. */
|
|
11922
|
+
events: number;
|
|
11923
|
+
/** @description Settled bouts (completed or no contest). */
|
|
11924
|
+
fights_completed: number;
|
|
11925
|
+
/** @description Settled bouts with per-fight totals. */
|
|
11926
|
+
fights_with_stats: number;
|
|
11927
|
+
/** @description Settled bouts with round-by-round lines. */
|
|
11928
|
+
fights_with_rounds: number;
|
|
11929
|
+
/** @description Settled bouts with at least one official commission scorecard (a finish has none, so this tops out at the decision share). */
|
|
11930
|
+
fights_with_scorecards: number;
|
|
11931
|
+
/** @description Settled bouts with a consensus odds line across the sportsbooks we track (information only, not betting advice). */
|
|
11932
|
+
fights_with_odds: number;
|
|
11933
|
+
/** @description fights_with_stats / fights_completed, 0–1; null with no settled bouts. */
|
|
11934
|
+
stats_rate: number | null;
|
|
11935
|
+
/** @description fights_with_rounds / fights_completed. */
|
|
11936
|
+
rounds_rate: number | null;
|
|
11937
|
+
/** @description fights_with_scorecards / fights_completed. */
|
|
11938
|
+
scorecards_rate: number | null;
|
|
11939
|
+
/** @description fights_with_odds / fights_completed. */
|
|
11940
|
+
odds_rate: number | null;
|
|
11941
|
+
};
|
|
11942
|
+
CoverageYear: {
|
|
11943
|
+
/** @description UTC year of the first bell. */
|
|
11944
|
+
year: number;
|
|
11945
|
+
/** @description Non-cancelled events that have started. */
|
|
11946
|
+
events: number;
|
|
11947
|
+
/** @description Settled bouts (completed or no contest). */
|
|
11948
|
+
fights_completed: number;
|
|
11949
|
+
/** @description Settled bouts with per-fight totals. */
|
|
11950
|
+
fights_with_stats: number;
|
|
11951
|
+
/** @description Settled bouts with round-by-round lines. */
|
|
11952
|
+
fights_with_rounds: number;
|
|
11953
|
+
/** @description Settled bouts with at least one official commission scorecard (a finish has none, so this tops out at the decision share). */
|
|
11954
|
+
fights_with_scorecards: number;
|
|
11955
|
+
/** @description Settled bouts with a consensus odds line across the sportsbooks we track (information only, not betting advice). */
|
|
11956
|
+
fights_with_odds: number;
|
|
11957
|
+
/** @description fights_with_stats / fights_completed, 0–1; null with no settled bouts. */
|
|
11958
|
+
stats_rate: number | null;
|
|
11959
|
+
/** @description fights_with_rounds / fights_completed. */
|
|
11960
|
+
rounds_rate: number | null;
|
|
11961
|
+
/** @description fights_with_scorecards / fights_completed. */
|
|
11962
|
+
scorecards_rate: number | null;
|
|
11963
|
+
/** @description fights_with_odds / fights_completed. */
|
|
11964
|
+
odds_rate: number | null;
|
|
11965
|
+
};
|
|
11966
|
+
/** @description What the database holds for one promotion. */
|
|
11967
|
+
OrgCoverage: {
|
|
11968
|
+
org: string;
|
|
11969
|
+
/**
|
|
11970
|
+
* Format: date-time
|
|
11971
|
+
* @description When the promotion's latest result was recorded.
|
|
11972
|
+
*/
|
|
11973
|
+
last_result_at: string | null;
|
|
11974
|
+
totals: components["schemas"]["CoverageCounts"];
|
|
11975
|
+
/** @description Newest first. */
|
|
11976
|
+
years: components["schemas"]["CoverageYear"][];
|
|
11977
|
+
};
|
|
10900
11978
|
/** @description Roster-search row: identity only (the bio lives on the detail route). */
|
|
10901
11979
|
FighterListItem: {
|
|
10902
11980
|
id: number;
|
|
@@ -11348,6 +12426,8 @@ interface components {
|
|
|
11348
12426
|
competition_level: string | null;
|
|
11349
12427
|
/** @description Who published the row: `ufcalendar` for native bouts; on history rows an official publisher's slug (`ufc-official`, `wikipedia`, a promotion's `*-official`), else `public-records`. */
|
|
11350
12428
|
source_slug: string | null;
|
|
12429
|
+
/** @description UFCalendar fantasy points for this fighter's corner (same score as `fantasy.points` on `/v1/fights/{id}/stats`). Set on settled launch-promotion bouts with per-fight totals, on `/v1/fighters/{idOrSlug}/history` and the timeline `/v1/compare` reads; null otherwise. */
|
|
12430
|
+
fantasy_points: number | null;
|
|
11351
12431
|
};
|
|
11352
12432
|
FighterRankingRow: {
|
|
11353
12433
|
org: string;
|
|
@@ -12602,11 +13682,12 @@ interface components {
|
|
|
12602
13682
|
ignored_params?: string[];
|
|
12603
13683
|
};
|
|
12604
13684
|
};
|
|
12605
|
-
/** @description One line per corner (`corner` a then b). Empty when the source has no totals. */
|
|
13685
|
+
/** @description One line per corner (`corner` a then b), each with its `fantasy` points. Empty when the source has no totals. */
|
|
12606
13686
|
FightStatsResponse: {
|
|
12607
13687
|
data: components["schemas"]["FightStatLine"][];
|
|
12608
13688
|
meta: {
|
|
12609
13689
|
fight_id: number;
|
|
13690
|
+
quality: components["schemas"]["StatsQuality"];
|
|
12610
13691
|
/** @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. */
|
|
12611
13692
|
ignored_params?: string[];
|
|
12612
13693
|
};
|
|
@@ -12654,6 +13735,48 @@ interface components {
|
|
|
12654
13735
|
ignored_params?: string[];
|
|
12655
13736
|
};
|
|
12656
13737
|
};
|
|
13738
|
+
/** @description Busiest first. */
|
|
13739
|
+
RefereesPageResponse: {
|
|
13740
|
+
data: components["schemas"]["Referee"][];
|
|
13741
|
+
meta: {
|
|
13742
|
+
/** @description Referees matching the filters. */
|
|
13743
|
+
total: number;
|
|
13744
|
+
pagination: components["schemas"]["Pagination"];
|
|
13745
|
+
/** @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. */
|
|
13746
|
+
ignored_params?: string[];
|
|
13747
|
+
};
|
|
13748
|
+
};
|
|
13749
|
+
RefereeResponse: {
|
|
13750
|
+
data: components["schemas"]["Referee"];
|
|
13751
|
+
meta: components["schemas"]["EmptyMeta"];
|
|
13752
|
+
};
|
|
13753
|
+
/** @description Newest first. */
|
|
13754
|
+
RefereeFightsResponse: {
|
|
13755
|
+
data: components["schemas"]["FightDetail"][];
|
|
13756
|
+
meta: {
|
|
13757
|
+
referee: components["schemas"]["Referee"];
|
|
13758
|
+
pagination: components["schemas"]["Pagination"];
|
|
13759
|
+
/** @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. */
|
|
13760
|
+
ignored_params?: string[];
|
|
13761
|
+
};
|
|
13762
|
+
};
|
|
13763
|
+
/** @description One row per launch promotion, in the API's org order. */
|
|
13764
|
+
CoverageResponse: {
|
|
13765
|
+
data: components["schemas"]["OrgCoverage"][];
|
|
13766
|
+
meta: {
|
|
13767
|
+
/** @description The `org=` filter applied; null for every launch promotion. */
|
|
13768
|
+
org: string | null;
|
|
13769
|
+
/**
|
|
13770
|
+
* Format: date-time
|
|
13771
|
+
* @description When the counts were computed (refreshed every 30 minutes).
|
|
13772
|
+
*/
|
|
13773
|
+
computed_at: string;
|
|
13774
|
+
/** @description Always present: what is counted. */
|
|
13775
|
+
note: string;
|
|
13776
|
+
/** @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. */
|
|
13777
|
+
ignored_params?: string[];
|
|
13778
|
+
};
|
|
13779
|
+
};
|
|
12657
13780
|
FightersPageResponse: {
|
|
12658
13781
|
data: components["schemas"]["FighterListItem"][];
|
|
12659
13782
|
meta: {
|
|
@@ -12958,4 +14081,4 @@ interface components {
|
|
|
12958
14081
|
}
|
|
12959
14082
|
type operations = Record<string, never>;
|
|
12960
14083
|
|
|
12961
|
-
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 CredentialConfidence, DEFAULT_BASE_URL, 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 Fight, FightAPI, FightAPIError, type FightAPIOptions, type FightInclude, type FightOdds, type FightProps, type FightResult, type FightSearchMethod, type FightSearchRow, 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, type MatchmakerCorner, type MatchmakerTag, type Matchup, type Meta, type MethodNormalized, type OddsBlock, type OddsHistoryPoint, type OddsLine, type OddsMovement, type OddsPair, type Org, 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 RightsSeries, type Scorecard, type ScorecardRound, type Scorecards, type SplitDecisionRow, type StatMetric, type StatScope, type StatsPanel, type StorylineCorner, type StorylineTag, type Usage, VERSION, type Venue, type WatchProvider, type WebhookEndpoint, type WhosNext, type YearStats, type operations, type paths };
|
|
14084
|
+
export { type Article, type ArticleLocale, type ArticleSummary, type BonusAward, type BonusLedger, type Broadcast, type BroadcastRight, type CareerBout, type CareerStats, type Champion, type ChangeFeedEntry, type ChangeKind, type Compare, type CompareAggregates, type CompareBout, type CoverageCounts, type CoverageYear, type CredentialConfidence, DEFAULT_BASE_URL, DEFAULT_MAX_RETRIES, type DissentingJudge, type Envelope, type EventChange, type EventDetail, type EventHeadline, type EventInclude, type EventListInclude, type EventOdds, type EventOddsRow, type EventPickem, type EventRef, type EventStatus, type EventStorylines, type EventSummary, type EventWatch, type Fantasy, type FantasyBreakdown, type Fight, FightAPI, FightAPIError, type FightAPIOptions, type FightInclude, type FightOdds, type FightProps, type FightResult, type FightSearchMethod, type FightSearchRow, type FightStatLine, type Fighter, type FighterAffiliation, type FighterBout, type FighterCredential, type FighterCredentials, type FighterImage, type FighterInclude, type FighterRef, type FighterSummary, type HeadlineCorner, type Judge, type JudgeColleague, type JudgeLeague, type JudgeScorecardRow, type LeaderboardRow, MAX_RETRY_AFTER_SECONDS, type MatchmakerCorner, type MatchmakerTag, type Matchup, type Meta, type MethodNormalized, type OddsBlock, type OddsHistoryPoint, type OddsLine, type OddsMovement, type OddsPair, type Org, type OrgCoverage, type OrgDivision, type PickemSplit, type Plan, type Plans, type PowerIndex, type PowerIndexFighter, type PowerIndexMover, type PowerIndexRow, type PowerIndexView, type ProbabilitySource, type PropLine, type PropMethodCorner, type PropTotalRounds, type PublicSource, type Query, type QueryValue, type RankingDivision, type RankingEntry, type RankingsBoard, type RateLimit, type RecordBookSection, type RecordEntry, type Referee, type RefereeFightRow, type RightsSeries, type Scorecard, type ScorecardRound, type Scorecards, type SplitDecisionRow, type StatMetric, type StatScope, type StatsPanel, type StatsQuality, type StorylineCorner, type StorylineTag, type Usage, VERSION, type Venue, type WatchProvider, type WebhookEndpoint, type WhosNext, type YearStats, type operations, type paths };
|