/api/v1/research/matchup/{gameId}

GET

const url = 'https://nbaproplab.com/api/v1/research/matchup/1';
const options = {
  method: 'GET',
  headers: {Authorization: 'Bearer <token>', 'X-API-Key': '<X-API-Key>'}
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://nbaproplab.com/api/v1/research/matchup/1 \
  --header 'Authorization: Bearer <token>' \
  --header 'X-API-Key: <X-API-Key>'

Authorizations

Parameters

Path Parameters

gameId

required

integer format: int32

/^-?(?:0|[1-9]\d*)$/

Responses

200

object

gameId

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

gameDate

required

string format: date-time

isPlayoffs

required

boolean

seriesStatus

required

null | string

home

required

object

teamId

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

abbreviation

required

string

fullName

required

string

isHome

required

boolean

isBackToBack

required

boolean

defense

required

One of:

null
object

null

dvp

required

Array<object>

object

position

required

string

stat

required

string

ratio

required

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

playTypeStrengths

required

Array<object>

object

playType

required

string

rank

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

pointsPerPossessionAllowed

required

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

playTypeWeaknesses

required

Array<object>

object

playType

required

string

rank

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

pointsPerPossessionAllowed

required

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

away

required

object

teamId

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

abbreviation

required

string

fullName

required

string

isHome

required

boolean

isBackToBack

required

boolean

defense

required

One of:

null
object

null

dvp

required

Array<object>

object

position

required

string

stat

required

string

ratio

required

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

playTypeStrengths

required

Array<object>

object

playType

required

string

rank

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

pointsPerPossessionAllowed

required

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

playTypeWeaknesses

required

Array<object>

object

playType

required

string

rank

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

pointsPerPossessionAllowed

required

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

spread

required

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

total

required

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

pace

required

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

picks

required

Array<object>

object

pickId

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

playerId

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

playerName

required

string

teamId

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

teamAbbreviation

required

string

stat

required

string

line

required

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

direction

required

string

scoreFinal

required

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

rating

required

string

ratingEmoji

required

string

generatedAt

required

string format: date-time

object

gameId

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

gameDate

required

string format: date-time

isPlayoffs

required

boolean

seriesStatus

required

null | string

home

required

object

teamId

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

abbreviation

required

string

fullName

required

string

isHome

required

boolean

isBackToBack

required

boolean

defense

required

One of:

null
object

null

dvp

required

Array<object>

object

position

required

string

stat

required

string

ratio

required

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

playTypeStrengths

required

Array<object>

object

playType

required

string

rank

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

pointsPerPossessionAllowed

required

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

playTypeWeaknesses

required

Array<object>

object

playType

required

string

rank

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

pointsPerPossessionAllowed

required

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

away

required

object

teamId

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

abbreviation

required

string

fullName

required

string

isHome

required

boolean

isBackToBack

required

boolean

defense

required

One of:

null
object

null

dvp

required

Array<object>

object

position

required

string

stat

required

string

ratio

required

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

playTypeStrengths

required

Array<object>

object

playType

required

string

rank

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

pointsPerPossessionAllowed

required

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

playTypeWeaknesses

required

Array<object>

object

playType

required

string

rank

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

pointsPerPossessionAllowed

required

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

spread

required

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

total

required

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

pace

required

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

picks

required

Array<object>

object

pickId

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

playerId

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

playerName

required

string

teamId

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

teamAbbreviation

required

string

stat

required

string

line

required

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

direction

required

string

scoreFinal

required

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

rating

required

string

ratingEmoji

required

string

generatedAt

required

string format: date-time

Example ^generated

{
  "gameId": 1,
  "gameDate": "2026-04-15T12:00:00Z",
  "isPlayoffs": true,
  "seriesStatus": "example",
  "home": {
    "teamId": 1,
    "abbreviation": "example",
    "fullName": "example",
    "isHome": true,
    "isBackToBack": true,
    "defense": {
      "defRating": 1,
      "oppPace": 1,
      "defRankPts": 1,
      "defRankReb": 1,
      "defRankAst": 1,
      "defRankThree": 1,
      "oppFgPctAtRim": 1,
      "oppFgPctMidrange": 1,
      "oppFgPctThree": 1
    },
    "dvp": [
      {
        "position": "example",
        "stat": "example",
        "ratio": 1
      }
    ],
    "playTypeStrengths": [
      {
        "playType": "example",
        "rank": 1,
        "pointsPerPossessionAllowed": 1
      }
    ],
    "playTypeWeaknesses": [
      {
        "playType": "example",
        "rank": 1,
        "pointsPerPossessionAllowed": 1
      }
    ]
  },
  "away": {
    "teamId": 1,
    "abbreviation": "example",
    "fullName": "example",
    "isHome": true,
    "isBackToBack": true,
    "defense": {
      "defRating": 1,
      "oppPace": 1,
      "defRankPts": 1,
      "defRankReb": 1,
      "defRankAst": 1,
      "defRankThree": 1,
      "oppFgPctAtRim": 1,
      "oppFgPctMidrange": 1,
      "oppFgPctThree": 1
    },
    "dvp": [
      {
        "position": "example",
        "stat": "example",
        "ratio": 1
      }
    ],
    "playTypeStrengths": [
      {
        "playType": "example",
        "rank": 1,
        "pointsPerPossessionAllowed": 1
      }
    ],
    "playTypeWeaknesses": [
      {
        "playType": "example",
        "rank": 1,
        "pointsPerPossessionAllowed": 1
      }
    ]
  },
  "spread": 1,
  "total": 1,
  "pace": 1,
  "picks": [
    {
      "pickId": 1,
      "playerId": 1,
      "playerName": "example",
      "teamId": 1,
      "teamAbbreviation": "example",
      "stat": "example",
      "line": 1,
      "direction": "example",
      "scoreFinal": 1,
      "rating": "example",
      "ratingEmoji": "example"
    }
  ],
  "generatedAt": "2026-04-15T12:00:00Z"
}

object

gameId

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

gameDate

required

string format: date-time

isPlayoffs

required

boolean

seriesStatus

required

null | string

home

required

object

teamId

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

abbreviation

required

string

fullName

required

string

isHome

required

boolean

isBackToBack

required

boolean

defense

required

One of:

null
object

null

dvp

required

Array<object>

object

position

required

string

stat

required

string

ratio

required

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

playTypeStrengths

required

Array<object>

object

playType

required

string

rank

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

pointsPerPossessionAllowed

required

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

playTypeWeaknesses

required

Array<object>

object

playType

required

string

rank

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

pointsPerPossessionAllowed

required

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

away

required

object

teamId

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

abbreviation

required

string

fullName

required

string

isHome

required

boolean

isBackToBack

required

boolean

defense

required

One of:

null
object

null

dvp

required

Array<object>

object

position

required

string

stat

required

string

ratio

required

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

playTypeStrengths

required

Array<object>

object

playType

required

string

rank

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

pointsPerPossessionAllowed

required

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

playTypeWeaknesses

required

Array<object>

object

playType

required

string

rank

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

pointsPerPossessionAllowed

required

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

spread

required

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

total

required

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

pace

required

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

picks

required

Array<object>

object

pickId

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

playerId

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

playerName

required

string

teamId

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

teamAbbreviation

required

string

stat

required

string

line

required

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

direction

required

string

scoreFinal

required

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

rating

required

string

ratingEmoji

required

string

generatedAt

required

string format: date-time

Example ^generated

{
  "gameId": 1,
  "gameDate": "2026-04-15T12:00:00Z",
  "isPlayoffs": true,
  "seriesStatus": "example",
  "home": {
    "teamId": 1,
    "abbreviation": "example",
    "fullName": "example",
    "isHome": true,
    "isBackToBack": true,
    "defense": {
      "defRating": 1,
      "oppPace": 1,
      "defRankPts": 1,
      "defRankReb": 1,
      "defRankAst": 1,
      "defRankThree": 1,
      "oppFgPctAtRim": 1,
      "oppFgPctMidrange": 1,
      "oppFgPctThree": 1
    },
    "dvp": [
      {
        "position": "example",
        "stat": "example",
        "ratio": 1
      }
    ],
    "playTypeStrengths": [
      {
        "playType": "example",
        "rank": 1,
        "pointsPerPossessionAllowed": 1
      }
    ],
    "playTypeWeaknesses": [
      {
        "playType": "example",
        "rank": 1,
        "pointsPerPossessionAllowed": 1
      }
    ]
  },
  "away": {
    "teamId": 1,
    "abbreviation": "example",
    "fullName": "example",
    "isHome": true,
    "isBackToBack": true,
    "defense": {
      "defRating": 1,
      "oppPace": 1,
      "defRankPts": 1,
      "defRankReb": 1,
      "defRankAst": 1,
      "defRankThree": 1,
      "oppFgPctAtRim": 1,
      "oppFgPctMidrange": 1,
      "oppFgPctThree": 1
    },
    "dvp": [
      {
        "position": "example",
        "stat": "example",
        "ratio": 1
      }
    ],
    "playTypeStrengths": [
      {
        "playType": "example",
        "rank": 1,
        "pointsPerPossessionAllowed": 1
      }
    ],
    "playTypeWeaknesses": [
      {
        "playType": "example",
        "rank": 1,
        "pointsPerPossessionAllowed": 1
      }
    ]
  },
  "spread": 1,
  "total": 1,
  "pace": 1,
  "picks": [
    {
      "pickId": 1,
      "playerId": 1,
      "playerName": "example",
      "teamId": 1,
      "teamAbbreviation": "example",
      "stat": "example",
      "line": 1,
      "direction": "example",
      "scoreFinal": 1,
      "rating": "example",
      "ratingEmoji": "example"
    }
  ],
  "generatedAt": "2026-04-15T12:00:00Z"
}

401

Authentication required.

application/problem+json

object

type

null | string

title

null | string

status

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

detail

null | string

instance

null | string

Example ^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

403

Insufficient permissions or tier.

application/problem+json

object

type

null | string

title

null | string

status

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

detail

null | string

instance

null | string

Example ^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

/api/v1/research/matchup/{gameId}

Authorizations

Parameters

Path Parameters

Responses

200

Example generated

Example generated

401

Example generated

403

Example generated

Example ^generated

Example ^generated

Example ^generated

Example ^generated