# 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.data.imgarena.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 | | org="ufc" | Filter out results based on the organisation, can pass org = "ufc" | 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 | | fightScoringComplete | boolean | provides confirmation on whether the fight has been marked as official | | 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 | | organisation | string | the organisation the fight is associated to, i,e UFC | ### 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 | | fighterId | integer | The ID of the fighter | ## Sample Responses **1 – TKO** ``` { "organisation": "UFC", "result": { "winner": "red", "method": "doctorstoppedtko", "methodDetails": { "endingTargetDetails": null, "endingPosition": null, "submissionDetails": null, "endingTime": "05:00", "fightScores": { "winnerScores": [], "loserScores": [] }, "endingRound": 2, "endingStrikeDetails": null } }, "fightScoringComplete": true, "fightcardId": 893, "redTeam": { "fighter1": { "firstName": "Renato", "lastName": "Moicano", "fighterId": 2260 } }, "date": "2024-09-28", "blueTeam": { "fighter1": { "firstName": "Benoit", "lastName": "Saint Denis", "fighterId": 3760 } }, "fightId": 8926 } ``` **2 – Decision** ``` { "organisation": "UFC", "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 } }, "fightScoringComplete": true, "fightcardId": 899, "redTeam": { "fighter1": { "firstName": "Magomed", "lastName": "Ankalaev", "fighterId": 404 } }, "date": "2024-10-26", "blueTeam": { "fighter1": { "firstName": "Aleksandar", "lastName": "Rakic", "fighterId: 2525 } }, "fightId": 8906 } ``` **3 - Submission** ``` { "organisation": "UFC", "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 } }, "fightScoringComplete": true, "fightcardId": 903, "redTeam": { "fighter1": { "firstName": "Joselyne", "lastName": "Edwards", "fighterId": 3606 } }, "date": "2024-10-19", "blueTeam": { "fighter1": { "firstName": "Tamires", "lastName": "Vidal", "fighterId": 3937 } }, "fightId": 8991 } ```