Match Endpoints

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

Scoring Format

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

{
  "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

GET /api/match/:matchId

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

Scores

GET /api/match/:matchId/scores

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

Point-by-Point

GET /api/match/:matchId/point-by-point

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

Lineups

GET /api/match/:matchId/lineups

Player information for the match.

Statistics

GET /api/match/:matchId/statistics

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

Incidents

GET /api/match/:matchId/incidents

Game wins, key moments during the match.

Player Statistics

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

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

Head-to-Head & Form

GET /api/match/:matchId/h2h
GET /api/match/:matchId/pregame-form
GET /api/match/:matchId/streaks
GET /api/match/:matchId/graph

Media

GET /api/match/:matchId/highlights
GET /api/match/:matchId/media

Match Info

GET /api/match/:matchId/votes
GET /api/match/:matchId/venue
GET /api/match/:matchId/referee
GET /api/match/:matchId/channels

Odds

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