Results Endpoint

This endpoint returns resulting information on all MMA fights. This is the only endpoint that should be used to settle markets and to announce the official winner of any MMA fight.

The frequency at which this endpoint is updated is configurable at launch and is polled every 10 seconds.

Endpoint URLs

https://dde-api.imggaming.com/mma/results

Required Headers

Key

Value

Accept

application/vnd.imggaming.dde.api+json;version=1

Content-Type

application/json

Authorization

Bearer eyvhaoudfgpdfgo*

Request Parameters

Parameter

Description

fight={fightId}

Condensed results for one specific fight

fightcard={fightcardId}

Condensed results for every fight within a fight card

This endpoint takes one parameter at a time.

If no parameter is provided, then this returns results for all fights from the 5 most recent fight cards.

Response Model:

Results Object

Field Name

Type

Description

result

object

Detailed information on the result of the fight

scoringComplete

boolean

Provides confirmation on whether scoring for the fight has been completed

fightcardId

integer

The ID of the Fightcard on which the fight took place

redTeam

object

Basic information on the fighters in the fight

date

string

The date of the fight

blueTeam

object

Basic information on the fighters in the fight

fightId

integer

The ID of the Fight

Result Object

Field Name

Type

Description

winner

string

The corner that won the fight (if applicable)

method

string

The method of the result. Possible values; unanimousdecision, splitdecision, majoritydecision, disqualification, ko, doctorstoppedtko, overturned, couldnotcontinue, submission.

methodDetails

object

Depending on the method returned, further method information will be returned within this object

Method Details Object

Field Name

Type

Description

endingTargetDetails

string

If method is KO/TKO, info returned in this field. Null if not. Possible values; Head, Body, Leg

endingPosition

string

If method is KO/TKO or Submission, info returned in this field. Null if not. Possible values; At Distance, In Clinch, On Ground, From Guard, From Half Guard, From Side Control, From Mount, From Back Control, From Bottom Guard, From Bottom Half Guard, From Bottom Side Control, From Bottom Mount, From Bottom Back Control, From North South, From Front Headlock, From Whizzer, After Drop to Guard, After Drop to Half Guard, After Drop to Ground, From Inoki-Ali Position, From Bottom, From Crucifix, Flying Armbar, From Scissor Takedown, Flying Triangle, Standing, Standing Back Control

endingTime

string

The time in the ending round in which the fight was stopped

fightScores

object

If method contains “decision”, this object will contain the scores of the judges for both teams.

submissionDetails

string

If Method is submission, info returned in this field. Null if not. Possible values; Armbar, Kimura, Keylock, Kneebar, Ankle Lock, Heel Hook, Toe Hold, Omoplata, Neck Crank, Other – Lock, Rear Naked Choke, Triangle Choke, Guillotine Choke, Arm Triangle, Anaconda Choke, Peruvian Necktie, D’Arce Choke, Gi Choke, Gogo Plata, Other – Choke, Strikes, Injury, Other, North-South Choke, Hammerlock, Forearm Choke

endingRound

integer

The round in which the fight ended

endingStrikeDetails

string

If Method is KO/TKO or Submission (from strikes), info returned in this field. Null if not. Possible values; Punch, Punches, Elbow, Elbows, Knee, Knees, Kick, Kicks, Stomp, Stomps, Headbutt, Headbutts, Spinning Back Fist, Spinning Back Kick, Flying Knee, Slam

Fight Score Object

Field Name

Type

Description

winnerScores

array

detailed information provided on the fight score of the winner

loserScores

array

detailed information provided on the fight score of the loser

Red Team / Blue Team Object

Field Name

Type

Description

fighter1

object

Information on fighter 1 within this team (In all UFC fights this is 1:1)

Fighter1 Object

Field Name

Type

Description

lastName

string

The last name of the fighter

firstName

string

The first name of the fighter

id

integer

The ID of the fighter

Sample Responses

1 – TKO

{
  "result": {
    "winner": "red",
    "method": "doctorstoppedtko",
    "methodDetails": {
      "endingTargetDetails": null,
      "endingPosition": null,
      "submissionDetails": null,
      "endingTime": "05:00",
      "fightScores": {
        "winnerScores": [],
        "loserScores": []
      },
      "endingRound": 2,
      "endingStrikeDetails": null
    }
  },
  "scoringComplete": true,
  "fightcardId": 893,
  "redTeam": {
    "fighter1": {
      "firstName": "Renato",
      "lastName": "Moicano",
      "id": 2260
    }
  },
  "date": "2024-09-28",
  "blueTeam": {
    "fighter1": {
      "firstName": "Benoit",
      "lastName": "Saint Denis",
      "id": 3760
    }
  },
  "fightId": 8926
}

2 – Decision

{
  "result": {
    "winner": "red",
    "method": "unanimousdecision",
    "methodDetails": {
      "endingTargetDetails": null,
      "endingPosition": null,
      "submissionDetails": null,
      "endingTime": "05:00",
      "fightScores": {
        "winnerScores": [
          {
            "judgeFirstName": "Tony",
            "judgeLastName": "Weeks",
            "score": 29
          },
          {
            "judgeFirstName": "Sal",
            "judgeLastName": "D'amato",
            "score": 29
          },
          {
            "judgeFirstName": "Jacob",
            "judgeLastName": "Montalvo",
            "score": 29
          }
        ],
        "loserScores": [
          {
            "judgeFirstName": "Tony",
            "judgeLastName": "Weeks",
            "score": 28
          },
          {
            "judgeFirstName": "Sal",
            "judgeLastName": "D'amato",
            "score": 28
          },
          {
            "judgeFirstName": "Jacob",
            "judgeLastName": "Montalvo",
            "score": 28
          }
        ]
      },
      "endingRound": 3,
      "endingStrikeDetails": null
    }
  },
  "scoringComplete": true,
  "fightcardId": 899,
  "redTeam": {
    "fighter1": {
      "firstName": "Magomed",
      "lastName": "Ankalaev",
      "id": 404
    }
  },
  "date": "2024-10-26",
  "blueTeam": {
    "fighter1": {
      "firstName": "Aleksandar",
      "lastName": "Rakic",
      "id": 2525
    }
  },
  "fightId": 8906
}

3 - Submission

{
  "result": {
    "winner": "red",
    "method": "submission",
    "methodDetails": {
      "endingTargetDetails": null,
      "endingPosition": "from back control",
      "submissionDetails": "rear naked choke",
      "endingTime": "04:33",
      "fightScores": {
        "winnerScores": [],
        "loserScores": []
      },
      "endingRound": 3,
      "endingStrikeDetails": null
    }
  },
  "scoringComplete": true,
  "fightcardId": 903,
  "redTeam": {
    "fighter1": {
      "firstName": "Joselyne",
      "lastName": "Edwards",
      "id": 3606
    }
  },
  "date": "2024-10-19",
  "blueTeam": {
    "fighter1": {
      "firstName": "Tamires",
      "lastName": "Vidal",
      "id": 3937
    }
  },
  "fightId": 8991
}

Last updated