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 events

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

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]'

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);
});

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"
  }
]

List upcoming events schedule

A common use-case is to list the events happening in the immediate future, e.g. the next 30 days. So created an endpoint to easily do that. The following query params can be used to filter the titles returned

Query Param	Description	Example	Default	Required
`days`	The number of days from today you want to search	`30`	`30`	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

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

axios.get('https://boxing-data-api.p.rapidapi.com/v1/events/schedule', {
  headers: {
    'X-RapidAPI-Key': '[Your RapidAPI Key]'
  }
})
.then(response => {
  console.log(response.data);
})
.catch(error => {
  console.error(error);
});

import requests

url = "https://boxing-data-api.p.rapidapi.com/v1/events/schedule"
headers = {
    'X-RapidAPI-Key': '[Your RapidAPI Key]'
}

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

Example response:

[
  {
    "title": "Berinchyk vs Davis",
    "slug": "berinchyk-vs-davis",
    "date": "2025-02-15T02:00:00",
    "location": "Madison Square Garden Theater, New York, United States",
    "status": "NOT_STARTED",
    "broadcasters": [
      {
        "United States": "ESPN+"
      },
      {
        "United Kingdom": "Sky Sports Action"
      }
    ],
    "id": "677f82523b7da567f76eac51"
  },
  {
    "title": "Catterall vs Barboza Jr",
    "slug": "catterall-vs-barboza-jr",
    "date": "2025-02-15T19:00:00",
    "location": "Co-op Live Arena, Manchester, United Kingdom",
    "status": "NOT_STARTED",
    "broadcasters": [
      {
        "United States": "DAZN"
      },
      {
        "United Kingdom": "DAZN Global"
      }
    ],
    "id": "6768d27263b45fd5ba602884"
  },
  {
    "title": "Moreno vs Francis",
    "slug": "moreno-vs-francis",
    "date": "2025-02-19T23:00:00",
    "location": "Chicken Ranch Casino Resort, Jamestown, United States",
    "status": "NOT_STARTED",
    "broadcasters": [
      {
        "United States": "ProBox TV US"
      },
      {
        "United Kingdom": "ProBox TV"
      }
    ],
    "id": "677cdf69e33ca8b9dcd3a921"
  },
]

Get specific event

You can get the details of a specific event by adding the event ID to the url. e.g /v1/events/{event_id}

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]'

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);
});

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.