Live, Schedule & Search Endpoints

Badminton V2 live scores, schedules, search, and discovery

Live & Schedule Endpoints (7)

All endpoints use base URL https://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"