Retrieve a session

GET /v1/sessions/{id}

Retrieve a session

cURL

curl --request GET \
  --url https://api.hooper.gg/v1/sessions/{id} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "sess_18234",
  "object": "session",
  "created": 1756224000,
  "status": "queued",
  "group": "grp_412",
  "source": {
    "type": "upload",
    "url": "<string>"
  },
  "metadata": {},
  "run_version": 123,
  "duration_seconds": 5412,
  "cost_cents": 752,
  "highlights": {
    "object": "list",
    "has_more": true,
    "total_count": 123,
    "data": [
      {
        "id": "hl_9f2c…",
        "object": "highlight",
        "shot": "shot_a1b2…",
        "shot_index": 123,
        "length_seconds": 8.5,
        "is_lowlight": true,
        "is_manual": true,
        "player": "plr_5",
        "video": {
          "default": "<string>",
          "horizontal": "<string>",
          "1080p": "<string>",
          "720p": "<string>",
          "480p": "<string>",
          "360p": "<string>",
          "240p": "<string>",
          "144p": "<string>"
        },
        "preview": {
          "default": "<string>",
          "horizontal": "<string>"
        },
        "created": 123
      }
    ],
    "url": "/v1/sessions/sess_18234/highlights"
  },
  "shots": {
    "object": "list",
    "has_more": true,
    "total_count": 123,
    "data": [
      {
        "id": "shot_a1b2…",
        "object": "shot",
        "index": 123,
        "start_seconds": 123,
        "end_seconds": 123,
        "made": true,
        "points": 123,
        "type": "fieldgoal",
        "is_three_point": true,
        "is_free_throw": true,
        "is_fouled": true,
        "location": {
          "shot_image_normed": [
            123
          ],
          "shot_world_normed": [
            123
          ],
          "hoop_image_normed": [
            123
          ]
        },
        "excitement_score": 123,
        "players": {
          "scorer": "plr_5",
          "assister": "<string>",
          "rebounder": "<string>"
        },
        "highlight": "hl_9f2c…"
      }
    ],
    "url": "/v1/sessions/sess_18234/highlights"
  },
  "players": {
    "object": "list",
    "has_more": true,
    "total_count": 123,
    "data": [
      {
        "id": "plr_5",
        "object": "player",
        "name": "<string>",
        "jersey": "<string>",
        "user_id": "<string>",
        "team_id": 123,
        "stats": {
          "points": 123,
          "fg_2pt_att": 123,
          "fg_2pt_make": 123,
          "fg_3pt_att": 123,
          "fg_3pt_make": 123,
          "ft_att": 123,
          "ft_make": 123,
          "assist": 123,
          "rebound": 123
        }
      }
    ],
    "url": "/v1/sessions/sess_18234/highlights"
  },
  "totals": {
    "points": 123,
    "fg_2pt_att": 123,
    "fg_2pt_make": 123,
    "fg_3pt_att": 123,
    "fg_3pt_make": 123,
    "ft_att": 123,
    "ft_make": 123,
    "assist": 123,
    "rebound": 123
  },
  "video": {
    "url": "<string>",
    "preview_url": "<string>",
    "1080p": "<string>",
    "720p": "<string>",
    "360p": "<string>",
    "width": 123,
    "height": 123,
    "fps": 123
  },
  "artifacts": {
    "actions": "<string>",
    "balls": "<string>",
    "hoops": "<string>",
    "clusters": "<string>"
  },
  "error": {
    "code": "no_shots",
    "message": "<string>"
  }
}

Authorizations

Authorization · string · header · required

API key issued by Hooper for your organization. Keys are environment-tagged: hk_prod_ keys work against production, hk_stg_ keys against staging.

Path Parameters

id · string · required

Example:

"sess_18234"

Response

200

application/json

OK

One submitted game. The same shape everywhere it appears — single read, list item, webhook payload. Highlights, shots and players are embedded (first 100 of each); their url pages the rest.

id · string

Example:

"sess_18234"

object · string

Allowed value: "session"

created · integer

Example:

1756224000

status · enum<string>

Available options: queued, processing, processed, failed

group · string

Example:

"grp_412"

source · object

Show child attributes

metadata · object

Show child attributes

run_version · integer | null

duration_seconds · integer | null

Example:

5412

cost_cents · integer | null

Example:

752

highlights · object

Show child attributes

shots · object

Show child attributes

players · object

Show child attributes

totals · object

Show child attributes

video · object

Show child attributes

artifacts · object

Raw model output (JSONL) behind the shots and highlights.

Show child attributes

error · object | null

Set when status is failed.

Show child attributes