We recommend the following frequency for your REST requests to ensure that you have the most up-to-date information at all times:
Sport
REST Endpoint
Frequency
UFC
dde-api.data.imgarena.com/mma/fightcards
Every 12hours
UFC
https://dde-api.data.imgarena.com/mma/fightcards/{id}/schedule
Every hour for the upcoming fightcard
Please note that only the next 3 or 4 future events will be available via the UFC fightcards endpoint. This is due to UFC still constructing the fights taking place.
You will first need to create a database or gather a list of "fightcards" (a list of events) and the fights associated to the fightcard/event.
Required Headers to use our endpoints:
Key
Value
Accept
application/vnd.imggaming.dde.api+json;version=1
Content-Type
application/json
Authorization
Bearer eyvhaoudfgpdfgo*
In order retrieve a list of "fightcards" or events, please hit the IMG UFC fightcard endpoint:
https://dde-api.data.imgarena.com/mma/fightcards
Note the Key values needed from this endpoint:
Endpoint
Description
Link to Sandbox
fightcardName
the name of the fightcard
-
identifier
the identifier of the fightcard
EventId
If you want to look at just the information for a particular fightcard, you can pass the event ID i.e:
https://dde-api.data.imgarena.com/mma/fightcards/{id}
To return "fightcards" for a given date range, this can be done by passing the dateFrom and dateTo parameters. Both parameters should specify a date in a YYYY-mm-dd format.
In addition you will need to get a list of fights associated to the fightcard/event, this can be done by passing the EventId for a fightcard via the IMG Arena UFC "Schedule" endpoint.
https://dde-api.data.imgarena.com/mma/fightcards/{id}/schedule
Note the Key values needed from endpoint:
Endpoint
Description
Link to sandbox
redTeam
An object containing information on the fighter of the red team
-
blueTeam
An object containing information on the fighter of the blue team
-
fightId
The ID number of the fight
fightId
This endpoint returns information on all fight cards, past and present.
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.
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
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
-
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
Field Name
Type
Description
status
string
Current booking status of the event on the DDE
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
This endpoint returns information on the schedule of a particular fightcard.
This endpoint returns information on the schedule of a particular fightcard. Information returned includes: Detailed information on the fighters of each team, Estimated start time, Fighter Records & Weight class.
https://dde-api.data.imgarena.com/mma/fightcards/{id}/schedule
Key
Value
Accept
application/vnd.imggaming.dde.api+json;version=1
Content-Type
application/json
Authorization
Bearer eyvhaoudfgpdfgo*
This endpoint takes no parameters
Field Name
Type
Description
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
weightClass
object
An object containing information on the weight class
referee
object
Contains ID, First and last name of the referee for the fight.
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 1
fightcardId
integer
the ID of the fightcard in which the fight is in
accolades
object
An object containing information on the belt & the name of the belt title
fightSeq
integer
The fight sequence on the overall fightcard. 1 if first, 2 if second etc.
redTeam
object
An object containing information on the fighter of the red team
Date
string
the date of the fight
blueTeam
object
An object containing information on the fighter of the blue team
status
string
the status of the fight. Possible values; “Not Started”, “In Progress” or “Finished”
cardSegment
string
The segment of the card that this fight belongs to. Options; main, prelims1, prelims2
fightId
string
The ID number of the fight
fightType
object
Contains information on the type of fight, total number of possible rounds
bookingStatus
object
information on whether or not a fight is booked
Field Name
Type
Description
status
string
Status of the current start time e.g. "EstimatedStart"
time
string
The start time of the fight + UTC offset format
Field Name
Type
Description
weight
string
the weight range, in lb, of the weightclass
description
string
description of the weightclass
id
integer
ID of the weightclass
obsolete
Boolean
Details whether the weightclass is still active within the organisation
abbreviation
string
abbreviated description of the weightclass
Field Name
Type
Description
id
integer
the ID of the referee
firstName
string
the first name of the referee
lastName
string
the last name of the referee
Field Name
Type
Description
belt
string
the type of belt
name
string
the title of the belt
Field Name
Type
Description
fighter1
object
detailed information on the fighter under the red team
rank
string
the fighters current rank. (may appear null if the fighter is not ranked)
accolades
object
-
Field Name
Type
Description
reach
decimal
the reach, in inches, of the fighter. Will be null if unknown.
dob
date
the date of birth of the fighter
fightsOutOf
string
the city, state, country, country code of where the fighter currently fights out of
height
integer
the height, in inches, of the fighter. Will be null if unknown.
country
string
country code of the fighter
age
integer
the age of the fighter
weighInWeight
float
the weigh in weight, in lb, of the fighter. Will be null if unknown.
lastName
string
the last name of the fighter
stance
string
the stance of the fighter. Possible values; Orthodox, Southpaw, Switch, Open. Will be null if unknown.
firstName
string
the first name of the fighter
nickName
string
the nickname of the fighter
id
integer
the id of the fighter
born
string
the city, state, country, country code of where the fighter was born
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.
Field Name
Type
Description
wins
integer
the amount of professional wins a fighter has
losses
integer
the amount of professional losses a fighter has
draws
integer
the amount of professional draws a fighter has
noContest
integer
the number of professional contests the fighter has participated in
Field Name
Type
Description
fighter1
object
detailed information on the fighter under the blue team
rank
string
the fighters current rank. (may appear null if the fighter is not ranked)
accolades
object
appears to be null- even for champions
Field Name
Type
Description
possibleRounds
integer
the number of possible rounds
description
string
description on the number of rounds
Field Name
Type
Description
status
string
-