# BoxingAPI

> Boxing data API and MCP server: fights to come with prices, results of every kind, fighter records, rankings from the four bodies, the board and our own tables, judges' cards by name, odds and upsets, events and the Olympic Games. Updated every hour. Operated by DeveloperData.net.

## Documentation

- [Complete reference (manual.md)](https://boxingapi.net/documentation/manual.md): every endpoint, sample answer and guide in one file
- [Documentation](https://boxingapi.net/documentation): the pages people read
- [OpenAPI](https://boxingapi.net/openapi.json)

## Guides

- [Quick start](https://boxingapi.net/documentation/quick-start): A key, the first call, the answer.
- [Authentication](https://boxingapi.net/documentation/authentication): Your key, the two ways to send it, and rotating it.
- [Plans and limits](https://boxingapi.net/documentation/plans-and-limits): What each plan reads, its limits, and the headers that count them.
- [Pagination](https://boxingapi.net/documentation/pagination): Pages with totals, or a cursor for long walks.
- [Errors](https://boxingapi.net/documentation/errors): One shape for every error, and what to do about each.
- [Webhooks](https://boxingapi.net/documentation/webhooks): Events posted to your address, signed and retried.
- [MCP](https://boxingapi.net/documentation/mcp): Connecting an assistant to the data.
- [Agent skill](https://boxingapi.net/documentation/agent-skill): One file that teaches an agent to use the API.
- [Changelog](https://boxingapi.net/documentation/changelog): What changed, newest first.
- [Fights to come](https://boxingapi.net/documentation/fights-guide): The cards ahead, priced, and how a fight becomes a result.
- [Results and bouts](https://boxingapi.net/documentation/results-guide): Every bout of every kind, and how to filter them.
- [Fighters](https://boxingapi.net/documentation/fighters-guide): Finding a fighter, their record and everything joined to them.
- [Rankings and ratings](https://boxingapi.net/documentation/rankings-guide): The bodies' lists, the board, and our own two tables.
- [Judges and referees](https://boxingapi.net/documentation/officials-guide): Each judge's card by name, and the officials' records.
- [Odds and upsets](https://boxingapi.net/documentation/odds-guide): Opening and closing prices, and the underdogs who beat them.
- [Statistics](https://boxingapi.net/documentation/statistics-guide): Ready-made views across the whole record.
- [Events and the Olympics](https://boxingapi.net/documentation/events-guide): Amateur tournaments, the Games and the cards outside the pro record.

## Endpoints

- [GET /v1/usage](https://boxingapi.net/documentation/usage): Your usage
- [GET /v1/results/yesterday](https://boxingapi.net/documentation/results-yesterday): Yesterday's results
- [GET /v1/results/today](https://boxingapi.net/documentation/results-today): Today's results
- [GET /v1/title-fights](https://boxingapi.net/documentation/title-fights): Title fights
- [GET /v1/fights/upcoming](https://boxingapi.net/documentation/fights-upcoming): Upcoming fights
- [GET /v1/bouts](https://boxingapi.net/documentation/bouts): Bouts
- [GET /v1/bouts/{id}](https://boxingapi.net/documentation/bout): One bout
- [GET /v1/fighters](https://boxingapi.net/documentation/fighters): Find a fighter
- [GET /v1/fighters/{id}](https://boxingapi.net/documentation/fighter): One fighter
- [GET /v1/fighters/{id}/bouts](https://boxingapi.net/documentation/fighter-bouts): A fighter's bouts
- [GET /v1/fighters/{id}/next](https://boxingapi.net/documentation/fighter-next): A fighter's next fights
- [GET /v1/fights/{id}](https://boxingapi.net/documentation/fight): One fight to come
- [GET /v1/rankings](https://boxingapi.net/documentation/rankings): Rankings
- [GET /v1/rankings/divisions](https://boxingapi.net/documentation/rankings-divisions): Ranking lists held
- [GET /v1/fighters/{id}/rankings](https://boxingapi.net/documentation/fighter-rankings): Where a fighter is ranked
- [GET /v1/fighters/{id}/ratings](https://boxingapi.net/documentation/fighter-ratings): A fighter's rating history
- [GET /v1/bouts/{id}/cards](https://boxingapi.net/documentation/bout-cards): A bout's judges' cards
- [GET /v1/judges](https://boxingapi.net/documentation/judges): Judges
- [GET /v1/judges/{id}](https://boxingapi.net/documentation/judge): One judge
- [GET /v1/judges/{id}/cards](https://boxingapi.net/documentation/judge-cards): A judge's cards
- [GET /v1/referees](https://boxingapi.net/documentation/referees): Referees
- [GET /v1/referees/{id}](https://boxingapi.net/documentation/referee): One referee
- [GET /v1/referees/{id}/bouts](https://boxingapi.net/documentation/referee-bouts): A referee's bouts
- [GET /v1/odds/{id}](https://boxingapi.net/documentation/odds): A bout's prices
- [GET /v1/upsets](https://boxingapi.net/documentation/upsets): Upsets
- [GET /v1/upsets/years](https://boxingapi.net/documentation/upsets-years): Upsets by year
- [GET /v1/stats/favourites](https://boxingapi.net/documentation/stats-favourites): How often favourites win
- [GET /v1/stats/methods](https://boxingapi.net/documentation/stats-methods): How fights end, by year
- [GET /v1/stats/rounds](https://boxingapi.net/documentation/stats-rounds): When stoppages come
- [GET /v1/stats/kinds](https://boxingapi.net/documentation/stats-kinds): Bouts by year and kind
- [GET /v1/stats/countries](https://boxingapi.net/documentation/stats-countries): Countries
- [GET /v1/stats/unbeaten](https://boxingapi.net/documentation/stats-unbeaten): Unbeaten records
- [GET /v1/stats/streaks](https://boxingapi.net/documentation/stats-streaks): Winning and losing runs
- [GET /v1/stats/finishers](https://boxingapi.net/documentation/stats-finishers): Finishers
- [GET /v1/stats/busiest](https://boxingapi.net/documentation/stats-busiest): The busiest fighters
- [GET /v1/stats/rematches](https://boxingapi.net/documentation/stats-rematches): Rematches and rivalries
- [GET /v1/stats/careers](https://boxingapi.net/documentation/stats-careers): The longest careers
- [GET /v1/stats/debuts](https://boxingapi.net/documentation/stats-debuts): Debuts by year
- [GET /v1/stats/titles](https://boxingapi.net/documentation/stats-titles): Title fights by year
- [GET /v1/stats/judges/agreement](https://boxingapi.net/documentation/stats-judges-agreement): How often judges agree
- [GET /v1/stats/judges/margins](https://boxingapi.net/documentation/stats-judges-margins): Card margins
- [GET /v1/stats/ages](https://boxingapi.net/documentation/stats-ages): Does youth win
- [GET /v1/stats/heights](https://boxingapi.net/documentation/stats-heights): Does height win
- [GET /v1/stats/champions](https://boxingapi.net/documentation/stats-champions): Title fight winners
- [GET /v1/stats/venues](https://boxingapi.net/documentation/stats-venues): Venues
- [GET /v1/stats/women](https://boxingapi.net/documentation/stats-women): Women's boxing by year
- [GET /v1/stats/movers](https://boxingapi.net/documentation/stats-movers): Rating movers
- [GET /v1/stats/activity](https://boxingapi.net/documentation/stats-activity): How often fighters box
- [GET /v1/stats/quality](https://boxingapi.net/documentation/stats-quality): How far the record agrees
- [GET /v1/fighters/{id}/vs/{other}](https://boxingapi.net/documentation/head-to-head): Head to head
- [GET /v1/webhooks](https://boxingapi.net/documentation/webhooks-list): Your webhooks
- [POST /v1/webhooks](https://boxingapi.net/documentation/webhook-add): Add a webhook
- [DELETE /v1/webhooks/{id}](https://boxingapi.net/documentation/webhook-delete): Delete a webhook
- [POST /v1/webhooks/{id}/test](https://boxingapi.net/documentation/webhook-test): Test a webhook
- [GET /v1/webhooks/{id}/deliveries](https://boxingapi.net/documentation/webhook-deliveries): A webhook's deliveries
- [GET /v1/events](https://boxingapi.net/documentation/events): Events
- [GET /v1/events/{id}](https://boxingapi.net/documentation/event): One event
- [GET /v1/events/{id}/bouts](https://boxingapi.net/documentation/event-bouts): An event's bouts
- [GET /v1/olympics](https://boxingapi.net/documentation/olympics): Olympic Games
- [GET /v1/olympics/{year}/medals](https://boxingapi.net/documentation/olympic-medals): Olympic medal table
- [GET /v1/olympics/{year}/podiums](https://boxingapi.net/documentation/olympic-podiums): Olympic medallists

## MCP

- [MCP server](https://api.boxingapi.net/mcp): Model Context Protocol endpoint, 18 tools
- [MCP tools](https://boxingapi.net/documentation/mcp-tools)

## Agent skill

- [BoxingAPI agent skill](https://boxingapi.net/.well-known/agent-skills/boxingapi/SKILL.md): how agents use BoxingAPI. Index: https://boxingapi.net/.well-known/agent-skills/index.json