---
title: "Get clipping readiness and canonical duration for an asset"
method: GET
path: "/workspace/media/assets/{assetId}/clipping-status"
tags: ["Media Library"]
---

# Get clipping readiness and canonical duration for an asset

`GET /workspace/media/assets/{assetId}/clipping-status`

## Request

- Base URL: `https://blitzreels.com/api/v1`
- URL: `https://blitzreels.com/api/v1/workspace/media/assets/{assetId}/clipping-status`
- Auth: API key in header `Authorization`

Get clipping readiness and canonical duration for an asset.

## Path parameters

- `assetId` string, required

## Query parameters

- `project_id` string

## Response `200`

Successful response

- object
  - `asset_id` string, required
  - `project_id` string, nullable, required
  - `media_processing_status` string, nullable, required
  - `processing` object, required
    - `processing_status` string, nullable, required
    - `processing_substage` string, nullable, required
    - `processing_error` string, nullable, required
    - `processing_errors` object, required
    - `processing_attempts` integer, nullable, required
    - `retryable` boolean, required
    - `provider_request_ids` object, required
      - `process_job_run_id` string, nullable, required
      - `transcribe_job_run_id` string, nullable, required
      - `provider_request_id` string, nullable, required
  - `transcript_status` string, nullable, required
  - `transcript_word_count` number, required
  - `captions_status` 'not_requested' | 'missing' | 'ready', required
  - `short_suggestions_status` 'missing' | 'ready' | 'no_candidates', required
  - `suggestion_outcome` object, nullable, required
    - `run_id` string, required
    - `suggestion_count` integer, required
    - `no_clip_reason` string, nullable, required
  - `suggestion_counts` object, required
    - `drafts` number, required
    - `saved` number, required
    - `total` number, required
  - `durations` object, required
    - `asset_reported_duration_seconds` number, nullable, required
    - `transcript_duration_seconds` number, nullable, required
    - `max_suggestion_end_seconds` number, nullable, required
    - `project_timeline_duration_seconds` number, nullable, required
    - `canonical_duration_seconds` number, nullable, required
    - `consistency` 'consistent' | 'inconsistent' | 'unknown', required
  - `readiness` object, required
    - `transcript_ready` boolean, required
    - `suggestions_ready` boolean, required
    - `captions_ready` boolean, required
    - `ready_to_apply` boolean, required
    - `ready_to_export` boolean, required
  - `warnings` string[], required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `404`: Not found
- `500`: Internal server error

---

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