Boxing Data API - Explore Boxer details with the Fighter Endpoint

Fighters are the individual boxers that participate in boxing matches. The Boxing Data API has data on hundreds of boxers both active and retired and our database is constantly growing.

We collect and store the most important data about each fighter, this includes, personal details, physical attributes and fight statistics.

Fighters can be filtered by division ID and if title ID if they hold any championship titles.

Exploring the Fighters Endpoint

The Fighters endpoint empowers you to build detailed fighter profile. There are two primary functionalities offered by this endpoint:

1. Search and filter many Fighter:

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

2. Get Details of a specific Fighter:

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

Utilizing the Fighters endpoint in your code

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

List all Fighters

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

Query Param	Description	Example	Default	Required
name	Search fighters by their name, part of their name or nickname	Fury	Null	No
division_id	The division id the boxer fights in	671513530ad13034eb88265a	Null	No
title_id	The id of a title that the fighter holds	67153e83af69bb50508b7911	Null	No
page_num	The page to display	5	1	No
page_size	The number of result to display on the page	10	25	No

Bash

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

JavaScript (using Axios)

axios.get('https://boxing-data-api.p.rapidapi.com/v1/fighters', {
  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/fighters"
headers = {
    'X-RapidAPI-Key': '[Your RapidAPI Key]'
}

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

Example response:

[
  {
    "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",
    "division": {
      "name": "Heavyweight",
      "slug": "heavyweight",
      "weight_lb": null,
      "weight_kg": null,
      "id": "671513530ad13034eb88265a"
    }
  },
  {
    "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",
    "division": {
      "name": "Heavyweight",
      "slug": "heavyweight",
      "weight_lb": null,
      "weight_kg": null,
      "id": "671513530ad13034eb88265a"
    }
  }
]

Get specific division

Bash

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

JavaScript (using Axios)

axios.get('https://boxing-data-api.p.rapidapi.com/v1/fighters/6715fc1faf69bb50508b7a83', {
  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/fighters/6715fc1faf69bb50508b7a83"
headers = {
    'X-RapidAPI-Key': '[Your RapidAPI Key]'
}

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

Example response:

{
  "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",
  "division": {
    "name": "Heavyweight",
    "slug": "heavyweight",
    "weight_lb": null,
    "weight_kg": null,
    "id": "671513530ad13034eb88265a"
  }
}

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