UFCalendar Fight API
Fight data API by [UFCalendar](https://www.ufcalendar.com) — MMA + bare-knuckle boxing: events, full cards, results, per-fight and per-round statistics,…
Data & analytics#sports--fitness
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Fight data API by UFCalendar — MMA + bare-knuckle boxing: events, full cards, results,
per-fight and per-round statistics, fighters with complete multi-promotion careers,
official rankings history (UFC 2013→), judges' scorecards (every round, every official,
UFC back to 1995), UFCalendar Power Index ratings, AI win probabilities and per-country
broadcast rights — for UFC, PFL, OKTAGON, BKFC and RIZIN.
Keys live at ufcalendar.com/account/api — every account gets the free plan: 100 requests a month, no card, never expires. Paid plans from $19/mo.
Plans and quotas: ufcalendar.com/developers.
Built for indie developers, side projects and small teams: fantasy apps, stats sites, Discord bots, analytics
projects. Plans are priced for them: self-serve only, no sales-negotiated contracts, and none planned.
Conventions: snake_case JSON in a {"data": ..., "meta": ...} envelope (meta is ALWAYS present, {} at minimum); cursor
pagination; UTC ISO-8601 timestamps plus venue IANA tz; errors as{"error": {"code", "message", "request_id"}} (every code is in the ErrorCode schema); monthly-quota headersX-RateLimit-Limit/-Remaining/-Reset and Retry-After on 429. Every GET /v1 200 carries a weak ETag andCache-Control: private, no-cache; send If-None-Match and an unchanged payload answers 304 with no body.
Every response body is described under components.schemas — closed objects, nullable as [T, "null"], every
vocabulary an enum — so generated clients get real types.
Odds (2026-09): one UFCalendar consensus line per corner: the mean across the sportsbooks we track (book
identities are never exposed; sources is how many backed each point), refreshed every 30 minutes in the 48 hours
before a card and every 2 hours otherwise. Current, opening and closing lines ship on every plan
(/v1/fights/{id}/odds, /v1/events/{id}/odds, include=odds); the full movement series is Pro and up
(/v1/fights/{id}/odds/history). Information only, not betting advice.
In-fight log and position stats (2026-11): for settled UFC bouts, the official in-fight log (every action,
referee stoppages with their reason, confirmed fouls: /v1/fights/{id}/timeline,/v1/fighters/{idOrSlug}/discipline) and position stats (time by range, control by position:/v1/fights/{id}/positions, /v1/fighters/{idOrSlug}/positions). Pro and Business plans. A foul is reported when
a record confirms it: the log's own eye-poke or low-blow row, a point the athletic commission deducted, or the
official result the bout ended on. A recorded foul is not a ruling on intent.
Source labels (2026-09-26): source / source_slug fields name official publishers only — ufc-stats,ufc-official, ufc-official-cards, a promotion's own *-official slug, wikipedia, or ufcalendar for our
own derivations. Every other publisher now ships as public-records (career records and history rows) orcommission-record (judges' scorecards); credential sources list public reference URLs only.
Fighter images are Wikimedia Commons/CC
only — the license/artist fields you receive MUST be displayed as a credit.
Not affiliated with UFC/Zuffa/TKO or any promotion.
Both official SDKs (pip install ufcalendar, npm install @ufcalendar/sdk) are
configured with the base URL https://api.ufcalendar.com/v1 — the same base every
code sample on this page uses.
Endpoints 61
Orgs
- GETList launch orgs with capability flags
/v1/orgsEach org carries flags (stats, rounds, rankings, broadcasts, predictions, scorecards, odds) so clients discover coverage programmatically — plus sport (mma,… - GETOne org
/v1/orgs/:slugSingle org by slug. Same shape as a list row. - GETOne division in one promotion
/v1/orgs/:slug/divisions/:divisionOne weight class in one promotion, in one call: division (slug, canonical name, weight_limit_lbs — null where no standard limit applies), rankings (the… - GETData coverage per promotion
/v1/coverageWhat the database actually holds, computed from it (refreshed every 30 minutes) rather than quoted from a marketing page: per launch promotion and per UTC…
Events
- GETList events (schedule + results)
/v1/eventsA bare listing is the upcoming calendar: events from the last ~6h onward, soonest first. Ordering defaults: explicit order always wins; else from= or a… - GETEvent with full card
/v1/events/:idOrSlugFull fight card (both corners, results when completed), venue and event-scoped broadcast rows. Every event and card entry carries sport (e.g. mma,… - GETCard-change log
/v1/events/:idOrSlug/changesThe 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… - GETStorylines of one card
/v1/events/:idOrSlug/storylinesThe talking points of one card, computed from the record — the pre-fight read, as of the card's start (a completed card reads as it did walking in). summary:… - GETPick'em splits for one card
/v1/events/:idOrSlug/pickemHow the UFCalendar community is picking each bout on one card, from the site's own pick'em game: fights[] in card order (non-cancelled bouts), each with… - GETCard-change feed across events
/v1/changesEvery card change across the launch promotions (or one of them), newest first — the same audit trail the card.changed webhook delivers, for callers that poll… - GETSearch venues
/v1/venuesArenas and venues that have hosted (or have booked) a launch-org event, alphabetical. q (at least 2 characters) matches the name or the city,… - GETEvents at a venue
/v1/venues/:id/eventsEvery launch-org event held (or booked) at one venue, newest first — upcoming cards on top, then the history. Same filters and row shape as /v1/events… - GETVenue
/v1/venues/:idVenue with city, region, country (+ country_code), coordinates, capacity and IANA tz. - GETICS calendar feed
/v1/calendar/:org.ics?key=stringSubscribe your calendar app to an org's schedule. Calendar apps can't send headers, so pass the key as ?key=. Refresh hourly at most. Three shapes: {org}.ics…
Fights
- GETSearch completed bouts (filtered)
/v1/fights/searchCompleted bouts with a winner across the launch promotions, filtered — the one-call answer to "the last title fight to end by knockout" or "every submission… - GETOne bout
/v1/fights/:idBout with corners (FighterRef with country_code), sport (bout override, else the org sport), weight_class + division_slug, result (raw method plus… - GETPer-fight totals
/v1/fights/:id/statsBoth corners: knockdowns, significant/total strikes, takedowns, submission attempts, reversals, control time, and target/position splits (head/body/leg,… - GETRound-by-round stats
/v1/fights/:id/roundsPer-round stat lines for both corners — each with round (and the stored round_number twin) and corner — including target/position splits (head/body/leg,… - GETIn-fight log: actions, stoppages and fouls (Pro+)
/v1/fights/:id/timelineThe official in-fight log of one settled UFC bout (Dana White's Contender Series included), from June 2013: every logged action in order, the referee… - GETPosition stats: time by range, control by position (Pro+)
/v1/fights/:id/positionsWhere one settled UFC bout was fought and who held control, from the official fight statistics (tracked reliably from 2007): totals is one line per fighter…
Fighters
- GETRoster search
/v1/fightersFighters with at least one launch-org fight (~4.5k). q is accent-insensitive. Rows are identity only (FighterRef plus second_nationality); country_code is… - GETFighter profile
/v1/fighters/:idOrSlugBio, records, stats, UFCalendar Power Index summary, and CC-licensed images with attribution metadata (displaying the credit is a license requirement). Read… - GETComplete career timeline
/v1/fighters/:idOrSlug/historyThe fighter's FULL multi-promotion career: native tracked bouts (richest data, source: "native") merged with the wider multi-promotion career record (source:… - GETCareer statistics
/v1/fighters/:idOrSlug/statsRaw per-source career rows, plus the readable split in meta.records / meta.stats (the same objects the fighter profile carries — read those unless you need… - GETRanking history
/v1/fighters/:idOrSlug/rankingsOfficial-board rows over time (org, board in the public vocabulary — official / meta — division slug, snapshot_date, rank, is_champion), newest snapshot… - GETPower Index trajectory
/v1/fighters/:idOrSlug/power-indexPer-bout rating history from the UFCalendar Power Index engine (rating before/after, model win probability, outcome 1 / 0 / 0.5 and its word twin result). The… - GETDiscipline: fouls committed and drawn (Pro+)
/v1/fighters/:idOrSlug/disciplineThe confirmed fouls in a fighter's UFC bouts, both the ones the fighter committed and the ones committed against them (drawn): eye pokes and low blows from… - GETCareer position profile: time by range, control for and against (Pro+)
/v1/fighters/:idOrSlug/positionsWhere a fighter's bouts happen, over their career: the share of cage time at distance, in the clinch and on the ground, and who held control in each position… - GETCompare two fighters
/v1/compare?a=string&b=stringThe tale of the tape in one call. a and b are fighter slugs or ids (a renamed slug is followed and named in meta.resolved); both are required and must differ…
Rankings
- GETOfficial board (point-in-time)
/v1/rankings/:orgThe 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… - GETOne division
/v1/rankings/:org/:divisionSame as the board endpoint, filtered to a division (lightweight, womens-strawweight, pound-for-pound, …) — entries carry the same movement / is_new /… - GETCurrent champions
/v1/championsRank-0 rows of each launch org's latest official board, with the champion's nationality and country_code (ISO-3166 alpha-2). org= narrows to one promotion and…
Scorecards
- GETJudges' scorecards for a bout
/v1/fights/:id/scorecardsThe official athletic-commission record: every judge, their score for each round, their card total, the decision type and any point deductions. UFC back to… - GETSplit and majority decisions
/v1/scorecards/splitsCompleted bouts the judges decided on a split or majority (including majority and split draws), newest first, across the launch promotions or one of them,… - GETJudge directory
/v1/judgesEvery official who has scored a launch-org bout (~550), busiest first, with their career shape: fights, rounds scored, rounds scored 10-8 or wider,… - GETOne judge
/v1/judges/:idA single official's career aggregates. Same shape as a directory row. - GETEverything a judge has scored
/v1/judges/:id/scorecardsThis judge's card for every launch-org bout they worked, newest first — the bout, its event, the decision type, and their own card, with where it sat on the…
Referees
- GETReferee directory
/v1/refereesEvery referee who has worked a settled launch-promotion bout, busiest first, with their career shape: bouts, promotions (by_org), first and last bout,… - GETOne referee
/v1/referees/:slugA single referee's career aggregates by slug (e.g. herb-dean). Same shape as a directory row. A spelling that folds to the same slug (Herb Dean) resolves too. - GETBouts a referee worked
/v1/referees/:slug/fightsEvery settled launch-promotion bout this referee worked, newest first — the bout (same shape as /v1/fights/{id}) with its event. meta.referee repeats the…
Odds
- GETConsensus odds for one card
/v1/events/:idOrSlug/oddsThe UFCalendar consensus line for every non-cancelled bout on one card, in card order: fights[], each with fight_id, status, both corners (fighter_a,… - GETConsensus odds for one bout
/v1/fights/:id/oddsThe UFCalendar consensus line for one bout: consensus (the latest point; the closing line once the bout is settled), opening (the first point we recorded; on… - GETConsensus line movement (Pro+)
/v1/fights/:id/odds/historyEvery stored consensus point for one bout, oldest first: the line-movement series. A point is stored only when the consensus changes, so the timestamps follow…
Power Index
- GETPower Index board
/v1/power-index/:orgThe UFCalendar Power Index (our own rating engine, hourly refresh) for one org, in three views: current (default): top-rated fighters whose latest bout was in…
Matchmaker
- GETMatchmaker board
/v1/matchmaker/:orgUFCalendar's matchmaker for one MMA promotion (ufc, pfl, oktagon, rizin; bkfc 400s unsupported_org — the engine runs on the Power Index, which rates MMA… - GETWho should this fighter fight next
/v1/matchmaker/next/:fighterOne fighter's most sensible next opponents by UFCalendar's matchmaker: the same engine and candidate pool as the board (their division's ladder plus the…
Stats
- GETOne stat leaderboard
/v1/stats/leaders?org=ufc&metric=total_fightsOne board from UFCalendar's Record Book rollup (rebuilt daily) for ONE promotion — org is required; there is no cross-promotion board on the API. metric picks… - GETThe Record Book
/v1/stats/record-book?org=ufcEvery leaderboard's top rows for ONE promotion in one call — org is required — grouped by category (fights, time, striking, grappling, discipline, records;… - GETA year in review
/v1/stats/years/:yearOne calendar year (UTC) of one promotion — or, without org, of every covered promotion together (never a promotion the API does not cover) — in numbers, over…
Predictions
- GETModel win probabilities (UFC)
/v1/predictions/upcomingUFCalendar model win probabilities for upcoming UFC bouts, published about three weeks ahead of each card and repriced at least weekly. Corner-guarded: a…
Broadcast
- GETHow to watch one event
/v1/events/:idOrSlug/watchWho airs one event, country by country: the promotion's standing rights deals merged with the event's own confirmed broadcast listings. Series-aware — a Dana… - GETWho airs it, per country
/v1/broadcast-rights/:orgOrg-level standing media rights per country (PFL harvested weekly across 212 countries; UFC ~110 curated). WORLD rows apply globally. Without series you get…
Search
- GETTypeahead search
/v1/search?q=stringAccent-insensitive search across roster fighters and events (up to 8 of each). Great for building pickers.
Articles
- GETSearch UFCalendar articles
/v1/articlesUFCalendar's own editorial archive — previews, recaps, investigations, fighter-pay and technique pieces — newest first. q (at least 2 characters) matches the… - GETGet an article
/v1/articles/:slugOne published UFCalendar article by slug: title, description, author_name, author_slug, tags, published_at, url and the full body_md (Markdown; the site's…
Account
- GETList your webhook endpoints
/v1/webhook-endpointsPro and above. Counts as one request against your quota; the deliveries themselves do not. - POSTRegister a webhook endpoint
/v1/webhook-endpointsPro+. Body: {"url": "https://...", "events": ["event.announced", "fight.result", "card.changed", "event.completed", "odds.moved"]}. Subscribe to… - DELETEDelete a webhook endpoint
/v1/webhook-endpoints/:idPro and above. Idempotent: deleting an id that is not yours (or no longer exists) still answers 200. - POSTRotate an endpoint signing secret
/v1/webhook-endpoints/:id/rotate-secretPro 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… - GETYour quota usage
/v1/usageCurrent-month usage for the calling key: tier, requests used/limit, rpm limit, and the reset as both a Unix timestamp (reset) and ISO-8601 (reset_at); month…
Discovery
- GETPlans, quotas and how to connect (no key required)
/v1/plansThe only endpoint that answers without a credential. Returns every plan, Free first, with its monthly request quota, per-minute limit, key limit and a…
API details
- Base URL
https://api.ufcalendar.com- Authentication
- A bearer token in the Authorization header
- Operations
- 61 operations on 60 pathsGET 58POST 2DELETE 1
- Main resources
- Events 10Fighters 9Fights 6Account 5Scorecards 5Orgs 4Odds 3Rankings 3Referees 3Stats 3
- Response formats
application/jsontext/calendar- Description format
- OpenAPI 3.1.0, API version
1.6.0 - Links
- Documentation · OpenAPI document · Terms of service · Support
- Listed from
- Ufcalendar's published OpenAPI description
How to test the UFCalendar Fight API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the UFCalendar Fight API collection, without the publisher's secrets.
- Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “List launch orgs with capability flags” (GET /v1/orgs), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the UFCalendar Fight API?
Fight data API by [UFCalendar](https://www.ufcalendar.com) — MMA + bare-knuckle boxing: events, full cards, results, per-fight and per-round statistics,… It is listed under Data & analytics and has 61 endpoints.
Who publishes the UFCalendar Fight API?
It is listed from UFCalendar's public API description (an OpenAPI document), not published by UFCalendar on Swastik Codes. Anyone who controls ufcalendar.com can claim the profile by adding a DNS TXT record.
What is the base URL of the UFCalendar Fight API?
Requests go to https://api.ufcalendar.com. Endpoint paths are added to this base URL.
How do I authenticate with the UFCalendar Fight API?
With A bearer token in the Authorization header.
How many endpoints does the UFCalendar Fight API have?
61 operations on 60 paths (58 GET, 2 POST, 1 DELETE). The largest groups are Events, Fighters, Fights, Account.
Is forking the UFCalendar Fight API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.