Badminton V2 API Overview

Base URL

https://api.sportsapipro.com/v2/badminton

Authentication

All requests require an x-api-key header:

curl -H "x-api-key: YOUR_API_KEY" \
  https://api.sportsapipro.com/v2/badminton/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.

Version coverage for badminton

Version	Badminton support
V2	Full: fixtures, results, point-by-point, tournaments (includes Olympic badminton, tournament IDs 557-561 by discipline)
V3	Covered (verified 20 Sep 2026): `/v3/badminton/{today,live,yesterday,tomorrow}` return leagues + events with set scores and player images. V3 is the feed that carries multi-sport games such as the Asian Games
V4 (odds)	Not covered. The V4 catalogue is 17 sports and badminton is not one of them
V6	Covered: `/v6/badminton/today`, `/v6/badminton/date/{YYYY-MM-DD}`, `/v6/badminton/countries`, `/v6/badminton/country/{id}/competitions`. Historic dates work (e.g. `2024-08-05` returns the Olympic Tournament). `/v6/badminton/competitions/hot` is empty for badminton

Tournament coverage is identical on Free and paid plans. Paid plans only raise the daily request quota, so you can validate coverage on Free first.

Multi-sport events

Event	Where to get it
Olympic badminton (2008-2024)	V2 (tournament IDs 557-561 by discipline)
Asian Games badminton	V3 (`Asian Games Teams` leagues on `/v3/badminton/today`) and V6 (competition `Asian Games, Women Teams`, id `ndkz69czw0nhgq3`)
Commonwealth Games badminton	Not currently covered on any version

The V2 badminton catalogue is the BWF circuit plus the Olympics only — 486 tournaments under the single International category (id 259). It has no Asian Games entry, so /v2/badminton/today during the Games returns only the concurrent BWF events (verified 20 Sep 2026: 12 Polish International matches on V2 while V3 and V6 both carried the Asian Games team ties). Verified working calls during Asian Games 2026:

# V3 — Asian Games Teams (men's + women's team, singles, doubles)
curl -H "x-api-key: YOUR_API_KEY" https://api.sportsapipro.com/v3/badminton/today
curl -H "x-api-key: YOUR_API_KEY" https://api.sportsapipro.com/v3/badminton/live

# V6 — same event with full match detail (incidents, stats, lineups)
curl -H "x-api-key: YOUR_API_KEY" https://api.sportsapipro.com/v6/badminton/today
curl -H "x-api-key: YOUR_API_KEY" https://api.sportsapipro.com/v6/badminton/match/{matchId}

V2’s badminton schedule populates close to match day. /v2/badminton/schedule/{date} returned zero events for dates a day or more ahead on 20 Sep 2026, so use it for today/recent days and V3 or V6 for forward-looking multi-sport event schedules.

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 -H "x-api-key: YOUR_API_KEY" \
  https://api.sportsapipro.com/v2/badminton/live

const response = await fetch(
  'https://api.sportsapipro.com/v2/badminton/live',
  { headers: { 'x-api-key': 'YOUR_API_KEY' } }
);
const data = await response.json();

import requests

response = requests.get(
    'https://api.sportsapipro.com/v2/badminton/live',
    headers={'x-api-key': 'YOUR_API_KEY'}
)
data = response.json()

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

API Reference

Guides

Popular Sports

Team Sports

Racquet & Precision Sports

Specialty Sports

V3 API

V4 Odds API

V6 AiScore API

V1 Legacy

Football V1

Basketball V1

Tennis V1

Hockey V1

Badminton V2 API Overview

Base URL

Authentication

Badminton-Specific Notes

Match Format

Disciplines

Teams vs Players

BWF World Tour

Version coverage for badminton

Multi-sport events

Key Stats

Test IDs

Endpoint Categories

Example Requests

UI Design Ideas

Sport Comparison — Badminton vs Tennis vs Table Tennis

​Base URL

​Authentication

​Badminton-Specific Notes

​Match Format

​Disciplines

​Teams vs Players

​BWF World Tour

​Version coverage for badminton

​Multi-sport events

​Key Stats

​Test IDs

​Endpoint Categories

​Example Requests

​UI Design Ideas

​Sport Comparison — Badminton vs Tennis vs Table Tennis

Base URL

Authentication

Badminton-Specific Notes

Match Format

Disciplines

Teams vs Players

BWF World Tour

Version coverage for badminton

Multi-sport events

Key Stats

Test IDs

Endpoint Categories

Example Requests

UI Design Ideas

Sport Comparison — Badminton vs Tennis vs Table Tennis