> ## 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.

# Match Endpoints

> Badminton V2 match data: scores, point-by-point, statistics, odds

## Scoring Format

Badminton is best of 3 games. The `/scores` endpoint returns:

```json theme={null}
{
  "homeScore": { "period1": 21, "period2": 18, "period3": 21, "point": "0", "current": 2 },
  "awayScore": { "period1": 18, "period2": 21, "period3": 15, "point": "0", "current": 1 }
}
```

* `period1`–`period3` = points per game (to 21, win by 2, cap at 30)
* `point` = current point score within the active game
* `current` = games won

## Match Endpoints (26)

All match endpoints use the base URL `https://api.sportsapipro.com/v2/badminton`.

### Match Details

```bash theme={null}
GET /api/match/:matchId
```

Returns full match details including players, scores, status, and tournament context.

### Scores

```bash theme={null}
GET /api/match/:matchId/scores
```

Game-by-game scores (e.g., 21-18, 15-21, 21-19). Fields: `period1`, `period2`, `period3`.

### Point-by-Point

```bash theme={null}
GET /api/match/:matchId/point-by-point
```

Point-by-point scoring progression for each game. Similar to tennis and table tennis.

### Lineups

```bash theme={null}
GET /api/match/:matchId/lineups
```

Player information for the match.

### Statistics

```bash theme={null}
GET /api/match/:matchId/statistics
```

Match stats: smashes, net shots, errors, etc.

### Incidents

```bash theme={null}
GET /api/match/:matchId/incidents
```

Game wins, key moments during the match.

### Player Statistics

```bash theme={null}
GET /api/match/:matchId/player-statistics
GET /api/match/:matchId/player/:playerId/statistics
```

All player stats in match, or individual player stats.

### Best Players & Award

```bash theme={null}
GET /api/match/:matchId/best-players
GET /api/match/:matchId/award
```

### Head-to-Head & Form

```bash theme={null}
GET /api/match/:matchId/h2h
GET /api/match/:matchId/pregame-form
GET /api/match/:matchId/streaks
GET /api/match/:matchId/graph
```

### Media

```bash theme={null}
GET /api/match/:matchId/highlights
GET /api/match/:matchId/media
```

### Match Info

```bash theme={null}
GET /api/match/:matchId/votes
GET /api/match/:matchId/venue
GET /api/match/:matchId/referee
GET /api/match/:matchId/channels
```

### Odds

```bash theme={null}
GET /api/match/:matchId/odds
GET /api/match/:matchId/odds/all
GET /api/match/:matchId/odds/pre-match
GET /api/match/:matchId/odds/live
GET /api/match/:matchId/winning-odds
```