get https://api.sportradar.com/mma//v2//competitors//versus//summaries.
Provides previous and upcoming fights between two competitors, including results and statistics.
Update Frequency
60s Time To Live / Cache
Data Points
Category & Sport:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | sport_event_context - category | String | Unique category ID for a sport event ex. sr:category:1089 (UFC) |
name | sport_event_context - category | String | Name for a sport event's category ex. UFC |
id | sport_event_context - sport | String | Unique sport ID for a sport event ex. sr:sport:117 |
name | sport_event_context - sport | String | Name for a sport event's sport ex. MMA |
Competition:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | sport_event_context - competition | String | Unique ID for a competition ex. sr:competition:29810 (UFC Fight Night - Mexico City) |
name | sport_event_context - competition | String | Name of a competition ex. UFC Fight Night - Mexico City or UFC 255 - Figueiredo vs. Perez |
parent_id | sport_event_context - competition | String | Unique parent ID for a competition ex. sr:competition:25325 is used to group all UFC competitions |
Event/Season:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
competition_id | sport_event_context - season | String | Unique ID for the competition an event/season belongs to ex. sr:competition:44157 (UFC 308: Topuria vs. Holloway) |
disabled | sport_event_context - season | Boolean | Signifies an event/season has been disabled when true |
end_date | sport_event_context - season | Date | End date of an event/season ex. 2024-10-27 |
id | season | String | Unique ID for an event/season ex. sr:season:123813 (UFC 308: Topuria vs. Holloway 2024) |
name | sport_event_context - season | String | Name of an event/season ex. UFC 308: Topuria vs. Holloway 2024 |
start_date | sport_event_context - season | Date | Start date of an event/season ex. 2024-10-26 |
year | sport_event_context - season | String | Year of an event/season ex. 24/25 or 2024 |
Stage:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
type | sport_event_context - stage | String | Type of fight within an event ex. Main Card |
Competitor:
Competitor info is available at the top of each file and for each individual match.
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
abbreviation | competitors - competitor | String | Abbreviation for a competitor name ex. Ullern |
gender | competitors - competitor | String | Gender of a competitor ex. male, female |
id | competitors - competitor | String | Unique ID for a competitor ex. sr:competitor:237652 |
name | competitors - competitor | String | Name for a competitor ex. Holloway, Max |
qualifier | competitors - competitor | String | Designation of a competitor for a matchhome, away |
virtual | competitors - competitor | Boolean | Signifies a competitor is virtual when true. Used for placeholder players/teams in TBD vs TBD matchups. |
Coverage Properties:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
type | sport_event - coverage | String | Type of coveragesport_event |
live | sport_event - coverage - sport_event_properties | Boolean | Signifies an event is covered live when true |
data_complete | sport_event - coverage - sport_event_properties | Boolean | Signifies data collection is complete for an event when true |
Sport Event:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | sport_event | String | Unique ID of a match ex. sr:sport_event:52161571 |
replaced_by | sport_event | String | An alternative sport event ID if the match is postponed and played at a later date ex. sr:sport_event:51847153 |
resume_time | sport_event | Date | An updated timestamp if there is a delay at the start or interruption during a match ex. 2024-03-26T20:00:00+00:00 |
start_time | sport_event | Date | Start time of a match ex. 2024-03-26T20:00:00+00:00 |
start_time_confirmed | sport_event | Boolean | Signifies the start time of a match is confirmed when true |
Sport Event Status:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
final_round | sport_event_status | Integer | Number of the final round of a fight |
final_round_length | sport_event_status | String | Length of the final round of a fight, in minutes and seconds ex. 1:34 |
main_event | sport_event_status | Boolean | Signifies a fight is the main event when true |
match_status | sport_event_status | String | Status within a match (sport event). May provide more detail on the state of a match when live than statusex. not_started, start_delayed, started, endedSee our FAQ for a complete list of statuses. |
method | sport_event_status | String | Method of a match result ex. ko_tko, submission, decision_split, disqualifiedSee our FAQ for a complete list of end methods. |
scheduled_length | sport_event_status | Integer | Scheduled number of rounds of a fight |
scout_abandoned | sport_event_status | Boolean | Signifies a match was abandoned by a scout when true |
status | sport_event_status | String | Status of a fight ex. not_started, live, ended, closedSee our FAQ for a complete list of statuses and their definitions. |
title_fight | sport_event_status | Boolean | Signifies a fight is the title fight when true |
weight_class | sport_event_status | String | Weight class of a fight ex. flyweight, middleweight, womens_bantamweight, heavyweightSee our FAQ for a complete list of weight classes |
winner | sport_event_status | String | Winner of a fighthome_team, away_team, draw, no_contest |
winner_id | sport_event_status | String | Unique ID of the match winner ex. sr:competitor:750503 |
Sport Event - Channel:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
country | sport_event - channels - channel | String | Country of a broadcast channel ex. Great Britain |
country_code | sport_event - channels - channel | String | Country code of a broadcast channel ex. GBR |
name | sport_event - channels - channel | String | Name of a broadcast channel ex. PPV, TNT Sports 2 - Eurobird 1 |
url | sport_event - channels - channel | String | URL of a broadcast |
Match Stats (Competitor):
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
control | totals - competitor - statistics | String | Control time for a competitor in a match ex. 00:45 |
knockdowns | totals - competitor - statistics | Integer | Number of knockdowns for a competitor in a match |
significant_strike_percentage | totals - competitor - statistics | Float | Significant strike percentage for a competitor in a match ex. 38.73 |
significant_strikes | totals - competitor - statistics | Integer | Number of significant strikes for a competitor in a match |
significant_strikes_attempted | totals - competitor - statistics | Integer | Number of significant strike attempts for a competitor in a match |
submission_attempts | totals - competitor - statistics | Integer | Number of submission attempts for a competitor in a match |
takedown_percentage | totals - competitor - statistics | Float | Significant strike percentage for a competitor in a match ex. 38.73 |
takedowns | totals - competitor - statistics | Integer | Number of takedowns for a competitor in a match |
takedowns_attempted | totals - competitor - statistics | Integer | Number of takedown attempts for a competitor in a match |
total_strike_percentage | totals - competitor - statistics | Float | Total strike percentage for a competitor in a match ex. 40.19 |
total_strikes | totals - competitor - statistics | Integer | Number of total strikes for a competitor in a match |
total_strikes_attempted | totals - competitor - statistics | Integer | Number of total strikes attempts for a competitor in a match |
Round Stats (Competitor):
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
number | summary - statistics - period | Integer | Round number of a match |
control | periods - competitor - statistics | String | Control time for a competitor in a round ex. 00:45 |
knockdowns | periods - competitor - statistics | Integer | Number of knockdowns for a competitor in a round |
significant_strike_percentage | periods - competitor - statistics | Float | Significant strike percentage for a competitor in a round ex. 38.73 |
significant_strikes | periods - competitor - statistics | Integer | Number of significant strikes for a competitor in a round |
significant_strikes_attempted | periods - competitor - statistics | Integer | Number of significant strike attempts for a competitor in a round |
submission_attempts | periods - competitor - statistics | Integer | Number of submission attempts for a competitor in a round |
takedown_percentage | periods - competitor - statistics | Float | Significant strike percentage for a competitor in a round ex. 38.73 |
takedowns | periods - competitor - statistics | Integer | Number of takedowns for a competitor in a round |
takedowns_attempted | periods - competitor - statistics | Integer | Number of takedown attempts for a competitor in a round |
total_strike_percentage | periods - competitor - statistics | Float | Total strike percentage for a competitor in a round ex. 40.19 |
total_strikes | periods - competitor - statistics | Integer | Number of total strikes for a competitor in a round |
total_strikes_attempted | periods - competitor - statistics | Integer | Number of total strikes attempts for a competitor in a round |
Venue:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
capacity | venue | Integer | Capacity of a venue ex. 17367 |
city_name | venue | String | City name of a venue ex. Paradise |
country_code | venue | String | Country code of a venue ex. USA |
country_name | venue | String | Country name of a venue ex. USA |
id | venue | String | Unique ID of a venue ex. sr:venue:20621 |
map_coordinates | venue | String | Coordinates of a venue ex. 36.102778, -115.178333 |
name | venue | String | Name of a venue ex. T-Mobile Arena |
state | venue | String | State of a venue ex. NV (Nevada) |
timezone | venue | String | Timezone of a venue ex. America/Los_Angeles |