FAQs

Categories

.

---

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

---

Stage Types

What are the possible stage – type values?

• Early Prelims
• Prelims
• Under Card
• Main Card

---

Sport Event Statuses

What are the valid sport_event_status - status values?

• 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
• 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?

• 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?

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

---

Weight Classes

What are the possible sport_event_status – 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)

---

Probabilities

What are the valid outcomes for probabilities?

• home_team_winner
• away_team_winner

What are markets and what are the different markets?

Markets is 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?).

---

Rankings

When are the rankings updated?

Once per week.

---