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_scheduleitself. Point any MCP client athttps://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
daysnumberbouts[]array- List of objects
bouts[].bout_idstringbouts[].event_idstringbouts[].event_namestringbouts[].event_datestringbouts[].starts_atstringbouts[].weight_classstringbouts[].card_segmentstringbouts[].match_numbernumberbouts[].title_fightbooleanbouts[].scheduled_roundsnumberbouts[].statusstringbouts[].fighter_astringbouts[].fighter_a_namestringbouts[].fighter_bstringbouts[].fighter_b_namestringbouts[].winnernullbouts[].methodnullbouts[].method_displaynullbouts[].end_roundnullbouts[].end_clocknullbouts[].duration_secondsnullbouts[].judges_scoresnullbouts[].refereenullbouts[].lines[]array- List of objects
bouts[].lines[].providerstringbouts[].lines[].anumberbouts[].lines[].bnumberbouts[].lines[].total_roundsnullcountnumber
Used in
- UFC odds data: Opening and closing moneylines for UFC fights since June 2020, joined to the result and both fighters' stat sheets, with line movement for upcoming fights.
- Guide: How do I get the upcoming UFC fight schedule in Python?
Related endpoints
get_event2 cr
Takes the event_id this one returns.
A card's fights with results, method, round, time and judges' scores
get_fight5 cr
Takes the bout_id this one returns.
One fight: result, full stat sheets, round-by-round lines, ratings and odds
get_fighter5 cr
Takes the fighter_id this one returns.
Profile, UFC record by method, career rates, rating and recent fights
get_fighter_fights5 cr
Takes the fighter_id this one returns.
A fighter's full UFC history with stats, ratings and closing lines
Try it
500 free credits every month: 250 calls to get_schedule, and no card.