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

> 26 endpoints for handball match data: scores, lineups, statistics, odds, and more

## Scoring Format

Handball uses two 30-minute halves. The `/scores` endpoint returns:

```json theme={null}
{
  "homeScore": { "period1": 14, "period2": 14, "current": 28 },
  "awayScore": { "period1": 12, "period2": 13, "current": 25 }
}
```

* `period1` = 1st half goals, `period2` = 2nd half goals
* `overtime` appears in knockout matches (2×5 min extra time)
* Typical scores: 25–35 goals per team

***

### Match Details

```
GET /api/match/:matchId
```

Full match details including teams, scores, status, and venue.

### Scores

```
GET /api/match/:matchId/scores
```

Half-by-half scores.

### Lineups

```
GET /api/match/:matchId/lineups
```

Starting lineup.

### Statistics

```
GET /api/match/:matchId/statistics
```

Match stats: goals, saves, turnovers, penalties, suspensions.

### Incidents

```
GET /api/match/:matchId/incidents
```

Goals, penalties, suspensions, timeouts.

### Player Statistics

```
GET /api/match/:matchId/player-statistics
```

All player stats for the match.

### Individual Player Stats

```
GET /api/match/:matchId/player/:playerId/statistics
```

### Best Players

```
GET /api/match/:matchId/best-players
```

Top performers of the match.

### Award / MVP

```
GET /api/match/:matchId/award
```

### Head to Head

```
GET /api/match/:matchId/h2h
```

### Scoring Graph

```
GET /api/match/:matchId/graph
```

Scoring progression through the match.

### Pre-Game Form

```
GET /api/match/:matchId/pregame-form
```

### Streaks

```
GET /api/match/:matchId/streaks
```

### Highlights

```
GET /api/match/:matchId/highlights
```

### Media

```
GET /api/match/:matchId/media
```

### Managers / Coaches

```
GET /api/match/:matchId/managers
```

### Fan Votes

```
GET /api/match/:matchId/votes
```

### Venue

```
GET /api/match/:matchId/venue
```

### Referee

```
GET /api/match/:matchId/referee
```

### TV Channels

```
GET /api/match/:matchId/channels
```

### Missing Players

```
GET /api/match/:matchId/missing-players
```

### Featured Odds

```
GET /api/match/:matchId/odds
```

### All Odds

```
GET /api/match/:matchId/odds/all
```

### Pre-Match Odds

```
GET /api/match/:matchId/odds/pre-match
```

### Live Odds

```
GET /api/match/:matchId/odds/live
```

### Winning Odds

```
GET /api/match/:matchId/winning-odds
```

Win probability.