Skip to main content

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

FieldDescription
period1+Judge scores per round (10-9, 10-8, etc.)
currentFinal result (0=in progress, 1=winner by decision)

Status Codes

CodeDescription
0Not started
6Round 1
7Round 2
8Round 3
9Round 4
10Round 5
31Between Rounds
100Ended
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)

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.
GET /api/trending-players

MMA News

GET /api/news?lang=en

Country Flag

GET /api/country/:code/flag
Last modified on April 12, 2026