Skip to content

get_fighter_fights

5 creditsStats + aggregationPOST /v1/get_fighter_fights

A fighter's full UFC history with stats, ratings and closing lines

Use it when you need a fighter's full UFC history to chart form, strength of schedule, or results against the closing line.

Parameters

fighter_idstringrequired
Fighter id from search_fighters.
limitintegeroptional
Max fights (default 50).
offsetintegeroptional
Page offset; use next_offset.

Notes

  • Over MCP, ask for it in plain English and the client calls get_fighter_fights itself. Point any MCP client at https://mcp.fighterapi.com/mcp?key=YOUR_API_KEY.
  • Each call costs 5 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_fighter_fights \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "fighter_id": "4350812",
  "limit": 3
}'

Response

json
{
  "fighter_id": "4350812",
  "fights": [
    {
      "bout_id": "401863575",
      "event_id": "600058854",
      "event_name": "UFC Freedom 250: Topuria vs. Gaethje",
      "event_date": "2026-06-14",
      "starts_at": "2026-06-15T00:00:00.000Z",
      "weight_class": "Lightweight",
      "card_segment": "main",
      "match_number": 1,
      "title_fight": true,
      "scheduled_rounds": 5,
      "status": "final",
      "fighter_a": "4350812",
      "fighter_a_name": "Ilia Topuria",
      "fighter_b": "3022345",
      "fighter_b_name": "Justin Gaethje",
      "winner": "3022345",
      "method": "kotko",
      "method_display": "KO/TKO",
      "end_round": 4,
      "end_clock": "5:00",
      "duration_seconds": 1200,
      "judges_scores": null,
      "referee": "Marc Goddard",
      "sig_landed": 97,
      "sig_absorbed": 91,
      "td_landed": 1,
      "rating_before": 1670,
      "rating_after": 1655,
      "median_closing_line": null,
      "result": "loss"
    },
    {
      "bout_id": "401758683",
      "event_id": "600053168",
      "event_name": "UFC 317: Topuria vs. Oliveira",
      "event_date": "2025-06-28",
      "starts_at": "2025-06-29T02:00:00.000Z",
      "weight_class": "Lightweight",
      "card_segment": "main",
      "match_number": 1,
      "title_fight": true,
      "scheduled_rounds": 5,
      "status": "final",
      "fighter_a": "4350812",
      "fighter_a_name": "Ilia Topuria",
      "fighter_b": "2504169",
      "fighter_b_name": "Charles Oliveira",
      "winner": "4350812",
      "method": "kotko",
      "method_display": "KO/TKO",
      "end_round": 1,
      "end_clock": "2:27",
      "duration_seconds": 147,
      "judges_scores": null,
      "referee": "Marc Goddard",
      "sig_landed": 21,
      "sig_absorbed": 9,
      "td_landed": 0,
      "rating_before": 1656,
      "rating_after": 1670,
      "median_closing_line": -450,
      "result": "win"
    },
    {
      "bout_id": "401654336",
      "event_id": "600044733",
      "event_name": "UFC 308: Topuria vs. Holloway",
      "event_date": "2024-10-26",
      "starts_at": "2024-10-26T18:00:00.000Z",
      "weight_class": "Featherweight",
      "card_segment": "main",
      "match_number": 1,
      "title_fight": true,
      "scheduled_rounds": 5,
      "status": "final",
      "fighter_a": "4350812",
      "fighter_a_name": "Ilia Topuria",
      "fighter_b": "2614933",
      "fighter_b_name": "Max Holloway",
      "winner": "4350812",
      "method": "kotko",
      "method_display": "KO/TKO",
      "end_round": 3,
      "end_clock": "1:34",
      "duration_seconds": 694,
      "judges_scores": null,
      "referee": "Marc Goddard",
      "sig_landed": 75,
      "sig_absorbed": 79,
      "td_landed": 2,
      "rating_before": 1640,
      "rating_after": 1656,
      "median_closing_line": -290,
      "result": "win"
    }
  ],
  "count": 3,
  "next_offset": 3
}

Response fields

fighter_idstring
fights[]array
List of objects
fights[].bout_idstring
fights[].event_idstring
fights[].event_namestring
fights[].event_datestring
fights[].starts_atstring
fights[].weight_classstring
fights[].card_segmentstring
fights[].match_numbernumber
fights[].title_fightboolean
fights[].scheduled_roundsnumber
fights[].statusstring
fights[].fighter_astring
fights[].fighter_a_namestring
fights[].fighter_bstring
fights[].fighter_b_namestring
fights[].winnerstring
fights[].methodstring
fights[].method_displaystring
fights[].end_roundnumber
fights[].end_clockstring
fights[].duration_secondsnumber
fights[].judges_scoresnull
fights[].refereestring
fights[].sig_landednumber
fights[].sig_absorbednumber
fights[].td_landednumber
fights[].rating_beforenumber
fights[].rating_afternumber
fights[].median_closing_linenull
fights[].resultstring
countnumber
next_offsetnumber

Related endpoints

Try it

500 credits free on signup: 100 calls to get_fighter_fights, and no card.