---
title: "GET /clips"
method: GET
path: "/clips"
---

# GET /clips

`GET /clips`

## Query parameters

- `query` string
- `status` string
- `aspectRatio` string
- `tags` string[]
- `statuses` string[]
- `people` string[]
- `personMode` 'any' | 'all'
- `keywords` string[]
- `workflowId` string
- `episodeId` string
- `workflowRunId` string
- `durationMin` number
- `durationMax` number
- `modifiedAfter` string, date-time
- `modifiedBefore` string, date-time
- `includeFacets` boolean
- `countOnly` boolean
- `sortBy` 'created_at' | 'updated_at' | 'duration' | 'title' | 'virality_score'
- `sortOrder` 'asc' | 'desc'
- `limit` integer
- `cursor` string — Opaque query-bound page cursor

## Response `200`

Filtered compact clip summaries, or a count-only result

---

[API](https://skmtc.dev/overlap/apis/overlap-internal-domain-api.md) · [All operations](https://skmtc.dev/overlap/apis/overlap-internal-domain-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/overlap/overlap-internal-domain-api/revisions/a7c23a61171f/schema)