---
title: "Get visual scenes"
method: GET
path: "/api/v1/projects/{projectId}/visual-scenes"
tags: ["Evidence"]
---

# Get visual scenes

`GET /api/v1/projects/{projectId}/visual-scenes`

## Request

- Base URL: `https://prismclip.com`
- URL: `https://prismclip.com/api/v1/projects/{projectId}/visual-scenes`
- Auth: HTTP bearer

Retrieve a bounded page of source-relative scenes from the latest completed full visual analysis for an owned project, including the analysis ID, model, duration, and timestamps needed for provenance.

## Path parameters

- `projectId` string, uuid, required

## Query parameters

- `offset` integer: Zero-based scene offset
- `limit` integer: Maximum visual scenes to return

## Response `200`

Completed visual analysis provenance and a bounded page of scenes.

- object
  - `projectId` string, uuid, required
  - `analysis` object, required
    - `id` string, uuid, required
    - `model` string, required
    - `status` 'completed', required
    - `durationMs` integer, required
    - `createdAt` string, required: ISO 8601 timestamp
    - `updatedAt` string, required: ISO 8601 timestamp
  - `scenes` object[], required
    - `index` integer, required
    - `startMs` integer, required
    - `endMs` integer, required
    - `description` string, required
  - `nextOffset` integer, nullable, required

## Other responses

- `400`: The scene offset or limit is invalid.
- `401`: The API key is missing or invalid.
- `403`: The API key lacks evidence:read.
- `404`: The owned project or completed visual analysis was not found.
- `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)