MMA Workflow Guide

Competition Feeds

Fighter Profiles

While the UFC does not maintain traditional teams or rosters, SportsDataIO maintains comprehensive profiles and weight class information for all fighters actively participating in the UFC.

• Fighter profiles include details such as name, weight class, birth date, height/weight, and reach.
• Profiles are updated annually at the start of each season and regularly throughout the year, reflecting changes in fighters’ weight classes for each fight.
• All MMA GlobalFighterID's start with 1400.

A full list of available data fields can be found here:

• FighterBasic

Event Feeds

Schedules & Fight Day Info

UFC event schedules and fight information are actively maintained and updated promptly upon official announcements, typically within a few hours. Dana White's Contender Series events are also confirmed and updated as they are announced and fighters commit.

• All fight days and times provided are in Eastern Time (ET).
• Individual fight start times are not available. Instead, the event’s start time is provided due to unpredictable durations of fights.
• SportsDataIO provides comprehensive coverage for:
  • UFC Pay-Per-View events (e.g., UFC 280, UFC 300, UFC 320, etc.)
  • UFC Fight Night events
  • Dana White’s Contender Series

Fight Statuses:

• Scheduled
• Pre-fight
• Walkouts
• Intros
• In Progress
• End of Round
• Final
• NULL
• Canceled

When a fight ends, use the ResultType field to view the result of the fight. The list of possible values is below:

• Submission
• No Contest
• KO/TKO
• Draw
• DQ
• Decision - Unanimous
• Decision - Split
• Decision - Majority

Scores & Game State

SportsDataIO provides detailed round-by-round results during live fights, with final fight results delivered after event conclusion.

Game State Details:

• Individual fight status
• Event start date/time
• Current round and round results
• Fighters involved and fight winner

Final Only (No Game State)

• Final results delivered approximately 5–10 minutes post-fight.
• A full list of available score details can be found here:
  • Fight
  • FightBasic

Live & Final (With Game State)

• Live fight coverage is delivered when the fight Status field switches from "Scheduled" to "InProgress".
• Game State data is updated alongside all other live in-game data, with a delay approximately 10-15 minutes behind the TV broadcast.
• Final scores are available at the conclusion of each fight.
• A full list of available score details can be found here:
  • Fight
  • FightBasic

Fighter Stats

Fight results and fighter stats are collected at the round level and a total for the entire fight.

• Fight results include things such as Knockdowns, Total Strikes (attempted & landed), Significant Strikes (attempted & landed), Takedowns (attempted, landed, slams, accuracy), Advances, Reversals, Submissions, Slam Rate, Time In Control, Number Round Wins (1, 2, 3, etc).
• Fighter stats and all other results are provided at the conclusion of each round and as final at the conclusion of each fight.

Final Only

• MMA Fighter stats delivered after the event is final is typically 5-10 minutes after each fight concludes.
• Each fight's final stats are added to a Fighter's Career Stats once the final fight stats are verified by our team (approx 1 hour after each game is completed).

Live & Final

• Each fight's final stats are added to a fighter's career stats once the final fight stats are verified by our team (approx 1 hour after each game is completed).
• Scorecards are updated as final typically 30 to 60 minutes after the conclusion of each fight.

Betting Feeds

Game Lines

Core fight lines are available pre-fight, including timestamps for opening prices, all line movement changes, and closing price.

Pre-Game Lines

• High-profile (headline) fight odds may appear months in advance; most fight odds typically become available in the week leading up to the event.

Pre-Game Lines Plus

Includes full-fight odds markets plus partial fight lines such as by round and all line movement for pre fight odds markets.

• Line Movement: The Betting Guide explains how to access the Betting Market endpoints to view an individual market's movement.

Props

Pre-fight prop markets include detailed bets such as method of victory, win-by-type, and most knockdowns.

• Prop markets vary in publication timing, with headline fight props generally available sooner than undercard props (some props become available only shortly before the fight).
• Includes timestamps for opening prices, line movements, and closing prices.

Props Plus

• Provides detailed line movement history for MMA prop markets.
  • The Betting Guide explains how to access the Betting Market endpoints to view an individual market's movement.

News

SportsDataIO provides bespoke news feeds and a variety of levels of news coverage to fit your specific needs:

• Editorial Wire Service: This includes more than 30,000 long-form content pieces in total across all leagues (previews, recaps, breaking news) with an associated image attached to each article. Please contact us to learn more about how we can connect you with newswire articles.
• Custom News: For bespoke articles created to fit your project, please contact us.
• AI-generated news: For procedurally-generated news based on data inputs, please contact us.

Previews, Recaps & Breaking News

• Previews, Recaps, and Breaking News are available all year round.
• Your SportsDataIO Client Manager can facilitate an introduction with appropriate news partners.
• These feeds are accessed directly through partner sites and not SportsDataIO endpoints.