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
Parameters: This endpoint does not require any parameters.
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
Parameters: This endpoint does not require any parameters.
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
Parameters: You can call this endpoint without any parameters to get the complete list.
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
Parameters: You can call this endpoint without any parameters to get the complete list.
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
You can use fighter
Parameters: This endpoint requires at least one of theses parameters : id, team, name, category, search.
This endpoint is updated every day
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
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
To know the list of available timezones you have to use the endpoint
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
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 defaultTo 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
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
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
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
Parameters: You can call this endpoint without any parameters to get the complete list.
All bets
id can be used in endpoint odds as filtersParameters: 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
Parameters: You can call this endpoint without any parameters to get the complete list.
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.