NBA & NCAAB API / matches

Get match by ID

GET https://nba.highlightly.net/matches/{id} NBA & NCAAB API
GET https://sports.highlightly.net/nba/matches/{id} All Sports API

Retrieve detailed information for one match.

This is the detail view. Matches returns general information for a list of games, and this route fills in everything that route leaves out.

Parameters

Parameter Type Description
idrequired numberpath Requested match id.

Request

curl --request GET \
  --url 'https://nba.highlightly.net/matches/{id}' \
  --header 'x-rapidapi-key: YOUR_API_KEY'
const response = await fetch('https://nba.highlightly.net/matches/{id}', {
  headers: {
    'x-rapidapi-key': process.env.HIGHLIGHTLY_API_KEY
  }
})

if (!response.ok) {
  throw new Error(`Highlightly responded ${response.status}`)
}

const data = await response.json()
import os
import requests

response = requests.get(
    'https://nba.highlightly.net/matches/{id}',
    headers={
        'x-rapidapi-key': os.environ['HIGHLIGHTLY_API_KEY'],
    },
    timeout=10,
)

response.raise_for_status()
data = response.json()

Response

idnumberrequired
leaguestringrequiredNBANCAA
seasonnumberrequired
stateNbaMatchStateResponserequired6 fields
clocknumberrequiredTime left for a game to finish.
scoreNbaMatchScoreResponserequired2 fields
awayTeamnumber[]requiredCurrent away team result for each inning.
homeTeamnumber[]requiredCurrent home team result for each inning.
periodnumberrequiredCurrent period
descriptionstringrequiredCurrent game state descriptionSuspendedPostponedCancelledAbandonedFinishedScheduledIn progressEnd periodHalf timeUnknown
homeTeamNbaTeamInfoResponserequired5 fields
idnumberrequired
displayNamestringrequired
namestringrequired
logostring
abbreviationstringrequired
awayTeamNbaTeamInfoResponserequired5 fields
idnumberrequired
displayNamestringrequired
namestringrequired
logostring
abbreviationstringrequired
datestringrequired
venueVenueDetails3 fields
citystring
namestring
statestring
forecastDetailedMatchForecastResponse2 fields
statusstring
temperaturestring
matchStatisticsMatchStatistics8 fields
awayTeamMatchTeamStatisticsrequired3 fields
statisticsMatchStatisticsItem[]required2 fields
namestringrequiredDisplay name for each statistics info.
valuenumberrequired
homeTeamMatchTeamStatisticsrequired3 fields
statisticsMatchStatisticsItem[]required2 fields
namestringrequiredDisplay name for each statistics info.
valuenumberrequired
eventsEvent[]11 fields
teamNbaTeamInfoResponserequired5 fields
idnumberrequired
displayNamestringrequired
namestringrequired
logostring
abbreviationstringrequired
clockstring
periodstring
descriptionstring
isScoringPlaybooleanboolean describing whether specific event is scoring or not
isShootingPlaybooleanboolean describing whether specific play is shooting or not
predictionsPredictionResponse18 fields
prematchPrediction[]required8 fields
typestringrequired
modelTypestringrequired
generatedAtstringrequired
descriptionstringrequired
probabilitiesPredictionProbabilitiesrequired3 fields
homestringrequired
drawstring
awaystringrequired
livePrediction[]required8 fields
typestringrequired
modelTypestringrequired
generatedAtstringrequired
descriptionstringrequired
probabilitiesPredictionProbabilitiesrequired3 fields
homestringrequired
drawstring
awaystringrequired

Example response

200 application/json 
[
  {
    "id": 5294,
    "league": "NBA",
    "season": 2024,
    "state": {
      "clock": 0,
      "score": {
        "awayTeam": [
          0
        ],
        "homeTeam": [
          0
        ]
      },
      "period": 4,
      "description": "Finished"
    },
    "homeTeam": {
      "id": 3,
      "displayName": "Denver Nuggets",
      "name": "Nuggets",
      "logo": "https://highlightly.net/nba/images/teams/3.png",
      "abbreviation": "DEN"
    },
    "awayTeam": {
      "id": 3,
      "displayName": "Denver Nuggets",
      "name": "Nuggets",
      "logo": "https://highlightly.net/nba/images/teams/3.png",
      "abbreviation": "DEN"
    },
    "date": "2024-04-07T01:00:00.000Z",
    "venue": {
      "city": "Denver",
      "name": "Ball Arena",
      "state": "CO"
    },
    "forecast": {
      "status": "cloudy",
      "temperature": "11.97°C"
    },
    "matchStatistics": {
      "awayTeam": {
        "statistics": [
          {
            "name": "3PT Accuracy",
            "value": "Numeric value representing statistics data."
          }
        ]
      },
      "homeTeam": {
        "statistics": [
          {
            "name": "3PT Accuracy",
            "value": "Numeric value representing statistics data."
          }
        ]
      }
    },
    "events": [
      {
        "team": {
          "id": 3,
          "displayName": "Denver Nuggets",
          "name": "Nuggets",
          "logo": "https://highlightly.net/nba/images/teams/3.png",
          "abbreviation": "DEN"
        },
        "clock": "12:00",
        "period": "1st Quarter",
        "description": "Rudy Gobert vs. Nikola Jokic (Anthony Edwards gains possession)",
        "isScoringPlay": false,
        "isShootingPlay": false
      }
    ],
    "predictions": {
      "prematch": [
        {
          "type": "prematch",
          "modelType": "three-way",
          "generatedAt": "2025-03-12T19:00:20.000Z",
          "description": "Team A is most likely to win the game against Team B.`",
          "probabilities": {
            "home": "30.22%",
            "draw": "0.00%",
            "away": "69.78%"
          }
        }
      ],
      "live": [
        {
          "type": "prematch",
          "modelType": "three-way",
          "generatedAt": "2025-03-12T19:00:20.000Z",
          "description": "Team A is most likely to win the game against Team B.`",
          "probabilities": {
            "home": "30.22%",
            "draw": "0.00%",
            "away": "69.78%"
          }
        }
      ]
    }
  }
]

Values are the examples declared in the OpenAPI spec, not a captured live response.

Errors

Status Description
400 Bad request descriptive error.
500 Internal server error.