Method

Endpoint

plans()

GET /v1/plans — plans (Free first), quotas, free-plan terms, MCP endpoint (no key required)

orgs() / org(slug)

GET /v1/orgs / …/{slug}

events({ org, status, from, to, order, isTitleCard, isPpv, include: ['headline'], limit })

GET /v1/events (paginated; headline = each card's main event and its result)

event(slug, { include: ['eta', 'odds'] }) / eventChanges(slug)

GET /v1/events/{slug} / …/changes (eta = per-bout estimated start; odds = each bout's latest consensus line)

eventWatch(slug, { country })

GET /v1/events/{slug}/watch — how to watch one event, per country: the rights deals for its series merged with the event's own listings

changes({ org, since, kind, limit })

GET /v1/changes — the card-change feed across every event, newest first (paginated; default last 90 days)

fight(id, { include: ['odds'] }) / fightStats(id) / fightRounds(id)

GET /v1/fights/{id} / …/stats / …/rounds (fightStats lines carry fantasy — UFCalendar fantasy points with a per-category breakdown; lastMeta.quality = data-quality flags)

fightOdds(id) / eventOdds(slug)

GET /v1/fights/{id}/odds / GET /v1/events/{slug}/odds — the UFCalendar consensus line: current, opening, closing (settled bouts), movement and sources (how many sportsbooks backed each point), plus props (method of victory per corner, total rounds over/under, goes the distance). Information only, not betting advice

fightOddsHistory(id, { from, to })

GET /v1/fights/{id}/odds/history — every consensus point, oldest first (async generator; Pro plans and up)

findFights({ org, titleOnly, method, division, fighter, winner, from, to, mainEventsOnly, order, limit })

GET /v1/fights/search — completed bouts, filtered, newest first (at least one narrowing filter; 25 a page, 10 pages deep)

fightScorecards(id)

GET /v1/fights/{id}/scorecards — judges, rounds, totals, deductions

judges({ q, org, minFights }) / judge(id) / judgeScorecards(id)

GET /v1/judges / …/{id} / …/{id}/scorecards (lastMeta.league = baseline rates; each card row flags lone_dissent / split and lists colleagues)

referees({ q, org }) / referee(slug) / refereeFights(slug)

GET /v1/referees / …/{slug} / …/{slug}/fights — referees across the launch promotions: bouts, finish rate, method mix, average fight time; the bouts each one worked (async iterators for the lists)

coverage({ org })

GET /v1/coverage — what the database holds per promotion per year: events, settled bouts, and the share with stats, round stats, commission scorecards and a consensus odds line

splitDecisions({ org, from, to, limit })

GET /v1/scorecards/splits — split and majority decisions, newest first, with every judge's card and the dissenters named (paginated)

fighters({ q, org, country }) / fighter(slug, { include: ['bonuses', 'credentials'] })

GET /v1/fighters / …/{slug} (always carries next_fight / last_fight; bonuses = the UFC bonus ledger; credentials = grappling and wrestling pedigree, gyms and coaches, each row sourced and confidence-graded)

fighterHistory / fighterStats / fighterRankings / fighterPowerIndex

GET /v1/fighters/{slug}/…

rankings(org, { date }) / divisionRankings(org, division) / champions()

GET /v1/rankings/… / /v1/champions (entries carry movement, is_new, country_code; lastMeta names the previous/next snapshot)

powerIndex(org, { view, division, days, limit }) / predictionsUpcoming({ event })

GET /v1/power-index/{org} (view: current · movers · peaks) / /v1/predictions/upcoming

matchmaker(org, { division, limit }) / whosNext(fighter, { limit })

GET /v1/matchmaker/{org} / …/next/{fighter} — UFCalendar's matchmaker: the fights worth making (scored 0–100, per division or across the roster; not bookings), and one fighter's best next opponents with the win probability for each and the bout already booked

leaderboard(org, metric, { division, country, population, limit }) / recordBook(org, { division, country, population, scope, top })

GET /v1/stats/leaders / …/record-book — the Record Book: one leaderboard (48 metrics; ties flagged, sample size on every row), or every board's top rows grouped by category

orgDivision(org, division)

GET /v1/orgs/{org}/divisions/{division} — one weight class: rankings board, upcoming bouts, latest results, roster by recency

yearStats(year, { org })

GET /v1/stats/years/{year} — one calendar year in numbers for one promotion (or every covered one): methods, divisions, fastest finishes, upsets, Power Index climbers, busiest fighters, countries, judges

compare(a, b)

GET /v1/compare — two fighters side by side: bios, career stats, strike mix, streaks, previous meetings, common opponents, booked bout, model prediction (UFC), Power Index

eventStorylines(slug)

GET /v1/events/{slug}/storylines — the talking points of one card: title fights, eliminators, closest bout, rematches, streaks, debuts, returns, ranked fighters, nations

eventPickem(slug)

GET /v1/events/{slug}/pickem — how the UFCalendar community is picking each bout on one card (picks per corner, total, percentage); crowd sentiment, not a market and not a forecast

broadcastRights(org, { country, series }) / venue(id) / search(q) / usage()

misc (series: 'dwcs' | 'rtufc' = a UFC sub-series grid)

venues({ q, country, limit }) / venueEvents(id, { status, from, to, order, limit })

GET /v1/venues / …/{id}/events — venue search, and every covered event at one venue, newest first (paginated)

articles({ q, tag, locale, limit }) / article(slug, { locale })

GET /v1/articles / …/{slug} — UFCalendar's own editorial archive, newest first, in any of the 13 site languages (paginated), and one article's full Markdown body

webhookEndpoints() / createWebhookEndpoint(url, events) / rotateWebhookSecret(id) / deleteWebhookEndpoint(id)

/v1/webhook-endpoints (Pro+; kinds event.announced, fight.result, card.changed, event.completed, odds.moved — the consensus line moved 5+ points or the favourite flipped)

calendarIcsUrl(org)

GET /v1/calendar/{org}.ics (URL builder — no request)

get(path, params) / getWithMeta(path, params)

escape hatch for anything new