Table of Contents

---

Getting Started

Coverage

How do you cover MMA events?

See our Coverage section in the MMA API Overview.

---

Integration

What is the difference between a competition and a season?

As with all Sportradar APIs, a competition (or in some cases "Tournament") is comprised of seasons. In UFC this is not intuitive, given that that structure doesn't apply to individual matchups. This structure is preserved for consistency with other sports.

Competitions will contain all events, whereas Seasons will only contain those which are known for the current year.

How do I get the schedule for a competition?

Call the Seasons endpoint and locate the start and end date for the season. Then use that information to call the Daily Summaries endpoint.

When is a sport_event (fight) removed? What happens next?

A sport_event (fight) may appear in the removed feed if a fight is cancelled. A new match, if officially announced, will appear in the season and match endpoints.

What if a match has incorrect details?

The sport_event_id will not change. The fight details will be changed, and the sport_event_id will appear in the Sport Event Change Log feed.

How can I find the values for various enum data points within the API?

Many enum values are listed in the FAQ below. For the most up-to-date values, please see the Schema section of the OpenAPI specification here.

What format are date fields presented in?

Date values are presented in the ISO 8601 standard format.

Timestamp fields are in UTC. These could include scheduled start times or play-by-play event timestamps. Examples: scheduled="2024-02-11T23:30:00+00:00", created_at="2024-02-11T23:43:20+00:00"

Date-only fields reflect local league convention and are not UTC-adjusted. These could include season start dates and birth dates. Examples: start_date="2024-08-16", date_of_birth="1984-09-22"

How do I locate the TTL (Time to Live)/cache on an API endpoint?

The cache (in seconds) can be accessed in the returned header information on each RESTful API call, under cache-control.

ex. cache-control: max-age=1, public, s-maxage=1 or cache-control: public, must-revalidate, max-age=120

---

Back to top ↑

---

Event Data

Stage Types

What are the possible stage - type values?

Here are the valid stage.type values:

• Early Prelims
• Prelims
• Under Card
• Main Card

---

Sport Event Statuses

What are the valid sport_event_status - status values?

Here are the valid sport_event_status values and their definitions:

• not_started - The match is scheduled to be played
• started - The match has begun
• live - The match is currently in progress
• postponed - The match has been postponed to a future date
• suspended - The match has been suspended
• match_about_to_start - The match is about to begin
• delayed - The match has been temporarily delayed and will be continued
• interrupted - The match began, but coverage has stopped for a short time. Note that match scores may not be updated during this period; the last recorded match score will be displayed instead. Any interrupted match that remains in this status for more than 48 hours will receive limited coverage upon resumption; coverage up to the point of interruption remains at the level originally specified for the match.
• cancelled - The match has been cancelled and will not be played
• ended - The match is over
• closed - The match results have been confirmed.

What are the possible sport_event_status - method values?

Here are the valid method values:

• ko_tko
• submission
• tko_doctors_stoppage
• decision_unanimous
• decision_split
• decision_majority
• overturned
• disqualified
• technical_decision

What are the valid sport_event_status - match_status values?

Here are the valid match_status values:

• not_started
• start_delayed
• ended
• cancelled
• postponed
• started

---

Probabilities

What are the valid outcomes for probabilities?

Here are the valid probability outcomes:

• home_team_winner
• away_team_winner
• draw

What are markets and what are the different markets?

Markets are something you can bet on that we provide probabilities for. Over time we intend to provide more and more markets in the API. Currently the only market we provide is 3-way (will the home team win? Or the away team? Or will it be a draw?).

---

Back to top ↑

---

Reference Data

Weight Classes

What are the possible sport_event_status - weight_class values?

Here are the valid weight_class values:

• flyweight (116-125)
• bantamweight (126-135)
• womens_bantamweight (126-135)
• featherweight (136-145)
• lightweight (146-155)
• welterweight (156-170)
• middleweight (171-185)
• light_heavyweight (186-205)
• heavyweight (206-265)
• catchweight (unrestricted weight)

---

Rankings

When are the rankings updated?

Once per week.

Back to top ↑

---

---