# Fightcards Endpoint

## Fightcards Endpoint

This endpoint returns information on all fight cards, past and present. This is kept up to date every 5 minutes.

### **Endpoint URLs** <a href="#endpoint-urls" id="endpoint-urls"></a>

**For all tournaments:**

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

**If you want to look at just information for a particular fightcard:**

| `https://dde-api.data.imgarena.com/mma/fightcards/{id}` |
| ------------------------------------------------------- |

​**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 using dateFrom and dateTo parameters together, to return just the fightcards within a certain date range. Both parameters should specify a date in a `YYYY-mm-dd` format.

### **Response Model** <a href="#response-model" id="response-model"></a>

#### **Tournament Object** <a href="#tournament-object" id="tournament-object"></a>

Field NameTypeDescription

|                           |         |                                                                           |
| ------------------------- | ------- | ------------------------------------------------------------------------- |
| fightcardName             | string  | the name of the fightcard                                                 |
| identifier                | integer | the identifier of the fightcard                                           |
| countryCode               | string  | the country code of the country where the fightcard is taking place       |
| location                  | string  | the country in which the fightcard is taking place                        |
| state                     | string  | the state/province in which the fightcard is taking place Null if uknown  |
| city                      | string  | The city in which the fightcard is taking place                           |
| venue                     | string  | The name of the venue where the fightcard is taking place                 |
| venueId                   | integer | The ID of the venue where the fightcard is taking place                   |
| startDate                 | date    | The start date for the fightcard                                          |
| endDate                   | date    | the end date for the fightcard                                            |
| startTime                 | time    | the time in which the fightcard starts, in local time + UTC offset format |
| utcOffset                 | integer | the UTC offset of the timezone in which the fightcard is taking place     |
| year                      | integer | the year in which the fightcard is taking place                           |
| sport                     | string  | the sport associated with the fightcard, in this case MMA                 |
| numberOfFights            | integer | the number of fights on the fightcard                                     |
| scheduleResource          | string  | a reference to the API URL for the schedule of this fightcard             |
| status                    | string  | the status of this fightcard.Potential values are: active / canceled.     |
| booking Status            | object  | information on whether or not a fightcard is booked                       |
| comments                  | array   | the latest comments on the status of the fightcard                        |
| numberOfFightsBookedToday | integer | Number of fights booked on the DDE as per your license agreement          |
| eventSummary              | object  | -                                                                         |
| competitions              | array   | -                                                                         |

#### **Fights Summary Object** <a href="#fights-summary-object" id="fights-summary-object"></a>

The fightcard will contain main card only for PFL and the number of fights.

| Field Name | Type    | Description                                               |
| ---------- | ------- | --------------------------------------------------------- |
| fights     | integer | the number of fights in this particular card of the fight |
| startTime  | time    | the estimated start time of that particular card          |

#### **Booking Status Object** <a href="#booking-status-object" id="booking-status-object"></a>

| **F**ield Name | Type   | Description                                    |
| -------------- | ------ | ---------------------------------------------- |
| status         | string | Current booking status of the event on the DDE |

#### **Competitions Object** <a href="#competitions-object" id="competitions-object"></a>

| Field Name        | Type   | Description                                              |
| ----------------- | ------ | -------------------------------------------------------- |
| organisation      | string | the organisation of the particular fightcard i,e PFL     |
| startDate         | date   | The start date for the fightcard                         |
| endDate           | date   | the end date for the fightcard                           |
| licensingProperty | string | The DDE property that licenses this particular fightcard |

### Sample Response

```

{
    "city": "Warna",
    "numberOfFightsBookedToday": 36,
    "year": 2025,
    "sport": "MMA",
    "venueId": "757",
    "scheduleResource": "/mma/fightcards/2424/schedule",
    "numberOfFights": 36,
    "venue": "ZOL test Venue 1",
    "startTime": "11:00",
    "location": "BG",
    "endDate": "2025-07-05",
    "fightcardName": "pfl-eu-brussels",
    "state": null,
    "identifier": 2424,
    "countryCode": "BG",
    "status": "active",
    "eventsSummary": {},
    "utcOffset": 0,
    "startDate": "2025-07-05",
    "bookingStatus": {
        "status": "AutoBooked"
    },
    "competitions": [
        {
            "organisation": "PFL",
            "startDate": "2025-07-05",
            "endDate": "2025-07-05"
        }
    ],
    "comments": []
}
```