List sessions

Newest first. Each item is the full session object, highlights included.

GET /v1/sessions

List sessions

cURL

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

200

{
  "object": "list",
  "has_more": true,
  "total_count": 123,
  "data": [
    {
      "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>"
      }
    }
  ],
  "url": "/v1/sessions/sess_18234/highlights"
}

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.

Query Parameters

limit · integer · default: 20

Required range: 1 <= x <= 100

starting_after · string

Cursor: the id of the last item on the previous page.

status · enum<string>

Available options: queued, processing, processed, failed

group · string

Example:

"grp_412"

Response

200

application/json

OK

object · string · required

Allowed value: "list"

has_more · boolean · required

total_count · integer · required

data · object[] · required

Show child attributes

url · string

Embedded lists only: the endpoint that pages the full set.

Example:

"/v1/sessions/sess_18234/highlights"