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

{
  "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

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

---

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