Match Endpoints - SportsAPI Pro

Base URL

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

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.

number

required

Numeric match ID. Discover via /api/live, /api/schedule/{date}, or /api/search.

Get Period Scores

GET /api/match/{matchId}/scores

Example response

Recorded 24 October 2026 from GET /v2/basketball/api/match/16624778/scores (lists trimmed to 2 items).

{
  "success": true,
  "matchId": 16624778,
  "source": "live",
  "scores": {
    "current": {
      "home": 85,
      "away": 96
    },
    "period1": {
      "home": 25,
      "away": 35
    },
    "period2": {
      "home": 25,
      "away": 18
    },
    "period3": {
      "home": 12,
      "away": 21
    },
    "period4": {
      "home": 23,
      "away": 22
    },
    "overtime": {},
    "normaltime": {
      "home": 85,
      "away": 96
    }
  },
  "timezone": {
    "name": "Europe/Paris",
    "utcOffset": "+02:00",
    "source": "auto",
    "country": "FR"
  }
}

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.code`	`status.type`	`status.description`	Meaning
`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

Example response

Recorded 24 October 2026 from GET /v2/basketball/api/match/16607282/lineups (lists trimmed to 1 item).

{
  "success": true,
  "matchId": 16607282,
  "endpoint": "lineups",
  "data": {
    "confirmed": false,
    "home": {
      "players": [
        {
          "player": {
            "name": "Simo Asikainen",
            "firstName": "Simo Asikainen",
            "slug": "simo-asikainen",
            "shortName": "S. Asikainen",
            "userCount": 0,
            "gender": "M",
            "country": {},
            "id": 2825907,
            "marketValueCurrency": "EUR"
          },
          "teamId": 6512,
          "shirtNumber": 44,
          "jerseyNumber": "44",
          "substitute": true,
          "statistics": {
            "secondsPlayed": 650,
            "points": 0,
            "twoPointsMade": 0,
            "twoPointAttempts": 2,
            "threePointsMade": 0,
            "threePointAttempts": 0,
            "freeThrowsMade": 0,
            "freeThrowAttempts": 0,
            "fieldGoalsMade": 0,
            "fieldGoalAttempts": 2,
            "rebounds": 1,
            "defensiveRebounds": 1,
            "offensiveRebounds": 0,
            "turnovers": 0,
            "blocks": 0,
            "personalFouls": 0,
            "assists": 0,
            "steals": 0,
            "plusMinus": 13,
            "rating": 5.9,
            "fieldGoalPct": 0,
            "statisticsType": {
              "sportSlug": "basketball",
              "statisticsType": "player"
            }
          },
          "minutesPlayed": null,
          "played": false
        }
      ],
      "supportStaff": [],
      "playerColor": {
        "primary": "000000",
        "number": "222226",
        "outline": "808080",
        "fancyNumber": "222226"
      },
      "goalkeeperColor": {
        "primary": "000000",
        "number": "222226",
        "outline": "808080",
        "fancyNumber": "222226"
      }
    },
    "away": {
      "players": [
        {
          "player": {
            "name": "Joonas Voksep",
            "firstName": "Joonas",
            "lastName": "Voksep",
            "slug": "joonas-voksep",
            "shortName": "J. Voksep",
            "jerseyNumber": "0",
            "height": 200,
            "userCount": 0,
            "gender": "M",
            "country": {},
            "id": 2351561,
            "marketValueCurrency": "EUR",
            "dateOfBirthTimestamp": 1267228800,
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "يوناس فوكسيب",
                "ru": "Йоонас Воксеп"
              },
              "shortNameTranslation": {
                "ar": "ي. فوكسيب",
                "ru": "Й. Воксеп"
              }
            }
          },
          "teamId": 176696,
          "shirtNumber": 1,
          "jerseyNumber": "1",
          "substitute": true,
          "statistics": {
            "secondsPlayed": 67,
            "points": 0,
            "twoPointsMade": 0,
            "twoPointAttempts": 0,
            "threePointsMade": 0,
            "threePointAttempts": 0,
            "freeThrowsMade": 0,
            "freeThrowAttempts": 0,
            "fieldGoalsMade": 0,
            "fieldGoalAttempts": 0,
            "rebounds": 0,
            "defensiveRebounds": 0,
            "offensiveRebounds": 0,
            "turnovers": 1,
            "blocks": 0,
            "personalFouls": 0,
            "assists": 0,
            "steals": 0,
            "plusMinus": -7,
            "statisticsType": {
              "sportSlug": "basketball",
              "statisticsType": "player"
            }
          },
          "minutesPlayed": null,
          "played": false
        }
      ],
      "supportStaff": [],
      "playerColor": {
        "primary": "000000",
        "number": "222226",
        "outline": "808080",
        "fancyNumber": "222226"
      },
      "goalkeeperColor": {
        "primary": "000000",
        "number": "222226",
        "outline": "808080",
        "fancyNumber": "222226"
      }
    }
  },
  "source": "live",
  "cacheHit": true,
  "timezone": {
    "name": "Europe/Paris",
    "utcOffset": "+02:00",
    "source": "auto",
    "country": "FR"
  }
}

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

The full-game box score for every player is in the Lineups response: GET /api/match/{matchId}/lineups. Each player’s statistics object holds points, rebounds, assists, steals, blocks, FG/3PT/FT splits, secondsPlayed and plus/minus. On a finished game, player points add up to the final score.

GET /api/match/{matchId}/player-statistics is not the box score source for basketball and can return 404, even when hasEventPlayerStatistics is true. Use /lineups instead. During a live game, /lineups is an in-progress snapshot; fetch it again 15–30 minutes after status.type becomes finished and treat that copy as final.

Specific Player Statistics

GET /api/match/{matchId}/player/{playerId}/statistics

Returns detailed statistics for a specific player in the match.

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

Featured 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://api.sportsapipro.com/v2/basketball/match/12345678/statistics" \
  -H "x-api-key: YOUR_API_KEY"

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

import requests

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

​Base URL

​Core Match Data

​Get Match Details

​Get Period Scores

​Basketball Status Codes

​Get Lineups

​Get Statistics

​Get Incidents / Play-by-Play

​Get Referee

​Get Venue

​Player Statistics

​All Player Box Scores

​Specific Player Statistics

​Best Players

​Award / MVP

​Analysis

​Momentum Graph

​Head to Head

​Pre-Game Form

​Team Streaks

​Betting & Odds

​Featured Odds

​All Odds

​Pre-Match Odds

​Live Odds

​Winning Odds

​Pre-Match Data

​Predicted Lineups

​Missing Players

​Media & Other

​Highlights

​Media

​Managers / Coaches

​Fan Votes

​TV Channels

​Example Requests

Base URL

Core Match Data

Get Match Details

Get Period Scores

Basketball Status Codes

Get Lineups

Get Statistics

Get Incidents / Play-by-Play

Get Referee

Get Venue

Player Statistics

All Player Box Scores

Specific Player Statistics

Best Players

Award / MVP

Analysis

Momentum Graph

Head to Head

Pre-Game Form

Team Streaks

Betting & Odds

Featured Odds

All Odds

Pre-Match Odds

Live Odds

Winning Odds

Pre-Match Data

Predicted Lineups

Missing Players

Media & Other

Highlights

Media

Managers / Coaches

Fan Votes

TV Channels

Example Requests