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).

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": "401916276",
      "event_id": "600061541",
      "event_name": "UFC Fight Night: Allen vs. Duncan",
      "event_date": "2026-10-10",
      "starts_at": "2026-10-11T00:00:00.000Z",
      "weight_class": "Middleweight",
      "card_segment": "main",
      "match_number": 1,
      "title_fight": false,
      "scheduled_rounds": 5,
      "status": "scheduled",
      "fighter_a": "4025699",
      "fighter_a_name": "Brendan Allen",
      "fighter_b": "4848674",
      "fighter_b_name": "Christian Leroy Duncan",
      "winner": null,
      "method": null,
      "method_display": null,
      "end_round": null,
      "end_clock": null,
      "duration_seconds": null,
      "judges_scores": null,
      "referee": null,
      "lines": [
        {
          "provider": "DraftKings",
          "a": -148,
          "b": 124,
          "total_rounds": 3.5
        }
      ]
    },
    {
      "bout_id": "401927415",
      "event_id": "600061541",
      "event_name": "UFC Fight Night: Allen vs. Duncan",
      "event_date": "2026-10-10",
      "starts_at": "2026-10-11T00:00:00.000Z",
      "weight_class": "Lightweight",
      "card_segment": "main",
      "match_number": 2,
      "title_fight": false,
      "scheduled_rounds": 3,
      "status": "scheduled",
      "fighter_a": "5170144",
      "fighter_a_name": "Matheus Camilo",
      "fighter_b": "4078246",
      "fighter_b_name": "Jai Herbert",
      "winner": null,
      "method": null,
      "method_display": null,
      "end_round": null,
      "end_clock": null,
      "duration_seconds": null,
      "judges_scores": null,
      "referee": null,
      "lines": [
        {
          "provider": "DraftKings",
          "a": -198,
          "b": 164,
          "total_rounds": 1.5
        }
      ]
    },
    {
      "bout_id": "401924510",
      "event_id": "600061541",
      "event_name": "UFC Fight Night: Allen vs. Duncan",
      "event_date": "2026-10-10",
      "starts_at": "2026-10-11T00:00:00.000Z",
      "weight_class": "Women's Strawweight",
      "card_segment": "main",
      "match_number": 3,
      "title_fight": false,
      "scheduled_rounds": 3,
      "status": "scheduled",
      "fighter_a": "4700617",
      "fighter_a_name": "Loopy Godínez",
      "fighter_b": "4566308",
      "fighter_b_name": "Ketlen Souza",
      "winner": null,
      "method": null,
      "method_display": null,
      "end_round": null,
      "end_clock": null,
      "duration_seconds": null,
      "judges_scores": null,
      "referee": null,
      "lines": null
    }
  ],
  "count": 47
}

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_roundsnumber
countnumber

Related endpoints

Try it

500 credits free on signup: 250 calls to get_schedule, and no card.