Boxing Data API - Explore details about past and upcoming fights

Fights are the individual bouts contested by boxers. Every fight has 2 boxers, a division_id and if any belts are on the line, an array of title_ids.

Understanding the fight data

Fight status

Upcoming fights will have status = NOT_STARTED, fights happening today will have status = LIVE and past fights will have status = FINISHED.

Who won the fight?

Once a fight has finished we update the results and identify the winner with winner = true in the fighters details.

What was the result?

The results key contains the outcome and the round the fight ended.

"results": {
      "outcome": "UD",
      "round": "12"
}

Possible outcome values:

"UD": Unanimous decision
"MD": Majority decision
"SD": Split decision
"TKO": Technical knockout
"KO": Knockout
"PTS": Points

What was the score?

If the judges scorecard was used, the scores will be in the scores key.

"scores": [
  "116-109",
  "117-108",
  "116-109"
]

Endpoints

1. List fights:

Endpoint URL: https://boxing-data-api.p.rapidapi.com/v2/fights/
Description: Retrieves a list of fights according to any filters that you apply.

2. Get a specific fight:

Endpoint URL: https://boxing-data-api.p.rapidapi.com/v2/fights/<fight_id>
Description: Retrieves detailed information about a specific fight.

List all fights

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

Query Param	Description	Example	Default	Required
`date`	The date of the fight, in format `YYYY-MM-DD`.	`2024-12-21`	Null	No
`data_from`	The starting date of date range, in format `YYYY-MM-DD`.	`2024-12-01`	Null	No
`date_to`	The ending date of a date range, in format `YYYY-MM-DD`.	`2025-01-01`	Null	No
`date_sort`	To sort the response by descending or ascending date order, either `ASC` or `DESC`.	`DESC`	`DESC`	No
`division_id`	The division id the bout is fought in.	`671513530ad13034eb88265a`	Null	No
`event_id`	The event the fight is related to.	`671d12333012a998846efa3c`	Null	No
`fighter_id`	The id of a fighter involved in the fight.	`6715fc1faf69bb50508b7c72`	Null	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
`cursor`	Opaque token from `pagination.next_page` for cursor-based navigation.	(value from next_page)	null	No

Pagination

Use page_num for normal browsing. For bulk export or iterating the full dataset, follow pagination.next_page — it’s a ready-to-use URL, just copy it into your next request. No manual token handling required.

Page-number navigation is blocked when the requested offset is 10,000 documents or greater, returning a 400 PageLimitExceeded error. For large datasets switch to cursor navigation — follow pagination.next_page to iterate without hitting this limit.

Note: on the cursor path total_items and total_pages are 0 — the count query is skipped for performance.

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

axios.get('https://boxing-data-api.p.rapidapi.com/v2/fights', {
  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/v2/fights"
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": 2,
    "total_pages": 1,
    "total_items": 2,
    "next_page": null
  },
  "error": {},
  "data": [
    {
      "title": "Joshua vs Dubois",
      "date": "2024-09-21T00:00:00",
      "fighters": {
        "fighter_1": {
          "name": "Dubois",
          "full_name": "Daniel Dubois",
          "winner": true,
          "fighter_id": "6715fc1faf69bb50508b7a4d"
        },
        "fighter_2": {
          "name": "Joshua",
          "full_name": "Anthony Joshua",
          "winner": false,
          "fighter_id": "6715fc1faf69bb50508b7af7"
        }
      },
      "location": "London, United Kingdom",
      "venue": "Wembley Stadium",
      "results": {
        "outcome": "KO",
        "round": "5"
      },
      "scheduled_rounds": 12,
      "scores": null,
      "status": "FINISHED",
      "updated_at": "2024-09-22T08:15:00.000000",
      "id": "671cc3f8198ef0907cf6e4d1",
      "event": {
        "title": "Joshua vs Dubois",
        "date": "2024-09-21T00:00:00",
        "location": "London, United Kingdom",
        "broadcasters": [
          {
            "United States": "DAZN PPV"
          },
          {
            "United Kingdom": "DAZN PPV UK"
          }
        ],
        "id": "671ab48736de0e5f4167863f",
        "poster_image_url": null
      },
      "division": {
        "name": "Heavyweight",
        "weight_lb": null,
        "weight_kg": null,
        "id": "671513530ad13034eb88265a"
      },
      "titles": []
    }
  ]
}

List upcoming fights schedule

Returns fights happening in the next N days. Defaults to 30 days.

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 ascending 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/v2/fights/schedule'
    --header 'x-rapidapi-key: [Your RapidAPI Key]'

axios.get('https://boxing-data-api.p.rapidapi.com/v2/fights/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/v2/fights/schedule"
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": 2,
    "total_pages": 1,
    "total_items": 2
  },
  "error": {},
  "data": [
    {
      "title": "Berinchyk vs Davis",
      "date": "2025-02-15T04:00:00",
      "location": "New York, United States",
      "venue": "Madison Square Garden Theater",
      "status": "NOT_STARTED",
      "scheduled_rounds": 12,
      "results": null,
      "scores": null,
      "fighters": {
        "fighter_1": {
          "name": "Berinchyk",
          "full_name": "Denys Berinchyk",
          "winner": false,
          "fighter_id": "6715fc1eaf69bb50508b79aa"
        },
        "fighter_2": {
          "name": "Davis",
          "full_name": "Keyshawn Davis",
          "winner": false,
          "fighter_id": "6715fc1faf69bb50508b7a2d"
        }
      },
      "updated_at": "2025-02-10T14:30:00.000000",
      "id": "677f825c3b7da567f76eac5a",
      "event": {
        "title": "Berinchyk vs Davis",
        "date": "2025-02-15T02:00:00",
        "location": "New York, United States",
        "broadcasters": [
          {
            "United States": "ESPN+"
          },
          {
            "United Kingdom": "Sky Sports Action"
          }
        ],
        "id": "677f82523b7da567f76eac51",
        "poster_image_url": null
      },
      "division": {
        "name": "Lightweight",
        "weight_lb": 135,
        "weight_kg": 61.23,
        "id": "671513530ad13034eb882652"
      },
      "titles": [
        {
          "name": "WBO World Lightweight Champion",
          "id": "67153e83af69bb50508b7914"
        }
      ]
    }
  ]
}

Get specific fight

To get a single fight, append the fight ID to the URL: /v2/fights/<fight_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": {
    "title": "Usyk vs Fury II",
    "date": "2024-12-21T00:00:00",
    "fighters": {
      "fighter_1": {
        "name": "Usyk",
        "full_name": "Oleksandr Usyk",
        "winner": false,
        "fighter_id": "6715fc1faf69bb50508b7c72"
      },
      "fighter_2": {
        "name": "Fury",
        "full_name": "Tyson Fury",
        "winner": false,
        "fighter_id": "6715fc1faf69bb50508b7a83"
      }
    },
    "location": "Riyadh, Saudi Arabia",
    "venue": "Kingdom Arena",
    "results": null,
    "scheduled_rounds": 12,
    "scores": null,
    "status": "NOT_STARTED",
    "updated_at": "2024-12-20T10:30:00.000000",
    "id": "671d12333012a998846efa3c",
    "event": {
      "title": "Usyk vs Fury II",
      "date": "2024-12-21T00:00:00",
      "location": "Riyadh, Saudi Arabia",
      "broadcasters": [
        {
          "United States": "DAZN PPV"
        },
        {
          "United Kingdom": "DAZN PPV UK"
        }
      ],
      "id": "671bcadd48e55a898f6895a3",
      "poster_image_url": null
    },
    "division": {
      "name": "Heavyweight",
      "weight_lb": null,
      "weight_kg": null,
      "id": "671513530ad13034eb88265a"
    },
    "titles": []
  }
}