> ## 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.

# Live, Schedule & Search Endpoints

> 14 endpoints for live MMA fights, schedules, search, and discovery

## Live & Schedule (7 endpoints)

### Live Fights

```
GET /api/live
```

Curated live fights with fighters, scores, and round info.

### Live (All)

```
GET /api/live/all
```

Raw live data for all MMA fights.

### Today's Fights

```
GET /api/today
```

### Schedule by Date

```
GET /api/schedule/:date
```

Date format: `YYYY-MM-DD`. **Example:** `GET /api/schedule/2026-03-12`

### Live Tournaments

```
GET /api/live-tournaments
```

Promotions with live fights right now.

### Scheduled Tournaments

```
GET /api/scheduled-tournaments/:date
```

Promotions with fights on a given date.

### Newly Added Events

```
GET /api/newly-added-events
```

### Response Example — `/api/live`

```json theme={null}
{
  "events": [
    {
      "id": 15522982,
      "homeTeam": { "id": 8901, "name": "Bartosiński" },
      "awayTeam": { "id": 8902, "name": "Fleminas" },
      "homeScore": {
        "current": 0,
        "display": 0,
        "period1": 10,
        "period2": 9
      },
      "awayScore": {
        "current": 0,
        "display": 0,
        "period1": 9,
        "period2": 10
      },
      "status": { "code": 8, "description": "Round 3", "type": "inprogress" },
      "tournament": { "name": "KSW 116", "id": 1400 },
      "startTimestamp": 1737331200
    }
  ]
}
```

### Score Fields

| Field      | Description                                        |
| ---------- | -------------------------------------------------- |
| `period1`+ | Judge scores per round (10-9, 10-8, etc.)          |
| `current`  | Final result (0=in progress, 1=winner by decision) |

### Status Codes

| Code | Description    |
| ---- | -------------- |
| 0    | Not started    |
| 6    | Round 1        |
| 7    | Round 2        |
| 8    | Round 3        |
| 9    | Round 4        |
| 10   | Round 5        |
| 31   | Between Rounds |
| 100  | Ended          |

<Note>MMA fights are 3 rounds (regular) or 5 rounds (title fights / main events). Fight can end early via KO/TKO, submission, or doctor stoppage.</Note>

***

## Search & Discovery (7 endpoints)

### Search

```
GET /api/search?q=conor
```

Search fighters, promotions, and events.

### Countries / Categories

```
GET /api/countries
```

### Countries (All)

```
GET /api/countries/all
```

### Category Tournaments

```
GET /api/categories/:categoryId/tournaments
```

Promotions in a category.

### Trending Fighters

```
GET /api/trending-players
```

### MMA News

```
GET /api/news?lang=en
```

### Country Flag

```
GET /api/country/:code/flag
```