> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sportsapipro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MMA V2 API — Overview

> Enhanced MMA API with 89 endpoints covering UFC, Bellator, KSW, PFL, ONE Championship and more

## Base URL

```
https://api.sportsapipro.com/v2/mma
```

## Authentication

All requests require an `x-api-key` header:

```bash theme={null}
curl -H "x-api-key: YOUR_API_KEY" \
  https://api.sportsapipro.com/v2/mma/live
```

## V1 vs V2 Comparison

| Feature          | V1 (Standard) | V2 (Enhanced)                              |
| ---------------- | ------------- | ------------------------------------------ |
| Endpoints        | \~15          | **89**                                     |
| Fighter profiles | Basic         | Full record, weight class, stats           |
| Fight stats      | Limited       | Strikes, takedowns, submissions            |
| Odds             | Pre-match     | Pre-fight + live in-fight                  |
| Promotions       | Major only    | UFC, Bellator, KSW, PFL, ONE, and 50+ more |

## MMA-Specific Concepts

### Fighters = Teams

In the V2 API, each fighter is represented as a **"team" entity** (similar to tennis players). Use `/api/teams/:id` for fighter profiles and fight history.

### Fight Format

* **Championship fights**: 5 rounds × 5 minutes
* **Regular fights**: 3 rounds × 5 minutes
* **Win methods**: KO/TKO, Submission, Decision (Unanimous/Split/Majority), Draw, No Contest

### Weight Classes

Flyweight, Bantamweight, Featherweight, Lightweight, Welterweight, Middleweight, Light Heavyweight, Heavyweight (and women's divisions).

### Key Statistics

* Strikes landed / attempted (significant + total)
* Takedowns landed / attempted
* Submission attempts
* Control time
* Knockdowns

## Key Test IDs

| Entity         | Name                    | ID         |
| -------------- | ----------------------- | ---------- |
| Tournament     | KSW                     | `19946`    |
| Fighter (Team) | Adrian Bartosiński      | `470979`   |
| Fighter (Team) | Madars Fleminas         | `461395`   |
| Fight (Match)  | Bartosiński vs Fleminas | `15522982` |

## Endpoint Categories

| Category                                                   | Endpoints | Description                       |
| ---------------------------------------------------------- | --------- | --------------------------------- |
| [Live & Schedule](/api-reference/mma-v2/global)            | 14        | Live fights, schedules, search    |
| [Match / Fight](/api-reference/mma-v2/match)               | 23        | Fight details, stats, odds        |
| [Tournament / Promotion](/api-reference/mma-v2/tournament) | 18        | Promotion info, seasons, rankings |
| [Team / Fighter](/api-reference/mma-v2/team)               | 11        | Fighter profiles, fight history   |
| [Player / Fighter](/api-reference/mma-v2/player)           | 16        | Detailed fighter stats            |
| [Referee & Venue](/api-reference/mma-v2/manager)           | 8         | Officials, arenas                 |
| **Total**                                                  | **89**    |                                   |

## Example Requests

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://api.sportsapipro.com/v2/mma/live" \
    -H "x-api-key: YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.sportsapipro.com/v2/mma/live',
    { headers: { 'x-api-key': 'YOUR_API_KEY' } }
  );
  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.sportsapipro.com/v2/mma/live',
      headers={'x-api-key': 'YOUR_API_KEY'}
  )
  data = response.json()
  ```
</CodeGroup>

## UI Design Ideas

* **Fight card layout**: Show fights stacked as Main Card / Prelims / Early Prelims
* **Fighter profile**: Show record (W-L-D), weight class, reach, stance (Orthodox/Southpaw), country flag
* **Fight result**: Show method of victory (KO/TKO R2 3:45, Sub R1 2:22, Decision Unanimous)
* **Fight stats**: Visualize significant strikes (head/body/leg), takedown accuracy, control time
* **Odds**: MMA odds are moneyline only (no spread/point totals) — show as favorites vs underdogs