---
title: "Get project readiness"
method: GET
path: "/api/v1/projects/{projectId}/readiness"
tags: ["Projects"]
---

# Get project readiness

`GET /api/v1/projects/{projectId}/readiness`

## Request

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

Inspect source, media metadata, transcript and visual preparation state with suggested next tool names. All evidence timestamps are source-relative milliseconds.

## Path parameters

- `projectId` string, uuid, required

## Response `200`

Readiness and next actions

- object
  - `projectId` string, uuid, required
  - `sourceReady` boolean, required
  - `mediaReady` boolean, required
  - `transcript` object, required
    - `status` string, required
    - `id` string, uuid, nullable, required
    - `errorCategory` string, nullable, required
    - `wordCount` integer, required
  - `visual` object, required
    - `status` string, required
    - `id` string, uuid, nullable, required
    - `errorCategory` string, nullable, required
  - `nextActions` string[], required
  - `timing` 'source-relative milliseconds; transcript ordinals are zero-based', required

## Other responses

- `400`: Invalid input.
- `401`: Authentication required.
- `402`: Source allowance exhausted.
- `403`: Required scope missing.
- `404`: Owned resource not found.
- `409`: Prerequisite unavailable or idempotency key reused with changed inputs.
- `429`: Rate limit exceeded.
- `503`: Processing 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)