Get Title Details

Titles refer to the belts that the world champion boxers hold. Each title is related to a boxing organization and a weight class division with a organization_id and division_id respectively.

Endpoints

There are 2 title endpoints:

1. List All Available Titles:

• Endpoint URL: https://boxing-data-api.p.rapidapi.com/v1/titles/
• Description: To retrive a list of available titles, including the name, organization_id and division_id.

2. Get a specific title’s details:

• Endpoint URL: https://boxing-data-api.p.rapidapi.com/v1/titles/<title_id>
• Description: To get the detail of a specific title.

Using the Organization endpoints

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

List all organizations

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

Param	Example	Default	Required
organization_id	6715193e0ad13034eb88265d	Null	No
division_id	671513530ad13034eb88265a	Null	No

---

Bash

curl --request GET
    --url https://boxing-data-api.p.rapidapi.com/v1/titles/
    --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/titles', {
  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/titles"
headers = {
    'X-RapidAPI-Key': '[Your RapidAPI Key]'
}

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

Example response:

[
  {
    "name": "The Ring Heavyweight Champion",
    "id": "67153e83af69bb50508b78f9",
    "division": {
      "name": "Heavyweight",
      "slug": "heavyweight",
      "weight_lb": null,
      "weight_kg": null,
      "id": "671513530ad13034eb88265a"
    },
    "organization": {
      "name": "The Ring Magazine",
      "slug": "the-ring-magazine",
      "id": "6715193e0ad13034eb88265c"
    }
  },
  {
    "name": "WBA World Heavyweight Champion",
    "id": "67153e83af69bb50508b7947",
    "division": {
      "name": "Heavyweight",
      "slug": "heavyweight",
      "weight_lb": null,
      "weight_kg": null,
      "id": "671513530ad13034eb88265a"
    },
    "organization": {
      "name": "World Boxing Association (WBA)",
      "slug": "world-boxing-association",
      "id": "6715193e0ad13034eb88265d"
    }
  }
]

Get Specific Organization Details by ID

Bash

curl --request GET
    --url https://boxing-data-api.p.rapidapi.com/v1/titles/67153e83af69bb50508b7947
    --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/titles/67153e83af69bb50508b7947', {
  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": "WBA World Heavyweight Champion",
  "id": "67153e83af69bb50508b7947",
  "division": {
    "name": "Heavyweight",
    "slug": "heavyweight",
    "weight_lb": null,
    "weight_kg": null,
    "id": "671513530ad13034eb88265a"
  },
  "organization": {
    "name": "World Boxing Association (WBA)",
    "slug": "world-boxing-association",
    "id": "6715193e0ad13034eb88265d"
  }
}

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