Badminton V2 API Overview

Enhanced Badminton API with 95 endpoints — BWF World Tour, live scores, point-by-point tracking

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

Category	Endpoints	Description
Live & Schedule	7	Live matches, schedules, tournaments
Search & Discovery	7	Search, categories, trending, news
Tournament	19	Tournament info, seasons, standings, brackets
Match	26	Match details, scores, point-by-point, stats, odds
Team / Player Entity	11	Player/pair details, matches, tournaments
Player	17	Player profiles, career stats, media
Referee / Venue	8	Umpires, venues

Total: 95 endpoints

Example Requests

cURL

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

Feature	Badminton	Tennis	Table Tennis
Match format	Best of 3 games	Best of 3 or 5 sets	Best of 5 or 7 games
Scoring	Games to 21 (win by 2, cap at 30)	Games to 6, tiebreak at 6-6	Games to 11 (deuce at 10-10)
Score fields	period1-period3 (games)	period1-period5 (sets)	period1-period7 (games)
Key endpoint	/point-by-point	/point-by-point	/point-by-point
Disciplines	MS, WS, MD, WD, XD	MS, WS, MD, WD, XD	MS, WS, MD, WD, XD
Court	Indoor court with net	Outdoor/Indoor	Indoor table
Equipment	Racket + shuttlecock	Racket + ball	Paddle + ball
Key stats	Smashes, net shots, clears, errors	Aces, winners, UEs	Points won