# Live Events Endpoint

## **Endpoint URLs**

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

This endpoint returns live fights with the status InProgress, no other statuses allow the fight to be present in the endpoint.

## **Required Headers**

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

## **Request Parameters**

This endpoint takes no parameters

## **Response Model:**

### **Fightcard Schedule Object**

| Field Name    | Type    | Description                                                                                                                                                                                                 |
| ------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| date          | date    | the date of the fight                                                                                                                                                                                       |
| startTime     | object  | an object containing “status” – the status of the start time, e.g. EstimatedStart, and “time”, the estimated start time, in local + UTC offset format                                                       |
| startTimeText | string  | text description of the start time. Note that the start time object contains detailed information about the start and is likely to be more useful than this field. Main values; Starts At, Follows Previous |
| fightOrder    | integer | The fight’s order on the card. Fight number 1 is the main event, 2 is the co-main event and so on, so that the first fight of the night has the highest number. The main event is always                    |
| fightSeq      | integer | The fight sequence on the overall fightcard. 1 if first, 2 if second, etc                                                                                                                                   |
| fightcardId   | integer | the ID of the fightcard in which the fight is in                                                                                                                                                            |
| fightId       | integer | the ID of the fight                                                                                                                                                                                         |
| fightType     | object  | contains information on the type of fight, how many possible rounds there could be                                                                                                                          |
| cardSegment   | string  | the segment of the card that this fight belongs to. Options; main, prelims1, prelims2                                                                                                                       |
| redTeam       | object  | information on the red team                                                                                                                                                                                 |
| blueTeam      | object  | information on the blue team                                                                                                                                                                                |

### **Red/Blue Team Object**

| Field Name    | Type            | Description                                                                                            |
| ------------- | --------------- | ------------------------------------------------------------------------------------------------------ |
| weighInWeight | integer         | the weigh in weight, in lb, of the fighter. Will be null if unknown.                                   |
| reach         | decimal         | the reach, in inches, of the fighter. Will be null if unknown.                                         |
| height        | integer         | the height, in inches, of the fighter. Will be null if unknown.                                        |
| stance        | string          | the stance of the fighter. Possible values; Orthodox, Southpaw, Switch, Open. Will be null if unknown. |
| country       | string          | country code 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                                                                            |
| age           | integer         | the age of the fighter                                                                                 |
| dob           | date            | the date of birth of the fighter                                                                       |
| born          | string          | the city, state, country, country code of where the fighter was born                                   |
| fightsOutOf   | string          | the city, state, country, country code of where the fighter currently fights out of                    |
| fighterId     | Integer         | the ID of figher                                                                                       |
| rank          | integer         | the current rank of the fighter within his weightclass                                                 |
| record        | object          | win/loss/draw/no contest record of the fighter                                                         |
| accolades     | string          | will be null unless a title holder. If not null, will explain what title the fighter holds.            |
| ufcFighterId  | integer or null | the UFC federation id of the fighter                                                                   |
| pflFighterId  | integer or null | the PFL federation id of the fighter                                                                   |

## Sample Response

```
[
    {
        "organisation": "PFL",
        "startTime": {
            "status": "NotKnown"
        },
        "startTimeText": "Follows Previous",
        "fightOrder": 1,
        "fightcardId": 2425,
        "date": "2025-07-31",
        "blueTeam": {
            "fighter1": {
                "reach": null,
                "ufcFighterId": null,
                "fighterId": 6342,
                "dob": "1994-01-17",
                "fightsOutOf": "Russia, RUS",
                "pflFighterId": "850",
                "height": null,
                "age": 31,
                "weighInWeight": null,
                "lastName": "Berkhamov",
                "fightsOutOfCountyCode": "RUS",
                "country": "RUS",
                "stance": null,
                "firstName": "Mukhamed",
                "nickName": "CHERKES",
                "born": "Russia, RUS",
                "record": {
                    "draws": 0,
                    "losses": 4,
                    "noContests": 1,
                    "wins": 17
                }
            },
            "rank": null,
            "accolades": null
        },
        "cardSegment": "main",
        "fightId": 12158,
        "fightType": {
            "description": "3 Rnd (5-5-5)",
            "possibleRounds": 3
        },
        "fightSeq": 3,
        "redTeam": {
            "fighter1": {
                "reach": null,
                "ufcFighterId": null,
                "fighterId": 6343,
                "dob": "1991-01-03",
                "fightsOutOf": "USA, USA",
                "pflFighterId": "495",
                "height": null,
                "age": 34,
                "weighInWeight": null,
                "lastName": "St. Louis",
                "fightsOutOfCountyCode": "USA",
                "country": null,
                "stance": null,
                "firstName": "Kendly",
                "nickName": "THE HIGHLANDER",
                "born": null,
                "record": {
                    "draws": 0,
                    "losses": 5,
                    "noContests": 0,
                    "wins": 11
                }
            },
            "rank": null,
            "accolades": null
        }
    }
]

```