# Fightcards Endpoint

## **Endpoint URLs**

**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 takes the following parameters:**

| **Parameter** | Type   | Purpose                                                                                                                                                             |
| ------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| org           | string | Filter out results based on the organisation, can pass org = "ufc"                                                                                                  |
| dateFrom      | date   | <p>Filter the tournaments by date. Only tournaments which have events on or after the specified date will be included.<br>E.g. <code>dateFrom=2024-06-01</code></p> |
| dateTo        | date   | <p>Filter the tournaments by date. Only tournaments which have events on or before the specified date will be included.<br>E.g. <code>dateTo=2024-06-30</code></p>  |

## **Response Model**

### **Tournament Object**

| Field Name                | Type           | Description                                                                         |
| ------------------------- | -------------- | ----------------------------------------------------------------------------------- |
| 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                           |
| 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                             |
| externalAssociationId     | string or null | The external federation id                                                          |
| 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         | <p>the status of this fightcard.</p><p>Potential values are: active / canceled.</p> |
| 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         | Summary of preliminary and main cards i.e. start and number of fights               |
| attendance                | integer        | Total fans in attendance                                                            |
| competitions              | array          | -                                                                                   |

### **Fights Summary Object**

Each fightcard will be broken into three cards; main, prelims1 and prelims 2. This object, will indicate the date of the fightcard, and the three cards.

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

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

### **Competitions Object**

| Field Name        | Type   | Description                                              |
| ----------------- | ------ | -------------------------------------------------------- |
| organisation      | string | the organisation of the particular fightcard             |
| 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": "Edmonton",
    "numberOfFightsBookedToday": 15,
    "year": 2024,
    "sport": "MMA",
    "venueId": "138",
    "scheduleResource": "/mma/fightcards/900/schedule",
    "numberOfFights": 15,
    "venue": "Rogers Place",
    "startTime": "21:00",
    "location": "CAN",
    "endDate": "2024-11-02",
    "fightcardName": "UFC Fight Night: Moreno vs. Albazi",
    "state": "Alberta",
    "identifier": 900,
    "countryCode": "CAN",
    "status": "active",
    "eventsSummary": {
      "2024-11-02": {
        "prelims1": {
          "fights": 8,
          "startTime": "21:00"
        },
        "main": {
          "fights": 7,
          "startTime": "00:00"
        }
      }
    },
    "utcOffset": 0,
    "startDate": "2024-11-02",
    "bookingStatus": {
      "status": "AutoBooked"
    },
    "competitions": [
      {
        "organisation": "UFC",
        "startDate": "2024-11-02",
        "endDate": "2024-11-02"
      }
    ],
    "comments": []
  },
  {
    "city": "Abu Dhabi",
    "numberOfFightsBookedToday": 18,
    "year": 2024,
    "sport": "MMA",
    "venueId": "295",
    "scheduleResource": "/mma/fightcards/899/schedule",
    "numberOfFights": 18,
    "venue": "Etihad Arena",
    "externalAssociationId": "ufc-eu-brussels123",
    "startTime": "14:00",
    "location": "UAE",
    "endDate": "2024-10-26",
    "fightcardName": "UFC 308: Topuria vs. Holloway",
    "state": "Abu Dhabi",
    "identifier": 899,
    "countryCode": "UAE",
    "status": "active",
    "eventsSummary": {
      "2024-10-26": {
        "prelims1": {
          "fights": 11,
          "startTime": "14:00"
        },
        "main": {
          "fights": 6,
          "startTime": "18:00"
        }
      }
    },
    "utcOffset": 0,
    "startDate": "2024-10-26",
    "bookingStatus": {
      "status": "AutoBooked"
    },
    "competitions": [
      {
        "organisation": "UFC",
        "startDate": "2024-10-26",
        "endDate": "2024-10-26"
      }
    ],
    "comments": []
  }
]
```