list_events
1 creditStatic referencePOST /v1/list_events
Data refreshed · changelog
Cards by year and status, with the main event
Use it when you need card ids for a year, or want to see what is scheduled. Each card comes with its main event and number of fights.
Parameters
seasonstring | numberoptional- Year, e.g. 2025.
statusenum: scheduled | finaloptional- Only upcoming or only completed cards.
limitintegeroptional- Max events (default 50).
offsetintegeroptional- Page offset; use next_offset.
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
list_eventsitself. Point any MCP client athttps://mcp.fighterapi.com/mcp?key=YOUR_API_KEY. - Each call costs 1 credit, 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/list_events \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"season": 2025,
"limit": 3
}'Response
json
{
"events": [
{
"event_id": "600056266",
"name": "UFC Fight Night: Royval vs. Kape",
"short_name": "UFC Fight Night",
"starts_at": "2025-12-14T00:00:00.000Z",
"event_date": "2025-12-13",
"venue": "Meta APEX",
"city": "Las Vegas",
"country": "USA",
"status": "final",
"bouts": 12,
"main_event": "Brandon Royval vs. Manel Kape"
},
{
"event_id": "600056375",
"name": "UFC 323: Dvalishvili vs. Yan 2",
"short_name": "UFC 323",
"starts_at": "2025-12-06T23:00:00.000Z",
"event_date": "2025-12-06",
"venue": "T-Mobile Arena",
"city": "Las Vegas",
"country": "USA",
"status": "final",
"bouts": 14,
"main_event": "Merab Dvalishvili vs. Petr Yan"
},
{
"event_id": "600055175",
"name": "UFC Fight Night: Tsarukyan vs. Hooker",
"short_name": "UFC Fight Night",
"starts_at": "2025-11-22T15:00:00.000Z",
"event_date": "2025-11-22",
"venue": "ABHA Arena",
"city": "Doha",
"country": "Qatar",
"status": "final",
"bouts": 14,
"main_event": "Arman Tsarukyan vs. Dan Hooker"
}
],
"count": 3,
"next_offset": 3
}Response fields
events[]array- List of objects
events[].event_idstringevents[].namestringevents[].short_namestringevents[].starts_atstringevents[].event_datestringevents[].venuestringevents[].citystringevents[].countrystringevents[].statusstringevents[].boutsnumberevents[].main_eventstringcountnumbernext_offsetnumber
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_odds5 cr
Takes the event_id this one returns.
Opening, closing and current moneylines by sportsbook for a fight (5) or a card (10)
search_fighters1 cr
Filters by the same limit and league.
Find fighters by name or nickname
get_leaders5 cr
Filters by the same limit.
Career leaderboards from every fight's stat sheet
Try it
500 free credits every month: 500 calls to list_events, and no card.