Fighters Endpoint

This endpoint returns basic information on all fighters. This information is kept up to date every 5 minutes.

Endpoint URLs

For all fighters:

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

Required Headers

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

Request Parameters

Parameter	Description
weightclass={weightclassId}	Return fighters only from a specific weight class. Weight class IDs can be retrieved from the WeightClasses endpoint

Response Model:

Fighters Object

Field Name	Type	Description
weight	integer	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.
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
rank	integer	The rank of the fighter. Null if no player ranking
height	integer	the height, in inches, of the fighter. Will be null if unknown.
country	string	country of the fighter
age	integer	the age of the fighter
accolades	array	an array containing 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
id	int	the id of the fighter.
born	string	the city, state, country code of where the fighter was born
record	object	an object showing the win/loss/draw/ information of the fighter

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, e.g. welterweight
id	integer	ID of the weightclass of the fighter
obsolete	boolean	true if this weightclass is obsolete
abbreviation	string	abbreviated description of the weightclass of the fighter

Accolade Object

Field Name	Type	Description
name	string	the name of the accolade the fighter has won
belt	string	the belt the fighter has won
won	date	when the accolade was won
lost	date	when the accolade was lost

Record Object

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

Sample Response

[
  {
    "dob": "1979-03-24",
    "rank": null,
    "height": 72,
    "country": "CAN",
    "age": 45,
    "accolades": [],
    "lastName": "Gill",
    "weight": 154,
    "reach": null,
    "weightClass": null,
    "fightsOutOf": null,
    "stance": "orthodox",
    "id": 1,
    "firstName": "Kultar",
    "nickName": "Black Mamba",
    "born": "Port Moody, British Columbia, CAN",
    "record": {
      "draws": 0,
      "losses": 8,
      "noContests": 0,
      "wins": 12
    }
  },
  {
    "dob": "1966-11-10",
    "rank": null,
    "height": 71,
    "country": "GBR",
    "age": 57,
    "accolades": [],
    "lastName": "Freeman",
    "weight": 225,
    "reach": null,
    "weightClass": {
      "weight": "206-265",
      "description": "Heavyweight",
      "id": 11,
      "obsolete": false,
      "abbreviation": "HW"
    },
    "fightsOutOf": null,
    "stance": "orthodox",
    "id": 2,
    "firstName": "Ian",
    "nickName": "The Machine",
    "born": "Sunderland, England, GBR",
    "record": {
      "draws": 1,
      "losses": 7,
      "noContests": 0,
      "wins": 20
    }
  },
  {
    "dob": "1984-12-17",
    "rank": null,
    "height": null,
    "country": "USA",
    "age": 39,
    "accolades": [],
    "lastName": "Ray",
    "weight": 170,
    "reach": null,
    "weightClass": null,
    "fightsOutOf": null,
    "stance": null,
    "id": 3,
    "firstName": "Joe",
    "nickName": null,
    "born": "Miramar, Florida, USA",
    "record": {
      "draws": 0,
      "losses": 0,
      "noContests": 0,
      "wins": 13
    }
  },
  {
    "dob": null,
    "rank": null,
    "height": 68,
    "country": "USA",
    "age": null,
    "accolades": [],
    "lastName": "Canterbury",
    "weight": 155,
    "reach": null,
    "weightClass": null,
    "fightsOutOf": null,
    "stance": null,
    "id": 4,
    "firstName": "Cody",
    "nickName": null,
    "born": "USA",
    "record": {
      "draws": 0,
      "losses": 10,
      "noContests": 0,
      "wins": 1
    }
  },
  {
    "dob": "1976-08-17",
    "rank": null,
    "height": 75,
    "country": "NED",
    "age": 48,
    "accolades": [],
    "lastName": "Overeem",
    "weight": 230,
    "reach": null,
    "weightClass": null,
    "fightsOutOf": null,
    "stance": "orthodox",
    "id": 5,
    "firstName": "Valentijn",
    "nickName": null,
    "born": "NED",
    "record": {
      "draws": 0,
      "losses": 32,
      "noContests": 0,
      "wins": 30
    }
  }
]