> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sportsapipro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Badminton V2 API Overview

> Enhanced Badminton API with 95 endpoints: BWF World Tour, live scores, point-by-point tracking

## Base URL

```
https://api.sportsapipro.com/v2/badminton
```

## Authentication

All requests require an `x-api-key` header:

```bash theme={null}
curl -H "x-api-key: YOUR_API_KEY" \
  https://api.sportsapipro.com/v2/badminton/live
```

## Badminton-Specific Notes

### Match Format

* **Best of 3 games** — each game to 21 points, win by 2, cap at 30
* Score fields: `period1`, `period2`, `period3`

### Disciplines

Five disciplines are supported:

* **MS** — Men's Singles
* **WS** — Women's Singles
* **MD** — Men's Doubles
* **WD** — Women's Doubles
* **XD** — Mixed Doubles

### Teams vs Players

In badminton, **"teams"** on the API represent individual players or doubles pairs, not clubs. Use the `/search` endpoint to discover player/pair entity IDs.

### BWF World Tour

Tournaments run year-round on the BWF circuit (Super 1000, Super 750, Super 500, Super 300, Super 100). During tournament weeks, expect 50-100+ matches per day.

### Key Stats

* Smashes, net shots, clears, drop shots, errors
* Point-by-point tracking via `/match/:id/point-by-point`

## Test IDs

Use the search endpoint to discover IDs:

```bash theme={null}
GET /api/search?q=all+england
GET /api/search?q=axelsen
GET /api/countries
```

## Endpoint Categories

| Category             | Endpoints | Description                                        |
| -------------------- | --------- | -------------------------------------------------- |
| Live & Schedule      | 7         | Live matches, schedules, tournaments               |
| Search & Discovery   | 7         | Search, categories, trending, news                 |
| Tournament           | 19        | Tournament info, seasons, standings, brackets      |
| Match                | 26        | Match details, scores, point-by-point, stats, odds |
| Team / Player Entity | 11        | Player/pair details, matches, tournaments          |
| Player               | 17        | Player profiles, career stats, media               |
| Referee / Venue      | 8         | Umpires, venues                                    |

**Total: 95 endpoints**

## Example Requests

<CodeGroup>
  ```bash cURL theme={null}
  curl -H "x-api-key: YOUR_API_KEY" \
    https://api.sportsapipro.com/v2/badminton/live
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.sportsapipro.com/v2/badminton/live',
    { headers: { 'x-api-key': 'YOUR_API_KEY' } }
  );
  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.sportsapipro.com/v2/badminton/live',
      headers={'x-api-key': 'YOUR_API_KEY'}
  )
  data = response.json()
  ```
</CodeGroup>

## UI Design Ideas

* **Score display**: Show game-by-game (G1: 21-18, G2: 15-21, G3: 21-19 = 2-1)
* **Point-by-point**: Critical for live matches — rally-level data
* **Draw bracket**: Primary navigation for tournaments — R128 → Final via `/knockout`
* **BWF Tour tiers**: Super 1000 (highest) → Super 100 — display tier in tournament info
* **H2H**: Important — use `/match/{id}/h2h`
* **Player profile**: Nationality, ranking, playing hand, discipline(s)

## Sport Comparison — Badminton vs Tennis vs Table Tennis

| Feature      | Badminton                          | Tennis                      | Table Tennis                 |
| ------------ | ---------------------------------- | --------------------------- | ---------------------------- |
| Match format | Best of 3 games                    | Best of 3 or 5 sets         | Best of 5 or 7 games         |
| Scoring      | Games to 21 (win by 2, cap at 30)  | Games to 6, tiebreak at 6-6 | Games to 11 (deuce at 10-10) |
| Score fields | period1-period3 (games)            | period1-period5 (sets)      | period1-period7 (games)      |
| Key endpoint | /point-by-point                    | /point-by-point             | /point-by-point              |
| Disciplines  | MS, WS, MD, WD, XD                 | MS, WS, MD, WD, XD          | MS, WS, MD, WD, XD           |
| Court        | Indoor court with net              | Outdoor/Indoor              | Indoor table                 |
| Equipment    | Racket + shuttlecock               | Racket + ball               | Paddle + ball                |
| Key stats    | Smashes, net shots, clears, errors | Aces, winners, UEs          | Points won                   |