@ufcalendar/sdk 0.8.5 → 0.9.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 +4 -2
- package/dist/index.cjs +35 -4
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +1262 -158
- package/dist/index.d.ts +1262 -158
- package/dist/index.js +35 -4
- 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 {
|
|
@@ -1171,7 +1174,7 @@ interface Plan {
|
|
|
1171
1174
|
interface Plans {
|
|
1172
1175
|
currency: string;
|
|
1173
1176
|
plans: Plan[];
|
|
1174
|
-
/** The permanent free plan (2026-10-29):
|
|
1177
|
+
/** The permanent free plan (2026-10-29): 100 requests a month, no card, never expires. */
|
|
1175
1178
|
free_plan: {
|
|
1176
1179
|
requests_per_month: number;
|
|
1177
1180
|
rpm: number;
|
|
@@ -1340,6 +1343,105 @@ 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";
|
|
1345
1447
|
/** Default number of times a GET that hit the per-minute limit is retried. */
|
|
@@ -1507,8 +1609,12 @@ declare class FightAPI {
|
|
|
1507
1609
|
to?: string;
|
|
1508
1610
|
limit?: number;
|
|
1509
1611
|
}): AsyncGenerator<OddsHistoryPoint, void, void>;
|
|
1510
|
-
/**
|
|
1511
|
-
|
|
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[]>;
|
|
1512
1618
|
/** Round-by-round stat lines for both corners. */
|
|
1513
1619
|
fightRounds(fightId: number | string): Promise<Record<string, unknown>[]>;
|
|
1514
1620
|
/**
|
|
@@ -1572,6 +1678,30 @@ declare class FightAPI {
|
|
|
1572
1678
|
judgeScorecards(judgeId: number | string, opts?: {
|
|
1573
1679
|
limit?: number;
|
|
1574
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[]>;
|
|
1575
1705
|
fighters(opts?: {
|
|
1576
1706
|
q?: string;
|
|
1577
1707
|
org?: string;
|
|
@@ -1759,7 +1889,7 @@ declare class FightAPI {
|
|
|
1759
1889
|
|
|
1760
1890
|
/** Kept in lockstep with package.json and the User-Agent by
|
|
1761
1891
|
* `apps/api/src/surfaces.test.ts`. Bump all three together. */
|
|
1762
|
-
declare const VERSION = "0.
|
|
1892
|
+
declare const VERSION = "0.9.1";
|
|
1763
1893
|
|
|
1764
1894
|
/**
|
|
1765
1895
|
* This file was auto-generated by openapi-typescript.
|
|
@@ -1776,7 +1906,7 @@ interface paths {
|
|
|
1776
1906
|
};
|
|
1777
1907
|
/**
|
|
1778
1908
|
* Plans, quotas and how to connect (no key required)
|
|
1779
|
-
* @description The only endpoint that answers without a credential. Returns every plan, Free first, with its monthly request quota, per-minute limit, key limit and a `checkout_url`; the free-plan terms (
|
|
1909
|
+
* @description The only endpoint that answers without a credential. Returns every plan, Free first, with its monthly request quota, per-minute limit, key limit and a `checkout_url`; the free-plan terms (100 requests a month, no card, never expires) and the URL that mints its key; the MCP endpoint with both of its auth doors; and the documentation links. Static per deploy and cached an hour — poll it never, read it once.
|
|
1780
1910
|
*/
|
|
1781
1911
|
get: {
|
|
1782
1912
|
parameters: {
|
|
@@ -1803,7 +1933,7 @@ interface paths {
|
|
|
1803
1933
|
* "name": "Free",
|
|
1804
1934
|
* "price_monthly_usd": 0,
|
|
1805
1935
|
* "price_yearly_usd": 0,
|
|
1806
|
-
* "requests_per_month":
|
|
1936
|
+
* "requests_per_month": 100,
|
|
1807
1937
|
* "rpm": 10,
|
|
1808
1938
|
* "key_limit": 1,
|
|
1809
1939
|
* "features": [
|
|
@@ -1825,7 +1955,7 @@ interface paths {
|
|
|
1825
1955
|
* }
|
|
1826
1956
|
* ],
|
|
1827
1957
|
* "free_plan": {
|
|
1828
|
-
* "requests_per_month":
|
|
1958
|
+
* "requests_per_month": 100,
|
|
1829
1959
|
* "rpm": 10,
|
|
1830
1960
|
* "key_limit": 1,
|
|
1831
1961
|
* "card_required": false,
|
|
@@ -1955,7 +2085,7 @@ interface paths {
|
|
|
1955
2085
|
"application/json": components["schemas"]["Error"];
|
|
1956
2086
|
};
|
|
1957
2087
|
};
|
|
1958
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
2088
|
+
/** @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). */
|
|
1959
2089
|
403: {
|
|
1960
2090
|
headers: {
|
|
1961
2091
|
[name: string]: unknown;
|
|
@@ -2060,7 +2190,7 @@ interface paths {
|
|
|
2060
2190
|
"application/json": components["schemas"]["Error"];
|
|
2061
2191
|
};
|
|
2062
2192
|
};
|
|
2063
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
2193
|
+
/** @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). */
|
|
2064
2194
|
403: {
|
|
2065
2195
|
headers: {
|
|
2066
2196
|
[name: string]: unknown;
|
|
@@ -2266,7 +2396,7 @@ interface paths {
|
|
|
2266
2396
|
"application/json": components["schemas"]["Error"];
|
|
2267
2397
|
};
|
|
2268
2398
|
};
|
|
2269
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
2399
|
+
/** @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). */
|
|
2270
2400
|
403: {
|
|
2271
2401
|
headers: {
|
|
2272
2402
|
[name: string]: unknown;
|
|
@@ -2447,7 +2577,7 @@ interface paths {
|
|
|
2447
2577
|
"application/json": components["schemas"]["Error"];
|
|
2448
2578
|
};
|
|
2449
2579
|
};
|
|
2450
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
2580
|
+
/** @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). */
|
|
2451
2581
|
403: {
|
|
2452
2582
|
headers: {
|
|
2453
2583
|
[name: string]: unknown;
|
|
@@ -2580,7 +2710,7 @@ interface paths {
|
|
|
2580
2710
|
"application/json": components["schemas"]["Error"];
|
|
2581
2711
|
};
|
|
2582
2712
|
};
|
|
2583
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
2713
|
+
/** @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). */
|
|
2584
2714
|
403: {
|
|
2585
2715
|
headers: {
|
|
2586
2716
|
[name: string]: unknown;
|
|
@@ -2695,7 +2825,7 @@ interface paths {
|
|
|
2695
2825
|
"application/json": components["schemas"]["Error"];
|
|
2696
2826
|
};
|
|
2697
2827
|
};
|
|
2698
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
2828
|
+
/** @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). */
|
|
2699
2829
|
403: {
|
|
2700
2830
|
headers: {
|
|
2701
2831
|
[name: string]: unknown;
|
|
@@ -2874,7 +3004,7 @@ interface paths {
|
|
|
2874
3004
|
"application/json": components["schemas"]["Error"];
|
|
2875
3005
|
};
|
|
2876
3006
|
};
|
|
2877
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
3007
|
+
/** @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). */
|
|
2878
3008
|
403: {
|
|
2879
3009
|
headers: {
|
|
2880
3010
|
[name: string]: unknown;
|
|
@@ -3105,7 +3235,7 @@ interface paths {
|
|
|
3105
3235
|
"application/json": components["schemas"]["Error"];
|
|
3106
3236
|
};
|
|
3107
3237
|
};
|
|
3108
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
3238
|
+
/** @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). */
|
|
3109
3239
|
403: {
|
|
3110
3240
|
headers: {
|
|
3111
3241
|
[name: string]: unknown;
|
|
@@ -3256,7 +3386,7 @@ interface paths {
|
|
|
3256
3386
|
"application/json": components["schemas"]["Error"];
|
|
3257
3387
|
};
|
|
3258
3388
|
};
|
|
3259
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
3389
|
+
/** @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). */
|
|
3260
3390
|
403: {
|
|
3261
3391
|
headers: {
|
|
3262
3392
|
[name: string]: unknown;
|
|
@@ -3463,7 +3593,7 @@ interface paths {
|
|
|
3463
3593
|
"application/json": components["schemas"]["Error"];
|
|
3464
3594
|
};
|
|
3465
3595
|
};
|
|
3466
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
3596
|
+
/** @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). */
|
|
3467
3597
|
403: {
|
|
3468
3598
|
headers: {
|
|
3469
3599
|
[name: string]: unknown;
|
|
@@ -3639,7 +3769,7 @@ interface paths {
|
|
|
3639
3769
|
"application/json": components["schemas"]["Error"];
|
|
3640
3770
|
};
|
|
3641
3771
|
};
|
|
3642
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
3772
|
+
/** @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). */
|
|
3643
3773
|
403: {
|
|
3644
3774
|
headers: {
|
|
3645
3775
|
[name: string]: unknown;
|
|
@@ -3845,7 +3975,7 @@ interface paths {
|
|
|
3845
3975
|
"application/json": components["schemas"]["Error"];
|
|
3846
3976
|
};
|
|
3847
3977
|
};
|
|
3848
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
3978
|
+
/** @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). */
|
|
3849
3979
|
403: {
|
|
3850
3980
|
headers: {
|
|
3851
3981
|
[name: string]: unknown;
|
|
@@ -4030,7 +4160,7 @@ interface paths {
|
|
|
4030
4160
|
"application/json": components["schemas"]["Error"];
|
|
4031
4161
|
};
|
|
4032
4162
|
};
|
|
4033
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
4163
|
+
/** @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). */
|
|
4034
4164
|
403: {
|
|
4035
4165
|
headers: {
|
|
4036
4166
|
[name: string]: unknown;
|
|
@@ -4086,6 +4216,10 @@ interface paths {
|
|
|
4086
4216
|
/**
|
|
4087
4217
|
* Per-fight totals
|
|
4088
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.
|
|
4089
4223
|
*/
|
|
4090
4224
|
get: {
|
|
4091
4225
|
parameters: {
|
|
@@ -4116,6 +4250,109 @@ interface paths {
|
|
|
4116
4250
|
[name: string]: unknown;
|
|
4117
4251
|
};
|
|
4118
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
|
+
*/
|
|
4119
4356
|
"application/json": components["schemas"]["FightStatsResponse"];
|
|
4120
4357
|
};
|
|
4121
4358
|
};
|
|
@@ -4135,7 +4372,7 @@ interface paths {
|
|
|
4135
4372
|
"application/json": components["schemas"]["Error"];
|
|
4136
4373
|
};
|
|
4137
4374
|
};
|
|
4138
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
4375
|
+
/** @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). */
|
|
4139
4376
|
403: {
|
|
4140
4377
|
headers: {
|
|
4141
4378
|
[name: string]: unknown;
|
|
@@ -4240,7 +4477,7 @@ interface paths {
|
|
|
4240
4477
|
"application/json": components["schemas"]["Error"];
|
|
4241
4478
|
};
|
|
4242
4479
|
};
|
|
4243
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
4480
|
+
/** @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). */
|
|
4244
4481
|
403: {
|
|
4245
4482
|
headers: {
|
|
4246
4483
|
[name: string]: unknown;
|
|
@@ -4450,7 +4687,7 @@ interface paths {
|
|
|
4450
4687
|
"application/json": components["schemas"]["Error"];
|
|
4451
4688
|
};
|
|
4452
4689
|
};
|
|
4453
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
4690
|
+
/** @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). */
|
|
4454
4691
|
403: {
|
|
4455
4692
|
headers: {
|
|
4456
4693
|
[name: string]: unknown;
|
|
@@ -4771,7 +5008,7 @@ interface paths {
|
|
|
4771
5008
|
"application/json": components["schemas"]["Error"];
|
|
4772
5009
|
};
|
|
4773
5010
|
};
|
|
4774
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
5011
|
+
/** @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). */
|
|
4775
5012
|
403: {
|
|
4776
5013
|
headers: {
|
|
4777
5014
|
[name: string]: unknown;
|
|
@@ -5216,7 +5453,7 @@ interface paths {
|
|
|
5216
5453
|
"application/json": components["schemas"]["Error"];
|
|
5217
5454
|
};
|
|
5218
5455
|
};
|
|
5219
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
5456
|
+
/** @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). */
|
|
5220
5457
|
403: {
|
|
5221
5458
|
headers: {
|
|
5222
5459
|
[name: string]: unknown;
|
|
@@ -5344,15 +5581,630 @@ interface paths {
|
|
|
5344
5581
|
* "split_rate": 0.2011,
|
|
5345
5582
|
* "lone_dissent_rate": 0.1023
|
|
5346
5583
|
* },
|
|
5347
|
-
* "pagination": {
|
|
5348
|
-
* "next_cursor": "eyJpZCI6NX0",
|
|
5349
|
-
* "has_more": true,
|
|
5350
|
-
* "limit": 25
|
|
5351
|
-
* }
|
|
5352
|
-
* }
|
|
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 (100 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 (100 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 (100 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 (100 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": {}
|
|
5353
6205
|
* }
|
|
5354
6206
|
*/
|
|
5355
|
-
"application/json": components["schemas"]["
|
|
6207
|
+
"application/json": components["schemas"]["RefereeResponse"];
|
|
5356
6208
|
};
|
|
5357
6209
|
};
|
|
5358
6210
|
/** @description Not Modified — `If-None-Match` matched the current weak `ETag`. Empty body. */
|
|
@@ -5362,15 +6214,6 @@ interface paths {
|
|
|
5362
6214
|
};
|
|
5363
6215
|
content?: never;
|
|
5364
6216
|
};
|
|
5365
|
-
/** @description Invalid input (`invalid_org`, `invalid_cursor`). */
|
|
5366
|
-
400: {
|
|
5367
|
-
headers: {
|
|
5368
|
-
[name: string]: unknown;
|
|
5369
|
-
};
|
|
5370
|
-
content: {
|
|
5371
|
-
"application/json": components["schemas"]["Error"];
|
|
5372
|
-
};
|
|
5373
|
-
};
|
|
5374
6217
|
/** @description Missing/invalid API key (`unauthorized`). */
|
|
5375
6218
|
401: {
|
|
5376
6219
|
headers: {
|
|
@@ -5380,7 +6223,7 @@ interface paths {
|
|
|
5380
6223
|
"application/json": components["schemas"]["Error"];
|
|
5381
6224
|
};
|
|
5382
6225
|
};
|
|
5383
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
6226
|
+
/** @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). */
|
|
5384
6227
|
403: {
|
|
5385
6228
|
headers: {
|
|
5386
6229
|
[name: string]: unknown;
|
|
@@ -5426,7 +6269,7 @@ interface paths {
|
|
|
5426
6269
|
patch?: never;
|
|
5427
6270
|
trace?: never;
|
|
5428
6271
|
};
|
|
5429
|
-
"/v1/
|
|
6272
|
+
"/v1/referees/{slug}/fights": {
|
|
5430
6273
|
parameters: {
|
|
5431
6274
|
query?: never;
|
|
5432
6275
|
header?: never;
|
|
@@ -5434,21 +6277,26 @@ interface paths {
|
|
|
5434
6277
|
cookie?: never;
|
|
5435
6278
|
};
|
|
5436
6279
|
/**
|
|
5437
|
-
*
|
|
5438
|
-
* @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).
|
|
5439
6282
|
*/
|
|
5440
6283
|
get: {
|
|
5441
6284
|
parameters: {
|
|
5442
|
-
query?:
|
|
6285
|
+
query?: {
|
|
6286
|
+
/** @description Opaque cursor from `meta.pagination.next_cursor`. */
|
|
6287
|
+
cursor?: string;
|
|
6288
|
+
limit?: number;
|
|
6289
|
+
};
|
|
5443
6290
|
header?: never;
|
|
5444
6291
|
path: {
|
|
5445
|
-
|
|
6292
|
+
/** @description Referee slug from `/v1/referees`. */
|
|
6293
|
+
slug: string;
|
|
5446
6294
|
};
|
|
5447
6295
|
cookie?: never;
|
|
5448
6296
|
};
|
|
5449
6297
|
requestBody?: never;
|
|
5450
6298
|
responses: {
|
|
5451
|
-
/** @description
|
|
6299
|
+
/** @description Bouts, newest first */
|
|
5452
6300
|
200: {
|
|
5453
6301
|
headers: {
|
|
5454
6302
|
/** @description Weak validator over the body, e.g. `W/"GKrimLo826WBqG27jbNFsW2ZHmA"`. Send it back as `If-None-Match` to get a 304. */
|
|
@@ -5466,7 +6314,96 @@ interface paths {
|
|
|
5466
6314
|
[name: string]: unknown;
|
|
5467
6315
|
};
|
|
5468
6316
|
content: {
|
|
5469
|
-
|
|
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"];
|
|
5470
6407
|
};
|
|
5471
6408
|
};
|
|
5472
6409
|
/** @description Not Modified — `If-None-Match` matched the current weak `ETag`. Empty body. */
|
|
@@ -5476,6 +6413,15 @@ interface paths {
|
|
|
5476
6413
|
};
|
|
5477
6414
|
content?: never;
|
|
5478
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
|
+
};
|
|
5479
6425
|
/** @description Missing/invalid API key (`unauthorized`). */
|
|
5480
6426
|
401: {
|
|
5481
6427
|
headers: {
|
|
@@ -5485,7 +6431,7 @@ interface paths {
|
|
|
5485
6431
|
"application/json": components["schemas"]["Error"];
|
|
5486
6432
|
};
|
|
5487
6433
|
};
|
|
5488
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
6434
|
+
/** @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). */
|
|
5489
6435
|
403: {
|
|
5490
6436
|
headers: {
|
|
5491
6437
|
[name: string]: unknown;
|
|
@@ -5531,7 +6477,7 @@ interface paths {
|
|
|
5531
6477
|
patch?: never;
|
|
5532
6478
|
trace?: never;
|
|
5533
6479
|
};
|
|
5534
|
-
"/v1/
|
|
6480
|
+
"/v1/coverage": {
|
|
5535
6481
|
parameters: {
|
|
5536
6482
|
query?: never;
|
|
5537
6483
|
header?: never;
|
|
@@ -5539,25 +6485,22 @@ interface paths {
|
|
|
5539
6485
|
cookie?: never;
|
|
5540
6486
|
};
|
|
5541
6487
|
/**
|
|
5542
|
-
*
|
|
5543
|
-
* @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.
|
|
5544
6490
|
*/
|
|
5545
6491
|
get: {
|
|
5546
6492
|
parameters: {
|
|
5547
6493
|
query?: {
|
|
5548
|
-
/** @description
|
|
5549
|
-
|
|
5550
|
-
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";
|
|
5551
6496
|
};
|
|
5552
6497
|
header?: never;
|
|
5553
|
-
path
|
|
5554
|
-
id: number;
|
|
5555
|
-
};
|
|
6498
|
+
path?: never;
|
|
5556
6499
|
cookie?: never;
|
|
5557
6500
|
};
|
|
5558
6501
|
requestBody?: never;
|
|
5559
6502
|
responses: {
|
|
5560
|
-
/** @description
|
|
6503
|
+
/** @description Coverage per promotion */
|
|
5561
6504
|
200: {
|
|
5562
6505
|
headers: {
|
|
5563
6506
|
/** @description Weak validator over the body, e.g. `W/"GKrimLo826WBqG27jbNFsW2ZHmA"`. Send it back as `If-None-Match` to get a 304. */
|
|
@@ -5579,81 +6522,58 @@ interface paths {
|
|
|
5579
6522
|
* @example {
|
|
5580
6523
|
* "data": [
|
|
5581
6524
|
* {
|
|
5582
|
-
* "
|
|
5583
|
-
* "
|
|
5584
|
-
*
|
|
5585
|
-
* "
|
|
5586
|
-
* "
|
|
5587
|
-
* "
|
|
5588
|
-
* "
|
|
5589
|
-
*
|
|
5590
|
-
*
|
|
5591
|
-
*
|
|
5592
|
-
*
|
|
5593
|
-
*
|
|
5594
|
-
* "
|
|
5595
|
-
* "judge_name": "Vito Paolillo",
|
|
5596
|
-
* "total_a": 28,
|
|
5597
|
-
* "total_b": 29,
|
|
5598
|
-
* "winner_fighter_id": 1120,
|
|
5599
|
-
* "is_draw": false,
|
|
5600
|
-
* "scores_known": true,
|
|
5601
|
-
* "rounds": [
|
|
5602
|
-
* {
|
|
5603
|
-
* "round": 1,
|
|
5604
|
-
* "a": 9,
|
|
5605
|
-
* "b": 10
|
|
5606
|
-
* }
|
|
5607
|
-
* ]
|
|
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
|
|
5608
6538
|
* },
|
|
5609
|
-
* "
|
|
5610
|
-
* "split": true,
|
|
5611
|
-
* "colleagues": [
|
|
6539
|
+
* "years": [
|
|
5612
6540
|
* {
|
|
5613
|
-
* "
|
|
5614
|
-
* "
|
|
5615
|
-
* "
|
|
5616
|
-
* "
|
|
5617
|
-
* "
|
|
5618
|
-
* "
|
|
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
|
|
5619
6552
|
* },
|
|
5620
6553
|
* {
|
|
5621
|
-
* "
|
|
5622
|
-
* "
|
|
5623
|
-
* "
|
|
5624
|
-
* "
|
|
5625
|
-
* "
|
|
5626
|
-
* "
|
|
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
|
|
5627
6565
|
* }
|
|
5628
6566
|
* ]
|
|
5629
6567
|
* }
|
|
5630
6568
|
* ],
|
|
5631
6569
|
* "meta": {
|
|
5632
|
-
* "
|
|
5633
|
-
*
|
|
5634
|
-
*
|
|
5635
|
-
* "fights": 412,
|
|
5636
|
-
* "rounds_scored": 1290,
|
|
5637
|
-
* "wide_rounds": 40,
|
|
5638
|
-
* "split_fights": 88,
|
|
5639
|
-
* "three_judge_fights": 410,
|
|
5640
|
-
* "lone_dissents": 31,
|
|
5641
|
-
* "first_scored": "2014-05-31",
|
|
5642
|
-
* "last_scored": "2026-08-29",
|
|
5643
|
-
* "orgs": [
|
|
5644
|
-
* "oktagon",
|
|
5645
|
-
* "ufc"
|
|
5646
|
-
* ]
|
|
5647
|
-
* },
|
|
5648
|
-
* "pagination": {
|
|
5649
|
-
* "next_cursor": null,
|
|
5650
|
-
* "has_more": false,
|
|
5651
|
-
* "limit": 25
|
|
5652
|
-
* }
|
|
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."
|
|
5653
6573
|
* }
|
|
5654
6574
|
* }
|
|
5655
6575
|
*/
|
|
5656
|
-
"application/json": components["schemas"]["
|
|
6576
|
+
"application/json": components["schemas"]["CoverageResponse"];
|
|
5657
6577
|
};
|
|
5658
6578
|
};
|
|
5659
6579
|
/** @description Not Modified — `If-None-Match` matched the current weak `ETag`. Empty body. */
|
|
@@ -5663,7 +6583,7 @@ interface paths {
|
|
|
5663
6583
|
};
|
|
5664
6584
|
content?: never;
|
|
5665
6585
|
};
|
|
5666
|
-
/** @description Invalid input (`
|
|
6586
|
+
/** @description Invalid input (`invalid_org`). */
|
|
5667
6587
|
400: {
|
|
5668
6588
|
headers: {
|
|
5669
6589
|
[name: string]: unknown;
|
|
@@ -5681,7 +6601,7 @@ interface paths {
|
|
|
5681
6601
|
"application/json": components["schemas"]["Error"];
|
|
5682
6602
|
};
|
|
5683
6603
|
};
|
|
5684
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
6604
|
+
/** @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). */
|
|
5685
6605
|
403: {
|
|
5686
6606
|
headers: {
|
|
5687
6607
|
[name: string]: unknown;
|
|
@@ -5824,7 +6744,7 @@ interface paths {
|
|
|
5824
6744
|
"application/json": components["schemas"]["Error"];
|
|
5825
6745
|
};
|
|
5826
6746
|
};
|
|
5827
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
6747
|
+
/** @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). */
|
|
5828
6748
|
403: {
|
|
5829
6749
|
headers: {
|
|
5830
6750
|
[name: string]: unknown;
|
|
@@ -6149,7 +7069,7 @@ interface paths {
|
|
|
6149
7069
|
"application/json": components["schemas"]["Error"];
|
|
6150
7070
|
};
|
|
6151
7071
|
};
|
|
6152
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
7072
|
+
/** @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). */
|
|
6153
7073
|
403: {
|
|
6154
7074
|
headers: {
|
|
6155
7075
|
[name: string]: unknown;
|
|
@@ -6204,7 +7124,7 @@ interface paths {
|
|
|
6204
7124
|
};
|
|
6205
7125
|
/**
|
|
6206
7126
|
* Complete career timeline
|
|
6207
|
-
* @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`.
|
|
6208
7128
|
*/
|
|
6209
7129
|
get: {
|
|
6210
7130
|
parameters: {
|
|
@@ -6267,7 +7187,8 @@ interface paths {
|
|
|
6267
7187
|
* "id": 1946,
|
|
6268
7188
|
* "slug": "stipe-miocic",
|
|
6269
7189
|
* "name": "Stipe Miocic"
|
|
6270
|
-
* }
|
|
7190
|
+
* },
|
|
7191
|
+
* "fantasy_points": 106.93
|
|
6271
7192
|
* }
|
|
6272
7193
|
* ],
|
|
6273
7194
|
* "meta": {
|
|
@@ -6303,7 +7224,7 @@ interface paths {
|
|
|
6303
7224
|
"application/json": components["schemas"]["Error"];
|
|
6304
7225
|
};
|
|
6305
7226
|
};
|
|
6306
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
7227
|
+
/** @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). */
|
|
6307
7228
|
403: {
|
|
6308
7229
|
headers: {
|
|
6309
7230
|
[name: string]: unknown;
|
|
@@ -6418,7 +7339,7 @@ interface paths {
|
|
|
6418
7339
|
"application/json": components["schemas"]["Error"];
|
|
6419
7340
|
};
|
|
6420
7341
|
};
|
|
6421
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
7342
|
+
/** @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). */
|
|
6422
7343
|
403: {
|
|
6423
7344
|
headers: {
|
|
6424
7345
|
[name: string]: unknown;
|
|
@@ -6568,7 +7489,7 @@ interface paths {
|
|
|
6568
7489
|
"application/json": components["schemas"]["Error"];
|
|
6569
7490
|
};
|
|
6570
7491
|
};
|
|
6571
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
7492
|
+
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (100 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
|
|
6572
7493
|
403: {
|
|
6573
7494
|
headers: {
|
|
6574
7495
|
[name: string]: unknown;
|
|
@@ -6702,7 +7623,7 @@ interface paths {
|
|
|
6702
7623
|
"application/json": components["schemas"]["Error"];
|
|
6703
7624
|
};
|
|
6704
7625
|
};
|
|
6705
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
7626
|
+
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (100 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
|
|
6706
7627
|
403: {
|
|
6707
7628
|
headers: {
|
|
6708
7629
|
[name: string]: unknown;
|
|
@@ -6948,7 +7869,7 @@ interface paths {
|
|
|
6948
7869
|
"application/json": components["schemas"]["Error"];
|
|
6949
7870
|
};
|
|
6950
7871
|
};
|
|
6951
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
7872
|
+
/** @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). */
|
|
6952
7873
|
403: {
|
|
6953
7874
|
headers: {
|
|
6954
7875
|
[name: string]: unknown;
|
|
@@ -7137,7 +8058,7 @@ interface paths {
|
|
|
7137
8058
|
"application/json": components["schemas"]["Error"];
|
|
7138
8059
|
};
|
|
7139
8060
|
};
|
|
7140
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
8061
|
+
/** @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). */
|
|
7141
8062
|
403: {
|
|
7142
8063
|
headers: {
|
|
7143
8064
|
[name: string]: unknown;
|
|
@@ -7289,7 +8210,7 @@ interface paths {
|
|
|
7289
8210
|
"application/json": components["schemas"]["Error"];
|
|
7290
8211
|
};
|
|
7291
8212
|
};
|
|
7292
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
8213
|
+
/** @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). */
|
|
7293
8214
|
403: {
|
|
7294
8215
|
headers: {
|
|
7295
8216
|
[name: string]: unknown;
|
|
@@ -7430,7 +8351,7 @@ interface paths {
|
|
|
7430
8351
|
"application/json": components["schemas"]["Error"];
|
|
7431
8352
|
};
|
|
7432
8353
|
};
|
|
7433
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
8354
|
+
/** @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). */
|
|
7434
8355
|
403: {
|
|
7435
8356
|
headers: {
|
|
7436
8357
|
[name: string]: unknown;
|
|
@@ -7585,7 +8506,7 @@ interface paths {
|
|
|
7585
8506
|
"application/json": components["schemas"]["Error"];
|
|
7586
8507
|
};
|
|
7587
8508
|
};
|
|
7588
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
8509
|
+
/** @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). */
|
|
7589
8510
|
403: {
|
|
7590
8511
|
headers: {
|
|
7591
8512
|
[name: string]: unknown;
|
|
@@ -7764,7 +8685,7 @@ interface paths {
|
|
|
7764
8685
|
"application/json": components["schemas"]["Error"];
|
|
7765
8686
|
};
|
|
7766
8687
|
};
|
|
7767
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
8688
|
+
/** @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). */
|
|
7768
8689
|
403: {
|
|
7769
8690
|
headers: {
|
|
7770
8691
|
[name: string]: unknown;
|
|
@@ -7819,7 +8740,7 @@ interface paths {
|
|
|
7819
8740
|
};
|
|
7820
8741
|
/**
|
|
7821
8742
|
* Who should this fighter fight next
|
|
7822
|
-
* @description One fighter's most sensible next opponents by UFCalendar's matchmaker: the same engine and candidate pool as the board (their division's ladder plus the promotion's active Power Index fighters), every pairing scored, best first. The promotion and division come from the fighter's most recent bouts in a covered MMA promotion (404 `not_found` when there is none, or the division has no pool); a renamed slug 308-redirects. The fighter is scored as free even when booked — the question is who comes after that — and `booked_next` names the bout already booked (opponent + event), or null. Opponents already booked against them are left out.
|
|
8743
|
+
* @description One fighter's most sensible next opponents by UFCalendar's matchmaker: the same engine and candidate pool as the board (their division's ladder plus the promotion's active Power Index fighters), every pairing scored, best first. The promotion and division come from the fighter's most recent bouts in a covered MMA promotion (404 `not_found` when there is none, or the division has no pool); a renamed slug 308-redirects. The fighter is scored as free even when booked — the question is who comes after that — and `booked_next` names the bout already booked (opponent + event), or null. Opponents already booked — against them or against anyone else — are left out, as they leave the board.
|
|
7823
8744
|
*
|
|
7824
8745
|
* `subject` carries the corner fields plus `days_since_last`; each suggestion has `opponent`, `win_probability_subject` (from the two Power Index ratings), `score` (0–100) and `tags` (same vocabulary as the board). Computed WITHOUT the website's style-clash (Fight DNA) factor, so scores can differ slightly from ufcalendar.com; probabilities are model output for information only.
|
|
7825
8746
|
*/
|
|
@@ -7937,7 +8858,7 @@ interface paths {
|
|
|
7937
8858
|
"application/json": components["schemas"]["Error"];
|
|
7938
8859
|
};
|
|
7939
8860
|
};
|
|
7940
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
8861
|
+
/** @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). */
|
|
7941
8862
|
403: {
|
|
7942
8863
|
headers: {
|
|
7943
8864
|
[name: string]: unknown;
|
|
@@ -8119,7 +9040,7 @@ interface paths {
|
|
|
8119
9040
|
"application/json": components["schemas"]["Error"];
|
|
8120
9041
|
};
|
|
8121
9042
|
};
|
|
8122
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
9043
|
+
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (100 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
|
|
8123
9044
|
403: {
|
|
8124
9045
|
headers: {
|
|
8125
9046
|
[name: string]: unknown;
|
|
@@ -8311,7 +9232,7 @@ interface paths {
|
|
|
8311
9232
|
"application/json": components["schemas"]["Error"];
|
|
8312
9233
|
};
|
|
8313
9234
|
};
|
|
8314
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
9235
|
+
/** @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). */
|
|
8315
9236
|
403: {
|
|
8316
9237
|
headers: {
|
|
8317
9238
|
[name: string]: unknown;
|
|
@@ -8547,7 +9468,7 @@ interface paths {
|
|
|
8547
9468
|
"application/json": components["schemas"]["Error"];
|
|
8548
9469
|
};
|
|
8549
9470
|
};
|
|
8550
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
9471
|
+
/** @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). */
|
|
8551
9472
|
403: {
|
|
8552
9473
|
headers: {
|
|
8553
9474
|
[name: string]: unknown;
|
|
@@ -8653,7 +9574,7 @@ interface paths {
|
|
|
8653
9574
|
"application/json": components["schemas"]["Error"];
|
|
8654
9575
|
};
|
|
8655
9576
|
};
|
|
8656
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
9577
|
+
/** @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). */
|
|
8657
9578
|
403: {
|
|
8658
9579
|
headers: {
|
|
8659
9580
|
[name: string]: unknown;
|
|
@@ -8790,7 +9711,7 @@ interface paths {
|
|
|
8790
9711
|
"application/json": components["schemas"]["Error"];
|
|
8791
9712
|
};
|
|
8792
9713
|
};
|
|
8793
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
9714
|
+
/** @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). */
|
|
8794
9715
|
403: {
|
|
8795
9716
|
headers: {
|
|
8796
9717
|
[name: string]: unknown;
|
|
@@ -8932,7 +9853,7 @@ interface paths {
|
|
|
8932
9853
|
"application/json": components["schemas"]["Error"];
|
|
8933
9854
|
};
|
|
8934
9855
|
};
|
|
8935
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
9856
|
+
/** @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). */
|
|
8936
9857
|
403: {
|
|
8937
9858
|
headers: {
|
|
8938
9859
|
[name: string]: unknown;
|
|
@@ -9097,7 +10018,7 @@ interface paths {
|
|
|
9097
10018
|
"application/json": components["schemas"]["Error"];
|
|
9098
10019
|
};
|
|
9099
10020
|
};
|
|
9100
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
10021
|
+
/** @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). */
|
|
9101
10022
|
403: {
|
|
9102
10023
|
headers: {
|
|
9103
10024
|
[name: string]: unknown;
|
|
@@ -9220,7 +10141,7 @@ interface paths {
|
|
|
9220
10141
|
"application/json": components["schemas"]["Error"];
|
|
9221
10142
|
};
|
|
9222
10143
|
};
|
|
9223
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
10144
|
+
/** @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). */
|
|
9224
10145
|
403: {
|
|
9225
10146
|
headers: {
|
|
9226
10147
|
[name: string]: unknown;
|
|
@@ -9369,7 +10290,7 @@ interface paths {
|
|
|
9369
10290
|
"application/json": components["schemas"]["Error"];
|
|
9370
10291
|
};
|
|
9371
10292
|
};
|
|
9372
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
10293
|
+
/** @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). */
|
|
9373
10294
|
403: {
|
|
9374
10295
|
headers: {
|
|
9375
10296
|
[name: string]: unknown;
|
|
@@ -9510,7 +10431,7 @@ interface paths {
|
|
|
9510
10431
|
"application/json": components["schemas"]["Error"];
|
|
9511
10432
|
};
|
|
9512
10433
|
};
|
|
9513
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
10434
|
+
/** @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). */
|
|
9514
10435
|
403: {
|
|
9515
10436
|
headers: {
|
|
9516
10437
|
[name: string]: unknown;
|
|
@@ -9650,7 +10571,7 @@ interface paths {
|
|
|
9650
10571
|
"application/json": components["schemas"]["Error"];
|
|
9651
10572
|
};
|
|
9652
10573
|
};
|
|
9653
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
10574
|
+
/** @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). */
|
|
9654
10575
|
403: {
|
|
9655
10576
|
headers: {
|
|
9656
10577
|
[name: string]: unknown;
|
|
@@ -9739,7 +10660,7 @@ interface paths {
|
|
|
9739
10660
|
"application/json": components["schemas"]["Error"];
|
|
9740
10661
|
};
|
|
9741
10662
|
};
|
|
9742
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
10663
|
+
/** @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). */
|
|
9743
10664
|
403: {
|
|
9744
10665
|
headers: {
|
|
9745
10666
|
[name: string]: unknown;
|
|
@@ -10234,7 +11155,7 @@ interface paths {
|
|
|
10234
11155
|
};
|
|
10235
11156
|
/**
|
|
10236
11157
|
* Your quota usage
|
|
10237
|
-
* @description Current-month usage for the calling key: tier, requests used/limit, rpm limit, and the reset as both a Unix timestamp (`reset`) and ISO-8601 (`reset_at`); `month` (`YYYYMM`) and `period` (`YYYY-MM`) are the same month in two spellings. On the free plan `tier` is `free` (
|
|
11158
|
+
* @description Current-month usage for the calling key: tier, requests used/limit, rpm limit, and the reset as both a Unix timestamp (`reset`) and ISO-8601 (`reset_at`); `month` (`YYYYMM`) and `period` (`YYYY-MM`) are the same month in two spellings. On the free plan `tier` is `free` (100 requests a month, metered per account). On an owner-granted trial, `trial_ends_at` is when the trial ends (null otherwise) — plan around it, not `reset_at`.
|
|
10238
11159
|
*/
|
|
10239
11160
|
get: {
|
|
10240
11161
|
parameters: {
|
|
@@ -10298,7 +11219,7 @@ interface paths {
|
|
|
10298
11219
|
"application/json": components["schemas"]["Error"];
|
|
10299
11220
|
};
|
|
10300
11221
|
};
|
|
10301
|
-
/** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (
|
|
11222
|
+
/** @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). */
|
|
10302
11223
|
403: {
|
|
10303
11224
|
headers: {
|
|
10304
11225
|
[name: string]: unknown;
|
|
@@ -10679,7 +11600,7 @@ interface components {
|
|
|
10679
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. */
|
|
10680
11601
|
odds?: components["schemas"]["OddsPair"] | null;
|
|
10681
11602
|
};
|
|
10682
|
-
/** @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. */
|
|
10683
11604
|
FightStatLine: {
|
|
10684
11605
|
fighter_id: number;
|
|
10685
11606
|
/** @description Stored corner encoding: 1 = `fighter_a`, 2 = `fighter_b`. Prefer `corner`. */
|
|
@@ -10718,6 +11639,45 @@ interface components {
|
|
|
10718
11639
|
clinch_attempted: number | null;
|
|
10719
11640
|
ground_landed: number | null;
|
|
10720
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;
|
|
10721
11681
|
};
|
|
10722
11682
|
/** @description One corner's line for one round. */
|
|
10723
11683
|
RoundStatLine: {
|
|
@@ -10916,6 +11876,105 @@ interface components {
|
|
|
10916
11876
|
/** @description Cards that disagree with the official result. */
|
|
10917
11877
|
dissenting_judges: components["schemas"]["DissentingJudge"][];
|
|
10918
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
|
+
};
|
|
10919
11978
|
/** @description Roster-search row: identity only (the bio lives on the detail route). */
|
|
10920
11979
|
FighterListItem: {
|
|
10921
11980
|
id: number;
|
|
@@ -11367,6 +12426,8 @@ interface components {
|
|
|
11367
12426
|
competition_level: string | null;
|
|
11368
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`. */
|
|
11369
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;
|
|
11370
12431
|
};
|
|
11371
12432
|
FighterRankingRow: {
|
|
11372
12433
|
org: string;
|
|
@@ -12621,11 +13682,12 @@ interface components {
|
|
|
12621
13682
|
ignored_params?: string[];
|
|
12622
13683
|
};
|
|
12623
13684
|
};
|
|
12624
|
-
/** @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. */
|
|
12625
13686
|
FightStatsResponse: {
|
|
12626
13687
|
data: components["schemas"]["FightStatLine"][];
|
|
12627
13688
|
meta: {
|
|
12628
13689
|
fight_id: number;
|
|
13690
|
+
quality: components["schemas"]["StatsQuality"];
|
|
12629
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. */
|
|
12630
13692
|
ignored_params?: string[];
|
|
12631
13693
|
};
|
|
@@ -12673,6 +13735,48 @@ interface components {
|
|
|
12673
13735
|
ignored_params?: string[];
|
|
12674
13736
|
};
|
|
12675
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
|
+
};
|
|
12676
13780
|
FightersPageResponse: {
|
|
12677
13781
|
data: components["schemas"]["FighterListItem"][];
|
|
12678
13782
|
meta: {
|
|
@@ -12977,4 +14081,4 @@ interface components {
|
|
|
12977
14081
|
}
|
|
12978
14082
|
type operations = Record<string, never>;
|
|
12979
14083
|
|
|
12980
|
-
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, 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 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, 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 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 };
|