Skip to main content

Base URL

Authentication

All requests require an x-api-key header:

V1 vs V2 Comparison

MMA-Specific Concepts

Fighters = Teams

In the V2 API, each fighter is represented as a “team” entity (similar to tennis players). Use /api/teams/:id for fighter profiles and fight history.

Fight Format

  • Championship fights: 5 rounds × 5 minutes
  • Regular fights: 3 rounds × 5 minutes
  • Win methods: KO/TKO, Submission, Decision (Unanimous/Split/Majority), Draw, No Contest

Weight Classes

Flyweight, Bantamweight, Featherweight, Lightweight, Welterweight, Middleweight, Light Heavyweight, Heavyweight (and women’s divisions).

Key Statistics

  • Strikes landed / attempted (significant + total)
  • Takedowns landed / attempted
  • Submission attempts
  • Control time
  • Knockdowns

Key Test IDs

Endpoint Categories

Example Requests

UI Design Ideas

  • Fight card layout: Show fights stacked as Main Card / Prelims / Early Prelims
  • Fighter profile: Show record (W-L-D), weight class, reach, stance (Orthodox/Southpaw), country flag
  • Fight result: Show method of victory (KO/TKO R2 3:45, Sub R1 2:22, Decision Unanimous)
  • Fight stats: Visualize significant strikes (head/body/leg), takedown accuracy, control time
  • Odds: MMA odds are moneyline only (no spread/point totals) — show as favorites vs underdogs
Last modified on June 29, 2026