# 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. -““ | | 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 | | organisation | string | the organisation that the weightclass is associated to i,e UFC | ### **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", "organisation": "UFC" }, "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 } ```