MMA API Documentation
This is the documentation for our MMA API. To get a more comprehensive understanding of what feeds we have to offer and the data points we deliver via our endpoints, we encourage you to explore the following resources:
All of our API endpoints can be accessed via an HTTP GET request using your API key.
The API key can be passed either as a query parameter or using the following HTTP request header.
Ocp-Apim-Subscription-Key: {key}
Competition Feeds
Teams, Players & Rosters
Available Endpoints
Subfeed
Teams, Players & Rosters
Returns fighter with biographical information such as birthdate, height, weight, reach, wins, losses, draws, knockouts, submissions, and more.
Fighter Profiles (Basic) - All
Returns fighter with biographical information such as birthdate, height, weight, reach, wins, losses, draws, knockouts, submissions, and more.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
Utility Endpoints
Available Endpoints
Subfeed
GET
Betting Metadata
Utility Endpoints
Returns the list of MarketTypes, BetTypes, PeriodTypes, OutcomeTypes, and ResultTypes to map the IDs to descriptive names. Also includes a list of the MarketType, BetType & PeriodType combinations which we will have resulting for.
Utility Endpoints
Returns a list of all available sportsbooks with their associated unique IDs.
Betting Metadata
Returns the list of MarketTypes, BetTypes, PeriodTypes, OutcomeTypes, and ResultTypes to map the IDs to descriptive names. Also includes a list of the MarketType, BetType & PeriodType combinations which we will have resulting for.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
BettingEntityMetadataCollection
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
Leagues
Returns a list of all leagues (currently this returns just UFC).
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
Sportsbooks - by Active
Returns a list of all available sportsbooks with their associated unique IDs.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
Event Feeds
Schedules & Game Day Info
Available Endpoints
Subfeed
GET
Event
Schedules & Game Day Info
Returns all fights that will take place within the specified event (fight card).
Event
Returns all fights that will take place within the specified event (fight card).
Endpoint Notes
Call Interval:
1 Minute
Return Type:
EventDetail
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
eventid
string
true
The unique ID of this event.
Examples:
Examples:
51, 52, etc.Schedules
Returns all upcoming events, from which the Fights can be discovered.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
league
string
true
The name of the league.
Examples:
Examples:
UFC, etcseason
string
true
Year of the season.
Examples:
Examples:
2019, 2020, etc.Scores & Game State
Available Endpoints
Subfeed
Final Only (No Game State)
Returns basic fight information, including number of rounds, clock, and related details. Data is available only after the fight concludes.
Live & Final (With Game State)
Returns basic fight information, including number of rounds, clock, and related details, available during and after the fight.
Fight (Basic) [Final]
Returns basic fight information, including number of rounds, clock, and related details. Data is available only after the fight concludes.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
fightid
string
true
The unique ID of this fight.
Examples:
Examples:
1100, etc.Fight (Basic) [Live & Final]
Returns basic fight information, including number of rounds, clock, and related details, available during and after the fight.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
fightid
string
true
The unique ID of this fight.
Examples:
Examples:
1100, etc.Team & Player Stats
Available Endpoints
Subfeed
GET
Fight [Final]
Final Only
Returns round-by-round statistical data for a specified FightId, available after the fight concludes.
Live & Final
Returns round-by-round statistical data for a specified FightId, delivered per round and confirmed after the fight concludes.
Fight [Final]
This is the Final version of this endpoint. For live data, please use Fight [Live & Final].
Returns round-by-round statistical data for a specified FightId, available after the fight concludes.
Endpoint Notes
Call Interval:
10 Seconds
Return Type:
FightDetail
Included Data Tables:
Not Ideal For:
Retrieving round-by-round fight information (Use Fight [Live & Final] instead.)
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
fightid
string
true
The unique ID of this fight.
Examples:
Examples:
1100, etc.Fight [Live & Final]
Returns round-by-round statistical data for a specified FightId, delivered per round and confirmed after the fight concludes.
Endpoint Notes
Call Interval:
10 Seconds
Return Type:
FightDetail
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
fightid
string
true
The unique ID of this fight.
Examples:
Examples:
1100, etc.Player Feeds
Depth Charts, Lineups & Injuries
Available Endpoints
Subfeed
Depth Charts, Lineups & Injuries
Returns all fighters with basic biographical information (birthdate, height, weight, reach, etc.) and career records.
Depth Charts, Lineups & Injuries
Returns all fighters with basic biographical information (birthdate, height, weight, reach, etc.) and career records.
Fighter Profile - By Fighter
Returns all fighters with basic biographical information (birthdate, height, weight, reach, etc.) and career records.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
fighterid
string
true
Each fighter has a unique ID assigned by FantasyData. Fighter IDs can be determined by pulling player related data. Example:
140000098Fighter Profiles - All
Returns all fighters with basic biographical information (birthdate, height, weight, reach, etc.) and career records.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
Betting Feeds
Game Lines
Available Endpoints
Subfeed
GET
Event Fight Odds
Pre-Game Lines
Returns basic fight odds (e.g. moneyline) for all fights in a given event. Only returns the most recently seen odds, not inclusive of line movement.
Pre-Game Lines Plus
Returns basic fight odds (e.g. moneyline) for all fights in a given event. Returns the full line movement for the fights. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
Event Fight Odds
Returns basic fight odds (e.g. moneyline) for all fights in a given event. Only returns the most recently seen odds, not inclusive of line movement.
Endpoint Notes
Call Interval:
30 Seconds
Return Type:
EventOdds
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
eventid
string
true
The unique ID of this event.
Examples:
Examples:
51, 52, etc.Event Fight Odds Line Movement
Returns basic fight odds (e.g. moneyline) for all fights in a given event. Returns the full line movement for the fights. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
Endpoint Notes
Call Interval:
30 Seconds
Return Type:
EventOdds
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
eventid
string
true
The unique ID of this event.
Examples:
Examples:
51, 52, etc.Props
Available Endpoints
Subfeed
Props
Returns a list of current betting events for the specified fight event (e.g., fight card), used to retrieve betting market data via the Betting Markets by Event endpoint. Includes all available market types (e.g., Player Props, Team Props).
Props
Returns a list of all currently scheduled betting events that have associated FightIds.
Props
Returns betting markets prefiltered to Player (Fighter) Props for a specified event. Ideal for applications focused solely on player props. For access to other market types (e.g., Fight Props), use the Betting Markets by Market Type endpoint.
Props
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for a given BettingEventID.
Props
Returns markets and available outcomes for a given event and market type.
NOTE: This is a lighter call than by BettingEventID as it only includes markets tagged with the specific MarketType, a full list of which is available for each sport in its Betting Metadata endpoint.
GET
Betting Market
Props Plus
Returns full line movement for a given BettingMarket.
NOTE: Due to the sheer size of the output and the level of detail, it is intended for historical data purposes and NOT for the most up-to-the-second lines.
Betting Events - by Event
Returns a list of current betting events for the specified fight event (e.g., fight card), used to retrieve betting market data via the Betting Markets by Event endpoint. Includes all available market types (e.g., Player Props, Team Props).
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingEvent[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
eventId
string
true
The top level EventId for the event (i.e. UFC 250). Distinct from the BettingEventId.
Betting Events - Upcoming
Returns a list of all currently scheduled betting events that have associated FightIds.
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingEvent[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
Betting Fighter Props - by Event
Returns betting markets prefiltered to Player (Fighter) Props for a specified event. Ideal for applications focused solely on player props. For access to other market types (e.g., Fight Props), use the Betting Markets by Market Type endpoint.
Endpoint Notes
Call Interval:
Return Type:
BettingMarket[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
include
string
false
- available
- unlisted
This parameter indicates which
Important Note: the default parameter of available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended.
Possible values include:
BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets. Important Note: the default parameter of available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended.
Possible values include:
available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted. unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available. URL Template Parameters
Parameter Name
Type
Required
Value
eventId
string
true
The top level EventId for the event (i.e. UFC 250). Distinct from the BettingEventId.
Betting Markets - by Event
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for a given BettingEventID.
Endpoint Notes
Call Interval:
Return Type:
BettingMarket[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
include
string
false
- available
- unlisted
This parameter indicates which
Important Note: the default parameter of
Possible values include:
BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets. Important Note: the default parameter of
available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended. Possible values include:
available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted. unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available. URL Template Parameters
Parameter Name
Type
Required
Value
bettingEventId
string
true
The BettingEventId for which to pull all betting markets (includes outcomes/bets).
Betting Markets - by Market Type
Returns markets and available outcomes for a given event and market type.
NOTE: This is a lighter call than by BettingEventID as it only includes markets tagged with the specific MarketType, a full list of which is available for each sport in its Betting Metadata endpoint.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
BettingMarket[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET
https://api.sportsdata.io/v3/mma/odds/{format}/BettingMarketsByMarketType/{eventId}/{marketTypeId}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
include
string
false
- available
- unlisted
This parameter indicates which
Important Note: the default parameter of
Possible values include:
BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets. Important Note: the default parameter of
available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended. Possible values include:
available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted. unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available. URL Template Parameters
Parameter Name
Type
Required
Value
eventId
string
true
The top level EventId for the event (i.e. UFC 250). Distinct from the BettingEventId.
marketTypeId
string
true
The BettingMarketTypeId of the desired market types to pull. See BettingMetaData endpoint for all of the types.
Betting Market
Returns full line movement for a given BettingMarket.
NOTE: Due to the sheer size of the output and the level of detail, it is intended for historical data purposes and NOT for the most up-to-the-second lines.
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingMarket
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
marketId
string
true
The BettingMarketId of the desired market for which to pull all outcomes/bets.