> For the complete documentation index, see [llms.txt](https://docs.sportradar.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sportradar.com/live-data/introduction/information-per-sport/mma.md).

# MMA

Sport-specific information, events, match statuses, and XML configurations for MMA

{% hint style="warning" %}
MMA is currently in development and testing. Output formats for Judges Results and Statistics may change. An updated XSD schema will follow.
{% endhint %}

## Match statuses in MMA

Use these values as the `extrainfo` attribute for event `1013` in MMA matches.

| ID  | Match status   | Description                                     | Additional information    |
| --- | -------------- | ----------------------------------------------- | ------------------------- |
| 0   | `NOT_STARTED`  | Not started yet                                 | —                         |
| 549 | `WALKOUT`      | Indicates the fighters' walkout.                | —                         |
| 550 | `STAREDOWN`    | Staredown                                       | —                         |
| 540 | `FIRST_ROUND`  | First round                                     | —                         |
| 541 | `SECOND_ROUND` | Second round                                    | —                         |
| 542 | `THIRD_ROUND`  | Third round                                     | —                         |
| 543 | `FOURTH_ROUND` | Fourth round                                    | Championship fights only  |
| 544 | `FIFTH_ROUND`  | Fifth round                                     | Championship fights only  |
| 301 | `FIRST_BREAK`  | Intermission between rounds. Round 1 has ended. | —                         |
| 302 | `SECOND_BREAK` | Intermission between rounds.                    | —                         |
| 303 | `THIRD_BREAK`  | Intermission between rounds.                    | —                         |
| 304 | `FOURTH_BREAK` | Intermission between rounds.                    | —                         |
| 80  | `INTERRUPTED`  | Interruption                                    | —                         |
| 551 | `FIGHT_ENDED`  | All rounds have ended. The fight has ended.     | Awaiting results (scores) |
| 552 | `OVERTURNED`   | —                                               | —                         |
| 553 | `NO_CONTEST`   | Fight considered a no contest (NC).             | —                         |
| 70  | `CANCELLED`    | —                                               | —                         |
| 60  | `POSTPONED`    | —                                               | —                         |
| 61  | `DELAYED`      | —                                               | —                         |
| 90  | `ABANDONED`    | —                                               | —                         |
| 100 | `ENDED`        | Match ended                                     | —                         |

## Events in MMA

| ID   | Event                           | Description                                                                                                                        | Coverage           | Attributes                                                                                                                                                                           |
| ---- | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 2407 | Position                        | Indicates the fighters' current position.                                                                                          | External feed      | `situation`                                                                                                                                                                          |
| 1013 | Match status                    | Indicates a match-period change.                                                                                                   | External feed      | `extrainfo` — see match statuses above                                                                                                                                               |
| 2408 | Strike                          | Triggered when a fighter attempts a hit or strike.                                                                                 | External feed      | `side`, `situation`, `target`, `impact`, `outcome`                                                                                                                                   |
| 2409 | Takedown Attempt                | Triggered when one fighter brings the other from standing to the ground.                                                           | External feed      | `side`, `situation`, `outcome`                                                                                                                                                       |
| 2410 | Standup                         | Triggered when fighters return to standing.                                                                                        | External feed      | —                                                                                                                                                                                    |
| 2411 | Reversal                        | Triggered when a fighter escapes a disadvantageous position and gains an advantageous position.                                    | External feed      | `side`, `situation`                                                                                                                                                                  |
| 2412 | Submission Attempt / Submission | Triggered when a fighter attempts to force the opponent to tap out.                                                                | External feed      | `side`, `situation`                                                                                                                                                                  |
| 2413 | Knockdown                       | Triggered when a fighter attempts a knockdown.                                                                                     | External feed      | `side`, `situation`                                                                                                                                                                  |
| 1010 | Betstart                        | Indicates that betting markets can be activated. This event is used before and during a match.                                     | External feed      | —                                                                                                                                                                                    |
| 1011 | Betstop                         | Indicates that all betting markets are closed. Used when scout and match supervisor communication is needed or a call disconnects. | External feed      | `extrainfo` — see [betstop reasons list](https://docs.sportradar.com/live-data/introduction/system-communication/xml-messages-sent-from-the-betradar-system/betstart-and-betstop.md) |
| 2414 | Pause                           | Triggered when a pause occurs during a round.                                                                                      | External feed (DC) | `reason`, `status`                                                                                                                                                                   |
| 1024 | Match about to start            | —                                                                                                                                  | External feed (DC) | —                                                                                                                                                                                    |
| 1036 | Time started / stopped          | Triggered when the clock starts or stops.                                                                                          | External feed (DC) | `extrainfo - 0 stopped, 1 - started`                                                                                                                                                 |
| 2415 | MMA Statistics                  | Statistics from the match.                                                                                                         | External feed (DC) | Proposed format                                                                                                                                                                      |
| 2416 | Fight score                     | Reports the fight score and result.                                                                                                | External feed (DC) | <p><code>side</code>, <code>extrainfo</code> (fight outcome), <code>extrainfomma</code> (win type)<br><code>outcome</code><br><code>wintype</code></p>                               |
| 2417 | MMA Foul                        | Triggered when a foul is committed.                                                                                                | External feed (DC) | `side`,`foul_outcome`, `points_deducted`                                                                                                                                             |
| 1015 | Free text                       | Used for a manual text message from operators                                                                                      | External feed (DC) | text attribute                                                                                                                                                                       |

## Enums used in event mappings

Each enum reserves `0` for `UNKNOWN`. Other values use one-based numeric IDs.

### `situation`

| ID | Enum value     |
| -- | -------------- |
| 0  | `UNKNOWN`      |
| 1  | `DISTANCE`     |
| 2  | `CLINCH`       |
| 3  | `GROUND`       |
| 4  | `SIDE`         |
| 5  | `GUARD`        |
| 6  | `HALF_GUARD`   |
| 7  | `BACK_CONTROL` |
| 8  | `MOUNT`        |

### `target`

| ID | Enum value    |
| -- | ------------- |
| 0  | `UNKNOWN`     |
| 1  | `HEAD`        |
| 2  | `MIDDLE_BODY` |
| 3  | `LEG`         |

### `impact`

| ID | Enum value    |
| -- | ------------- |
| 0  | `UNKNOWN`     |
| 1  | `STANDARD`    |
| 2  | `SIGNIFICANT` |

### `outcome`

| ID | Enum value   |
| -- | ------------ |
| 0  | `UNKNOWN`    |
| 1  | `SUCCESSFUL` |
| 2  | `MISSED`     |

### `outcome`

| ID | Enum value |
| -- | ---------- |
| 0  | `UNKNOWN`  |
| 1  | `DRAW`     |
| 2  | `WINNER`   |

### `foul_outcome`

| ID | Enum value         |
| -- | ------------------ |
| 0  | `UNKNOWN`          |
| 1  | `WARNING`          |
| 2  | `POINTS_DEDUCTION` |

### `reason`

| ID | Enum value     |
| -- | -------------- |
| 0  | `UNKNOWN`      |
| 1  | `EYE_POKE`     |
| 2  | `LOW_BLOW`     |
| 3  | `DOCTOR_CHECK` |
| 4  | `OTHER`        |

### `status`

| ID | Enum value |
| -- | ---------- |
| 0  | `UNKNOWN`  |
| 1  | `STARTED`  |
| 2  | `FINISHED` |

### `wintype`

| ID | Enum value           |
| -- | -------------------- |
| 0  | `UNKNOWN`            |
| 1  | `KNOCKOUT`           |
| 2  | `TECHNICAL_KNOCKOUT` |
| 3  | `DISQUALIFIED`       |
| 4  | `SUBMISSION`         |
| 5  | `DECISION`           |

## Sport specific XML elements and attributes

The proposed Statistics output will resemble the following XML.

{% hint style="warning" %}
This structure may change before the final product specification. New elements will be added.
{% endhint %}

```xml
<roundstats>
    <fighter id="1052">
        <rounds>
            <round number="1">
                <knockdowns>0</knockdowns>
                <totalstrikesattempted>39</totalstrikesattempted>
                <totalstrikeslanded>17</totalstrikeslanded>
                <sigstrikesattempted>39</sigstrikesattempted>
                <sigstrikeslanded>17</sigstrikeslanded>
                <sigstrikesaccuracy>43.59</sigstrikesaccuracy>
                <sigheadstrikesattempted>26</sigheadstrikesattempted>
                <sigheadstrikeslanded>6</sigheadstrikeslanded>
                <sigbodystrikesattempted>8</sigbodystrikesattempted>
                <sigbodystrikeslanded>6</sigbodystrikeslanded>
                <siglegstrikesattempted>5</siglegstrikesattempted>
                <siglegstrikeslanded>5</siglegstrikeslanded>
                <takedownsattempted>0</takedownsattempted>
                <takedownslanded>0</takedownslanded>
                <takedownsaccuracy>0</takedownsaccuracy>
                <reversals>0</reversals>
                <submissionsattempted>0</submissionsattempted>
            </round>
            <!-- Additional <round> elements for Rounds 2, 3, and later use this structure. -->
        </rounds>
    </fighter>
</roundstats>
```

### Proposed score representation

The proposed score and verdict output will resemble the following XML.\
\
Fight score is received with event 2416.\
The event contains information about the winner, fight outcome, and win type.\ <br>

{% hint style="warning" %}
This structure may change before the final product specification. The XSD will reflect the final format.
{% endhint %}

```xml
<event type="2416" stime="1791867133000" side="away" mtime="14:59" info="Decision - John Doe wins" id="10000000720" uuid="e605b024-952f-4741-92c0-9b4f1652a71b" extrainfo="2" extrainfomma="5">
 </event>
 <!-- Judge verdicts (who each judge scored the fight for) -->
  <score type="match" t1="0" t2="1" judgeid="3"/>
  <score type="match" t1="0" t2="1" judgeid="5"/>
  <score type="match" t1="1" t2="0" judgeid="6"/>

  <!-- Round 1: each judge's round score (points, not 1/0) -->
  <score type="round1" t1="9"  t2="10" judgeid="3"/>
  <score type="round1" t1="9"  t2="10" judgeid="5"/>
  <score type="round1" t1="10" t2="9"  judgeid="6"/>

  <!-- Round 2 -->
  <score type="round2" t1="10" t2="9"  judgeid="3"/>
  <score type="round2" t1="10" t2="9"  judgeid="5"/>
  <score type="round2" t1="9"  t2="10" judgeid="6"/>

  <!-- Round 3 -->
  <score type="round3" t1="9"  t2="10" judgeid="3"/>
  <score type="round3" t1="9"  t2="10" judgeid="5"/>
  <score type="round3" t1="10" t2="9"  judgeid="6"/>

  <!-- Official fight result (winner + method + when) -->
  <score type="result" winnerId="4325434" round="3" mtime="4:59" outcome="WINNER" wintype="DECISION" text="Decision - John Doe wins in round 3"/>

```

#### Text/Info matrix <a href="#text-info-matrix" id="text-info-matrix"></a>

The event `info` has no round suffix. Every `score type="result"` `text` gets the suffix (`" in round N"` for a winner, `" after round N"` for a draw).

* WINNER + KNOCKOUT gives `Knockout - {name} wins`
* WINNER + TECHNICAL\_KNOCKOUT gives `Technical Knockout - {name} wins`
* WINNER + SUBMISSION gives `Submission - {name} wins`
* WINNER + DISQUALIFIED gives `Disqualification - {name} wins` (I chose the noun form, because "Disqualified - X wins" reads as if X was disqualified)
* WINNER + DECISION gives `Decision - {name} wins`
* WINNER + UNKNOWN gives `{name} wins`
* DRAW + DECISION gives `Decision - Draw`
* DRAW + any other known win type gives `{Win Type Label} - Draw`
* DRAW + UNKNOWN gives `Draw`
* UNKNOWN outcome: the event info is `Fight Score`, the result `text` is omitted, and the result score has no `outcome` attribute

### Proposed match element

The proposed match element will resemble the following XML.

{% hint style="warning" %}
This structure may change before the final product specification. The XSD will reflect the final format.
{% endhint %}

```xml
<match
    t1namenatural="Fighter One"
    t2namenatural="Fighter Two"
    t1name="FIGHTER ONE"
    t2name="FIGHTER TWO"
    t1id="90000001"
    t2id="90000002"
    t1abbr="F1"
    t2abbr="F2"
    start="1785735600000"
    matchid="73366715"
    feedtype="full"
    extrainfo="0"
    betstatus="BETSTOP"
    connectionstatus="0"
    device="5"
    coveredfrom="venue"
    st1id="99000001"
    st2id="99000002"
    matchtime="00:18:42"
    sportid="mma"
    stime="1785743848497">
</match>
```

#### **Attributes in \<event> element** <a href="#attributes-in-less-than-event-greater-than-element" id="attributes-in-less-than-event-greater-than-element"></a>

| Element | Attributes                                                     | Description                                                                        | Possible values |
| ------- | -------------------------------------------------------------- | ---------------------------------------------------------------------------------- | --------------- |
| event   | *extrainfo*                                                    | Attribute containing additional information about the event. (see the table above) | Long            |
| ​       | *side*                                                         | Home or Away                                                                       | String          |
| ​       | *situation, target, impact, outcome, foul\_outcome, win\_type* | See section: Enums used in the events                                              | Enums           |
| ​       | confidence\_properties                                         |                                                                                    |                 |
| ​       | is\_entered\_late                                              |                                                                                    | String          |
| ​       | matchstatus                                                    | See table Match statuses in MMA                                                    | String          |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.sportradar.com/live-data/introduction/information-per-sport/mma.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
