Skip to main content

​
Base URL

https://v2.basketball.sportsapipro.com
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

GET /api/match/{matchId}
Returns full match details including scores, teams, venue, status, and timestamps.
​
matchId
number
required
Numeric match ID. Discover via /api/live, /api/schedule/{date}, or /api/search.

​
Get Period Scores

GET /api/match/{matchId}/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

status.codestatus.typestatus.descriptionMeaning
0"notstarted""Not started"Game not yet started
13"inprogress""1st Quarter"1st quarter in progress
14"inprogress""2nd Quarter"2nd quarter
15"inprogress""3rd Quarter"3rd quarter
16"inprogress""4th Quarter"4th quarter
17"inprogress""Overtime"Overtime period
30"inprogress""Pause"Between quarters/halftime
31"inprogress""Halftime"Halftime break
60"postponed""Postponed"Game postponed
70"cancelled""Cancelled"Game cancelled
100"finished""Ended"Game completed
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

GET /api/match/{matchId}/lineups
Returns starting five and bench players for both teams, including jersey numbers and positions (G, F, C).

​
Get Statistics

GET /api/match/{matchId}/statistics
Returns team statistics: FG%, 3PT%, FT%, rebounds, assists, steals, blocks, turnovers, and more.

​
Get Incidents / Play-by-Play

GET /api/match/{matchId}/incidents
Returns play-by-play events: baskets, fouls, free throws, timeouts, and substitutions in chronological order.

​
Get Referee

GET /api/match/{matchId}/referee
Returns referee details assigned to the match.

​
Get Venue

GET /api/match/{matchId}/venue
Returns arena information: name, city, capacity, and location.

​
Player Statistics

​
All Player Box Scores

GET /api/match/{matchId}/player-statistics
Returns comprehensive box scores for all players: points, rebounds, assists, steals, blocks, FG/3PT/FT splits, minutes, and plus/minus.

​
Specific Player Statistics

GET /api/match/{matchId}/player/{playerId}/statistics
Returns detailed statistics for a specific player in the match.
​
playerId
number
required
Numeric player ID. Get from lineups or match details.

​
Best Players

GET /api/match/{matchId}/best-players
Returns the top performers from the match with ratings and key stats.

​
Award / MVP

GET /api/match/{matchId}/award
Returns MVP / best player summary for the match.

​
Analysis

​
Momentum Graph

GET /api/match/{matchId}/graph
Returns momentum/scoring graph data showing the flow of the game over time.

​
Head to Head

GET /api/match/{matchId}/h2h
Returns head-to-head history between the two teams.

​
Pre-Game Form

GET /api/match/{matchId}/pregame-form
Returns recent form for both teams going into the game (last 5–10 results).

​
Team Streaks

GET /api/match/{matchId}/streaks
Returns streak data for both teams (e.g., “5 wins in a row”, “3-game losing streak”).

​
Betting & Odds

GET /api/match/{matchId}/odds
Returns featured betting odds for the match.

​
All Odds

GET /api/match/{matchId}/odds/all
Returns odds from all available providers and markets.

​
Pre-Match Odds

GET /api/match/{matchId}/odds/pre-match
Returns pre-match odds snapshot.

​
Live Odds

GET /api/match/{matchId}/odds/live
Returns live in-game odds that update during the match.

​
Winning Odds

GET /api/match/{matchId}/winning-odds
Returns win probability movement for the match.

​
Pre-Match Data

​
Predicted Lineups

GET /api/match/{matchId}/predicted-lineups
Returns expected starting five before the official lineups are announced.

​
Missing Players

GET /api/match/{matchId}/missing-players
Returns injured and suspended players for both teams.

​
Media & Other

​
Highlights

GET /api/match/{matchId}/highlights
Returns video highlight links for the match.

​
Media

GET /api/match/{matchId}/media
Returns media content associated with the match.

​
Managers / Coaches

GET /api/match/{matchId}/managers
Returns head coach details for both teams.

​
Fan Votes

GET /api/match/{matchId}/votes
Returns fan voting/prediction results.

​
TV Channels

GET /api/match/{matchId}/channels
Returns TV broadcast channels organized by country.

​
Example Requests

curl -X GET "https://v2.basketball.sportsapipro.com/api/match/12345678/statistics" \
  -H "x-api-key: YOUR_API_KEY"
Last modified on April 12, 2026