Boxing Data API - Explore Weight Classes with the Divisions Endpoint

Divisions represent the various weight categories in which boxers compete. Common examples include Heavyweight, Middleweight, and Featherweight. Each division has a specific maximum weight limit.

The Boxing Data API provides access to information about these divisions, including:

- Division names: Easily identify different weight classes.

- Maximum weight limits: Understand the weight restrictions for each division (in both pounds and kilograms).

- Filtering capabilities: Filter fights and fighters by division ID for targeted results.

Exploring the Divisions Endpoint

The Divisions endpoint provides access to detailed information about weight classes within the Boxing Data API. There are two primary functionalities offered by this endpoint:

1. List All Available Divisions:

• Endpoint URL: https://boxing-data-api.p.rapidapi.com/v1/divisions/
• Description: This request retrieves a complete list of all supported weight classes.
• Response: The API returns an array of objects, each representing a division. Each object includes the division’s name, maximum weight limits in pounds and kilograms, and a unique identifier.

2. Get Details of a Specific Division:

• Endpoint URL: https://boxing-data-api.p.rapidapi.com/v1/divisions/<division_id> (replace <division_id> with the specific ID you want)
• Description: By providing a specific division ID, you can retrieve detailed information about that particular weight class.
• Response: The API returns an object containing all information associated with the requested division, including its name, weight limits, and ID.

Utilizing the Divisions Endpoint in Your Code

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

List all divisions

Bash

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

JavaScript (using Axios)

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

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

Example response:

[
  {
    "name": "Flyweight",
    "weight_lb": 112,
    "weight_kg": 50.8,
    "id": "671513530ad13034eb88264c"
  },
  {
    "name": "Middleweight",
    "weight_lb": 160,
    "weight_kg": 72.57,
    "id": "671513530ad13034eb882656"
  },
  {
    "name": "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/divisions/671513530ad13034eb882656
    --header 'x-rapidapi-host: boxing-data-api.p.rapidapi.com'
    --header 'x-rapidapi-key: [Your RapidAPI Key]'

JavaScript (using Axios)

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

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

Example response:

{
  "name": "Middleweight",
  "weight_lb": 160,
  "weight_kg": 72.57,
  "id": "671513530ad13034eb882656"
}

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

By leveraging the Divisions endpoint, you can effectively incorporate weight class data into your applications. This empowers you to:

* Filter fights and fighters based on weight class.

* Display weight class information alongside boxer profiles.

* Analyze trends and statistics within specific weight divisions.