Live & Schedule Endpoints (7)
All endpoints use base URLhttps://api.sportsapipro.com/v2/badminton.
GET /api/live # Curated live matches
GET /api/live/all # Raw live data
GET /api/today # Today's scheduled matches
GET /api/schedule/:date # Schedule by date (YYYY-MM-DD)
GET /api/live-tournaments # Tournaments with live matches
GET /api/scheduled-tournaments/:date # Tournaments with matches on date
GET /api/newly-added-events # Recently added matches
Response Example — /api/live
{
"events": [
{
"id": 12345678,
"homeTeam": { "id": 5201, "name": "Viktor Axelsen" },
"awayTeam": { "id": 5202, "name": "Kodai Naraoka" },
"homeScore": {
"current": 1,
"display": 1,
"period1": 21,
"period2": 18,
"period3": 0,
"point": "12"
},
"awayScore": {
"current": 1,
"display": 1,
"period1": 18,
"period2": 21,
"period3": 0,
"point": "9"
},
"status": { "code": 13, "description": "3rd Game", "type": "inprogress" },
"tournament": { "name": "BWF World Tour Finals", "id": 1200 },
"startTimestamp": 1737331200
}
]
}
Score Fields
| Field | Description |
|---|---|
period1 – period3 | Points scored in each game (games to 21, win by 2, cap at 30) |
point | Current point score within the active game |
current | Games won (best of 3) |
Status Codes
| Code | Description |
|---|---|
| 0 | Not started |
| 11 | 1st Game |
| 12 | 2nd Game |
| 13 | 3rd Game |
| 31 | Game Break |
| 100 | Ended |
Search & Discovery Endpoints (7)
GET /api/search?q=axelsen # Search players, tournaments
GET /api/countries # Categories (BWF International)
GET /api/countries/all # Extended categories
GET /api/categories/:categoryId/tournaments # Tournaments in category
GET /api/trending-players # Trending badminton players
GET /api/news?lang=en # Badminton news
GET /api/country/:code/flag # Country flag URL
Example: Find Live Matches
curl -H "x-api-key: YOUR_API_KEY" \
https://api.sportsapipro.com/v2/badminton/live
Example: Search for a Player
curl -H "x-api-key: YOUR_API_KEY" \
"https://api.sportsapipro.com/v2/badminton/search?q=axelsen"