---
title: "List Recaps"
method: GET
path: "/v1/recaps"
tags: ["Recaps"]
---

# List Recaps

`GET /v1/recaps`

## Request

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

## Query parameters

- `limit` integer, nullable
- `cursor` string, nullable

## Response `200`

Success

- ListPublicRecapsResponse
  - `recaps` PublicRecapResponse[], required
    - `id` integer, required
    - `name` string, nullable
    - `editor_project_id` string, nullable
    - `status` string, required
    - `project_id` integer, required
    - `target_duration_seconds` integer, nullable
    - `render_video` string, nullable
    - `exclude_event_types` string[], nullable
    - `video_url` string, nullable
    - `otio_timeline` object, nullable
    - `duration` number, nullable
    - `num_clips` integer, nullable
    - `selected_edit_ids` string[], nullable
    - `render_job_id` string, nullable
    - `thumbnail_url` 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)
