Fighters

Fighter profile

Bio, records, stats, UFCalendar Power Index summary, and CC-licensed images with attribution metadata (displaying the credit is a license requirement). Read records and stats (added 2026-09-24): records is a map keyed by a clean name — pro_mma (the career MMA record), amateur_mma, pro_kickboxing, …, and the org slug for a record INSIDE one promotion (ufc, one, bkfc) — each { value, source, scope }; stats is ONE per-minute panel (SLpM, striking accuracy/defense, SApM, takedown average/accuracy/defense, submission average), always ONE sport (the fighter's headline sport: the pro-mma panel over MMA bouts in every promotion; pro-knuckle for a bare-knuckle fighter, pro-muay-thai / pro-kickboxing for a ONE striker; sports are never averaged together), with basis: { bouts, orgs, source, scope } stating exactly which bouts it averages over (e.g. 7 UFC bouts, or 18 MMA bouts across UFC + Oktagon); null when no real panel exists. career_stats is the raw per-source row list these are built from and stays unchanged for existing integrations.

next_fight is the fighter's next booked bout (not completed or cancelled, on an event that has not been cancelled and started no more than ~6h ago; result is always null) and last_fight their most recent completed or no-contest bout — both in the same shape as a source: "native" row of /history, or null.

?include=bonuses adds bonuses: the UFC post-fight bonus ledger — counts of Fight / Performance / KO / Submission of the Night (fotn, potn, kotn, sotn), their total, and the fights that earned them, newest first. Fight of the Night is credited to both corners, the other awards to the winner only. Award counts only, no dollar amounts.

?include=credentials adds credentials: the fighter's combat-sports background, researched by UFCalendar from public sources — credentials[] (kind: belt-rank, competition-result, professional-title, national-team, base-style, training-started, athletic-education, sports-club, award, sport-rank, record; discipline, competition, placement, rank, year, detail (kind-specific extras), note) and affiliations[] (kind: gym, coach, training-partner, manager; name, role, status current/former, is_primary, location, gym, discipline, relationship, as_of, period, note). EVERY row carries sources (the public reference URLs behind the claim — Wikipedia, the promotion's own pages, official bodies; may be empty, since only public references are listed) and confidence (confirmed = an official body or 2+ independent sources, reported = one credible outlet); unverified claims are never served. meta.note asks you to verify before republishing. Both lists may be empty.

Comma-separate to combine (include=bonuses,credentials). An unknown include value is 400 invalid_include.

get/v1/fighters/{idOrSlug}

Request

Base URL: https://api.ufcalendar.com
URL: https://api.ufcalendar.com/v1/fighters/{idOrSlug}
Auth: HTTP bearer

Path parameters

idOrSlugstring required

Numeric id or slug of the fighter. Stale slugs 308-redirect to the canonical URL.

Query parameters

include'bonuses' | 'credentials'

Comma-separated extra blocks. bonuses = the UFC bonus ledger; credentials = grappling and wrestling pedigree, gyms and coaches (sourced, confidence-graded).

Response

Fighter detail

Example response

{
  "data": {
    "next_fight": {
      "sport": "mma"
    },
    "last_fight": {
      "sport": "mma"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.