Fightcards Endpoint

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

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	Filter the tournaments by date. Only tournaments which have events on or after the specified date will be included. E.g. dateFrom=2024-06-01
dateTo	date	Filter the tournaments by date. Only tournaments which have events on or before the specified date will be included. E.g. dateTo=2024-06-30

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

Field 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": []
  }
]