Diacritical Marks

Release Date

Feeds Affected

Benefit

12/06/2024

Champions

Competitor Profile

Competitor Summaries

Competitor vs Competitor

Daily Summaries

Live Summaries

Rankings

Season Competitors

Season Info

Season Probabilities

Season Summaries

Sport Event Summary

We've added support for diacritical marks in our MMA API.

Competitors will now display accented characters when applicable, such as Procházka, Jiří or Peña, Julianna. To access the diacritical marks use en_us (instead of en) in the language code parameter for a request.

Sample Request:
mma/trial/v2/en_us/sport_events/sr:sport_event:50760313/summary.xml?api_key=[API_KEY]

<sport_event id="sr:sport_event:50760313" start_time="2024-06-30T04:40:00+00:00" start_time_confirmed="true">
  <sport_event_context>
    <sport id="sr:sport:117" name="MMA"/>
--snip--
  <competitors>
    <competitor id="sr:competitor:837536" name="Pereira, Alex" abbreviation="PER" qualifier="home" gender="male"/>
    <competitor id="sr:competitor:251853" name="Procházka, Jiří" abbreviation="PRO" qualifier="away" gender="male"/>
  </competitors>

{
    "generated_at": "2024-12-06T14:46:08+00:00",
    "sport_event": {
        "id": "sr:sport_event:50760313",
        "start_time": "2024-06-30T04:40:00+00:00",
        "start_time_confirmed": true,
        "sport_event_context": {
            "sport": {
                "id": "sr:sport:117",
                "name": "MMA"
            },
--snip--
        },
        "coverage": {
            "type": "sport_event",
            "sport_event_properties": {
                "live": true,
                "data_complete": true
            }
        },
        "competitors": [
            {
                "id": "sr:competitor:837536",
                "name": "Pereira, Alex",
                "abbreviation": "PER",
                "qualifier": "home",
                "gender": "male"
            },
            {
                "id": "sr:competitor:251853",
                "name": "Procházka, Jiří",
                "abbreviation": "PRO",
                "qualifier": "away",
                "gender": "male"
            }
        ],

Technical Decision Winner Method

Release Date

Feeds Affected

Benefit

04/23/2024

Competitor Summaries

Competitor vs Competitor

Daily Summaries

Live Summaries

Season Probabilities

Season Summaries

Sport Event Summary

Added technical_decision as a valid entry under sport_event_status.method for matches.

Valid winner methods can be found in the MMA Open API Spec.

- decision_majority

decision_split
decision_unanimous
disqualified
ko_tko
overturned
submission
tko_doctors_stoppage
technical_decision

Coverage Node Update

Release Date

Feeds Affected

Benefit

02/26/2024

Competitor Summaries

Competitor vs Competitor

Daily Summaries

Live Summaries

Season Probabilities

Season Summaries

Sport Event Summary

Moved the live attribute from the main coverage node to the sport_event_properties node.

<sport_event_summary
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns="http://schemas.sportradar.com/sportsapi/mma/v2" generated_at="2024-01-17T09:11:42+00:00">
	<sport_event id="sr:sport_event:44809082" start_time="2023-11-11T23:10:00+00:00" start_time_confirmed="true">
		<sport_event_context>
			<sport id="sr:sport:117" name="MMA"/>
			<category id="sr:category:1089" name="UFC"/>
			<competition id="sr:competition:40371" name="UFC 295: Prochazka vs. Pereira"/>
			<season id="sr:season:107687" name="UFC 295: Prochazka vs. Pereira 2023" start_date="2023-11-11" end_date="2023-11-12" year="2023" competition_id="sr:competition:40371"/>
			<stage type="Early Prelims"/>
		</sport_event_context>
		<coverage type="sport_event">
			<sport_event_properties live="true" data_complete="true"/>
		</coverage>
		<competitors>
			<competitor id="sr:competitor:511388" name="Buzukja, Dennis" abbreviation="BUZ" qualifier="home" gender="male"/>
			<competitor id="sr:competitor:453255" name="Emmers, Jamall" abbreviation="EMM" qualifier="away" gender="male"/>
		</competitors>
		<venue id="sr:venue:6054" name="Madison Square Garden" capacity="19812" city_name="New York" country_name="USA" map_coordinates="40.750496,-73.993447" country_code="USA" timezone="America/New_York" state="NY"/>
		<channels>
			<channel name="ESPN+ US - ESPN US (stream)" url="http://www.espn.com/mma/fightcenter" country="United States" country_code="USA"/>
			<channel name="ESPNN - ESPN US" url="https://www.espn.com/mma/fightcenter" country="United States" country_code="USA"/>
		</channels>
	</sport_event>
	<sport_event_status status="closed" match_status="ended" winner_id="sr:competitor:453255" final_round="1" final_round_length="0:49" method="ko_tko" winner="away_team" scheduled_length="3" weight_class="featherweight(136-145)" title_fight="false" main_event="false"/>
	<statistics>
		<totals>
			<competitors>
				<competitor id="sr:competitor:453255" name="Emmers, Jamall" abbreviation="EMM" qualifier="away">
					<statistics control="00:03" knockdowns="1" significant_strike_percentage="70" significant_strikes="14" significant_strikes_attempted="20" submission_attempts="0" takedown_percentage="0" takedowns="0" takedowns_attempted="0" total_strike_percentage="70" total_strikes="14" total_strikes_attempted="20"/>
				</competitor>
				<competitor id="sr:competitor:511388" name="Buzukja, Dennis" abbreviation="BUZ" qualifier="home">
					<statistics control="0:00" knockdowns="0" significant_strike_percentage="42.86" significant_strikes="3" significant_strikes_attempted="7" submission_attempts="0" takedown_percentage="0" takedowns="0" takedowns_attempted="0" total_strike_percentage="42.86" total_strikes="3" total_strikes_attempted="7"/>
				</competitor>
			</competitors>
		</totals>
		<periods>
			<period number="1">
				<competitors>
					<competitor id="sr:competitor:453255" name="Emmers, Jamall" abbreviation="EMM" qualifier="away">
						<statistics control="00:03" knockdowns="1" significant_strike_percentage="70" significant_strikes="14" significant_strikes_attempted="20" submission_attempts="0" takedown_percentage="0" takedowns="0" takedowns_attempted="0" total_strike_percentage="70" total_strikes="14" total_strikes_attempted="20"/>
					</competitor>
					<competitor id="sr:competitor:511388" name="Buzukja, Dennis" abbreviation="BUZ" qualifier="home">
						<statistics control="0:00" knockdowns="0" significant_strike_percentage="42.86" significant_strikes="3" significant_strikes_attempted="7" submission_attempts="0" takedown_percentage="0" takedowns="0" takedowns_attempted="0" total_strike_percentage="42.86" total_strikes="3" total_strikes_attempted="7"/>
					</competitor>
				</competitors>
			</period>
		</periods>
	</statistics>
</sport_event_summary>

<?xml version="1.0" encoding="UTF-8"?>
<sport_event_summary xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" generated_at="2024-02-23T21:35:34+00:00" xmlns="http://schemas.sportradar.com/sportsapi/mma/v2" xsi:schemaLocation="http://schemas.sportradar.com/sportsapi/mma/v2 https://schemas.sportradar.com/sportsapi/mma/v2/schemas/sport_event_summary.xsd">
    <sport_event id="sr:sport_event:39870789" start_time="2023-04-08T22:35:00+00:00" start_time_confirmed="true">
        <sport_event_context>
            <sport id="sr:sport:117" name="MMA"/>
            <category id="sr:category:1089" name="UFC"/>
            <competition id="sr:competition:39101" name="UFC 287: Pereira vs. Adesanya 2"/>
            <season id="sr:season:102363" name="UFC 287: Pereira vs. Adesanya 2 2023" start_date="2023-04-08" end_date="2023-04-09" year="2023" competition_id="sr:competition:39101"/>
            <stage type="Early Prelims"/>
        </sport_event_context>
        <coverage live="true" type="sport_event">
            <sport_event_properties data_complete="true"/>
        </coverage>
        <competitors>
            <competitor id="sr:competitor:956523" name="Amorim, Jaqueline" abbreviation="AMO" qualifier="home" gender="female"/>
            <competitor id="sr:competitor:753437" name="Hughes, Sam" abbreviation="HUG" qualifier="away" gender="female"/>
        </competitors>
        <venue id="sr:venue:6928" name="Kaseya Center" capacity="19600" city_name="Miami" country_name="USA" map_coordinates="25.781389,-80.188056" country_code="USA" timezone="America/New_York" state="FL"/>
        <channels>
            <channel name="ESPN+ US - ESPN US (stream)" url="http://www.espn.com/mma/fightcenter" country="United States" country_code="USA"/>
        </channels>
    </sport_event>
    <sport_event_status status="closed" match_status="ended" winner_id="sr:competitor:753437" final_round="3" final_round_length="5:00" method="decision_unanimous" winner="away_team" scheduled_length="3" weight_class="strawweight(106-115)" title_fight="false" main_event="false"/>
    <statistics>
        <totals>
            <competitors>
                <competitor id="sr:competitor:753437" name="Hughes, Sam" abbreviation="HUG" qualifier="away">
                    <statistics control="07:02" knockdowns="0" significant_strike_percentage="44.23" significant_strikes="46" significant_strikes_attempted="104" submission_attempts="0" takedown_percentage="100" takedowns="1" takedowns_attempted="1" total_strike_percentage="60.8" total_strikes="107" total_strikes_attempted="176"/>
                </competitor>
                <competitor id="sr:competitor:956523" name="Amorim, Jaqueline" abbreviation="AMO" qualifier="home">
                    <statistics control="03:42" knockdowns="0" significant_strike_percentage="23.08" significant_strikes="12" significant_strikes_attempted="52" submission_attempts="3" takedown_percentage="20" takedowns="2" takedowns_attempted="10" total_strike_percentage="47.71" total_strikes="52" total_strikes_attempted="109"/>
                </competitor>
            </competitors>
        </totals>
        <periods>
            <period number="1">
                <competitors>
                    <competitor id="sr:competitor:753437" name="Hughes, Sam" abbreviation="HUG" qualifier="away">
                        <statistics control="00:02" knockdowns="0" significant_strike_percentage="44" significant_strikes="11" significant_strikes_attempted="25" submission_attempts="0" takedown_percentage="0" takedowns="0" takedowns_attempted="0" total_strike_percentage="48.15" total_strikes="13" total_strikes_attempted="27"/>
                    </competitor>
                    <competitor id="sr:competitor:956523" name="Amorim, Jaqueline" abbreviation="AMO" qualifier="home">
                        <statistics control="03:24" knockdowns="0" significant_strike_percentage="28" significant_strikes="7" significant_strikes_attempted="25" submission_attempts="3" takedown_percentage="100" takedowns="2" takedowns_attempted="2" total_strike_percentage="32.35" total_strikes="11" total_strikes_attempted="34"/>
                    </competitor>
                </competitors>
            </period>
            <period number="2">
                <competitors>
                    <competitor id="sr:competitor:753437" name="Hughes, Sam" abbreviation="HUG" qualifier="away">
                        <statistics control="03:29" knockdowns="0" significant_strike_percentage="28.57" significant_strikes="6" significant_strikes_attempted="21" submission_attempts="0" takedown_percentage="100" takedowns="1" takedowns_attempted="1" total_strike_percentage="61.82" total_strikes="34" total_strikes_attempted="55"/>
                    </competitor>
                    <competitor id="sr:competitor:956523" name="Amorim, Jaqueline" abbreviation="AMO" qualifier="home">
                        <statistics control="00:17" knockdowns="0" significant_strike_percentage="50" significant_strikes="3" significant_strikes_attempted="6" submission_attempts="0" takedown_percentage="0" takedowns="0" takedowns_attempted="4" total_strike_percentage="72.73" total_strikes="8" total_strikes_attempted="11"/>
                    </competitor>
                </competitors>
            </period>
            <period number="3">
                <competitors>
                    <competitor id="sr:competitor:753437" name="Hughes, Sam" abbreviation="HUG" qualifier="away">
                        <statistics control="03:31" knockdowns="0" significant_strike_percentage="50" significant_strikes="29" significant_strikes_attempted="58" submission_attempts="0" takedown_percentage="0" takedowns="0" takedowns_attempted="0" total_strike_percentage="63.83" total_strikes="60" total_strikes_attempted="94"/>
                    </competitor>
                    <competitor id="sr:competitor:956523" name="Amorim, Jaqueline" abbreviation="AMO" qualifier="home">
                        <statistics control="00:01" knockdowns="0" significant_strike_percentage="9.52" significant_strikes="2" significant_strikes_attempted="21" submission_attempts="0" takedown_percentage="0" takedowns="0" takedowns_attempted="4" total_strike_percentage="51.56" total_strikes="33" total_strikes_attempted="64"/>
                    </competitor>
                </competitors>
            </period>
        </periods>
    </statistics>
</sport_event_summary>

Active Season Indicator

Release Date	Feeds Affected	Benefit
08/28/2023	Sport Events Created	Added a `active_season` attribute for newly created matches appearing in the Sport Events Created endpoint. When marked as `true` this will signify that an added match is part of an active season.

<sport_event_created id="sr:sport_event:43393169" active_season="true" created_at="2023-08-30T14:42:39+00:00"/>
<sport_event_created id="sr:sport_event:43393167" active_season="true" created_at="2023-08-30T14:42:39+00:00"/>
<sport_event_created id="sr:sport_event:43393165" active_season="true" created_at="2023-08-30T14:42:38+00:00"/>
<sport_event_created id="sr:sport_event:43393163" active_season="true" created_at="2023-08-30T14:42:37+00:00"/>
<sport_event_created id="sr:sport_event:43393029" active_season="true" created_at="2023-08-30T14:37:40+00:00"/>

{
"generated_at": "2023-08-30T14:47:30+00:00",
    "sport_events_created": [
    {
        "id": "sr:sport_event:43393169",
        "active_season": true,
        "created_at": "2023-08-30T14:42:39+00:00"
    },
    {
        "id": "sr:sport_event:43393167",
        "active_season": true,
        "created_at": "2023-08-30T14:42:39+00:00"
    },
    {
        "id": "sr:sport_event:43393165",
        "active_season": true,
        "created_at": "2023-08-30T14:42:38+00:00"
    },
    {
        "id": "sr:sport_event:43393163",
        "active_season": true,
        "created_at": "2023-08-30T14:42:37+00:00"
    },

Main Event Signifier

Release Date	Feeds Affected	Benefit
05/15/2023	Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Season Probabilities Season Summaries Sport Event Summary	Added a Boolean flag (`main_event`) under `sport_event_status` to all summary endpoints. The `main_event` flag, when set to true, will indicate which sport_event(s) are the main events for that specific season (UFC event).

Pagination Update to Season Probabilities

Release Date	Feeds Affected	Benefit
03/03/2023	Season Probabilities	Added pagination to the Season Probabilities endpoint for several APIs. Going forward, the first 200 events will be displayed. To retrieve further events additional query string parameters will be required. For example, to load the next 200 events you will need to append `&start=200` to the call and to load the next 200 add `&start=400` and so on.

Category Data

Release Date	Feeds Affected	Benefit
01/20/2023	Competition Info	Added the `category` element to the Competition Info endpoint. This includes category `id`, `name`, and `country_code`. The category will be represented by the country or `International` to better distinguish the country designation.

Gender Distinction

Release Date	Feeds Affected	Benefit
12/16/2022	Champions Competitor Profile Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Rankings Season Info Season Probabilities Season Summaries Sport Event Summary	Added competitor gender to several endpoints.

Probability Data

Release Date	Feeds Affected	Benefit
08/22/2022	Season Probabilities	Added data within `sport_event_status` to the Season Probabilities endpoint. This data exists in other feeds within the MMA API, but was included here to enhance consistency.

'Sport Events Created' Endpoint

Release Date	Feeds Affected	Benefit
06/29/2022	Sport Events Created	Our new Sport Events Created endpoint provides a list of all events created within the last 24 hours. Send requests to this endpoint as needed to assist in locating and storing newly created events.

Updated Data Display

Release Date	Feeds Affected	Update
03/21/2022	Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Season Summaries Sport Event Summary Sport Event Timeline	Updated our handling of the `control` statistic to display in a time format.

Added Dataset

Release Date	Feeds Affected	Update
02/18/2022	Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Season Summaries Sport Event Summary	Backfilled all 2021 events to include new round level statistics.

Added Statistics

Release Date	Feeds Affected	Update
01/26/2022	Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Season Info Season Summaries Sport Event Summary	New access to more round level statistics such as control, significant strike percentage, significant strikes attempted, takedown percentage, takedowns attempted, total strike percentage, and total strikes attempted. In addition, we are now collecting control data for matches.

'Season Competitors' Endpoint

Release Date	Feeds Affected	Update
06/14/2021	Season Competitors	Added data points to support the Season Competitors feed.

Data Complete Property

Release Date	Feeds Affected	Update
06/14/2021	Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Season Probabilities Season Summaries Sport Event Summary	Added the `data_complete` data point in `sport_event_properties`.

'Competitor Merge Mapping' Endpoint

Release Date	Feeds Affected	Update
08/11/2020	Competitor Merge Mapping	Added support for the new Competitor Merge Mappings feed.

API Release

Release Date	Feeds Affected	Update
11/25/2019	All	Initial release of MMA v2.