---
title: "List private generation candidates for an owned project"
method: GET
path: "/video/projects/{id}/generation-candidates"
---

# List private generation candidates for an owned project

`GET /video/projects/{id}/generation-candidates`

## Request

- Base URL: `https://api.bamf.ai/v1`
- URL: `https://api.bamf.ai/v1/video/projects/{id}/generation-candidates`
- Auth: HTTP bearer

Requires a signed-in JWT user who owns the project; API-key actors are not supported. Lists successful private video takes bound to this project, creator, workspace, and user, excluding takes already assigned in the current shot manifest. Results are candidates only; no automatic attachment or approval occurs. Only safe metadata is returned, with private no-store caching.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Sanitized successful private generation candidates and bounded pagination state

- object
  - `data` object, required
    - `items` object[], required
      - `id` string, uuid, required
      - `createdAt` string, date-time, required
      - `completedAt` string, date-time, required
      - `requestedDurationSeconds` number, nullable, required
      - `outputSha256` string, required
      - `contentType` 'video/mp4', required
      - `byteSize` integer, required
    - `hasMore` boolean, required
    - `nextOffset` integer, nullable, required

## Other responses

- `400`: Project ID or pagination parameters are invalid
- `401`: Missing or invalid user session
- `403`: API-key actor or unsupported actor type
- `404`: Owned project not found
- `503`: Candidate lookup unavailable

---

[API](https://skmtc.dev/bamf/apis/bamf-developer-platform-api.md) · [All operations](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/revisions/a390dd3294bd?raw)