Skip to content

get_schedule

2 creditsBasic lookupPOST /v1/get_schedule

Upcoming fights with current moneylines where a book has posted one

Use it when you want the upcoming fights with any posted moneyline, for a fight-night app or a betting model's inputs.

Parameters

daysintegeroptional
Days ahead (default 30, max 180).
leagueenum: mma | pfl | bellatoroptional
League. Defaults to mma. One of: mma, pfl, bellator.

Notes

  • Over MCP, ask for it in plain English and the client calls get_schedule itself. Point any MCP client at https://mcp.fighterapi.com/mcp?key=YOUR_API_KEY.
  • Each call costs 2 credits, taken before it runs and refunded if the server errors.
  • Not the call you need? Find the right call by what you are trying to answer.

Request

curl -X POST https://mcp.fighterapi.com/v1/get_schedule \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "days": 30
}'

Response

json
{
  "days": 30,
  "bouts": [
    {
      "bout_id": "401932715",
      "event_id": "600061268",
      "event_name": "UFC Fight Night: Cortes Acosta vs. Walker",
      "event_date": "2026-11-07",
      "starts_at": "2026-11-08T01:00:00.000Z",
      "weight_class": "Heavyweight",
      "card_segment": "main",
      "match_number": 1,
      "title_fight": false,
      "scheduled_rounds": 5,
      "status": "scheduled",
      "fighter_a": "4903365",
      "fighter_a_name": "Waldo Cortes Acosta",
      "fighter_b": "3146944",
      "fighter_b_name": "Johnny Walker",
      "winner": null,
      "method": null,
      "method_display": null,
      "end_round": null,
      "end_clock": null,
      "duration_seconds": null,
      "judges_scores": null,
      "referee": null,
      "lines": [
        {
          "provider": "BetMGM",
          "a": -225,
          "b": 185,
          "total_rounds": null
        }
      ]
    },
    {
      "bout_id": "401928111",
      "event_id": "600061268",
      "event_name": "UFC Fight Night: Cortes Acosta vs. Walker",
      "event_date": "2026-11-07",
      "starts_at": "2026-11-08T01:00:00.000Z",
      "weight_class": "Women's Strawweight",
      "card_segment": "main",
      "match_number": 2,
      "title_fight": false,
      "scheduled_rounds": 3,
      "status": "scheduled",
      "fighter_a": "4020435",
      "fighter_a_name": "Tatiana Suarez",
      "fighter_b": "4289516",
      "fighter_b_name": "Virna Jandiroba",
      "winner": null,
      "method": null,
      "method_display": null,
      "end_round": null,
      "end_clock": null,
      "duration_seconds": null,
      "judges_scores": null,
      "referee": null,
      "lines": [
        {
          "provider": "BetMGM",
          "a": -220,
          "b": 180,
          "total_rounds": null
        }
      ]
    },
    {
      "bout_id": "401928119",
      "event_id": "600061268",
      "event_name": "UFC Fight Night: Cortes Acosta vs. Walker",
      "event_date": "2026-11-07",
      "starts_at": "2026-11-08T01:00:00.000Z",
      "weight_class": "Bantamweight",
      "card_segment": "main",
      "match_number": 3,
      "title_fight": false,
      "scheduled_rounds": 3,
      "status": "scheduled",
      "fighter_a": "3070984",
      "fighter_a_name": "Davey Grant",
      "fighter_b": "5144797",
      "fighter_b_name": "Elijah Smith",
      "winner": null,
      "method": null,
      "method_display": null,
      "end_round": null,
      "end_clock": null,
      "duration_seconds": null,
      "judges_scores": null,
      "referee": null,
      "lines": [
        {
          "provider": "BetMGM",
          "a": 260,
          "b": -325,
          "total_rounds": null
        }
      ]
    }
  ],
  "count": 37
}

Response fields

daysnumber
bouts[]array
List of objects
bouts[].bout_idstring
bouts[].event_idstring
bouts[].event_namestring
bouts[].event_datestring
bouts[].starts_atstring
bouts[].weight_classstring
bouts[].card_segmentstring
bouts[].match_numbernumber
bouts[].title_fightboolean
bouts[].scheduled_roundsnumber
bouts[].statusstring
bouts[].fighter_astring
bouts[].fighter_a_namestring
bouts[].fighter_bstring
bouts[].fighter_b_namestring
bouts[].winnernull
bouts[].methodnull
bouts[].method_displaynull
bouts[].end_roundnull
bouts[].end_clocknull
bouts[].duration_secondsnull
bouts[].judges_scoresnull
bouts[].refereenull
bouts[].lines[]array
List of objects
bouts[].lines[].providerstring
bouts[].lines[].anumber
bouts[].lines[].bnumber
bouts[].lines[].total_roundsnull
countnumber

Used in

Related endpoints

Try it

500 free credits every month: 250 calls to get_schedule, and no card.