Skip to content

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_events itself. Point any MCP client at https://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_idstring
events[].namestring
events[].short_namestring
events[].starts_atstring
events[].event_datestring
events[].venuestring
events[].citystring
events[].countrystring
events[].statusstring
events[].boutsnumber
events[].main_eventstring
countnumber
next_offsetnumber

Related endpoints

Try it

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