Categories

Coverage
Stage Types
Weight Classes
Probabilities

Integration
Sport Event Statuses
Rankings

.

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

Rankings

When are the rankings updated?

Once per week.