Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs
Coverage MatrixDocumentationChange LogLog InContact Us

Change Log

Find all updates to the MMA v2 API and its documentation

City IDs in Venue Objects

🗓️ Release Date 06/01/2026

We've added a city_id unique identifier to all venue objects across our General Sport Media APIs. The new field is included alongside the existing city_name field and is available in all feeds that contain venue information.

This is a non-breaking enhancement to existing responses.

"city_name": "Liverpool",
"city_id": "sr:city:31",

⭐ Benefit

Use a city's unique identifier for entity linking, data enrichment, and cross-feed correlation wherever venue information is available.

☑️ Sample Requests:

Soccer - Competitor Profile

curl --request GET \
     --url https://api.sportradar.com/soccer/trial/v4/en/competitors/sr:competitor:44/profile.json \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

⚙️ Return Samples

<venue id="sr:venue:8117" name="Dodger Stadium" capacity="56000" city_name="Los Angeles, CA" city_id="sr:city:963" country_name="USA" map_coordinates="34.0745409, -118.2408881" country_code="USA" timezone="America/Los_Angeles"/>
"venue": {
    "id": "sr:venue:8117",
    "name": "Dodger Stadium",
    "capacity": 56000,
    "city_name": "Los Angeles, CA",
    "city_id": "sr:city:963",
    "country_name": "USA",
    "map_coordinates": "34.0745409, -118.2408881",
    "country_code": "USA",
    "timezone": "America/Los_Angeles"
},

Diacritical Marks

Release DateFeeds AffectedBenefit
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 DateFeeds AffectedBenefit
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 DateFeeds AffectedBenefit
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 DateFeeds AffectedBenefit
08/28/2023Sport Events CreatedAdded 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 DateFeeds AffectedBenefit
05/15/2023Competitor 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 DateFeeds AffectedBenefit
03/03/2023Season ProbabilitiesAdded 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 DateFeeds AffectedBenefit
01/20/2023Competition InfoAdded 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 DateFeeds AffectedBenefit
12/16/2022Champions
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 DateFeeds AffectedBenefit
08/22/2022Season ProbabilitiesAdded 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 DateFeeds AffectedBenefit
06/29/2022Sport Events CreatedOur 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 DateFeeds AffectedUpdate
03/21/2022Competitor 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 DateFeeds AffectedUpdate
02/18/2022Competitor 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 DateFeeds AffectedUpdate
01/26/2022Competitor 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 DateFeeds AffectedUpdate
06/14/2021Season CompetitorsAdded data points to support the Season Competitors feed.

Data Complete Property

Release DateFeeds AffectedUpdate
06/14/2021Competitor 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 DateFeeds AffectedUpdate
08/11/2020Competitor Merge MappingAdded support for the new Competitor Merge Mappings feed.

API Release

Release DateFeeds AffectedUpdate
11/25/2019AllInitial release of MMA v2.

Updated about 2 months ago

Did this page help you?

Updated about 2 months ago

Did this page help you?

© Sportradar AG, St. Gallen, Switzerland