SofaScore MMA schedule API

Endpoint facts

Method

GET

API path

/sofascore/mma-schedule

Auth

apiKey

Credits

1 credit/request

Charged on

Successful 2xx responses only

Platform

SofaScore

Response schema

#/definitions/sofascore.mmaScheduleResponseDoc

How this endpoint behaves

Query parameters:

• org_id: required. Numeric SofaScore MMA organisation id. Organisations (live-verified 2026-10-07): 19906 UFC, 19910 PFL, 20269 ONE Fighting Championship, 19905 Rizin, 20463 Fight Nation Championship, 19946 KSW, 20258 OKTAGON MMA, 20254 Absolute Championship Akhmat, 19909 Cage Warriors, 20264 Dana White's Contender Series, 20267 Brave Combat Federation, 20253 Jungle Fight Championship. Discover the current list with sofascore/categories (sport mma, which returns the World category 1708) and sofascore/category-tournaments with id=1708.
• month: required. Calendar month as YYYY-MM, e.g. 2026-10. Any other format is rejected with 400.

Notable response behavior:

• main_events has one fight per card: the main event, with the card_id and card_name (the card is a SofaScore tournament, e.g. UFC 332: Silva vs. Wang). Pass card_id to sofascore/mma-card to list every bout of the card.
• Each fight has home_fighter and away_fighter (id is the SofaScore team id, the same id the rankings endpoint uses), weight_class (seen: straw, fly, bantam, feather, light, welter, middle, lightheavy, heavy), scheduled_rounds, status and start_time. A finished fight also has winner_code (1 home, 2 away), win_type (seen: KO, TKO, SUB, UD, SD, NC), final_round and time_played_seconds.
• A fighter's ranking is the division ranking where 0 is the champion; it is omitted for an unranked fighter. wins, draws and losses are the professional record. nickname is omitted when SofaScore has none.
• Returns 404 when the organisation has no card in that month. SofaScore answers the same 404 for a month far in the past or future and for an id that is not an MMA organisation, so they cannot be told apart.

Example response (shortened):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "org_id": 19906,
    "month": "2026-10",
    "source_url": "https://api.sofascore.com/api/v1/unique-tournament/19906/scheduled-mma-main-events/2026-10",
    "fetched_at": "2026-10-07T17:00:00Z",
    "count": 5,
    "main_events": [
      {
        "id": 17042538,
        "slug": "wang-cong-natalia-silva",
        "card_id": 197311,
        "card_name": "UFC 332: Silva vs. Wang",
        "order": 14,
        "fight_type": "maincard",
        "weight_class": "fly",
        "win_type": "UD",
        "gender": "F",
        "final_round": 5,
        "scheduled_rounds": 5,
        "time_played_seconds": 1500,
        "status": {
          "code": 100,
          "description": "Ended",
          "type": "finished"
        },
        "winner_code": 1,
        "start_timestamp": 1791079953,
        "start_time": "2026-10-04T02:12:33Z",
        "home_fighter": {
          "id": 461932,
          "name": "Natália Silva",
          "slug": "natalia-silva",
          "country": "Brazil",
          "ranking": 0,
          "wins": 21,
          "draws": 1,
          "losses": 5
        },
        "away_fighter": {
          "id": 811429,
          "name": "Wang Cong",
          "slug": "cong-wang",
          "country": "China",
          "nickname": "The Joker",
          "ranking": 8,
          "wins": 10,
          "draws": 0,
          "losses": 2
        }
      },
      {
        "id": 16855023,
        "slug": "movsar-evloev-alexander-volkanovski",
        "card_id": 194262,
        "card_name": "UFC 333: Volkanovski vs. Evloev",
        "order": 12,
        "fight_type": "maincard",
        "weight_class": "feather",
        "gender": "M",
        "scheduled_rounds": 5,
        "status": {
          "code": 0,
          "description": "Not started",
          "type": "notstarted"
        },
        "start_timestamp": 1792857600,
        "start_time": "2026-10-24T16:00:00Z",
        "home_fighter": {
          "id": 467404,
          "name": "Alexander Volkanovski",
          "slug": "alex-volkanovski",
          "country": "Australia",
          "nickname": "The Great",
          "ranking": 0,
          "wins": 27,
          "draws": 0,
          "losses": 4
        },
        "away_fighter": {
          "id": 467455,
          "name": "Movsar Evloev",
          "slug": "movsar-evloev",
          "country": "Russia",
          "ranking": 1,
          "wins": 19,
          "draws": 0,
          "losses": 0
        }
      }
    ]
  }
}

Live monitoring

Monitored request

GET /sofascore/mma-schedule?month=2025-10&org_id=19906

Checks passed, 7 days to 14 Oct 2026

100%

Median response time

0.85 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026

GET /sofascore/mma-schedule?month=2025-10&org_id=19906

Items in main_events

4

Fields filled in every checked item

18

Shared guides

Related