Match Endpoints

22 endpoints for beach volleyball match data: set-by-set scores, player stats, and odds

Scoring Format

Beach volleyball is best of 3 sets. The /scores endpoint returns:

{
  "homeScore": { "period1": 21, "period2": 18, "period3": 15, "current": 2 },
  "awayScore": { "period1": 19, "period2": 21, "period3": 12, "current": 1 }
}

• period1–period3 = points per set
• Sets 1–2 to 21 (win by 2), set 3 to 15 (win by 2)
• current = sets won

---

Match Details

GET /api/match/:matchId

Scores

GET /api/match/:matchId/scores

Set-by-set scores (Set 1, Set 2, Set 3).

Lineups

GET /api/match/:matchId/lineups

Players on each team (2 per side).

Match Statistics

GET /api/match/:matchId/statistics

Aces, blocks, kills, errors, attack %.

Incidents

GET /api/match/:matchId/incidents

Key moments: timeouts, set wins, challenges.

All Player Statistics

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

Individual Player Stats

GET /api/match/:matchId/player/:pid/statistics

Best Players

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

Match Award

GET /api/match/:matchId/award

Head-to-Head

GET /api/match/:matchId/h2h

History between the two pairs.

Scoring Progression

GET /api/match/:matchId/graph

Pre-Match Form

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

Streaks

GET /api/match/:matchId/streaks

Highlights

GET /api/match/:matchId/highlights

Match Media

GET /api/match/:matchId/media

Fan Predictions

GET /api/match/:matchId/votes

TV Channels

GET /api/match/:matchId/channels

Featured Odds

GET /api/match/:matchId/odds

All Odds Providers

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

Pre-Match Odds

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

Live Odds

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

Win Probability

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