list_events

1 creditStatic referencePOST /v1/list_events

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.

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": 2024,
  "limit": 3
}'

Response

json

{
  "events": [
    {
      "event_id": "600049126",
      "name": "UFC Fight Night: Covington vs. Buckley",
      "short_name": "UFC Fight Night",
      "starts_at": "2024-12-15T00:00:00.000Z",
      "event_date": "2024-12-14",
      "venue": "Benchmark International Arena",
      "city": "Tampa",
      "country": "USA",
      "status": "final",
      "bouts": 13,
      "main_event": "Colby Covington vs. Joaquin Buckley"
    },
    {
      "event_id": "600049125",
      "name": "UFC 310: Pantoja vs. Asakura",
      "short_name": "UFC 310",
      "starts_at": "2024-12-07T23:00:00.000Z",
      "event_date": "2024-12-07",
      "venue": "T-Mobile Arena",
      "city": "Las Vegas",
      "country": "USA",
      "status": "final",
      "bouts": 14,
      "main_event": "Alexandre Pantoja vs. Kai Asakura"
    },
    {
      "event_id": "600048962",
      "name": "UFC Fight Night: Yan vs. Figueiredo",
      "short_name": "UFC Fight Night",
      "starts_at": "2024-11-23T08:00:00.000Z",
      "event_date": "2024-11-23",
      "venue": "Galaxy Arena",
      "city": "Cotai",
      "country": "Macau",
      "status": "final",
      "bouts": 13,
      "main_event": "Petr Yan vs. Deiveson Figueiredo"
    }
  ],
  "count": 3,
  "next_offset": 3
}