@ufcalendar/sdk 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,3112 @@
+/**
+ * Hand-written shapes for the payloads people actually consume. Field names
+ * come from the serializers in `apps/api/src/routes/*.ts`, not from
+ * imagination — if a field is not here it is because the API does not send
+ * it. The generated `paths` type (from the OpenAPI document) is exported
+ * alongside these for anything not covered.
+ *
+ * Everything is snake_case because the wire is.
+ */
+/** `{"data": ..., "meta": ...}` — every JSON response. */
+interface Envelope<T> {
+    data: T;
+    meta?: Meta;
+}
+interface Meta {
+    pagination?: {
+        next_cursor: string | null;
+        has_more: boolean;
+    };
+    [k: string]: unknown;
+}
+interface RateLimit {
+    /** Monthly quota. */
+    limit: string | null;
+    remaining: string | null;
+    reset: string | null;
+}
+interface Org {
+    slug: string;
+    name: string;
+    short_name: string | null;
+    sport: string;
+    country: string | null;
+    website: string | null;
+    capabilities: {
+        stats: boolean;
+        rounds: boolean;
+        rankings: boolean;
+        broadcasts: boolean;
+        predictions: boolean;
+        scorecards: boolean;
+    };
+}
+type EventStatus = 'announced' | 'scheduled' | 'live' | 'completed' | 'cancelled';
+/** A row of `GET /v1/events`. The card lives on the detail route. */
+interface EventSummary {
+    id: number;
+    slug: string;
+    title: string;
+    short_title: string | null;
+    numbering: string | null;
+    org: string;
+    sport: string;
+    /** UTC ISO-8601. */
+    starts_at: string | null;
+    main_card_at: string | null;
+    prelims_at: string | null;
+    early_prelims_at: string | null;
+    /** Venue IANA timezone, snapshotted at write time. */
+    tz: string | null;
+    status: EventStatus | string;
+    is_ppv: boolean;
+    is_title_card: boolean;
+}
+interface Venue {
+    id: number;
+    slug: string | null;
+    name: string;
+    city: string | null;
+    region: string | null;
+    country: string | null;
+    tz: string | null;
+    capacity: number | null;
+}
+interface Broadcast {
+    region: string | null;
+    provider: string | null;
+    kind: string | null;
+    url: string | null;
+}
+interface EventDetail extends EventSummary {
+    venue: Venue | null;
+    card: Fight[];
+    broadcasts: Broadcast[];
+}
+interface EventChange {
+    kind: string;
+    before: unknown;
+    after: unknown;
+    observed_at: string | null;
+}
+/** Identity fields only — the full record is on `/v1/fighters/{id}`. */
+interface FighterRef {
+    id: number;
+    slug: string;
+    name: string;
+    nickname: string | null;
+    nationality: string | null;
+}
+interface FightResult {
+    winner_fighter_id: number | null;
+    method: string | null;
+    round: number | null;
+    time: string | null;
+    details: string | null;
+}
+interface Fight {
+    id: number;
+    ordering: number | null;
+    card_section: string | null;
+    sport: string;
+    weight_class: string | null;
+    is_title: boolean;
+    is_main: boolean;
+    scheduled_rounds: number | null;
+    status: string | null;
+    fighter_a: FighterRef | null;
+    fighter_b: FighterRef | null;
+    result: FightResult | null;
+    referee: string | null;
+    bonus: string | null;
+}
+interface ScorecardRound {
+    round: number;
+    a: number | null;
+    b: number | null;
+}
+interface Scorecard {
+    judge_id: number | null;
+    judge_name: string | null;
+    total_a: number | null;
+    total_b: number | null;
+    winner_fighter_id: number | null;
+    is_draw: boolean;
+    /**
+     * False when the commission published only the outcome: totals are a
+     * 1-0 / 1-1 / 0-0 placeholder and `rounds` is empty. Check it before
+     * charting.
+     */
+    scores_known: boolean;
+    rounds: ScorecardRound[];
+}
+interface Scorecards {
+    fight_id: number;
+    fighter_a_id: number | null;
+    fighter_b_id: number | null;
+    decision_type: string | null;
+    deductions: unknown[];
+    cards: Scorecard[];
+}
+interface Judge {
+    id: number;
+    name: string;
+    fights?: number;
+    rounds_scored?: number;
+    rounds_10_8?: number;
+    split_cards?: number;
+    lone_dissents?: number;
+    [k: string]: unknown;
+}
+interface FighterSummary {
+    id: number;
+    slug: string;
+    name: string;
+    nickname: string | null;
+    nationality: string | null;
+    /** ISO-3166 alpha-2. */
+    country_code: string | null;
+}
+/** Wikimedia Commons / Creative Commons only. Rendering one WITHOUT the
+ * `license` + `artist` credit violates the licence, not just our terms. */
+interface FighterImage {
+    url: string;
+    width: number | null;
+    height: number | null;
+    license: string | null;
+    license_url: string | null;
+    artist: string | null;
+    source_page: string | null;
+}
+interface CareerStats {
+    /** `pro-mma`, `ufc-only`, … */
+    scope: string;
+    /** Which source published this row. */
+    source: string;
+    record: string | null;
+    slpm: number | null;
+    str_acc: number | null;
+    sapm: number | null;
+    str_def: number | null;
+    td_avg: number | null;
+    td_acc: number | null;
+    td_def: number | null;
+    sub_avg: number | null;
+}
+interface PowerIndex {
+    rating: number;
+    peak: number;
+    peak_at: string | null;
+    fights_rated: number;
+    last_fought_at: string | null;
+}
+interface Fighter extends FighterSummary {
+    height_inches: number | null;
+    weight_lbs: number | null;
+    reach_inches: number | null;
+    stance: string | null;
+    /** YYYY-MM-DD. */
+    dob: string | null;
+    team: string | null;
+    birthplace: string | null;
+    career_stats: CareerStats[];
+    power_index: PowerIndex | null;
+    images: FighterImage[];
+}
+/** One line of `GET /v1/fighters/{id}/history` — native bouts and fill-source
+ * rows merged into one multi-promotion timeline. */
+interface CareerBout {
+    source: 'native' | 'history';
+    date: string | null;
+    opponent_name: string | null;
+    event_name?: string | null;
+    result: string | null;
+    method: string | null;
+    round: number | null;
+    time: string | null;
+    weight_class: string | null;
+    sport: string | null;
+    [k: string]: unknown;
+}
+interface RankingEntry {
+    /** 0 = champion. Ties are real. */
+    rank: number;
+    is_champion: boolean;
+    fighter_id: number;
+    fighter_slug: string;
+    name: string;
+}
+interface RankingDivision {
+    division: string;
+    entries: RankingEntry[];
+}
+/** Point-in-time board: valid until superseded. */
+interface RankingsBoard {
+    org: string;
+    board: string;
+    snapshot_date: string;
+    divisions: RankingDivision[];
+}
+interface Plan {
+    key: string;
+    name: string;
+    price_monthly_usd: number | null;
+    price_yearly_usd: number | null;
+    requests_per_month: number;
+    rpm: number;
+    key_limit: number;
+    features: string[];
+    checkout_url: string;
+}
+interface Plans {
+    currency: string;
+    plans: Plan[];
+    trial: {
+        hours: number;
+        requests: number;
+        card_required: boolean;
+        per_account: number;
+        start_url: string;
+    };
+    enterprise: {
+        contact: string;
+    };
+    mcp: {
+        url: string;
+        transport: string;
+        auth: string[];
+        oauth_metadata: string;
+        protected_resource_metadata: string;
+    };
+    links: Record<string, string>;
+}
+interface BroadcastRight {
+    country: string;
+    provider: string;
+    kind: string | null;
+    url: string | null;
+    note_key?: string | null;
+    [k: string]: unknown;
+}
+interface WebhookEndpoint {
+    id: number;
+    url: string;
+    events: string[];
+    /** Returned ONCE, on create and on rotate. */
+    secret?: string;
+    disabled?: boolean;
+    created_at?: string | null;
+    [k: string]: unknown;
+}
+interface Usage {
+    tier: string;
+    requests_this_month: number;
+    requests_per_month: number;
+    [k: string]: unknown;
+}
+
+declare const DEFAULT_BASE_URL = "https://api.ufcalendar.com/v1";
+interface FightAPIOptions {
+    /** `ufcalendar_…` key from https://www.ufcalendar.com/account/api. Falls back
+     * to `UFCALENDAR_API_KEY` / `UFCAL_API_KEY` in the environment. Only
+     * `plans()` works without one. */
+    apiKey?: string;
+    /** Override for testing; defaults to the production `/v1`. */
+    baseUrl?: string;
+    /** Inject a fetch (a test double, an instrumented fetch, undici). */
+    fetch?: typeof fetch;
+    /** Per-request timeout. Default 30s. */
+    timeoutMs?: number;
+    /** Extra headers on every request. */
+    headers?: Record<string, string>;
+}
+/** An error response from the Fight API. */
+declare class FightAPIError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly requestId: string | null;
+    constructor(status: number, code: string, message: string, requestId?: string | null);
+}
+type QueryValue = string | number | boolean | null | undefined;
+type Query = Record<string, QueryValue>;
+declare class FightAPI {
+    #private;
+    readonly baseUrl: string;
+    readonly apiKey: string | undefined;
+    /** `meta` of the most recent response (pagination cursor, generated_at …). */
+    lastMeta: Meta | null;
+    /** `X-RateLimit-*` of the most recent response. */
+    lastRateLimit: RateLimit;
+    constructor(apiKeyOrOptions?: string | FightAPIOptions, options?: FightAPIOptions);
+    /** Raw GET returning the `data` value. Escape hatch for new endpoints. */
+    get<T = unknown>(path: string, params?: Query): Promise<T>;
+    /** Raw GET returning the whole `{data, meta}` envelope. */
+    getWithMeta<T = unknown>(path: string, params?: Query): Promise<Envelope<T>>;
+    /**
+     * Plans, quotas, the free 1-day trial rule, the MCP endpoint and the doc
+     * links. The only endpoint that answers without a credential.
+     */
+    plans(): Promise<Plans>;
+    /** Launch orgs with capability flags (stats / rounds / rankings / broadcasts / predictions). */
+    orgs(): Promise<Org[]>;
+    org(slug: string): Promise<Org>;
+    /**
+     * Schedule + results. Bare call = the upcoming calendar, soonest first.
+     * `status: 'completed'` (or `order: 'desc'`) browses the archive
+     * newest-first. `from` / `to` are `YYYY-MM-DD`.
+     */
+    events(opts?: {
+        org?: string;
+        status?: string;
+        from?: string;
+        to?: string;
+        order?: 'asc' | 'desc';
+        limit?: number;
+    }): AsyncGenerator<EventSummary, void, void>;
+    /** One event with its full fight card, venue and broadcasts. */
+    event(idOrSlug: string | number): Promise<EventDetail>;
+    /** Card-change diff log (fight added/removed, opponent swapped, date moved, profile merged). */
+    eventChanges(idOrSlug: string | number): Promise<EventChange[]>;
+    fight(fightId: number | string): Promise<Fight>;
+    /** Per-fight totals for both corners. */
+    fightStats(fightId: number | string): Promise<Record<string, unknown>[]>;
+    /** Round-by-round stat lines for both corners. */
+    fightRounds(fightId: number | string): Promise<Record<string, unknown>[]>;
+    /**
+     * The judges' scorecards for a bout — the official commission record:
+     * decision type, point deductions, and one card per judge with every
+     * round, the totals and `winner_fighter_id`. Scores are oriented to
+     * `fighter_a_id` / `fighter_b_id`, both repeated on the payload.
+     *
+     * Check `scores_known` on a card before charting totals: when it is false
+     * the commission published only the outcome. Throws 404 for a bout that
+     * did not go to the judges.
+     */
+    fightScorecards(fightId: number | string): Promise<Scorecards>;
+    /**
+     * Every official who has scored a launch-org bout, busiest first. Rates
+     * mean little below ~10 fights; pass `minFights: 10`.
+     */
+    judges(opts?: {
+        q?: string;
+        org?: string;
+        minFights?: number;
+        limit?: number;
+    }): AsyncGenerator<Judge, void, void>;
+    judge(judgeId: number | string): Promise<Judge>;
+    /** Every card this judge has turned in, newest first. */
+    judgeScorecards(judgeId: number | string, opts?: {
+        limit?: number;
+    }): AsyncGenerator<Record<string, unknown>, void, void>;
+    fighters(opts?: {
+        q?: string;
+        org?: string;
+        country?: string;
+        limit?: number;
+    }): AsyncGenerator<FighterSummary, void, void>;
+    /** Bio, records, career stats, Power Index and CC-licensed images. */
+    fighter(idOrSlug: string | number): Promise<Fighter>;
+    /** Complete multi-promotion career timeline. */
+    fighterHistory(idOrSlug: string | number): Promise<CareerBout[]>;
+    /** Career statistics, one source-stamped row per scope (`pro-mma`, `ufc-only` …). */
+    fighterStats(idOrSlug: string | number): Promise<CareerStats[]>;
+    /** Every official ranking row the fighter ever held, newest first. */
+    fighterRankings(idOrSlug: string | number): Promise<Record<string, unknown>[]>;
+    fighterPowerIndex(idOrSlug: string | number): Promise<PowerIndex & Record<string, unknown>>;
+    /**
+     * Official board, point-in-time. `date: 'YYYY-MM-DD'` returns the board
+     * that was valid on that day (UFC history back to 2013; rank 0 = champion).
+     */
+    rankings(org?: string, opts?: {
+        date?: string;
+        board?: string;
+    }): Promise<RankingsBoard>;
+    divisionRankings(org: string, division: string, opts?: {
+        date?: string;
+    }): Promise<RankingsBoard>;
+    /** Current champions across every launch org. */
+    champions(): Promise<Record<string, unknown>[]>;
+    /** UFCalendar Power Index board. */
+    powerIndex(org?: string): Promise<Record<string, unknown>>;
+    /** Model win probabilities for upcoming UFC bouts. */
+    predictionsUpcoming(): Promise<Record<string, unknown>[]>;
+    /** Who airs the promotion, per ISO-2 country. */
+    broadcastRights(org?: string, opts?: {
+        country?: string;
+    }): Promise<BroadcastRight[]>;
+    venue(venueId: number | string): Promise<Venue>;
+    /** Typeahead across fighters and events. */
+    search(q: string): Promise<Record<string, unknown>>;
+    /** Your key's month-to-date quota usage. */
+    usage(): Promise<Usage>;
+    /**
+     * Subscribable ICS feed URL for calendar apps (authenticates via `?key=`).
+     *
+     * Throws without a key rather than returning `?key=`: that empty URL is
+     * pasted into a calendar app, fails there hours later, and the failure
+     * surfaces nowhere near this call.
+     */
+    calendarIcsUrl(org?: string): string;
+    webhookEndpoints(): Promise<WebhookEndpoint[]>;
+    /**
+     * Register a signed webhook (Pro and up). `events` ⊆ `event.announced`,
+     * `fight.result`, `card.changed`, `event.completed`. The signing secret is
+     * returned ONCE, in this response.
+     */
+    createWebhookEndpoint(url: string, events?: string[]): Promise<WebhookEndpoint>;
+    deleteWebhookEndpoint(endpointId: number | string): Promise<void>;
+    rotateWebhookSecret(endpointId: number | string): Promise<WebhookEndpoint>;
+}
+
+/** Kept in lockstep with package.json and the User-Agent by
+ * `apps/api/src/surfaces.test.ts`. Bump all three together. */
+declare const VERSION = "0.1.0";
+
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+
+interface paths {
+    "/v1/plans": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Plans, quotas and how to connect (no key required)
+         * @description The only endpoint that answers without a credential. Returns every plan with its monthly request quota, per-minute limit, key limit and a `checkout_url`; the terms of the free 1-day trial and the URL that starts it; 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.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Plans, trial rule, MCP endpoint and links */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": {
+                         *         "currency": "USD",
+                         *         "plans": [
+                         *           {
+                         *             "key": "hobby",
+                         *             "name": "Hobby",
+                         *             "price_monthly_usd": 19,
+                         *             "price_yearly_usd": 190,
+                         *             "requests_per_month": 30000,
+                         *             "rpm": 60,
+                         *             "key_limit": 5,
+                         *             "features": [],
+                         *             "checkout_url": "https://www.ufcalendar.com/account/api?plan=hobby"
+                         *           }
+                         *         ],
+                         *         "trial": {
+                         *           "hours": 24,
+                         *           "requests": 100,
+                         *           "card_required": false,
+                         *           "per_account": 1,
+                         *           "start_url": "https://www.ufcalendar.com/account/api?trial=1"
+                         *         },
+                         *         "enterprise": {
+                         *           "contact": "api@ufcalendar.com"
+                         *         },
+                         *         "mcp": {
+                         *           "url": "https://api.ufcalendar.com/mcp",
+                         *           "transport": "streamable-http",
+                         *           "auth": [
+                         *             "bearer_api_key",
+                         *             "oauth"
+                         *           ],
+                         *           "oauth_metadata": "https://www.ufcalendar.com/.well-known/oauth-authorization-server",
+                         *           "protected_resource_metadata": "https://api.ufcalendar.com/.well-known/oauth-protected-resource"
+                         *         },
+                         *         "links": {
+                         *           "docs": "https://api.ufcalendar.com/docs",
+                         *           "openapi": "https://api.ufcalendar.com/openapi.json"
+                         *         }
+                         *       },
+                         *       "meta": {
+                         *         "generated_at": "2026-09-19T00:00:00.000Z"
+                         *       }
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/orgs": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List launch orgs with capability flags
+         * @description Each org carries flags (`stats`, `rounds`, `rankings`, `broadcasts`, `predictions`, `scorecards`) so clients discover coverage programmatically — plus `sport` (`mma`, `bare-knuckle-boxing`). Staged orgs (ONE, KSW, ACA) appear the day they clear the reliability bar. RIZIN publishes no official board, so its `rankings` flag is false. `scorecards` is true for UFC, PFL, OKTAGON and RIZIN; no commission covers bare-knuckle, so BKFC is false.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Launch orgs */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": [
+                         *         {
+                         *           "id": 1,
+                         *           "slug": "ufc",
+                         *           "name": "Ultimate Fighting Championship",
+                         *           "short_name": "UFC",
+                         *           "country": "United States",
+                         *           "website": "https://www.ufc.com",
+                         *           "capabilities": {
+                         *             "stats": true,
+                         *             "rounds": true,
+                         *             "rankings": true,
+                         *             "broadcasts": true,
+                         *             "predictions": true,
+                         *             "scorecards": true
+                         *           }
+                         *         }
+                         *       ]
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/orgs/{slug}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * One org
+         * @description Single org by slug.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    slug: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Org */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/events": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List events (schedule + results)
+         * @description A bare listing is the upcoming calendar: events from the last ~6h onward, soonest first. Ordering defaults: explicit `order` always wins; else `from=` or a forward status (`announced|scheduled|live`) → `asc`; else (`completed|cancelled|to=`) → `desc`, newest first. `order=desc` with no filters browses the full archive newest-first. Live results land within ≤5 minutes (UFC ≤2).
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Launch org slug: `ufc`, `pfl`, `oktagon`, `bkfc` or `rizin`. Staged orgs 400 until promoted. */
+                    org?: "ufc" | "pfl" | "oktagon" | "bkfc" | "rizin";
+                    status?: "announced" | "scheduled" | "live" | "completed" | "cancelled";
+                    from?: string;
+                    to?: string;
+                    /** @description Sort by start time. Defaults are contextual — see endpoint description. */
+                    order?: "asc" | "desc";
+                    /** @description Opaque cursor from `meta.pagination.next_cursor`. */
+                    cursor?: string;
+                    limit?: number;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Events page */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": [
+                         *         {
+                         *           "id": 812,
+                         *           "slug": "ufc-320",
+                         *           "title": "UFC 320",
+                         *           "numbering": "UFC 320",
+                         *           "org": "ufc",
+                         *           "sport": "mma",
+                         *           "starts_at": "2026-10-04T02:00:00.000Z",
+                         *           "main_card_at": "2026-10-04T02:00:00.000Z",
+                         *           "tz": "America/Los_Angeles",
+                         *           "status": "scheduled",
+                         *           "is_ppv": true,
+                         *           "is_title_card": true
+                         *         }
+                         *       ],
+                         *       "meta": {
+                         *         "pagination": {
+                         *           "next_cursor": "eyJpZCI6ODEyfQ",
+                         *           "has_more": true
+                         *         }
+                         *       }
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/events/{idOrSlug}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Event with full card
+         * @description Full fight card (both corners, results when completed), venue and event-scoped broadcast rows. Every event and card entry carries `sport` (e.g. `mma`, `bare-knuckle-boxing`). Renamed events 308-redirect from stale slugs.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Numeric id or slug of the event. Stale slugs 308-redirect to the canonical URL. */
+                    idOrSlug: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Event detail */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/events/{idOrSlug}/changes": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Card-change log
+         * @description The diff log behind "card updated": fight added/removed, opponent swapped, card order or date moved, or a fighter profile merged (`fighter-merged`: two of our fighter ids turned out to be one athlete, so a live bout now carries the surviving id — same humans, new ids). Each entry has `kind`, `before`, `after`, `observed_at`.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Numeric id or slug of the event. Stale slugs 308-redirect to the canonical URL. */
+                    idOrSlug: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Change entries */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/fights/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * One bout
+         * @description Bout with corners, `sport` (bout override, else the org sport), result (method/round/time/referee) and bonus flags.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: number;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Fight */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/fights/{id}/stats": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Per-fight totals
+         * @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. `distance_time_sec`, `clinch_time_sec`, `ground_time_sec` (integers, nullable) are seconds spent at distance / in the clinch / on the ground — Sofascore-sourced, and can appear alongside official strike counts on any org (Sofascore fills position time even where another source owns the rest of the row).
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: number;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Stat lines */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/fights/{id}/rounds": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Round-by-round stats
+         * @description Per-round stat lines for both corners, including target/position splits (head/body/leg, distance/clinch/ground) where the source logs them per round (BKFC for head/body/distance/clinch; Sofascore additionally for leg/ground). `distance_time_sec`, `clinch_time_sec`, `ground_time_sec` (integers, nullable) are seconds spent at distance / in the clinch / on the ground, per round — Sofascore-sourced.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: number;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Round lines */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/fights/{id}/scorecards": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Judges' scorecards for a bout
+         * @description The official athletic-commission record: every judge, their score for each round, their card total, the decision type and any point deductions. UFC back to 1995, PFL to 2018, OKTAGON to 2025, RIZIN from March 2026 (Japan has no athletic commission — the record is published by JMOC, the officials body that runs RIZIN). UFC cards also come from ufc.com's own official scorecard images (Dana White's Contender Series and Road to UFC included, images from March 2022) — mmadecisions is preferred wherever both cover a bout, and the ufc.com extraction fills the rest.
+         *
+         *     `total_a`/`total_b` and every round are oriented to the bout's `fighter_a_id`/`fighter_b_id`, which are repeated on the payload so you never have to fetch the fight to read a card. `winner_fighter_id` is who THAT judge gave it to.
+         *
+         *     **Check `scores_known` before charting totals.** When it is false the commission published only the outcome, and `total_a`/`total_b` are a 1-0 / 1-1 / 0-0 placeholder rather than a score (66 fights, nearly all pre-2005); `rounds` is empty on those cards. A bout that did not go to the judges 404s.
+         *
+         *     **Some cards carry no judge identity.** PFL's US events have no published commission scorecard, so those bouts are served from PFL's own results post: three cards with `judge_id`/`judge_name` null, `total_a`/`total_b` set and `rounds` empty. `scores_known` is still true — the totals are real. Europe/UAE PFL cards and every other org carry the named, round-by-round record.
+         *
+         *     Media-member and fan scorecards are not part of this dataset.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: number;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Scorecards */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": {
+                         *         "fight_id": 83379,
+                         *         "fighter_a_id": 213,
+                         *         "fighter_b_id": 1120,
+                         *         "decision_type": "split",
+                         *         "deductions": [],
+                         *         "cards": [
+                         *           {
+                         *             "judge_id": 36,
+                         *             "judge_name": "Vito Paolillo",
+                         *             "total_a": 28,
+                         *             "total_b": 29,
+                         *             "winner_fighter_id": 1120,
+                         *             "is_draw": false,
+                         *             "scores_known": true,
+                         *             "rounds": [
+                         *               {
+                         *                 "round": 1,
+                         *                 "a": 9,
+                         *                 "b": 10
+                         *               },
+                         *               {
+                         *                 "round": 2,
+                         *                 "a": 10,
+                         *                 "b": 9
+                         *               },
+                         *               {
+                         *                 "round": 3,
+                         *                 "a": 9,
+                         *                 "b": 10
+                         *               }
+                         *             ]
+                         *           },
+                         *           {
+                         *             "judge_id": 34,
+                         *             "judge_name": "Clemens Werner",
+                         *             "total_a": 29,
+                         *             "total_b": 28,
+                         *             "winner_fighter_id": 213,
+                         *             "is_draw": false,
+                         *             "scores_known": true,
+                         *             "rounds": [
+                         *               {
+                         *                 "round": 1,
+                         *                 "a": 9,
+                         *                 "b": 10
+                         *               },
+                         *               {
+                         *                 "round": 2,
+                         *                 "a": 10,
+                         *                 "b": 9
+                         *               },
+                         *               {
+                         *                 "round": 3,
+                         *                 "a": 10,
+                         *                 "b": 9
+                         *               }
+                         *             ]
+                         *           },
+                         *           {
+                         *             "judge_id": 17,
+                         *             "judge_name": "Cezary Wojciechowski",
+                         *             "total_a": 28,
+                         *             "total_b": 29,
+                         *             "winner_fighter_id": 1120,
+                         *             "is_draw": false,
+                         *             "scores_known": true,
+                         *             "rounds": [
+                         *               {
+                         *                 "round": 1,
+                         *                 "a": 9,
+                         *                 "b": 10
+                         *               },
+                         *               {
+                         *                 "round": 2,
+                         *                 "a": 10,
+                         *                 "b": 9
+                         *               },
+                         *               {
+                         *                 "round": 3,
+                         *                 "a": 9,
+                         *                 "b": 10
+                         *               }
+                         *             ]
+                         *           }
+                         *         ]
+                         *       },
+                         *       "meta": {
+                         *         "fight_id": 83379
+                         *       }
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/judges": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Judge directory
+         * @description Every official who has scored a launch-org bout (~550), busiest first, with their career shape: fights, rounds scored, rounds scored 10-8 or wider, three-judge cards that came back split, and `lone_dissents` — cards where this judge alone picked the other corner.
+         *
+         *     Filter with `q` (name), `org`, and `min_fights` (the rates mean little below ~10 fights).
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Name substring, case-insensitive. */
+                    q?: string;
+                    /** @description Launch org slug: `ufc`, `pfl`, `oktagon`, `bkfc` or `rizin`. Staged orgs 400 until promoted. */
+                    org?: "ufc" | "pfl" | "oktagon" | "bkfc" | "rizin";
+                    /** @description Only judges with at least this many scored fights. */
+                    min_fights?: number;
+                    /** @description Opaque cursor from `meta.pagination.next_cursor`. */
+                    cursor?: string;
+                    limit?: number;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Judges page */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": [
+                         *         {
+                         *           "id": 5,
+                         *           "name": "Sal D'Amato",
+                         *           "fights": 1096,
+                         *           "rounds_scored": 3598,
+                         *           "wide_rounds": 146,
+                         *           "split_fights": 242,
+                         *           "three_judge_fights": 1095,
+                         *           "lone_dissents": 118,
+                         *           "first_scored": "2009-04-01",
+                         *           "last_scored": "2026-08-15",
+                         *           "orgs": [
+                         *             "pfl",
+                         *             "ufc"
+                         *           ]
+                         *         }
+                         *       ],
+                         *       "meta": {
+                         *         "total": 550,
+                         *         "pagination": {
+                         *           "next_cursor": "eyJpZCI6NX0",
+                         *           "has_more": true
+                         *         }
+                         *       }
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/judges/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * One judge
+         * @description A single official's career aggregates. Same shape as a directory row.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: number;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Judge */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/judges/{id}/scorecards": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Everything a judge has scored
+         * @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 only (the full panel is on `/v1/fights/{id}/scorecards`). Cursor-paginated.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Opaque cursor from `meta.pagination.next_cursor`. */
+                    cursor?: string;
+                    limit?: number;
+                };
+                header?: never;
+                path: {
+                    id: number;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Cards, newest first */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": [
+                         *         {
+                         *           "fight_id": 83379,
+                         *           "event": {
+                         *             "id": 2507,
+                         *             "slug": "ufc-fight-night-2026-08-29",
+                         *             "title": "UFC Fight Night: Nurmagomedov vs Song",
+                         *             "org": "ufc",
+                         *             "starts_at": "2026-08-29T07:00:00.000Z"
+                         *           },
+                         *           "fighter_a_id": 213,
+                         *           "fighter_b_id": 1120,
+                         *           "decision_type": "split",
+                         *           "card": {
+                         *             "judge_id": 36,
+                         *             "judge_name": "Vito Paolillo",
+                         *             "total_a": 28,
+                         *             "total_b": 29,
+                         *             "winner_fighter_id": 1120,
+                         *             "is_draw": false,
+                         *             "scores_known": true,
+                         *             "rounds": [
+                         *               {
+                         *                 "round": 1,
+                         *                 "a": 9,
+                         *                 "b": 10
+                         *               }
+                         *             ]
+                         *           }
+                         *         }
+                         *       ],
+                         *       "meta": {
+                         *         "judge": {
+                         *           "id": 36,
+                         *           "name": "Vito Paolillo"
+                         *         },
+                         *         "pagination": {
+                         *           "next_cursor": null,
+                         *           "has_more": false
+                         *         }
+                         *       }
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/fighters": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Roster search
+         * @description Fighters with at least one launch-org fight (~4.5k). `q` is accent-insensitive.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    q?: string;
+                    /** @description Launch org slug: `ufc`, `pfl`, `oktagon`, `bkfc` or `rizin`. Staged orgs 400 until promoted. */
+                    org?: "ufc" | "pfl" | "oktagon" | "bkfc" | "rizin";
+                    /** @description ISO-2 code or country name. */
+                    country?: string;
+                    /** @description Opaque cursor from `meta.pagination.next_cursor`. */
+                    cursor?: string;
+                    limit?: number;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Fighters page */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/fighters/{idOrSlug}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Fighter profile
+         * @description Bio, per-scope career records (one row per scope, `source`-stamped), UFCalendar Power Index summary, and CC-licensed images with attribution metadata (displaying the credit is a license requirement).
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Numeric id or slug of the fighter. Stale slugs 308-redirect to the canonical URL. */
+                    idOrSlug: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Fighter detail */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/fighters/{idOrSlug}/history": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Complete career timeline
+         * @description The fighter's FULL multi-promotion career: native tracked bouts (richest data, `source: "native"`) merged with fill-source history rows (`source: "history"`). Spans every promotion they fought in — not just launch orgs.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Numeric id or slug of the fighter. Stale slugs 308-redirect to the canonical URL. */
+                    idOrSlug: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Timeline entries, newest first */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/fighters/{idOrSlug}/stats": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Career statistics
+         * @description Per-scope career stats (`pro-mma`, `amateur-mma`, …): record, strikes landed/absorbed per minute, accuracy/defense, takedown and submission averages. Exactly ONE row per scope; `source` names the publisher it came from (`tapology` — the complete multi-promotion career — is preferred, then `sofascore`, then the promotion's own site). A Tapology record is a crawl-time snapshot advanced by every settled bout UFCalendar tracked after it, so it matches the record on ufcalendar.com. Org-scoped rows (`ufc-only`, `bkfc-only`, `one-only`, `oktagon-only`, `aca-only`) are the fighter's record INSIDE that promotion, not a career record. Scope `tracked` rows are computed by UFCalendar from per-fight totals when no scraped panel carries data (e.g. Contender Series debutants, PFL/OKTAGON rosters); their `record` is always null.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Numeric id or slug of the fighter. Stale slugs 308-redirect to the canonical URL. */
+                    idOrSlug: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Career stat rows */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/fighters/{idOrSlug}/rankings": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Ranking history
+         * @description Official-board rows over time (org, board, division, snapshot_date, rank). Rank 0 = champion.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Numeric id or slug of the fighter. Stale slugs 308-redirect to the canonical URL. */
+                    idOrSlug: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Ranking rows */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/fighters/{idOrSlug}/power-index": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Power Index trajectory
+         * @description Per-bout rating history from the UFCalendar Power Index engine (rating before/after, model win probability, outcome).
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Numeric id or slug of the fighter. Stale slugs 308-redirect to the canonical URL. */
+                    idOrSlug: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Rating points */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/rankings/{org}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Official board (point-in-time)
+         * @description **The time machine**: pass `?date=YYYY-MM-DD` for the board as it stood on any date (UFC official back to 2013, 543 snapshots). A snapshot is valid until superseded. Rank 0 = champion; P4P has no rank 0.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    date?: string;
+                    /** @description Default `official` (for UFC that is the media-panel vote ufc.com publishes). UFC additionally has `meta`. */
+                    board?: string;
+                };
+                header?: never;
+                path: {
+                    org: "ufc" | "pfl" | "oktagon" | "bkfc";
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Board grouped by division */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": {
+                         *         "org": "ufc",
+                         *         "board": "official",
+                         *         "snapshot_date": "2016-11-14",
+                         *         "divisions": [
+                         *           {
+                         *             "division": "Lightweight",
+                         *             "entries": [
+                         *               {
+                         *                 "rank": 0,
+                         *                 "is_champion": true,
+                         *                 "fighter_id": 3021,
+                         *                 "fighter_slug": "conor-mcgregor",
+                         *                 "name": "Conor McGregor"
+                         *               }
+                         *             ]
+                         *           }
+                         *         ]
+                         *       }
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/rankings/{org}/{division}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * One division
+         * @description Same as the board endpoint, filtered to a division (`lightweight`, `womens-strawweight`, `pound-for-pound`, …).
+         */
+        get: {
+            parameters: {
+                query?: {
+                    date?: string;
+                };
+                header?: never;
+                path: {
+                    org: string;
+                    division: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Division entries */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/champions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Current champions
+         * @description Rank-0 rows of each launch org's latest official board.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Champions */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/power-index/{org}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Power Index board
+         * @description Top-rated active fighters whose latest bout was in this org, by the UFCalendar Power Index (our own rating engine, hourly refresh).
+         */
+        get: {
+            parameters: {
+                query?: {
+                    limit?: number;
+                };
+                header?: never;
+                path: {
+                    org: "ufc" | "pfl" | "oktagon" | "bkfc" | "rizin";
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Board rows */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/predictions/upcoming": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Model win probabilities (UFC)
+         * @description UFCalendar model win probabilities for upcoming UFC bouts, refreshed every 30 minutes. Corner-guarded: a probability is only served while the stored pair matches the bout's current pair — a late opponent swap removes the row rather than mislabeling it. Not betting advice.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Predictions */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/broadcast-rights/{org}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Who airs it, per country
+         * @description Org-level standing media rights per country (PFL harvested weekly across 212 countries; UFC ~110 curated). `WORLD` rows apply globally.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description ISO-2 country code. */
+                    country?: string;
+                };
+                header?: never;
+                path: {
+                    org: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Rights rows */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/venues/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Venue
+         * @description Venue with city, country, coordinates, capacity and IANA tz.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: number;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Venue */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/search": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Typeahead search
+         * @description Accent-insensitive search across roster fighters and events. Great for building pickers.
+         */
+        get: {
+            parameters: {
+                query: {
+                    q: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Matches */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/calendar/{org}.ics": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * ICS calendar feed
+         * @description Subscribe your calendar app to an org's schedule. Calendar apps can't send headers, so pass the key as `?key=`. Refresh hourly at most.
+         */
+        get: {
+            parameters: {
+                query: {
+                    key: string;
+                };
+                header?: never;
+                path: {
+                    /** @description `ufc.ics`, `pfl.ics`, `oktagon.ics`, `bkfc.ics` or `rizin.ics` */
+                    "org.ics": string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description text/calendar VEVENT feed of upcoming events */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/webhook-endpoints": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List your webhook endpoints
+         * @description Pro and above. Counts as one request against your quota; the deliveries themselves do not.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Endpoints */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Requires Pro or above */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        /**
+         * Register a webhook endpoint
+         * @description Pro+. Body: `{"url": "https://...", "events": ["event.announced", "fight.result", "card.changed", "event.completed"]}`. Subscribe to `event.announced` and you do not need to poll `/v1/events` to discover new cards — it fires once, within a minute of a card first landing in our data, and carries the same event object the list endpoint returns. The response contains the signing `secret` ONCE. Deliveries carry `X-UFCalendar-Signature: t=<unix>,v1=<hmac>` where the HMAC-SHA256 input is `"<t>.<rawBody>"`. **Verify the timestamp too**: reject anything where `|now - t|` exceeds 300 seconds, otherwise a captured delivery can be replayed at you forever with a valid HMAC. Delivery is at-least-once — deduplicate on the event body, and expect a retry roughly every 60s until your endpoint returns 2xx. Endpoints auto-disable after 20 consecutive failures, and you may hold at most 3 active endpoints. Latency: results are dispatched within ~1 minute of our scrapers writing them. `event.announced` only fires for cards that have not started yet, so archive backfills never reach you as new-card noise. `card.changed` is filtered the same way: a change whose before and after read identically (a venue row re-minted for the same arena, a source dropping a sub-time it never knew) is never delivered, and when a source flip-flops a value we deliver the move and its undo once, not the twentieth repeat. Deliveries are free — they never count against your monthly request quota, only the calls you make to manage endpoints do.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Created — includes the one-time secret */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Requires Pro or above */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/webhook-endpoints/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Delete a webhook endpoint
+         * @description Pro and above.
+         */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: number;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Deleted */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Requires Pro or above */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/webhook-endpoints/{id}/rotate-secret": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Rotate an endpoint signing secret
+         * @description Pro and above. Issues a fresh `whsec_` secret for the endpoint and returns it ONCE, keeping the endpoint id and its delivery history. The previous secret stops verifying the moment this returns, so deploy the new one to your receiver first (or accept both during the cutover). Use this instead of delete-and-recreate when a secret leaks.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: number;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Rotated — includes the new one-time secret */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Requires Pro or above */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No such endpoint on this account */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/bulk/{kind}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Bulk snapshot (Enterprise only)
+         * @description Enterprise only — the full dataset is licensed, not self-serve; contact api@ufcalendar.com. Downloads the full launch-scope dataset as gzipped JSON: `events.json.gz`, `fights.json.gz` or `fighters.json.gz`. Responds 302 to a presigned URL; snapshots regenerate at most every 6 hours. One request per download (the redirect is free).
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    kind: "events.json.gz" | "fights.json.gz" | "fighters.json.gz";
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Redirect to a time-limited download URL */
+                302: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Requires an Enterprise agreement */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/usage": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Your quota usage
+         * @description Current-month usage for the calling key: tier, requests used/limit, rpm limit, reset.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Usage */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "data": {
+                         *         "tier": "pro",
+                         *         "month": "202608",
+                         *         "requests_used": 1204,
+                         *         "requests_limit": 200000,
+                         *         "rpm_limit": 300,
+                         *         "reset": 1756684800
+                         *       }
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Missing/invalid API key. `{"error":{"code":"unauthorized",...}}` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Not found (staged-org data 404s until the org is promoted). */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Rate limited (`rate_limited`) or monthly quota reached (`quota_exceeded`). Honor `Retry-After`. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+type operations = Record<string, never>;
+
+export { type Broadcast, type BroadcastRight, type CareerBout, type CareerStats, DEFAULT_BASE_URL, type Envelope, type EventChange, type EventDetail, type EventStatus, type EventSummary, type Fight, FightAPI, FightAPIError, type FightAPIOptions, type FightResult, type Fighter, type FighterImage, type FighterRef, type FighterSummary, type Judge, type Meta, type Org, type Plan, type Plans, type PowerIndex, type Query, type QueryValue, type RankingDivision, type RankingEntry, type RankingsBoard, type RateLimit, type Scorecard, type ScorecardRound, type Scorecards, type Usage, VERSION, type Venue, type WebhookEndpoint, type operations, type paths };