Find all updates to the MMA v2 API and its documentation
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. |