Boxing Data API - Explore Weight Classes with the Divisions Endpoint

Events are a collection of boxing matches that are put together by a promotion company. Using the event ID you can filter for all fights related to a specific event and build the fight card.

The Boxing data Events api provides the following contextual information:

- Title: The headline title of the event.

- Date: The scheduled date the event will take place.

- Location: Information about the venue where the event will be hosted.

- Status: The current status of the event such as NOT_STARTED, LIVE or FINISHED.

- Broacaster: Information about which broadcasters in which countries will be showing the event.

Exploring the Events Endpoint

The Events endpoint provides access to detailed information about upcoming and historic boxing events. There are two primary functionalities offered by this endpoint:

1. List many events:

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

2. Get Details of a specific Event:

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

Utilizing the Events endpoint in your code

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

List all divisions

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

Query Param	Description	Example	Default	Required
status	The status of the event, either NOT_STARTED, LIVE or FINISHED	FINISHED	Null	No
date	The date of the event, in the format YYYY-MM-DD	2024-11-13	Null	No
date_from	The starting date of date range, in format YYYY-MM-DD	2024-10-13	Null	No
date_to	The ending date of a date range, in format YYYY-MM-DD	2024-11-13	Null	No
date_sort	To sort the response by descending or acesdeing date order, either ASC or DESC	DESC	DESC	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/events/
    --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/events', {
  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/events"
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",
    "location": "Kingdom Arena, Riyadh, Saudi Arabia",
    "broadcasters": [
      {
        "United States": "DAZN PPV"
      },
      {
        "United Kingdom": "DAZN PPV UK"
      }
    ],
    "status": "NOT_STARTED",
    "id": "671bcadd48e55a898f6895a3"
  },
  {
    "title": "Mike Tyson vs Jake Paul",
    "slug": "mike-tyson-vs-jake-paul",
    "date": "2024-11-15T00:00:00",
    "date_str": "Friday, 15 November 2024",
    "location": "AT&T Stadium, Arlington, TX, United States",
    "broadcasters": [
      {
        "United States": "Netflix"
      },
      {
        "United Kingdom": "Netflix UK"
      }
    ],
    "status": "NOT_STARTED",
    "id": "671bcadd48e55a898f689597"
  }
]

Get specific division

Bash

curl --request GET
    --url https://boxing-data-api.p.rapidapi.com/v1/events/671bcadd48e55a898f6895a3
    --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/events/671bcadd48e55a898f6895a3', {
  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/events/671bcadd48e55a898f6895a3"
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",
  "location": "Kingdom Arena, Riyadh, Saudi Arabia",
  "broadcasters": [
    {
      "United States": "DAZN PPV"
    },
    {
      "United Kingdom": "DAZN PPV UK"
    }
  ],
  "status": "NOT_STARTED",
  "id": "671bcadd48e55a898f6895a3"
}

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