---
title: "List Highlight Packages"
method: GET
path: "/v1/highlight-packages"
tags: ["Highlight Packages"]
---

# List Highlight Packages

`GET /v1/highlight-packages`

## Request

- Base URL: `https://api.narrative-sports.com`
- URL: `https://api.narrative-sports.com/v1/highlight-packages`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `cursor` string, nullable
- `created_after` string, nullable
- `created_before` string, nullable
- `status` string, nullable

## Response `200`

Success

- ListMultiGamePackagesResponse
  - `packages` MultiGamePackageListItem[], required
    - `id` integer, required
    - `name` string, nullable
    - `status` string, required
    - `project_ids` integer[], required
    - `target_duration_seconds` integer, nullable
    - `render_video` 'ffmpeg' | 'none', nullable
    - `fight_filter` ProjectFightFilter[], nullable
      - `project_id` integer, required
      - `fight_numbers` integer[], required
    - `has_otio_timeline` boolean, required
    - `has_video` boolean, required
    - `duration` number, nullable
    - `num_clips` integer, nullable
    - `render_job_id` string, nullable
    - `failure_reason` string, nullable
    - `task_id` string, nullable
    - `created_at` string, nullable
  - `total` integer, required
  - `next_cursor` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/narrative-sports/apis/narrative-sports-api.md) - [All operations](https://skmtc.dev/narrative-sports/apis/narrative-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/narrative-sports/apis/narrative-sports-api/revisions/bab6af886f8e?raw)
