/api/v1/picks/evaluate

POST

/api/v1/picks/evaluate

curl --request POST \
  --url https://nbaproplab.com/api/v1/picks/evaluate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: score-day-2026-05-27-001' \
  --header 'X-API-Key: <X-API-Key>' \
  --data '{ "playerId": 1, "stat": "example", "line": 1, "direction": "example", "gameDate": "example", "opponentTeamId": 1, "league": "example" }'

Authorizations

• BearerJwt
• OpsToken
• X-API-Key

Parameters

Header Parameters

Idempotency-Key

string

Unique key for safe retry. Duplicate requests return the original operation.

Example

score-day-2026-05-27-001

Request Body ^required

object

playerId

required

integer | string format: int32

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

stat

required

string

line

required

number | string format: double

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

direction

required

string

gameDate

null | string

opponentTeamId

null | integer | string format: int32

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

league

null | string

Example ^generated

{
  "playerId": 1,
  "stat": "example",
  "line": 1,
  "direction": "example",
  "gameDate": "example",
  "opponentTeamId": 1,
  "league": "example"
}

object

playerId

required

integer | string format: int32

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

stat

required

string

line

required

number | string format: double

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

direction

required

string

gameDate

null | string

opponentTeamId

null | integer | string format: int32

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

league

null | string

Example ^generated

{
  "playerId": 1,
  "stat": "example",
  "line": 1,
  "direction": "example",
  "gameDate": "example",
  "opponentTeamId": 1,
  "league": "example"
}

object

playerId

required

integer | string format: int32

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

stat

required

string

line

required

number | string format: double

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

direction

required

string

gameDate

null | string

opponentTeamId

null | integer | string format: int32

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

league

null | string

Example ^generated

{
  "playerId": 1,
  "stat": "example",
  "line": 1,
  "direction": "example",
  "gameDate": "example",
  "opponentTeamId": 1,
  "league": "example"
}

Responses

200

OK

object

playerName

string

stat

string

direction

string

line

number | string format: double

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

finalScore

number | string format: double

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

finalConfidence

number | string format: double

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

rating

string

ratingEmoji

string

blocks

Array<object>

object

blockType

string

score

number | string format: double

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

confidence

number | string format: double

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

subScores

object

key

additional properties

number | string format: double

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

explanation

string

spiderChart

object

name

string

axes

Array<object>

object

label

string

value

number | string format: double

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

max

number | string format: double

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

evaluatedAt

string format: date-time

object

playerName

string

stat

string

direction

string

line

number | string format: double

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

finalScore

number | string format: double

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

finalConfidence

number | string format: double

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

rating

string

ratingEmoji

string

blocks

Array<object>

object

blockType

string

score

number | string format: double

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

confidence

number | string format: double

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

subScores

object

key

additional properties

number | string format: double

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

explanation

string

spiderChart

object

name

string

axes

Array<object>

object

label

string

value

number | string format: double

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

max

number | string format: double

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

evaluatedAt

string format: date-time

Example ^generated

{
  "playerName": "example",
  "stat": "example",
  "direction": "example",
  "line": 1,
  "finalScore": 1,
  "finalConfidence": 1,
  "rating": "example",
  "ratingEmoji": "example",
  "blocks": [
    {
      "blockType": "example",
      "score": 1,
      "confidence": 1,
      "subScores": {
        "additionalProperty": 1
      },
      "explanation": "example"
    }
  ],
  "spiderChart": {
    "name": "example",
    "axes": [
      {
        "label": "example",
        "value": 1,
        "max": 1
      }
    ]
  },
  "evaluatedAt": "2026-04-15T12:00:00Z"
}

object

playerName

string

stat

string

direction

string

line

number | string format: double

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

finalScore

number | string format: double

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

finalConfidence

number | string format: double

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

rating

string

ratingEmoji

string

blocks

Array<object>

object

blockType

string

score

number | string format: double

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

confidence

number | string format: double

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

subScores

object

key

additional properties

number | string format: double

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

explanation

string

spiderChart

object

name

string

axes

Array<object>

object

label

string

value

number | string format: double

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

max

number | string format: double

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

evaluatedAt

string format: date-time

Example ^generated

{
  "playerName": "example",
  "stat": "example",
  "direction": "example",
  "line": 1,
  "finalScore": 1,
  "finalConfidence": 1,
  "rating": "example",
  "ratingEmoji": "example",
  "blocks": [
    {
      "blockType": "example",
      "score": 1,
      "confidence": 1,
      "subScores": {
        "additionalProperty": 1
      },
      "explanation": "example"
    }
  ],
  "spiderChart": {
    "name": "example",
    "axes": [
      {
        "label": "example",
        "value": 1,
        "max": 1
      }
    ]
  },
  "evaluatedAt": "2026-04-15T12:00:00Z"
}

401

Authentication required.

Media type 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.

Media type 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"
}