Boxing Data API - Explore details about past and upcoming fights

Fights are the individual bouts contested by boxers. Every fight has 2 boxers, a division_id and if any belts are on the line, an array of title_ids.

Understanding the fight data

Fight status

Upcoming fights that are happening in the future will have status = NOT_STARTED, while fights that are happening today will have status = LIVE and past fights will have status = FINISHED.

Who won the fight?

Once a fight has finished we will update the final results, scores and identify the winner with winner = true in the fighters details.

What was the result?

Details of the final result are in the results key which will contain the outcome and the round the fight ended.

"results": {
      "outcome": "UD",
      "round": "12"
}

Possible outcome values can include:

"UD": Unanimous decision
"MD": Majority decision
"SD": Split decision
"TKO": Technical knockout
"KO": Knockout
"PTS": Points

What was the score?

If the judges scorecard was used, e.g. in results that are not knockouts, the scores will be in the scores key.

"scores": [
  "116-109",
  "117-108",
  "116-109"
]

Exploring the Fights Endpoint

The Fights endpoint enables you to build detailed fight schedules, live score boards and post fight analsys. There are two primary functionalities offered by this endpoint:

1. Search and filter many Fights:

• Endpoint URL: https://boxing-data-api.p.rapidapi.com/v1/fights/
• Description: This request retrieves a list of fights according to any filters that you apply.

2. Get Details of a specific Fight:

• Endpoint URL: https://boxing-data-api.p.rapidapi.com/v1/fights/<fight_id> (replace <fight_id> with the specific ID you want)
• Description: By providing a specific fight ID, you can retrieve detailed information about that particular fight.

Utilizing the Fight endpoint in your code

Here are some code examples demonstrating how to interact with the Fight endpoint using various programming languages.

List all Fights

The following query params can be used to filter the fights returned

Query Param	Description	Example	Default	Required
date	The status of the event, either NOT_STARTED, LIVE or FINISHED.	NOT_STARTED	Null	No
data_from	The starting date of date range, in format YYYY-MM-DD.	2024-12-01	Null	No
date_to	The ending date of a date range, in format YYYY-MM-DD.	2025-01-01	Null	No
date_sort	To sort the response by descending or ascending date order, either ASC or DESC.	DESC	DESC	No
division_id	The division id the bout is fought in.	671513530ad13034eb88265a	Null	No
event_id	The event the fight is related to.	671d12333012a998846efa3c	Null	No
fighter_id	The id of a fighter involved in the fight.	6715fc1faf69bb50508b7c72	Null	No
page_size	To limit the amount of items returned in the response.	10	25	No
page_num	The page number of the response.	5	1	No

Bash

curl --request GET
    --url https://boxing-data-api.p.rapidapi.com/v1/fights/
    --header 'x-rapidapi-key: [Your RapidAPI Key]'

JavaScript (using Axios)

axios.get('https://boxing-data-api.p.rapidapi.com/v1/fights', {
  headers: {
    'X-RapidAPI-Key': '[Your RapidAPI Key]'
  }
})
.then(response => {
  console.log(response.data);
})
.catch(error => {
  console.error(error);
});

Python (using requests)

import requests

url = "https://boxing-data-api.p.rapidapi.com/v1/fights"
headers = {
    'X-RapidAPI-Key': '[Your RapidAPI Key]'
}

response = requests.get(url, headers=headers)
print(response.json())

Example response:

[
  {
    "title": "Usyk vs Fury II",
    "slug": "usyk-vs-fury-ii",
    "date": "2024-12-21T00:00:00",
    "date_str": "Saturday, 21 December 2024",
    "fighters": {
      "fighter_1": {
        "name": "Oleksandr Usyk",
        "age": 37,
        "gender": null,
        "height": "6' 3\" / 191 cm",
        "nationality": "Ukraine",
        "nickname": null,
        "reach": "78\" / 198 cm",
        "stance": "Southpaw (L)",
        "stats": {
          "wins": 22,
          "losses": 0,
          "draws": 0,
          "total_bouts": 22,
          "total_rounds": 189,
          "ko_percentage": 64,
          "ko_wins": 14,
          "stopped": 0
        },
        "debut": "2013",
        "id": "6715fc1faf69bb50508b7c72"
      },
      "fighter_2": {
        "name": "Tyson Fury",
        "age": 36,
        "gender": null,
        "height": "6' 9\" / 206 cm",
        "nationality": "United Kingdom",
        "nickname": null,
        "reach": "85\" / 216 cm",
        "stance": "Orthodox (R)",
        "stats": {
          "wins": 34,
          "losses": 1,
          "draws": 1,
          "total_bouts": 36,
          "total_rounds": 242,
          "ko_percentage": 71,
          "ko_wins": 24,
          "stopped": 0
        },
        "debut": "2008",
        "id": "6715fc1faf69bb50508b7a83"
      }
    },
    "location": "Kingdom Arena, Riyadh, Saudi Arabia",
    "results": null,
    "scheduled_rounds": 12,
    "scores": null,
    "status": "NOT_STARTED",
    "id": "671d12333012a998846efa3c",
    "event": {
      "title": "Usyk vs Fury II",
      "slug": "usyk-vs-fury-ii",
      "date": "2024-12-21T00:00:00",
      "date_str": "Saturday, 21 December 2024",
      "location": "Kingdom Arena, Riyadh, Saudi Arabia",
      "broadcasters": [
        {
          "United States": "DAZN PPV"
        },
        {
          "United Kingdom": "DAZN PPV UK"
        }
      ],
      "status": "NOT_STARTED",
      "id": "671bcadd48e55a898f6895a3"
    },
    "division": {
      "name": "Heavyweight",
      "weight_lb": null,
      "weight_kg": null,
      "id": "671513530ad13034eb88265a"
    }
  },
  {
    "title": "Joshua vs Dubois",
    "slug": "joshua-vs-dubois",
    "date": "2024-09-21T00:00:00",
    "date_str": "Saturday, 21 September 2024",
    "fighters": {
      "fighter_1": {
        "name": "Daniel Dubois",
        "age": 27,
        "gender": null,
        "height": "6' 5\" / 196 cm",
        "nationality": "United Kingdom",
        "nickname": null,
        "reach": "78\" / 198 cm",
        "stance": "Orthodox (R)",
        "stats": {
          "wins": 22,
          "losses": 2,
          "draws": 0,
          "total_bouts": 24,
          "total_rounds": 95,
          "ko_percentage": 95,
          "ko_wins": 21,
          "stopped": 2
        },
        "debut": "2017",
        "id": "6715fc1faf69bb50508b7a4d"
      },
      "fighter_2": {
        "name": "Anthony Joshua",
        "age": 35,
        "gender": null,
        "height": "6' 6\" / 198 cm",
        "nationality": "United Kingdom",
        "nickname": null,
        "reach": "81.9\" / 208 cm",
        "stance": "Orthodox (R)",
        "stats": {
          "wins": 28,
          "losses": 4,
          "draws": 0,
          "total_bouts": 32,
          "total_rounds": 167,
          "ko_percentage": 89,
          "ko_wins": 25,
          "stopped": 2
        },
        "debut": "2013",
        "id": "6715fc1faf69bb50508b7af7"
      }
    },
    "location": "Wembley Stadium, London, United Kingdom",
    "results": {
      "outcome": "KO",
      "round": "5"
    },
    "scheduled_rounds": 12,
    "scores": null,
    "status": "FINISHED",
    "id": "671cc3f8198ef0907cf6e4d1",
    "event": {
      "title": "Joshua vs Dubois",
      "slug": "joshua-vs-dubois",
      "date": "2024-09-21T00:00:00",
      "location": "Wembley Stadium, London, United Kingdom",
      "date_str": "Saturday, 21 September 2024",
      "broadcasters": [
        {
          "United States": "DAZN PPV"
        },
        {
          "United Kingdom": "DAZN PPV UK"
        }
      ],
      "status": "FINISHED",
      "id": "671ab48736de0e5f4167863f"
    },
    "division": {
      "name": "Heavyweight",
      "weight_lb": null,
      "weight_kg": null,
      "id": "671513530ad13034eb88265a"
    }
  }
]

Get specific Fight

Bash

curl --request GET
    --url https://boxing-data-api.p.rapidapi.com/v1/fights/671d12333012a998846efa3c
    --header 'x-rapidapi-key: [Your RapidAPI Key]'

JavaScript (using Axios)

axios.get('https://boxing-data-api.p.rapidapi.com/v1/fights/671d12333012a998846efa3c', {
  headers: {
    'X-RapidAPI-Key': '[Your RapidAPI Key]'
  }
})
.then(response => {
  console.log(response.data);
})
.catch(error => {
  console.error(error);
});

Python (using requests)

import requests

url = "https://boxing-data-api.p.rapidapi.com/v1/fights/671d12333012a998846efa3c"
headers = {
    'X-RapidAPI-Key': '[Your RapidAPI Key]'
}

response = requests.get(url, headers=headers)
print(response.json())

Example response:

{
  "title": "Usyk vs Fury II",
  "slug": "usyk-vs-fury-ii",
  "date": "2024-12-21T00:00:00",
  "date_str": "Saturday, 21 December 2024",
  "fighters": {
    "fighter_1": {
      "name": "Oleksandr Usyk",
      "age": 37,
      "gender": null,
      "height": "6' 3\" / 191 cm",
      "nationality": "Ukraine",
      "nickname": null,
      "reach": "78\" / 198 cm",
      "stance": "Southpaw (L)",
      "stats": {
        "wins": 22,
        "losses": 0,
        "draws": 0,
        "total_bouts": 22,
        "total_rounds": 189,
        "ko_percentage": 64,
        "ko_wins": 14,
        "stopped": 0
      },
      "debut": "2013",
      "id": "6715fc1faf69bb50508b7c72"
    },
    "fighter_2": {
      "name": "Tyson Fury",
      "age": 36,
      "gender": null,
      "height": "6' 9\" / 206 cm",
      "nationality": "United Kingdom",
      "nickname": null,
      "reach": "85\" / 216 cm",
      "stance": "Orthodox (R)",
      "stats": {
        "wins": 34,
        "losses": 1,
        "draws": 1,
        "total_bouts": 36,
        "total_rounds": 242,
        "ko_percentage": 71,
        "ko_wins": 24,
        "stopped": 0
      },
      "debut": "2008",
      "id": "6715fc1faf69bb50508b7a83"
    }
  },
  "location": "Kingdom Arena, Riyadh, Saudi Arabia",
  "results": null,
  "scheduled_rounds": 12,
  "scores": null,
  "status": "NOT_STARTED",
  "id": "671d12333012a998846efa3c",
  "event": {
    "title": "Usyk vs Fury II",
    "slug": "usyk-vs-fury-ii",
    "date": "2024-12-21T00:00:00",
    "date_str": "Saturday, 21 December 2024",
    "location": "Kingdom Arena, Riyadh, Saudi Arabia",
    "broadcasters": [
      {
        "United States": "DAZN PPV"
      },
      {
        "United Kingdom": "DAZN PPV UK"
      }
    ],
    "status": "NOT_STARTED",
    "id": "671bcadd48e55a898f6895a3"
  },
  "division": {
    "name": "Heavyweight",
    "weight_lb": null,
    "weight_kg": null,
    "id": "671513530ad13034eb88265a"
  }
}

Remember to replace [Your RapidAPI Key] with your actual RapidAPI key in your code.