Skip to content
SportsDataAPI Real-time sports data

MMA API Documentation

v1.4.7 12 endpoints
https://v1.mma.sportsdataapi.com

Timezone

1 endpoint
GET /timezone timezone
Returns the list of timezone set that can be used in the endpoints fights, fights/statistics, fights/statistics/fighters and odds.

Parameters: This endpoint does not require any parameters.
GET https://v1.mma.sportsdataapi.com/timezone

This endpoint does not require any query parameters.

Seasons

1 endpoint
GET /seasons seasons
Return the list of all available seasons.

All seasons are only 4-digit keys.

All seasons can be used in other endpoints as parameter.

Parameters: This endpoint does not require any parameters.
GET https://v1.mma.sportsdataapi.com/seasons

This endpoint does not require any query parameters.

Categories

1 endpoint
GET /categories categories
Return the list of all available categories.

Categories can be used as parameters in endpoint fights and fighters.

Parameters: You can call this endpoint without any parameters to get the complete list.
GET https://v1.mma.sportsdataapi.com/categories

Query Parameters

Name Type Required Description
search string The name of the category

Teams

1 endpoint
GET /teams teams
Return the list of available teams.

The team id are unique in the API.

Parameters: You can call this endpoint without any parameters to get the complete list.
GET https://v1.mma.sportsdataapi.com/teams

Query Parameters

Name Type Required Description
id integer The id of the team
search string The name of the team

Fighters

2 endpoints
GET /fighters fighters
Return a set of data about the fighters.

The fighter id are unique in the API and keep it among all the competitions/fights in which they participate.

You can use fighter id in other endpoint like fights, fights/statistics/fighters as parameter.

Parameters: This endpoint requires at least one of theses parameters : id, team, name, category, search.

This endpoint is updated every day
GET https://v1.mma.sportsdataapi.com/fighters

Query Parameters

Name Type Required Description
id integer The id of the fighter
team integer The id of the team
name string The name of the fighter
category string The category of the fighter
search string The name of the fighter
GET /fighters/records records
Return the fighter's career statistics.

Parameters: This endpoint requires at least one parameter.

This endpoint is updated every day
GET https://v1.mma.sportsdataapi.com/fighters/records

Query Parameters

Name Type Required Description
id integer The id of the fighter

Fights

3 endpoints
GET /fights fights
Return the list of fights according to the given parameters.

For all requests to games you can add the query parameter timezone to your request in order to retrieve the list of fights in the timezone of your choice like *“Europe/London“*. In case the timezone is not recognized, empty or is not part of the endpoint timezone list, the UTC value will be applied by default

To know the list of available timezones you have to use the endpoint timezone.

Available Status

* NS : Not Started * IN : Intros * PF : Pre-fight * LIVE : In Progress * EOR : End of Round * FT : Finished * WO : Walkouts * CANC : Cancelled (Fight cancelled and not rescheduled) * PST : Postponed (Fight postponed and waiting for a new Fight date)

Parameters: This endpoint requires at least one of these parameters : id, date, season, fighter.

Fights are updated every 30 seconds
GET https://v1.mma.sportsdataapi.com/fights

Query Parameters

Name Type Required Description
id integer The id of the fight
date string A valid date
season integer A valid season
fighter integer The id of the fighter
category string The name of the category
timezone string A valid timezone
GET /fights/results/ results
Return the results from one or several fights.

Parameters: This endpoint requires at least one of theses parameters : id, ids, date.

This endpoint is updated every 30 seconds
GET https://v1.mma.sportsdataapi.com/fights/results/

Query Parameters

Name Type Required Description
id integer The id of the fight
ids string One or more fights ids
id-id-id
date string A valid date
GET /fights/statistics/fighters fighters statistics
Return fighters statistics from one or several fights.

Parameters: This endpoint requires at least one of theses parameters : id, ids, date, fighter.

This endpoint is updated every 30 seconds
GET https://v1.mma.sportsdataapi.com/fights/statistics/fighters

Query Parameters

Name Type Required Description
id integer The id of the fight
ids string One or more fights ids
id-id-id
date string A valid date

Odds

3 endpoints
GET /odds odds
Return the list of available odds for fights.

We provide pre-match odds between 1 and 7 days before the fight.

We keep a 7-day history *(The availability of odds may vary according to the fights, seasons and bookmakers)*

Parameters: This endpoint requires at least one of theses parameters : fight, date.

Odds are updated four times a day
GET https://v1.mma.sportsdataapi.com/odds

Query Parameters

Name Type Required Description
fight integer The id of the fight
date string A valid date
bookmaker integer The id of the bookmaker
bet integer The id of the bet
GET /odds/bets bets
Return the list of available bets for odds.

All bets id can be used in endpoint odds as filters

Parameters: You can call this endpoint without any parameters to get the complete list.
GET https://v1.mma.sportsdataapi.com/odds/bets

Query Parameters

Name Type Required Description
id integer The id of the bet
search string The name of the bet
GET /odds/bookmakers bookmakers
Return the list of available bookmakers for odds.

All bookmakers id can be used in endpoint odds as filters.

Parameters: You can call this endpoint without any parameters to get the complete list.
GET https://v1.mma.sportsdataapi.com/odds/bookmakers

Query Parameters

Name Type Required Description
id integer The id of the bookmaker
search string The name of the bookmaker

Quick Reference

Base URL

https://v1.mma.sportsdataapi.com

Authentication

x-apisports-key: YOUR_API_KEY
cURL
curl -X GET "https://v1.mma.sportsdataapi.com/timezone" \
  -H "x-apisports-key: YOUR_API_KEY"

Start free. Scale when ready.

Get 100 free mma API requests per day. No credit card required.

Upgrade to PRO for full real-time data, live odds, and unlimited historical access.

Already have an account?