# Rankings Endpoint

This endpoint returns information on all rankings, split into rankings per weightclass. This information is kept up to date every hour.

## **Endpoint URLs:**

| `https://dde-api.data.imgarena.com/mma/rankings` |
| ------------------------------------------------ |

## **Required Headers**

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

## **Request Parameters**

This endpoint can be requested just by requesting the rankings for a certain weightclass. e.g. \&weightclass={weightclassId}.

| Parameter | Description |
| --------- | ----------- |
|           |             |

## **Response Model:**

### **PoundForPound Object**

| Field Name      | Type   | Description                                                                                                                  |
| --------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------- |
| poundForPound   | array  | contains the pound for pound ranking for all fighters. information is only returned back when a weight class isn't specified |
| weightClasses   | object | contains details of the given weight class                                                                                   |
| fighterRankings | array  | contains details about the rankings for a given weight class                                                                 |

### **poundForPound Array**

| Field Name      | Type    | Description                                 |
| --------------- | ------- | ------------------------------------------- |
| rank            | integer | the rank of the current fighter             |
| lastName        | string  | the last name of the fighter                |
| firstName       | string  | the first name of the fighter               |
| nickName        | string  | the nickname of the fighter                 |
| Id              | integer | the ID of the fighter                       |
| interimChampion | boolean | true if the fighter is interim champion     |
| previousRank    | integer | the previous rank of the fighter            |
| record          | object  | the fighters ufc W/L/D/NC record in the UFC |

### **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 |

### **Weightclasses Object**

| Field Name   | Type   | Description                                |
| ------------ | ------ | ------------------------------------------ |
| weight       | string | The weight range of the weightclass, in LB |
| description  | string | A description of the weightclass           |
| id           | int    | The ID of the weightclass                  |
| obsolete     | bool   | Boolean, true if no longer used in UFC     |
| abbreviation | string | Abbreviation of the weightclass            |

### **Fighter Info Object:**

| Field Name      | Type    | Description                                  |
| --------------- | ------- | -------------------------------------------- |
| rank            | string  | The current rank 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                  |
| id              | int     | the id of the fighter.                       |
| previousRank    | integer | The previous rank of the fighter             |
| interimChampion | boolean | True if fighter is the interim champion      |
| record          | object  | The fighter’s UFC W/L/D/NC record in the UFC |

### **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**

```
{
  "poundForPound": [],
  "weightClasses": [
    {
      "fighterRankings": [
        {
          "rank": "champion",
          "lastName": "Pantoja",
          "interimChampion": false,
          "previousRank": "champion",
          "record": {
            "draws": 0,
            "losses": 5,
            "noContests": 0,
            "wins": 28
          },
          "id": 1165,
          "firstName": "Alexandre",
          "nickName": "The Cannibal"
        },
        {
          "rank": 1,
          "lastName": "Royval",
          "interimChampion": false,
          "previousRank": 1,
          "record": {
            "draws": 0,
            "losses": 7,
            "noContests": 0,
            "wins": 17
          },
          "id": 3436,
          "firstName": "Brandon",
          "nickName": "Raw Dawg"
        },
        {
          "rank": 2,
          "lastName": "Moreno",
          "interimChampion": false,
          "previousRank": 2,
          "record": {
            "draws": 2,
            "losses": 8,
            "noContests": 0,
            "wins": 22
          },
          "id": 361,
          "firstName": "Brandon",
          "nickName": "The Assassin Baby"
        },
        {
          "rank": 3,
          "lastName": "Albazi",
          "interimChampion": false,
          "previousRank": 3,
          "record": {
            "draws": 0,
            "losses": 2,
            "noContests": 0,
            "wins": 17
          },
          "id": 3455,
          "firstName": "Amir",
          "nickName": "The Prince"
        },
        {
          "rank": 4,
          "lastName": "Kara-France",
          "interimChampion": false,
          "previousRank": 4,
          "record": {
            "draws": 0,
            "losses": 11,
            "noContests": 1,
            "wins": 25
          },
          "id": 1858,
          "firstName": "Kai",
          "nickName": "Don't Blink"
        },
        {
          "rank": 5,
          "lastName": "Taira",
          "interimChampion": false,
          "previousRank": 5,
          "record": {
            "draws": 0,
            "losses": 1,
            "noContests": 0,
            "wins": 16
          },
          "id": 3794,
          "firstName": "Tatsuro",
          "nickName": null
        },
        {
          "rank": 6,
          "lastName": "Perez",
          "interimChampion": false,
          "previousRank": 6,
          "record": {
            "draws": 0,
            "losses": 9,
            "noContests": 0,
            "wins": 25
          },
          "id": 926,
          "firstName": "Alex",
          "nickName": null
        },
        {
          "rank": 7,
          "lastName": "Almabayev",
          "interimChampion": false,
          "previousRank": 7,
          "record": {
            "draws": 0,
            "losses": 2,
            "noContests": 0,
            "wins": 21
          },
          "id": 4024,
          "firstName": "Asu",
          "nickName": "Zulfikar"
        },
        {
          "rank": 8,
          "lastName": "Kape",
          "interimChampion": false,
          "previousRank": 8,
          "record": {
            "draws": 0,
            "losses": 7,
            "noContests": 0,
            "wins": 19
          },
          "id": 3432,
          "firstName": "Manel",
          "nickName": "StarBoy"
        },
        {
          "rank": 9,
          "lastName": "Erceg",
          "interimChampion": false,
          "previousRank": 9,
          "record": {
            "draws": 0,
            "losses": 3,
            "noContests": 0,
            "wins": 12
          },
          "id": 3882,
          "firstName": "Steve",
          "nickName": "Astroboy"
        },
        {
          "rank": 10,
          "lastName": "Nicolau",
          "interimChampion": false,
          "previousRank": 10,
          "record": {
            "draws": 1,
            "losses": 6,
            "noContests": 0,
            "wins": 19
          },
          "id": 1972,
          "firstName": "Matheus",
          "nickName": null
        },
        {
          "rank": 11,
          "lastName": "Elliott",
          "interimChampion": false,
          "previousRank": 11,
          "record": {
            "draws": 1,
            "losses": 13,
            "noContests": 0,
            "wins": 21
          },
          "id": 1122,
          "firstName": "Tim",
          "nickName": null
        },
        {
          "rank": 12,
          "lastName": "Ulanbekov",
          "interimChampion": false,
          "previousRank": 12,
          "record": {
            "draws": 0,
            "losses": 2,
            "noContests": 0,
            "wins": 15
          },
          "id": 3437,
          "firstName": "Tagir",
          "nickName": null
        },
        {
          "rank": 13,
          "lastName": "Silva",
          "interimChampion": false,
          "previousRank": 13,
          "record": {
            "draws": 2,
            "losses": 5,
            "noContests": 1,
            "wins": 14
          },
          "id": 3246,
          "firstName": "Bruno",
          "nickName": "Bulldog"
        },
        {
          "rank": 14,
          "lastName": "Durden",
          "interimChampion": false,
          "previousRank": 14,
          "record": {
            "draws": 1,
            "losses": 6,
            "noContests": 0,
            "wins": 17
          },
          "id": 3506,
          "firstName": "Cody",
          "nickName": "Custom Made"
        },
        {
          "rank": 15,
          "lastName": "Johnson",
          "interimChampion": false,
          "previousRank": 15,
          "record": {
            "draws": 0,
            "losses": 6,
            "noContests": 0,
            "wins": 17
          },
          "id": 3801,
          "firstName": "Charles",
          "nickName": "InnerG"
        }
      ],
      "weightClass": {
        "weight": "116-125",
        "description": "Flyweight",
        "id": 19,
        "obsolete": false,
        "abbreviation": "FLW"
      }
    },
    {
      "fighterRankings": [
        {
          "rank": "champion",
          "lastName": "Pereira",
          "interimChampion": false,
          "previousRank": "champion",
          "record": {
            "draws": 0,
            "losses": 2,
            "noContests": 0,
            "wins": 12
          },
          "id": 3524,
          "firstName": "Alex",
          "nickName": "Poatan"
        },
        {
          "rank": 1,
          "lastName": "Ankalaev",
          "interimChampion": false,
          "previousRank": 1,
          "record": {
            "draws": 1,
            "losses": 1,
            "noContests": 1,
            "wins": 20
          },
          "id": 404,
          "firstName": "Magomed",
          "nickName": null
        },
        {
          "rank": 2,
          "lastName": "Prochazka",
          "interimChampion": false,
          "previousRank": 1,
          "record": {
            "draws": 1,
            "losses": 5,
            "noContests": 0,
            "wins": 30
          },
          "id": 3406,
          "firstName": "Jiri",
          "nickName": null
        },
        {
          "rank": 3,
          "lastName": "Hill",
          "interimChampion": false,
          "previousRank": 3,
          "record": {
            "draws": 0,
            "losses": 2,
            "noContests": 1,
            "wins": 12
          },
          "id": 3316,
          "firstName": "Jamahal",
          "nickName": "Sweet Dreams"
        },
        {
          "rank": 4,
          "lastName": "Blachowicz",
          "interimChampion": false,
          "previousRank": 4,
          "record": {
            "draws": 1,
            "losses": 10,
            "noContests": 0,
            "wins": 29
          },
          "id": 1079,
          "firstName": "Jan",
          "nickName": null
        },
        {
          "rank": 5,
          "lastName": "Rakic",
          "interimChampion": false,
          "previousRank": 5,
          "record": {
            "draws": 0,
            "losses": 5,
            "noContests": 0,
            "wins": 14
          },
          "id": 2525,
          "firstName": "Aleksandar",
          "nickName": "Rocket"
        },
        {
          "rank": 6,
          "lastName": "Rountree Jr.",
          "interimChampion": false,
          "previousRank": 7,
          "record": {
            "draws": 0,
            "losses": 6,
            "noContests": 1,
            "wins": 14
          },
          "id": 821,
          "firstName": "Khalil",
          "nickName": null
        },
        {
          "rank": 6,
          "lastName": "Krylov",
          "interimChampion": false,
          "previousRank": 6,
          "record": {
            "draws": 0,
            "losses": 9,
            "noContests": 0,
            "wins": 30
          },
          "id": 1448,
          "firstName": "Nikita",
          "nickName": "The Miner"
        },
        {
          "rank": 8,
          "lastName": "Oezdemir",
          "interimChampion": false,
          "previousRank": 8,
          "record": {
            "draws": 0,
            "losses": 7,
            "noContests": 0,
            "wins": 20
          },
          "id": 2235,
          "firstName": "Volkan",
          "nickName": "No Time"
        },
        {
          "rank": 9,
          "lastName": "Walker",
          "interimChampion": false,
          "previousRank": 9,
          "record": {
            "draws": 0,
            "losses": 9,
            "noContests": 1,
            "wins": 21
          },
          "id": 1415,
          "firstName": "Johnny",
          "nickName": null
        },
        {
          "rank": 10,
          "lastName": "Ulberg",
          "interimChampion": false,
          "previousRank": 10,
          "record": {
            "draws": 0,
            "losses": 1,
            "noContests": 0,
            "wins": 11
          },
          "id": 3580,
          "firstName": "Carlos",
          "nickName": "Black Jag"
        },
        {
          "rank": 11,
          "lastName": "Murzakanov",
          "interimChampion": false,
          "previousRank": 11,
          "record": {
            "draws": 0,
            "losses": 0,
            "noContests": 0,
            "wins": 14
          },
          "id": 1307,
          "firstName": "Azamat",
          "nickName": "The Professional"
        },
        {
          "rank": 12,
          "lastName": "Smith",
          "interimChampion": false,
          "previousRank": 12,
          "record": {
            "draws": 0,
            "losses": 20,
            "noContests": 0,
            "wins": 38
          },
          "id": 681,
          "firstName": "Anthony",
          "nickName": "Lionheart"
        },
        {
          "rank": 12,
          "lastName": "Reyes",
          "interimChampion": false,
          "previousRank": 13,
          "record": {
            "draws": 0,
            "losses": 4,
            "noContests": 0,
            "wins": 13
          },
          "id": 2627,
          "firstName": "Dominick",
          "nickName": "The Devastator"
        },
        {
          "rank": 14,
          "lastName": "Guskov",
          "interimChampion": false,
          "previousRank": 14,
          "record": {
            "draws": 0,
            "losses": 3,
            "noContests": 0,
            "wins": 16
          },
          "id": 4154,
          "firstName": "Bogdan",
          "nickName": "Czarevitch"
        },
        {
          "rank": 15,
          "lastName": "Menifield",
          "interimChampion": false,
          "previousRank": 15,
          "record": {
            "draws": 1,
            "losses": 5,
            "noContests": 0,
            "wins": 15
          },
          "id": 226,
          "firstName": "Alonzo",
          "nickName": "Atomic"
        }
      ],
      "weightClass": {
        "weight": "186-205",
        "description": "Light Heavyweight",
        "id": 4,
        "obsolete": false,
        "abbreviation": "LHW"
      }
    }
  ]
}
```