Base URL
All match endpoints use the pattern /api/match/{matchId}/...
Finding Match IDs: Use /api/live for current matches, /api/schedule/{date} for scheduled matches, or /api/search?q=team to find matches by team name. Match IDs are numeric.
Core Match Data
Get Match Details
Returns full match details including scores, teams, venue, status, and timestamps.
Numeric match ID. Discover via /api/live, /api/schedule/{date}, or /api/search.
Get Period Scores
Returns period-by-period scores: Q1, Q2, Q3, Q4, overtime periods, and final score.
Basketball scores include period1 through period4, plus overtime and normaltime fields — unlike football which uses halftime periods.
Basketball Status Codes
Pattern: Quarter codes are 12 + quarter_number. So 1st quarter = 13, 2nd = 14, 3rd = 15, 4th = 16. The statusCode field in /api/live responses matches status.code in match detail responses.
Get Lineups
Returns starting five and bench players for both teams, including jersey numbers and positions (G, F, C).
Get Statistics
Returns team statistics: FG%, 3PT%, FT%, rebounds, assists, steals, blocks, turnovers, and more.
Get Incidents / Play-by-Play
Returns play-by-play events: baskets, fouls, free throws, timeouts, and substitutions in chronological order.
Get Referee
Returns referee details assigned to the match.
Get Venue
Returns arena information: name, city, capacity, and location.
Player Statistics
All Player Box Scores
Returns comprehensive box scores for all players: points, rebounds, assists, steals, blocks, FG/3PT/FT splits, minutes, and plus/minus.
Specific Player Statistics
Returns detailed statistics for a specific player in the match.
Numeric player ID. Get from lineups or match details.
Best Players
Returns the top performers from the match with ratings and key stats.
Award / MVP
Returns MVP / best player summary for the match.
Analysis
Momentum Graph
Returns momentum/scoring graph data showing the flow of the game over time.
Head to Head
Returns head-to-head history between the two teams.
Returns recent form for both teams going into the game (last 5–10 results).
Team Streaks
Returns streak data for both teams (e.g., “5 wins in a row”, “3-game losing streak”).
Betting & Odds
Featured Odds
Returns featured betting odds for the match.
All Odds
Returns odds from all available providers and markets.
Pre-Match Odds
Returns pre-match odds snapshot.
Live Odds
Returns live in-game odds that update during the match.
Winning Odds
Returns win probability movement for the match.
Pre-Match Data
Predicted Lineups
Returns expected starting five before the official lineups are announced.
Missing Players
Returns injured and suspended players for both teams.
Highlights
Returns video highlight links for the match.
Returns media content associated with the match.
Managers / Coaches
Returns head coach details for both teams.
Fan Votes
Returns fan voting/prediction results.
TV Channels
Returns TV broadcast channels organized by country.
Example Requests
