Matchmaker board
UFCalendar's matchmaker for one MMA promotion (ufc, pfl, oktagon, rizin; bkfc 400s unsupported_org — the engine runs on the Power Index, which rates MMA only). Every candidate pair inside a division is scored 0–100 for rank proximity, momentum, competitiveness, readiness and story (rematches, trilogy deciders, eliminators): the promotion's official ladder where one exists plus the strongest active unranked Power Index fighters. UFC pairs are scored by UFCalendar's booking model (a ranker trained on every realized UFC booking), weighted by the stakes term; other promotions use the fitted heuristic. Fighters already booked leave the board, pairs already booked are excluded, and one fighter appears in at most two slips per division.
Without division the list is the cross-division top board (at most two slips per division); with it, that division's best pairs. meta.divisions lists the promotion's divisions (an unknown one 400s invalid_division), meta.rankings_date the ladder snapshot used (null when the promotion has no current ladder). Each slip: key (lo-hi fighter ids), a (red corner — the better-credentialed side) and b with rank (0 = champion, null = unranked), power_index, streak (signed: +3 = three straight wins) and booked; score; win_probability_a from the two Power Index ratings; tags (title, eliminator, coinFlip, bothStreaking, finishers, trilogyDecider, unfinishedBusiness, rematch, unrankedGem, bounceBack, steppingUp, bothDue, booked).
Computed WITHOUT the website's style-clash (Fight DNA) factor, so scores can differ slightly from ufcalendar.com. A ranking of fights worth making, not a report of bookings; probabilities are model output for information only. Recomputed at most every 10 minutes.
Request
- Base URL: https://api.ufcalendar.com
- URL: https://api.ufcalendar.com/v1/matchmaker/{org}
- Auth: HTTP bearer
Path parameters
Query parameters
One division slug from meta.divisions, e.g. lightweight, womens-strawweight. Omit for the cross-division board.
Response
Matchups, best first
Changes
No recorded changes to this operation across all 1 revision of this API.