APIMatches

Get the box score

Per-player and team totals already summed from the tagged events: points, shooting splits, rebounds, assists, steals, blocks, turnovers, fouls, minutes and efficiency. Matches what the Superstat app shows on the match report.

GET

/v1/matches/{matchId}/box-score

GET

/v1/matches/{matchId}/box-score

curl -X GET "https://api.superstatsport.com/v1/matches/3fa85f64-5717-4562-b3fc-2c963f66afa6/box-score" \
  -H "Authorization: Bearer $SUPERSTAT_API_KEY"

Authorization

Authorization
string
header
required
Club API key, for example ss_live_…. Create one in the Superstat app under Settings → API keys.

Parameters

matchId
string<uuid>
path
required
Match id.

Response

application/json

Success

data
MatchBoxScore
required
error
object | null
required

{
  "data": {
    "matchId": "d4e5f6a7-b8c9-4d0e-af12-3b4c5d6e7f80",
    "team": {
      "name": "Northside U16 Boys",
      "totals": {
        "points": 68,
        "fieldGoalsMade": 26,
        "fieldGoalsAttempted": 58,
        "fieldGoalPercentage": 44.8,
        "threePointersMade": 6,
        "threePointersAttempted": 18,
        "threePointPercentage": 33.3,
        "freeThrowsMade": 10,
        "freeThrowsAttempted": 14,
        "freeThrowPercentage": 71.4,
        "offensiveRebounds": 11,
        "defensiveRebounds": 23,
        "rebounds": 34,
        "assists": 15,
        "steals": 9,
        "blocks": 3,
        "turnovers": 12,
        "fouls": 16
      },
      "players": [
        {
          "points": 68,
          "fieldGoalsMade": 26,
          "fieldGoalsAttempted": 58,
          "fieldGoalPercentage": 44.8,
          "threePointersMade": 6,
          "threePointersAttempted": 18,
          "threePointPercentage": 33.3,
          "freeThrowsMade": 10,
          "freeThrowsAttempted": 14,
          "freeThrowPercentage": 71.4,
          "offensiveRebounds": 11,
          "defensiveRebounds": 23,
          "rebounds": 34,
          "assists": 15,
          "steals": 9,
          "blocks": 3,
          "turnovers": 12,
          "fouls": 16,
          "playerId": "f6a7b8c9-d0e1-4f2a-9b34-5d6e7f809102",
          "rosterEntryId": "a7b8c9d0-e1f2-4a3b-8c45-6e7f80910213",
          "name": "Ava Nguyen",
          "jerseyNumber": "7",
          "minutes": 27.4,
          "efficiency": 24,
          "trueShootingPercentage": 58.6
        }
      ]
    },
    "opponent": {
      "name": "Northside U16 Boys",
      "totals": {
        "points": 68,
        "fieldGoalsMade": 26,
        "fieldGoalsAttempted": 58,
        "fieldGoalPercentage": 44.8,
        "threePointersMade": 6,
        "threePointersAttempted": 18,
        "threePointPercentage": 33.3,
        "freeThrowsMade": 10,
        "freeThrowsAttempted": 14,
        "freeThrowPercentage": 71.4,
        "offensiveRebounds": 11,
        "defensiveRebounds": 23,
        "rebounds": 34,
        "assists": 15,
        "steals": 9,
        "blocks": 3,
        "turnovers": 12,
        "fouls": 16
      },
      "players": [
        {
          "points": 68,
          "fieldGoalsMade": 26,
          "fieldGoalsAttempted": 58,
          "fieldGoalPercentage": 44.8,
          "threePointersMade": 6,
          "threePointersAttempted": 18,
          "threePointPercentage": 33.3,
          "freeThrowsMade": 10,
          "freeThrowsAttempted": 14,
          "freeThrowPercentage": 71.4,
          "offensiveRebounds": 11,
          "defensiveRebounds": 23,
          "rebounds": 34,
          "assists": 15,
          "steals": 9,
          "blocks": 3,
          "turnovers": 12,
          "fouls": 16,
          "playerId": "f6a7b8c9-d0e1-4f2a-9b34-5d6e7f809102",
          "rosterEntryId": "a7b8c9d0-e1f2-4a3b-8c45-6e7f80910213",
          "name": "Ava Nguyen",
          "jerseyNumber": "7",
          "minutes": 27.4,
          "efficiency": 24,
          "trueShootingPercentage": 58.6
        }
      ]
    }
  },
  "error": null
}

GET

/v1/matches/{matchId}/box-score

curl -X GET "https://api.superstatsport.com/v1/matches/3fa85f64-5717-4562-b3fc-2c963f66afa6/box-score" \
  -H "Authorization: Bearer $SUPERSTAT_API_KEY"

{
  "data": {
    "matchId": "d4e5f6a7-b8c9-4d0e-af12-3b4c5d6e7f80",
    "team": {
      "name": "Northside U16 Boys",
      "totals": {
        "points": 68,
        "fieldGoalsMade": 26,
        "fieldGoalsAttempted": 58,
        "fieldGoalPercentage": 44.8,
        "threePointersMade": 6,
        "threePointersAttempted": 18,
        "threePointPercentage": 33.3,
        "freeThrowsMade": 10,
        "freeThrowsAttempted": 14,
        "freeThrowPercentage": 71.4,
        "offensiveRebounds": 11,
        "defensiveRebounds": 23,
        "rebounds": 34,
        "assists": 15,
        "steals": 9,
        "blocks": 3,
        "turnovers": 12,
        "fouls": 16
      },
      "players": [
        {
          "points": 68,
          "fieldGoalsMade": 26,
          "fieldGoalsAttempted": 58,
          "fieldGoalPercentage": 44.8,
          "threePointersMade": 6,
          "threePointersAttempted": 18,
          "threePointPercentage": 33.3,
          "freeThrowsMade": 10,
          "freeThrowsAttempted": 14,
          "freeThrowPercentage": 71.4,
          "offensiveRebounds": 11,
          "defensiveRebounds": 23,
          "rebounds": 34,
          "assists": 15,
          "steals": 9,
          "blocks": 3,
          "turnovers": 12,
          "fouls": 16,
          "playerId": "f6a7b8c9-d0e1-4f2a-9b34-5d6e7f809102",
          "rosterEntryId": "a7b8c9d0-e1f2-4a3b-8c45-6e7f80910213",
          "name": "Ava Nguyen",
          "jerseyNumber": "7",
          "minutes": 27.4,
          "efficiency": 24,
          "trueShootingPercentage": 58.6
        }
      ]
    },
    "opponent": {
      "name": "Northside U16 Boys",
      "totals": {
        "points": 68,
        "fieldGoalsMade": 26,
        "fieldGoalsAttempted": 58,
        "fieldGoalPercentage": 44.8,
        "threePointersMade": 6,
        "threePointersAttempted": 18,
        "threePointPercentage": 33.3,
        "freeThrowsMade": 10,
        "freeThrowsAttempted": 14,
        "freeThrowPercentage": 71.4,
        "offensiveRebounds": 11,
        "defensiveRebounds": 23,
        "rebounds": 34,
        "assists": 15,
        "steals": 9,
        "blocks": 3,
        "turnovers": 12,
        "fouls": 16
      },
      "players": [
        {
          "points": 68,
          "fieldGoalsMade": 26,
          "fieldGoalsAttempted": 58,
          "fieldGoalPercentage": 44.8,
          "threePointersMade": 6,
          "threePointersAttempted": 18,
          "threePointPercentage": 33.3,
          "freeThrowsMade": 10,
          "freeThrowsAttempted": 14,
          "freeThrowPercentage": 71.4,
          "offensiveRebounds": 11,
          "defensiveRebounds": 23,
          "rebounds": 34,
          "assists": 15,
          "steals": 9,
          "blocks": 3,
          "turnovers": 12,
          "fouls": 16,
          "playerId": "f6a7b8c9-d0e1-4f2a-9b34-5d6e7f809102",
          "rosterEntryId": "a7b8c9d0-e1f2-4a3b-8c45-6e7f80910213",
          "name": "Ava Nguyen",
          "jerseyNumber": "7",
          "minutes": 27.4,
          "efficiency": 24,
          "trueShootingPercentage": 58.6
        }
      ]
    }
  },
  "error": null
}

Get the box score - Superstat Help Center | Productlane

APIMatches

Get the box score

GET

/v1/matches/{matchId}/box-score

GET

/v1/matches/{matchId}/box-score

curl -X GET "https://api.superstatsport.com/v1/matches/3fa85f64-5717-4562-b3fc-2c963f66afa6/box-score" \
  -H "Authorization: Bearer $SUPERSTAT_API_KEY"

Authorization

Authorization
string
header
required
Club API key, for example ss_live_…. Create one in the Superstat app under Settings → API keys.

Parameters

matchId
string<uuid>
path
required
Match id.

Response

application/json

Success

data
MatchBoxScore
required
error
object | null
required

{
  "data": {
    "matchId": "d4e5f6a7-b8c9-4d0e-af12-3b4c5d6e7f80",
    "team": {
      "name": "Northside U16 Boys",
      "totals": {
        "points": 68,
        "fieldGoalsMade": 26,
        "fieldGoalsAttempted": 58,
        "fieldGoalPercentage": 44.8,
        "threePointersMade": 6,
        "threePointersAttempted": 18,
        "threePointPercentage": 33.3,
        "freeThrowsMade": 10,
        "freeThrowsAttempted": 14,
        "freeThrowPercentage": 71.4,
        "offensiveRebounds": 11,
        "defensiveRebounds": 23,
        "rebounds": 34,
        "assists": 15,
        "steals": 9,
        "blocks": 3,
        "turnovers": 12,
        "fouls": 16
      },
      "players": [
        {
          "points": 68,
          "fieldGoalsMade": 26,
          "fieldGoalsAttempted": 58,
          "fieldGoalPercentage": 44.8,
          "threePointersMade": 6,
          "threePointersAttempted": 18,
          "threePointPercentage": 33.3,
          "freeThrowsMade": 10,
          "freeThrowsAttempted": 14,
          "freeThrowPercentage": 71.4,
          "offensiveRebounds": 11,
          "defensiveRebounds": 23,
          "rebounds": 34,
          "assists": 15,
          "steals": 9,
          "blocks": 3,
          "turnovers": 12,
          "fouls": 16,
          "playerId": "f6a7b8c9-d0e1-4f2a-9b34-5d6e7f809102",
          "rosterEntryId": "a7b8c9d0-e1f2-4a3b-8c45-6e7f80910213",
          "name": "Ava Nguyen",
          "jerseyNumber": "7",
          "minutes": 27.4,
          "efficiency": 24,
          "trueShootingPercentage": 58.6
        }
      ]
    },
    "opponent": {
      "name": "Northside U16 Boys",
      "totals": {
        "points": 68,
        "fieldGoalsMade": 26,
        "fieldGoalsAttempted": 58,
        "fieldGoalPercentage": 44.8,
        "threePointersMade": 6,
        "threePointersAttempted": 18,
        "threePointPercentage": 33.3,
        "freeThrowsMade": 10,
        "freeThrowsAttempted": 14,
        "freeThrowPercentage": 71.4,
        "offensiveRebounds": 11,
        "defensiveRebounds": 23,
        "rebounds": 34,
        "assists": 15,
        "steals": 9,
        "blocks": 3,
        "turnovers": 12,
        "fouls": 16
      },
      "players": [
        {
          "points": 68,
          "fieldGoalsMade": 26,
          "fieldGoalsAttempted": 58,
          "fieldGoalPercentage": 44.8,
          "threePointersMade": 6,
          "threePointersAttempted": 18,
          "threePointPercentage": 33.3,
          "freeThrowsMade": 10,
          "freeThrowsAttempted": 14,
          "freeThrowPercentage": 71.4,
          "offensiveRebounds": 11,
          "defensiveRebounds": 23,
          "rebounds": 34,
          "assists": 15,
          "steals": 9,
          "blocks": 3,
          "turnovers": 12,
          "fouls": 16,
          "playerId": "f6a7b8c9-d0e1-4f2a-9b34-5d6e7f809102",
          "rosterEntryId": "a7b8c9d0-e1f2-4a3b-8c45-6e7f80910213",
          "name": "Ava Nguyen",
          "jerseyNumber": "7",
          "minutes": 27.4,
          "efficiency": 24,
          "trueShootingPercentage": 58.6
        }
      ]
    }
  },
  "error": null
}

GET

/v1/matches/{matchId}/box-score

curl -X GET "https://api.superstatsport.com/v1/matches/3fa85f64-5717-4562-b3fc-2c963f66afa6/box-score" \
  -H "Authorization: Bearer $SUPERSTAT_API_KEY"

{
  "data": {
    "matchId": "d4e5f6a7-b8c9-4d0e-af12-3b4c5d6e7f80",
    "team": {
      "name": "Northside U16 Boys",
      "totals": {
        "points": 68,
        "fieldGoalsMade": 26,
        "fieldGoalsAttempted": 58,
        "fieldGoalPercentage": 44.8,
        "threePointersMade": 6,
        "threePointersAttempted": 18,
        "threePointPercentage": 33.3,
        "freeThrowsMade": 10,
        "freeThrowsAttempted": 14,
        "freeThrowPercentage": 71.4,
        "offensiveRebounds": 11,
        "defensiveRebounds": 23,
        "rebounds": 34,
        "assists": 15,
        "steals": 9,
        "blocks": 3,
        "turnovers": 12,
        "fouls": 16
      },
      "players": [
        {
          "points": 68,
          "fieldGoalsMade": 26,
          "fieldGoalsAttempted": 58,
          "fieldGoalPercentage": 44.8,
          "threePointersMade": 6,
          "threePointersAttempted": 18,
          "threePointPercentage": 33.3,
          "freeThrowsMade": 10,
          "freeThrowsAttempted": 14,
          "freeThrowPercentage": 71.4,
          "offensiveRebounds": 11,
          "defensiveRebounds": 23,
          "rebounds": 34,
          "assists": 15,
          "steals": 9,
          "blocks": 3,
          "turnovers": 12,
          "fouls": 16,
          "playerId": "f6a7b8c9-d0e1-4f2a-9b34-5d6e7f809102",
          "rosterEntryId": "a7b8c9d0-e1f2-4a3b-8c45-6e7f80910213",
          "name": "Ava Nguyen",
          "jerseyNumber": "7",
          "minutes": 27.4,
          "efficiency": 24,
          "trueShootingPercentage": 58.6
        }
      ]
    },
    "opponent": {
      "name": "Northside U16 Boys",
      "totals": {
        "points": 68,
        "fieldGoalsMade": 26,
        "fieldGoalsAttempted": 58,
        "fieldGoalPercentage": 44.8,
        "threePointersMade": 6,
        "threePointersAttempted": 18,
        "threePointPercentage": 33.3,
        "freeThrowsMade": 10,
        "freeThrowsAttempted": 14,
        "freeThrowPercentage": 71.4,
        "offensiveRebounds": 11,
        "defensiveRebounds": 23,
        "rebounds": 34,
        "assists": 15,
        "steals": 9,
        "blocks": 3,
        "turnovers": 12,
        "fouls": 16
      },
      "players": [
        {
          "points": 68,
          "fieldGoalsMade": 26,
          "fieldGoalsAttempted": 58,
          "fieldGoalPercentage": 44.8,
          "threePointersMade": 6,
          "threePointersAttempted": 18,
          "threePointPercentage": 33.3,
          "freeThrowsMade": 10,
          "freeThrowsAttempted": 14,
          "freeThrowPercentage": 71.4,
          "offensiveRebounds": 11,
          "defensiveRebounds": 23,
          "rebounds": 34,
          "assists": 15,
          "steals": 9,
          "blocks": 3,
          "turnovers": 12,
          "fouls": 16,
          "playerId": "f6a7b8c9-d0e1-4f2a-9b34-5d6e7f809102",
          "rosterEntryId": "a7b8c9d0-e1f2-4a3b-8c45-6e7f80910213",
          "name": "Ava Nguyen",
          "jerseyNumber": "7",
          "minutes": 27.4,
          "efficiency": 24,
          "trueShootingPercentage": 58.6
        }
      ]
    }
  },
  "error": null
}