Fighter Endpoint

This endpoint returns detailed information for a given fighter, including basic result info on all of their UFC fights. This information is kept up to date every 5 minutes.

Endpoint URL

https://dde-api.data.imgarena.com/mma/fighters/{id}

Required Headers

Key	Value
Accept	application/vnd.imggaming.dde.api+json;version=1
Content-Type	application/json
Authorization	Bearer eyvhaoudfgpdfgo*

Response Model:

Fighters Object

Field Name	Type	Description
leftstanceImage	string	a link to an image of the fighter in their left stance
weight	float	the weigh in weight, in lb, of the fighter. Will be null if unknown.
reach	float	the reach, in inches, of the fighter. Will be null if unknown.
fights	array	the number of fights that the fighter has participated in
currentWinStreak	integer	the number of consecutive fights been won
headshotImage	string	a link to the headshot image of the fighter
rightStanceImage	string	a link to an image of the fighter in their right stance
dob	date	the date of birth of the fighter
weightClass	object	an object containing information on the fighters weight class
fightsOutOf	string	the city, state, country code of where the fighter currently fights out of
height	integer	the height, in inches, of the fighter. Will be null if unknown.
winByMethod	object	an object containing a detailed breakdown of the fighters win
country	string	country of the fighter
age	integer	the age of the fighter
accolades	array	detailed information on the belt
lastName	string	the last name of the fighter
stance	string	the stance of the fighter. Possible values; Orthodox, Southpaw, Switch, Open. Will be null if unknown.
firstName	string	the first name of the fighter
nickName	string	the nickname of the fighter
ufcLink	string	link of the ufc fighter for e.g. -“https://www.ufc.com/fighter/khabib-nurmagomedov“
rankings	array	detailed information about the rank of the fighter (will be empty if the fighter isn't ranked)
averageFightTime	integer	the avg duration of the fights the fighter has participated in
born	string	the city, state, country code of where the fighter was born
record	object	detailed information of the fighters record
sigStrikesAccuracy	Float	Percentage: Career Significant Strikes Landed / Career Significant Strikes Attempted
ufcBonus	Array	Object containing UFC performance awards given at the discretion of the UFC. All elements always appear with a minimum value of 0.
sigStrikesPerMin	Float	Significant strikes landed per minute
careerOffensiveBreakdown	Array	Object containing the fighters career offensive breakdown. Note this is percentage breakdown of a fighters Strikes landed, takedown landed and submission attempted equaling 100%
takedownsDefense	Float	Percentage: One minus Takedowns landed by opponents divided by takedowns attempted by opponents.
takedownAccuracy	Float	takedown accuracy averaged per 15 minutes of fight time.
takedownAvg	Float	Takedowns landed averaged per 15 minutes of fight time.
sigStrikesAbsorbed	Float	Significant Strikes Absorbed per Minute.
sigStrikesDefense	Float	Percentage: Opponent Career Significant Strikes landed / Opponent Career Significant Strikes Attempted
submissionsAverage	Float	submission averaged per 15 minutes of fight time.

Fight Array (for historical results)

Field Name	Type	Description
weight	decimal	The fighter’s weight for that fight
eventName	string	The name of the event where the fight took place
titleFight	boolean	True if the fight was for a title
result	string	“redwon”, “bluewon”, “draw”, “nocontest”
dateTime	string	Date/Time of the fight
finishMethod	object	detailed information on the finish method of the fight
fightcardId	int	Id of the fightcard where the fight took place
opponent	object	Fighter ID, name & their record info at the time of the fight
title	string	What title the fight was for (if applicable)

Finish Method Object:

Field Name	Type	Description
type	string	the finish method type
submission	string	the specific type of submission used

Opponent Object

Field Name	Type	Description
fighterId	int	The ID of the fighter
lastName	string	The last name of the fighter
firstName	string	The first name of the fighter
nickName	string	the nickname of the fighter
record	object	The fighter’s record at the time of the fight

Record Object

Field Name	Type	Description
wins	integer	Their number of wins in the UFC
losses	integer	Their number of losses in the UFC
draws	integer	Their number of draws in the UFC
noContests	integer	Their number of no contests in the UFC

Weightclass Object

Field Name	Type	Description
weight	string	the weight range, in lb, of the weightclass of the fighter
description	string	description of the weightclass of the fighter
id	integer	ID of the weightclass of the fighter
obsolete	boolean	new field required further clarification
abbreviation	string	abbreviated description of the weightclass of the fighter

WinByMethod Object

Field Name	Type	Description
kotkoWins	integer	number of wins by ko/tko
submissionWins	integer	number of wins by submission
decisionWins	integer	number of wins by decision
otherWins	integer	number of wins by other means i.e. disqualification

Ranking Array

Field Name	Type	Description
weightClass	object	id/name of the weightclass
previousRank	integer	The fighter’s previous rank within that weightclass
interimChampion	boolean	True if the fighter is the interim champion of that weightclass
rank	integer	The fighter’s rank within that weightclass

Weightclass Object

Field Name	Type	Description
id	integer	the id of the specified weight class
name	string	the name of the weightclass

Record Object

Field Name	Type	Description
wins	integer	The number of wins for that fighter
losses	integer	The number of losses for that fighter
draws	integer	The number of draws for that fighter
noContests	integer	The number of no contests for that fighter

UFC Bonus Object

Field Name	Type	Description
fightOfTheNight	integer	Number of times fighter has received "fight of the night" award.
koOfTheNight	integer	Number of times fighter has received "KO of the night" award.
performanceOfTheNight	integer	Number of times fighter has received "performance of the night" award.
submissionOfTheNight	integer	Number of times fighter has received "submission of the night" award.
total	integer	Total of number of bonus won

Career Offensive Breakdown Object

Field Name	Type	Description
strikesLanded	Float	Career percentage of strikes landed
submissionsAttempted	Float	Career percentage of submissions attempted
takedownsLanded	Float	Career percentage of takedown landed

Sample Response

{
  "leftStanceImage": "https://ufclivepubstorage.blob.core.windows.net/public-files/daef1edf-cb45-4408-8f3d-3d01f55e96c6/MORENO_BRANDON_L_11-02.png",
  "fights": [
    {
      "titleFight": false,
      "result": null,
      "fightcardId": 900,
      "opponent": {
        "fighterId": 3455,
        "lastName": "Albazi",
        "record": {
          "draws": 0,
          "losses": 1,
          "noContests": 0,
          "wins": 17
        },
        "firstName": "Amir",
        "nickName": "The Prince"
      },
      "title": null,
      "weight": null,
      "eventName": "UFC Fight Night: Moreno vs. Albazi",
      "dateTime": "2024-11-02T21:00:00",
      "finishMethod": null
    },
    {
      "titleFight": false,
      "result": "LOST",
      "fightcardId": 873,
      "opponent": {
        "fighterId": 3436,
        "lastName": "Royval",
        "record": {
          "draws": 0,
          "losses": 7,
          "noContests": 0,
          "wins": 17
        },
        "firstName": "Brandon",
        "nickName": "Raw Dawg"
      },
      "title": null,
      "weight": 126,
      "eventName": "UFC Fight Night: Moreno vs. Royval 2",
      "dateTime": "2024-02-25T00:00:00",
      "finishMethod": "splitdecision"
    },
    {
      "titleFight": false,
      "result": null,
      "fightcardId": 873,
      "opponent": {
        "fighterId": 3455,
        "lastName": "Albazi",
        "record": {
          "draws": 0,
          "losses": 1,
          "noContests": 0,
          "wins": 17
        },
        "firstName": "Amir",
        "nickName": "The Prince"
      },
      "title": null,
      "weight": null,
      "eventName": "UFC Fight Night: Moreno vs. Royval 2",
      "dateTime": "2024-02-25T00:00:00",
      "finishMethod": null
    },
    {
      "titleFight": true,
      "result": "LOST",
      "fightcardId": 802,
      "opponent": {
        "fighterId": 1165,
        "lastName": "Pantoja",
        "record": {
          "draws": 0,
          "losses": 5,
          "noContests": 0,
          "wins": 28
        },
        "firstName": "Alexandre",
        "nickName": "The Cannibal"
      },
      "title": "UFC Flyweight Title",
      "weight": 125,
      "eventName": "UFC 290: Volkanovski vs. Rodriguez",
      "dateTime": "2023-07-08T22:00:00",
      "finishMethod": "splitdecision"
    },
    {
      "titleFight": true,
      "result": "WON",
      "fightcardId": 768,
      "opponent": {
        "fighterId": 2198,
        "lastName": "Figueiredo",
        "record": {
          "draws": 1,
          "losses": 3,
          "noContests": 0,
          "wins": 24
        },
        "firstName": "Deiveson",
        "nickName": "Deus da Guerra"
      },
      "title": "UFC Flyweight Title",
      "weight": 125,
      "eventName": "UFC 283: Teixeira vs. Hill",
      "dateTime": "2023-01-21T22:30:00",
      "finishMethod": "doctorstoppedtko"
    },
    {
      "titleFight": true,
      "result": "WON",
      "fightcardId": 750,
      "opponent": {
        "fighterId": 1858,
        "lastName": "Kara-France",
        "record": {
          "draws": 0,
          "losses": 11,
          "noContests": 1,
          "wins": 25
        },
        "firstName": "Kai",
        "nickName": "Don't Blink"
      },
      "title": "UFC Interim Flyweight Title",
      "weight": 124.5,
      "eventName": "UFC 277: Pena vs. Nunes 2",
      "dateTime": "2022-07-30T22:00:00",
      "finishMethod": "ko"
    },
    {
      "titleFight": true,
      "result": "LOST",
      "fightcardId": 700,
      "opponent": {
        "fighterId": 2198,
        "lastName": "Figueiredo",
        "record": {
          "draws": 1,
          "losses": 3,
          "noContests": 0,
          "wins": 24
        },
        "firstName": "Deiveson",
        "nickName": "Deus da Guerra"
      },
      "title": "UFC Flyweight Title",
      "weight": 124,
      "eventName": "UFC 270: Ngannou vs. Gane",
      "dateTime": "2022-01-23T00:00:00",
      "finishMethod": "unanimousdecision"
    },
    {
      "titleFight": true,
      "result": null,
      "fightcardId": 697,
      "opponent": {
        "fighterId": 2198,
        "lastName": "Figueiredo",
        "record": {
          "draws": 1,
          "losses": 3,
          "noContests": 0,
          "wins": 24
        },
        "firstName": "Deiveson",
        "nickName": "Deus da Guerra"
      },
      "title": "UFC Flyweight Title",
      "weight": null,
      "eventName": "UFC 269: Oliveira vs. Poirier",
      "dateTime": "2021-12-11T23:00:00",
      "finishMethod": null
    },
    {
      "titleFight": true,
      "result": "WON",
      "fightcardId": 676,
      "opponent": {
        "fighterId": 2198,
        "lastName": "Figueiredo",
        "record": {
          "draws": 1,
          "losses": 3,
          "noContests": 0,
          "wins": 24
        },
        "firstName": "Deiveson",
        "nickName": "Deus da Guerra"
      },
      "title": "UFC Flyweight Title",
      "weight": 125,
      "eventName": "UFC 263: Adesanya vs. Vettori 2",
      "dateTime": "2021-06-12T22:00:00",
      "finishMethod": {
        "type": "submission",
        "submission": "rearnakedchoke"
      }
    },
    {
      "titleFight": true,
      "result": "DRAW",
      "fightcardId": 633,
      "opponent": {
        "fighterId": 2198,
        "lastName": "Figueiredo",
        "record": {
          "draws": 1,
          "losses": 3,
          "noContests": 0,
          "wins": 24
        },
        "firstName": "Deiveson",
        "nickName": "Deus da Guerra"
      },
      "title": "UFC Flyweight Title",
      "weight": 124.5,
      "eventName": "UFC 256: Figueiredo vs. Moreno",
      "dateTime": "2020-12-13T00:30:00",
      "finishMethod": "majoritydecision"
    },
    {
      "titleFight": false,
      "result": "WON",
      "fightcardId": 631,
      "opponent": {
        "fighterId": 3436,
        "lastName": "Royval",
        "record": {
          "draws": 0,
          "losses": 7,
          "noContests": 0,
          "wins": 17
        },
        "firstName": "Brandon",
        "nickName": "Raw Dawg"
      },
      "title": null,
      "weight": 125,
      "eventName": "UFC 255: Figueiredo vs. Perez",
      "dateTime": "2020-11-21T23:30:00",
      "finishMethod": "ko"
    },
    {
      "titleFight": false,
      "result": "WON",
      "fightcardId": 565,
      "opponent": {
        "fighterId": 783,
        "lastName": "Formiga",
        "record": {
          "draws": 0,
          "losses": 8,
          "noContests": 0,
          "wins": 23
        },
        "firstName": "Jussier",
        "nickName": null
      },
      "title": null,
      "weight": 126,
      "eventName": "UFC Fight Night: Lee vs. Oliveira",
      "dateTime": "2020-03-14T19:00:00",
      "finishMethod": "unanimousdecision"
    },
    {
      "titleFight": false,
      "result": "WON",
      "fightcardId": 552,
      "opponent": {
        "fighterId": 1858,
        "lastName": "Kara-France",
        "record": {
          "draws": 0,
          "losses": 11,
          "noContests": 1,
          "wins": 25
        },
        "firstName": "Kai",
        "nickName": "Don't Blink"
      },
      "title": null,
      "weight": 125.5,
      "eventName": "UFC 245: Usman vs. Covington",
      "dateTime": "2019-12-14T23:15:00",
      "finishMethod": "unanimousdecision"
    },
    {
      "titleFight": false,
      "result": "DRAW",
      "fightcardId": 543,
      "opponent": {
        "fighterId": 3341,
        "lastName": "Askarov",
        "record": {
          "draws": 1,
          "losses": 1,
          "noContests": 0,
          "wins": 14
        },
        "firstName": "Askar",
        "nickName": "Bullet"
      },
      "title": null,
      "weight": 124,
      "eventName": "UFC Fight Night: Rodriguez vs. Stephens",
      "dateTime": "2019-09-21T21:00:00",
      "finishMethod": "splitdecision"
    },
    {
      "titleFight": false,
      "result": "LOST",
      "fightcardId": 213,
      "opponent": {
        "fighterId": 1165,
        "lastName": "Pantoja",
        "record": {
          "draws": 0,
          "losses": 5,
          "noContests": 0,
          "wins": 28
        },
        "firstName": "Alexandre",
        "nickName": "The Cannibal"
      },
      "title": null,
      "weight": 125,
      "eventName": "UFC Fight Night: Maia vs. Usman",
      "dateTime": "2018-05-19T22:30:00",
      "finishMethod": "unanimousdecision"
    },
    {
      "titleFight": false,
      "result": "LOST",
      "fightcardId": 452,
      "opponent": {
        "fighterId": 837,
        "lastName": "Pettis",
        "record": {
          "draws": 0,
          "losses": 5,
          "noContests": 0,
          "wins": 18
        },
        "firstName": "Sergio",
        "nickName": null
      },
      "title": null,
      "weight": 126,
      "eventName": "UFC Fight Night: Pettis vs. Moreno",
      "dateTime": "2017-08-05T23:00:00",
      "finishMethod": "unanimousdecision"
    },
    {
      "titleFight": false,
      "result": "WON",
      "fightcardId": 197,
      "opponent": {
        "fighterId": 2455,
        "lastName": "Ortiz",
        "record": {
          "draws": 0,
          "losses": 8,
          "noContests": 0,
          "wins": 19
        },
        "firstName": "Dustin",
        "nickName": null
      },
      "title": null,
      "weight": 125,
      "eventName": "UFC Fight Night: Swanson vs. Lobov",
      "dateTime": "2017-04-22T22:30:00",
      "finishMethod": {
        "type": "submission",
        "submission": "rearnakedchoke"
      }
    },
    {
      "titleFight": false,
      "result": "WON",
      "fightcardId": 169,
      "opponent": {
        "fighterId": 1656,
        "lastName": "Benoit",
        "record": {
          "draws": 0,
          "losses": 8,
          "noContests": 0,
          "wins": 10
        },
        "firstName": "Ryan",
        "nickName": "Baby Face"
      },
      "title": null,
      "weight": 126,
      "eventName": "The Ultimate Fighter: Tournament of Champions Finale",
      "dateTime": "2016-12-04T00:00:00",
      "finishMethod": "splitdecision"
    },
    {
      "titleFight": false,
      "result": "WON",
      "fightcardId": 437,
      "opponent": {
        "fighterId": 1722,
        "lastName": "Smolka",
        "record": {
          "draws": 0,
          "losses": 9,
          "noContests": 0,
          "wins": 17
        },
        "firstName": "Louis",
        "nickName": "Da Last Samurai"
      },
      "title": null,
      "weight": 126,
      "eventName": "UFC Fight Night: Lineker vs. Dodson",
      "dateTime": "2016-10-01T23:15:00",
      "finishMethod": {
        "type": "submission",
        "submission": "guillotinechoke"
      }
    }
  ],
  "currentWinStreak": 0,
  "headshotImage": "https://ufclivepubstorage.blob.core.windows.net/public-files/53d14884-959f-463a-81fd-28780ffbd102/MORENO_BRANDON_11-02.png",
  "sigStrikesAccuracy": 44.05,
  "country": "MEX",
  "age": 30,
  "takedownAvg": 1.74,
  "lastName": "Moreno",
  "rankings": [
    {
      "interimChampion": false,
      "previousRank": 2,
      "rank": 2,
      "weightClass": {
        "id": 19,
        "name": "Flyweight"
      }
    }
  ],
  "ufcBonus": {
    "fightOfTheNight": 4,
    "koOfTheNight": 0,
    "performanceOfTheNight": 3,
    "submissionOfTheNight": 0,
    "total": 7
  },
  "sigStrikesPerMin": 3.87,
  "averageFightTime": 969,
  "careerOffensiveBreakdown": {
    "strikesLanded": 38.69,
    "submissionsAttempted": 23.9,
    "takedownsLanded": 37.4
  },
  "takedownAccuracy": 46.88,
  "sigStrikesAbsorbed": 3.63,
  "weight": 125,
  "reach": 70,
  "rightStanceImage": "https://ufclivepubstorage.blob.core.windows.net/public-files/9c4e751d-a7bb-45bf-81bb-5c57b661b325/MORENO_BRANDON_R_02-24.png",
  "dob": "1993-12-07",
  "weightClass": {
    "weight": "116-125",
    "description": "Flyweight",
    "id": 19,
    "obsolete": false,
    "abbreviation": "FLW"
  },
  "fightsOutOf": "Tijuana, Baja California, MEX",
  "height": 67,
  "winsByMethod": {
    "decisionWins": 3,
    "kotkoWins": 3,
    "otherWins": 0,
    "submissionWins": 3
  },
  "accolades": [
    {
      "name": "UFC Interim Flyweight Title",
      "belt": "weightbelt",
      "won": "2022-07-31",
      "lost": "2023-07-09"
    },
    {
      "name": "UFC Flyweight Title",
      "belt": "weightbelt",
      "won": "2021-06-13",
      "lost": "2024-10-28"
    }
  ],
  "sigStrikesDefense": 59.69,
  "stance": "orthodox",
  "ufcLink": "http://www.ufc.com/athlete/Brandon-Moreno",
  "firstName": "Brandon",
  "nickName": "The Assassin Baby",
  "born": "Tijuana, Baja California, MEX",
  "submissionsAverage": 0.46,
  "record": {
    "draws": 2,
    "losses": 8,
    "noContests": 0,
    "wins": 21
  },
  "takedownsDefense": 63.64
}