Boxing Data API - Explore Weight Classes with the Divisions Endpoint

Divisions represent the weight categories in which boxers compete. Each division has a name and a maximum weight limit in both pounds and kilograms. Use the division ID to filter fights and fighters by weight class.

Endpoints

1. List all divisions:

• Endpoint URL: https://boxing-data-api.p.rapidapi.com/v2/divisions/
• Description: Retrieves a complete list of all supported weight classes.

2. Get a specific division:

• Endpoint URL: https://boxing-data-api.p.rapidapi.com/v2/divisions/<division_id>
• Description: Retrieves detailed information about a specific weight class.

List all divisions

Bash

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

JavaScript (using Axios)

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

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

Example response:

{
  "metadata": {
    "timestamp": "2026-02-27T12:00:00.000000+00:00"
  },
  "pagination": {
    "page": 1,
    "items": 3,
    "total_pages": 1,
    "total_items": 3
  },
  "error": {},
  "data": [
    {
      "name": "Flyweight",
      "weight_lb": 112,
      "weight_kg": 50.8,
      "id": "671513530ad13034eb88264c"
    }
  ]
}

Get specific division

To get a single division, append the division ID to the URL: /v2/divisions/<division_id>

Example response:

{
  "metadata": {
    "timestamp": "2026-02-27T12:00:00.000000+00:00"
  },
  "pagination": {
    "page": 1,
    "items": 1,
    "total_pages": 1,
    "total_items": 1
  },
  "error": {},
  "data": {
    "name": "Middleweight",
    "weight_lb": 160,
    "weight_kg": 72.57,
    "id": "671513530ad13034eb882656"
  }
}