Skip to main content

Base URL

https://v2.badminton.sportsapipro.com

Authentication

All requests require an x-api-key header:
curl -H "x-api-key: YOUR_API_KEY" \
  https://v2.badminton.sportsapipro.com/api/live

Badminton-Specific Notes

Match Format

  • Best of 3 games — each game to 21 points, win by 2, cap at 30
  • Score fields: period1, period2, period3

Disciplines

Five disciplines are supported:
  • MS — Men’s Singles
  • WS — Women’s Singles
  • MD — Men’s Doubles
  • WD — Women’s Doubles
  • XD — Mixed Doubles

Teams vs Players

In badminton, “teams” on the API represent individual players or doubles pairs, not clubs. Use the /search endpoint to discover player/pair entity IDs.

BWF World Tour

Tournaments run year-round on the BWF circuit (Super 1000, Super 750, Super 500, Super 300, Super 100). During tournament weeks, expect 50-100+ matches per day.

Key Stats

  • Smashes, net shots, clears, drop shots, errors
  • Point-by-point tracking via /match/:id/point-by-point

Test IDs

Use the search endpoint to discover IDs:
GET /api/search?q=all+england
GET /api/search?q=axelsen
GET /api/countries

Endpoint Categories

CategoryEndpointsDescription
Live & Schedule7Live matches, schedules, tournaments
Search & Discovery7Search, categories, trending, news
Tournament19Tournament info, seasons, standings, brackets
Match26Match details, scores, point-by-point, stats, odds
Team / Player Entity11Player/pair details, matches, tournaments
Player17Player profiles, career stats, media
Referee / Venue8Umpires, venues
Total: 95 endpoints

Example Requests

curl -H "x-api-key: YOUR_API_KEY" \
  https://v2.badminton.sportsapipro.com/api/live

UI Design Ideas

  • Score display: Show game-by-game (G1: 21-18, G2: 15-21, G3: 21-19 = 2-1)
  • Point-by-point: Critical for live matches — rally-level data
  • Draw bracket: Primary navigation for tournaments — R128 → Final via /knockout
  • BWF Tour tiers: Super 1000 (highest) → Super 100 — display tier in tournament info
  • H2H: Important — use /match/{id}/h2h
  • Player profile: Nationality, ranking, playing hand, discipline(s)

Sport Comparison — Badminton vs Tennis vs Table Tennis

FeatureBadmintonTennisTable Tennis
Match formatBest of 3 gamesBest of 3 or 5 setsBest of 5 or 7 games
ScoringGames to 21 (win by 2, cap at 30)Games to 6, tiebreak at 6-6Games to 11 (deuce at 10-10)
Score fieldsperiod1-period3 (games)period1-period5 (sets)period1-period7 (games)
Key endpoint/point-by-point/point-by-point/point-by-point
DisciplinesMS, WS, MD, WD, XDMS, WS, MD, WD, XDMS, WS, MD, WD, XD
CourtIndoor court with netOutdoor/IndoorIndoor table
EquipmentRacket + shuttlecockRacket + ballPaddle + ball
Key statsSmashes, net shots, clears, errorsAces, winners, UEsPoints won