---
title: "SofaScore MMA schedule"
method: GET
path: "/sofascore/mma-schedule"
tags: ["SofaScore"]
---

# SofaScore MMA schedule

`GET /sofascore/mma-schedule`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/sofascore/mma-schedule`
- Auth: API key in header `x-api-key`

Returns the main event of every fight card an MMA organisation holds in one calendar month, with the card id and name, fighters (country, nickname, ranking where 0 is the champion, record), weight class, scheduled rounds, status, and for finished fights the winner, win type and final round. Find organisation ids (UFC 19906, PFL 19910, ONE 20269, Rizin 19905, Fight Nation Championship 20463, KSW 19946, OKTAGON 20258, Absolute Championship Akhmat 20254, Cage Warriors 19909, Dana White's Contender Series 20264, Brave CF 20267, Jungle Fight 20253) with sofascore-categories (sport `mma`) and sofascore-category-tournaments (category 1708). Use the `card_id` with sofascore-mma-card to read every bout. Returns 404 when the organisation has no card in that month or the id is not an MMA organisation.

## Query parameters

- `org_id` string, required
- `month` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreMmaScheduleResponseDoc
  - `code` integer
  - `data` SofascoreMMAScheduleResponse
    - `count` integer
    - `fetched_at` string
    - `main_events` SofascoreMMAFight[]
      - `away_fighter` SofascoreMMAFighter
        - `country` string
        - `draws` integer
        - `id` integer
        - `losses` integer
        - `name` string
        - `nickname` string
        - `ranking` integer: Ranking is the fighter's division ranking; 0 is the champion, and it is omitted for an unranked fighter.
        - `slug` string
        - `wins` integer: Wins, Draws and Losses are the professional record going into the fight.
      - `card_id` integer
      - `card_name` string
      - `fight_type` string: FightType is the card segment the bout belongs to: `maincard`, `prelims` or `earlyprelims`.
      - `final_round` integer: FinalRound is the round the bout ended in; ScheduledRounds is its scheduled length. TimePlayedSeconds is the fight time actually fought.
      - `gender` string
      - `home_fighter` SofascoreMMAFighter
        - `country` string
        - `draws` integer
        - `id` integer
        - `losses` integer
        - `name` string
        - `nickname` string
        - `ranking` integer: Ranking is the fighter's division ranking; 0 is the champion, and it is omitted for an unranked fighter.
        - `slug` string
        - `wins` integer: Wins, Draws and Losses are the professional record going into the fight.
      - `id` integer
      - `order` integer: Order is the bout's position on the card; the highest number is the main event.
      - `scheduled_rounds` integer
      - `slug` string
      - `start_time` string
      - `start_timestamp` integer
      - `status` SofascoreEventStatus
        - `code` integer: SofaScore's numeric status code, for example 0 for not started and 100 for ended.
        - `description` string: Status as displayed, for example "Ended".
        - `type` string: Status group, for example `notstarted`, `inprogress` or `finished`.
      - `time_played_seconds` integer
      - `weight_class` string: WeightClass is SofaScore's division key, for example `fly`, `bantam`, `feather`, `light`, `welter`, `middle`, `lightheavy`, `heavy` or `straw`.
      - `win_type` string: WinType is how the bout ended, for example `KO`, `TKO`, `SUB`, `UD`, `SD` or `NC`; omitted until it has ended.
      - `winner_code` integer: WinnerCode is 1 when the home fighter won, 2 for the away fighter; absent until decided.
    - `month` string
    - `org_id` integer
    - `source_url` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)