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

will return null

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

will return null

rightStanceImage

string

will return null

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

will return null

rankings

array

currently an emptry array

averageFightTime

integer

the avg duration of the fights the fighter has participated in currently return as null

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 currently return as 0.0

ufcBonus

Array

will return null

sigStrikesPerMin

Float

Significant strikes landed per minute currently will return as 0.0

careerOffensiveBreakdown

Array

will return null

takedownsDefense

Float

Percentage: One minus Takedowns landed by opponents divided by takedowns attempted by opponents. currently return as 0.0

takedownAccuracy

Float

takedown accuracy averaged per 15 minutes of fight time. currently return as 0.0

takedownAvg

Float

Takedowns landed averaged per 15 minutes of fight time. currently return as 0.0

sigStrikesAbsorbed

Float

Significant Strikes Absorbed per Minute. currently return as 0.0

sigStrikesDefense

Float

Percentage: Opponent Career Significant Strikes landed / Opponent Career Significant Strikes Attempted currently return as 0.0

submissionsAverage

Float

submission averaged per 15 minutes of fight time. currently return as 0.0

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

“WON”, “LOST”, “DRAW”, “NOCONTEST”

dateTime

string

Date/Time of the fight

finishMethod

object (might be string)

detailed information on the finish method of the fight

fightcardId

integer

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 PFL

losses

integer

Their number of losses in the PFL

draws

integer

Their number of draws in the PFL

noContests

integer

Their number of no contests in the PFL

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 PFL

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

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

Sample Response

Last updated

Was this helpful?