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

> Esports V2 match data: scores, statistics, odds, streams

## Scoring Format

Esports matches are played across maps/games. The `/scores` endpoint returns:

```json theme={null}
{
  "homeScore": { "period1": 16, "period2": 10, "period3": 16, "current": 2 },
  "awayScore": { "period1": 13, "period2": 16, "period3": 12, "current": 1 }
}
```

* `period1`+ = score per map (CS2: rounds won, typically to 13/16; LoL/Dota: 1=win, 0=loss)
* `current` = maps/games won
* Bo3 = first to 2 maps, Bo5 = first to 3 maps

## Match Endpoints (22)

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

### Match Details

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

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

### Scores

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

Map-by-map or game-by-game scores (e.g., CS2: 16-13, 13-16, 16-10 = 2-1). Fields: `period1` through `period5`.

### Lineups

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

Team rosters for the match (5 players per team in CS2/LoL/Dota 2).

### Statistics

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

Match stats: kills, deaths, assists, ADR, rating (CS2); CS, gold, towers (LoL/Dota).

### Incidents

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

Round wins, map picks/bans, 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/channels
```

The `/channels` endpoint returns Twitch and YouTube stream links.

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