NBA & NCAAB API / lineups

Lineups

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

Retrieve the home and away lineups for a game.

When to query
Up to a few hours before the game starts

The matchId comes from matches.

Both squads come back together, so one request covers the whole game rather than one per side.

Lineups rendered in a client application

Parameters

Parameter Type Description
matchIdrequired numberpath Requested match id.

Request

curl --request GET \
  --url 'https://nba.highlightly.net/lineups/{matchId}' \
  --header 'x-rapidapi-key: YOUR_API_KEY'
const response = await fetch('https://nba.highlightly.net/lineups/{matchId}', {
  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/lineups/{matchId}',
    headers={
        'x-rapidapi-key': os.environ['HIGHLIGHTLY_API_KEY'],
    },
    timeout=10,
)

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

Response

homeNbaLineupsrequired14 fields
teamNbaTeamResponserequired6 fields
idnumberrequired
logostring
namestring
displayNamestringrequired
abbreviationstringrequired
leaguestringrequiredNBANCAA
lineupNbaLineupsPlayer[]required6 fields
idnumberrequired
jerseynumber
playerstringrequired
positionstringrequired
positionAbbreviationstringrequired
isStarterboolean
awayNbaLineupsrequired14 fields
teamNbaTeamResponserequired6 fields
idnumberrequired
logostring
namestring
displayNamestringrequired
abbreviationstringrequired
leaguestringrequiredNBANCAA
lineupNbaLineupsPlayer[]required6 fields
idnumberrequired
jerseynumber
playerstringrequired
positionstringrequired
positionAbbreviationstringrequired
isStarterboolean

Example response

200 application/json 
{
  "home": {
    "team": {
      "id": 28,
      "logo": "https://highlightly.net/nba/images/teams/28.png",
      "name": "Rockets",
      "displayName": "Houston Rockets",
      "abbreviation": "HOU",
      "league": "NBA"
    },
    "lineup": [
      {
        "id": 61000787,
        "jersey": 28,
        "player": "Hachimura",
        "position": "Small forward",
        "positionAbbreviation": "SF",
        "isStarter": true
      }
    ]
  },
  "away": {
    "team": {
      "id": 28,
      "logo": "https://highlightly.net/nba/images/teams/28.png",
      "name": "Rockets",
      "displayName": "Houston Rockets",
      "abbreviation": "HOU",
      "league": "NBA"
    },
    "lineup": [
      {
        "id": 61000787,
        "jersey": 28,
        "player": "Hachimura",
        "position": "Small forward",
        "positionAbbreviation": "SF",
        "isStarter": true
      }
    ]
  }
}

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.