ShotTracker Developer

Unparalleled data set + realtime API = future of sports. Build with live tracking, stats, and broadcast-ready endpoints.

Event API

Base URL: https://api.shottracker.com

/v1/data/stats/games/{event_id}/possessions

GETPossessions

Parameters

NameInTypeRequiredDescription
event_idpathstringYesID of the game event

Responses

  • 200OK
    {
      "possessions": [
        {
          "supervision": "MANUAL",
          "startTimestamp": 1744073493000,
          "teamId": "2621",
          "lineupName": "TWO",
          "sessionId": "d7cb9107-1410-11f0-bb5b-06f676c73f13",
          "practiceId": null,
          "drillDefinitionId": null,
          "practiceDefinitionId": null,
          "gameId": "9f2b05b8-c9a9-4dfc-b9a4-3dcca28295d8",
          "lineupPlayers": [
            "93238",
            "98328",
            "141995",
            "149235",
            "149237"
          ],
          "opponentLineupPlayers": [
            "110765",
            "151108",
            "153836",
            "153837",
            "153844"
          ],
          "screenPlayers": [],
          "corrected": false,
          "deleted": false,
          "version": 1,
          "startGameClock": "19:59:00",
          "period": "H1",
          "facilityId": "d02bc93a-259f-11ee-a134-02bc757c58a3",
          "courtId": "2f9dee99-58f9-11ee-8aef-02bc757c58a3",
          "possessions": [
            {
              "sessionId": "d7cb9107-1410-11f0-bb5b-06f676c73f13",
              "teamId": "2621",
              "playerId": "98328",
              "lineup": "TWO",
              "possessionType": "FGA",
              "3Point": false,
              "shotDistance": 0,
              "x": 0,
              "y": 0,
              "z": 0,
              "zone": 0,
              "advancedZone": 0,
              "timestamp": 1744073513002,
              "gameClock": "19:41:00",
              "shotClock": "11.00",
              "scoring": false,
              "nonScoring": true,
              "turnover": false
            }
          ],
          "shotDistance": [
            0
          ],
          "resultedStats": {},
          "id": "962942f6-749d-4128-a589-0b14fa6870e5",
          "possessionTime": 20002,
          "endTimestamp": 1744073513002,
          "endPossession": {
            "sessionId": "d7cb9107-1410-11f0-bb5b-06f676c73f13",
            "teamId": "2621",
            "playerId": "98328",
            "lineup": "TWO",
            "possessionType": "FGA",
            "3Point": false,
            "shotDistance": 0,
            "x": 0,
            "y": 0,
            "z": 0,
            "zone": 0,
            "advancedZone": 0,
            "timestamp": 1744073513002,
            "gameClock": "19:41:00",
            "shotClock": "11.00",
            "scoring": false,
            "nonScoring": true,
            "turnover": false
          },
          "locationsPreview": [],
          "stats": {
            "turnover": 0,
            "shotType": 2,
            "shotValue": 0,
            "points": 0,
            "passes": 1,
            "halfCourt": true,
            "paintTouch": false,
            "ballReversals": 0,
            "ballScreens": 0,
            "ballScreensLeftWing": 0,
            "ballScreensMiddleWing": 0,
            "ballScreensRightWing": 0,
            "ballScreensPickAndPop": 0,
            "ballScreensPickAndRoll": 0,
            "ballScreensPickAndShortRoll": 0,
            "ballScreensScreenedShot": 0,
            "ballScreensHandoff": 0,
            "ballScreensDrag": 0,
            "ballScreensPop": 0,
            "ballScreensRoll": 0,
            "ballScreensSlip": 0,
            "ballScreensShortRoll": 0,
            "ballScreensReject": 0,
            "ballScreensReScreen": 0,
            "ballScreensStay": 0,
            "ballScreensStepUp": 0,
            "ballScreensSnake": 0,
            "ballScreensSplit": 0,
            "ballScreensOther": 0
          },
          "endGameClock": "19:41:00",
          "clipId": null,
          "videoClipStartTimestamp": 0,
          "videoClipEndTimestamp": 0,
          "classification": null,
          "series": 1,
          "distanceLos": 0,
          "multiTeamClipId": null,
          "labeledEvents": {
            "passDeflectedBy": [],
            "passes": 1,
            "offenses": [
              "motion"
            ],
            "videoTimeMark": "00:21:44",
            "paintTouch": false,
            "defenses": [
              "manToMan"
            ]
          },
          "isoPlayerId": null,
          "scoring": false,
          "valid": true,
          "manuallySupervised": true,
          "notManuallySupervised": false,
          "videoAttributes": {
            "facilityId": "d02bc93a-259f-11ee-a134-02bc757c58a3",
            "courtId": "2f9dee99-58f9-11ee-8aef-02bc757c58a3",
            "sessionId": "d7cb9107-1410-11f0-bb5b-06f676c73f13"
          },
          "nonScoring": true,
          "fieldGoalShotType": 2,
          "possessionRange": {
            "empty": true
          },
          "turnover": false,
          "score": 0
        }
      ],
      "gameTotals": {
        "awayTeamScore": {
          "teamId": "2",
          "value": 22
        },
        "homeTeamScore": {
          "teamId": "1",
          "value": 11
        },
        "period": "H2",
        "gameClock": "00:15:00",
        "status": "ACTIVE",
        "periodTotals": [
          {
            "awayTeamScore": {
              "teamId": "2",
              "value": 2
            },
            "homeTeamScore": {
              "teamId": "1",
              "value": 10
            },
            "period": "H2",
            "sessionId": "37c2cf99-05fb-11f1-8a55-0211f60c14bb"
          },
          {
            "awayTeamScore": {
              "teamId": "2",
              "value": 20
            },
            "homeTeamScore": {
              "teamId": "1",
              "value": 1
            },
            "period": "H1",
            "sessionId": "37c2cf99-05fb-11f1-8a55-0211f60c14aa"
          }
        ]
      }
    }
  • 403Forbidden
    {
      "status": 403,
      "message": "Access denied to resource",
      "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
    }
  • 500Internal Server Error
    {
      "status": 500,
      "message": "<General System Error Message>",
      "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
    }