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

> 22 endpoints for snooker match data: frame scores, statistics, odds, and highlights

## Scoring Format

Snooker is played frame-by-frame. The `/scores` endpoint returns:

```json theme={null}
{
  "homeScore": { "period1": 72, "period2": 0, "period3": 85, "current": 5 },
  "awayScore": { "period1": 68, "period2": 91, "period3": 0, "current": 3 }
}
```

* `period1`+ = points scored in each frame (0 = lost that frame)
* `current` = frames won
* Maximum frame score: 147 (maximum break)

## Match Endpoints (22)

All endpoints use base URL `https://api.sportsapipro.com/v2/snooker`.

### Match Details

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

Full match details including players, frame scores, tournament context.

### Scores

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

Frame-by-frame scores.

### Lineups

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

Player details for both sides.

### Match Statistics

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

Match stats: century breaks, highest break, frame win percentage.

### Incidents

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

Frame results, breaks, key moments.

### Player Statistics

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

All player stats or individual player stats in the match.

### Best Players & Award

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

### Head-to-Head

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

Historical head-to-head record between the two players.

### Scoring Graph

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

Scoring progression throughout the match.

### Form & Streaks

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

### Media & Highlights

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

### Fan Predictions

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

### Broadcast Info

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

TV broadcast info (BBC, Eurosport, etc.).

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