Skip to content

get_fighter

5 creditsStats + aggregationPOST /v1/get_fighter

Profile, UFC record by method, career rates, rating and recent fights

Use it when you are profiling a fighter: physical details, UFC record by method, career rates per 15 minutes, rating, and the last five fights.

Parameters

fighter_idstringrequired
Fighter id from search_fighters.

Notes

  • Over MCP, ask for it in plain English and the client calls get_fighter 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 \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "fighter_id": "4350812"
}'

Response

json
{
  "fighter": {
    "fighter_id": "4350812",
    "name": "Ilia Topuria",
    "nickname": "El Matador",
    "date_of_birth": "1997-01-21",
    "height_in": 67,
    "reach_in": 69,
    "weight_lbs": 155,
    "stance": "Orthodox",
    "country": "Georgia",
    "gym": "Climent Club",
    "gender": "MALE",
    "weight_class": "Lightweight",
    "pro_record": null
  },
  "record": {
    "wins": 9,
    "losses": 1,
    "draws": 0,
    "no_contests": 0,
    "wins_ko": 6,
    "wins_sub": 1,
    "wins_dec": 2,
    "losses_ko": 1,
    "losses_sub": 0,
    "losses_dec": 0
  },
  "ufc_record": {
    "wins": 9,
    "losses": 1,
    "draws": 0,
    "no_contests": 0,
    "wins_ko": 6,
    "wins_sub": 1,
    "wins_dec": 2,
    "losses_ko": 1,
    "losses_sub": 0,
    "losses_dec": 0
  },
  "career_rates": {
    "minutes_fought": 104,
    "sig_landed_per_15": 72.23,
    "sig_absorbed_per_15": 59.57,
    "sig_accuracy": 0.501,
    "sig_defense": 0.621,
    "td_per_15": 1.73,
    "td_accuracy": 0.571,
    "td_defense": 0.952,
    "sub_attempts_per_15": 0.86,
    "control_share": 0.205,
    "knockdowns": 8
  },
  "rating": {
    "current": 1655,
    "peak": 1670
  },
  "recent_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"
    },
    {
      "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"
    },
    {
      "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"
    }
  ]
}

Response fields

fighterobject
fighter.fighter_idstring
fighter.namestring
fighter.nicknamestring
fighter.date_of_birthstring
fighter.height_innumber
fighter.reach_innumber
fighter.weight_lbsnumber
fighter.stancestring
fighter.countrystring
fighter.gymstring
fighter.genderstring
fighter.weight_classstring
fighter.pro_recordnull
recordobject
record.winsnumber
record.lossesnumber
record.drawsnumber
record.no_contestsnumber
record.wins_konumber
record.wins_subnumber
record.wins_decnumber
record.losses_konumber
record.losses_subnumber
record.losses_decnumber
ufc_recordobject
ufc_record.winsnumber
ufc_record.lossesnumber
ufc_record.drawsnumber
ufc_record.no_contestsnumber
ufc_record.wins_konumber
ufc_record.wins_subnumber
ufc_record.wins_decnumber
ufc_record.losses_konumber
ufc_record.losses_subnumber
ufc_record.losses_decnumber
career_ratesobject
career_rates.minutes_foughtnumber
career_rates.sig_landed_per_15number
career_rates.sig_absorbed_per_15number

Related endpoints

Try it

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