---
title: "Search the owned library"
method: GET
path: "/api/v1/library"
tags: ["Evidence", "Projects"]
---

# Search the owned library

`GET /api/v1/library`

## Request

- Base URL: `https://prismclip.com`
- URL: `https://prismclip.com/api/v1/library`
- Auth: HTTP bearer

Search active owned projects across filenames, generated summaries, transcript words, and completed visual scene descriptions. Results identify which evidence sources matched and use a stable cursor.

## Query parameters

- `q` string: Words to match across filename, summary, transcript, and visual scenes
- `limit` integer: Maximum matching projects to return
- `cursor` string: Opaque cursor returned by the previous page

## Response `200`

Owned matching projects with evidence match types and an optional next cursor.

- object
  - `items` object[], required
    - `project` object, required
      - `id` string, uuid, required
      - `filename` string, required
      - `mimeType` string, required
      - `byteLength` integer, required
      - `durationMs` integer, nullable, required
      - `width` integer, nullable, required
      - `height` integer, nullable, required
      - `status` string, required
      - `claim` string, required
      - `targetSeconds` integer, required
      - `activeMomentSetId` string, uuid, nullable, required
      - `activeRenderVariantId` string, uuid, nullable, required
      - `error` string, nullable, required
      - `createdAt` string, required: ISO 8601 timestamp
      - `updatedAt` string, required: ISO 8601 timestamp
    - `summary` string, nullable, required
    - `matches` string[], required
  - `nextCursor` string, nullable, required

## Other responses

- `400`: The query, limit, or cursor is invalid.
- `401`: The API key is missing or invalid.
- `403`: The API key lacks evidence:read.
- `429`: The API-key rate limit was exceeded.
- `503`: Evidence storage is unavailable.

---

[API](https://skmtc.dev/prismclip/apis/prismclip-api.md) · [All operations](https://skmtc.dev/prismclip/apis/prismclip-api/llms.txt) · [OpenAPI document](https://skmtc.dev/prismclip/apis/prismclip-api/revisions/05eda9436f1d?raw)