---
title: "Get video chain status"
method: GET
path: "/api/longform-video/status/{chainId}"
tags: ["Video Chain"]
---

# Get video chain status

`GET /api/longform-video/status/{chainId}`

## Request

- Base URL: `https://app.addshuffle.com`
- URL: `https://app.addshuffle.com/api/longform-video/status/{chainId}`
- Auth: none required

Returns the current status, progress, and step details of a video chain. No authentication required — the chain ID acts as an unguessable access token.

## Path parameters

- `chainId` string, required

## Response `200`

Chain status

- object
  - `chainId` string
  - `status` 'ACTIVE' | 'COMPLETED' | 'FAILED' | 'CANCELLED' | 'AWAITING_RETRY'
  - `mode` 'MANUAL' | 'AUTOMATED'
  - `stitchStatus` string, nullable
  - `chainSettings` ChainSettings
    - `model` string
    - `resolution` '720p' | '1080p' | '4k'
    - `aspectRatio` '16:9' | '9:16'
    - `generateAudio` boolean
    - `clipDurationSeconds` integer
    - `creditCostPerClip` integer
  - `progress` Progress
    - `currentStep` integer
    - `totalSteps` integer
    - `completedSteps` integer
    - `failedSteps` integer
    - `percentComplete` integer
  - `isComplete` boolean
  - `videoUrl` string, nullable
  - `error` string, nullable
  - `steps` unknown[]
    - unknown

## Other responses

- `404`: Chain not found

---

[API](https://skmtc.dev/addshuffle/apis/farcash-longform-video-api.md) · [All operations](https://skmtc.dev/addshuffle/apis/farcash-longform-video-api/llms.txt) · [OpenAPI document](https://skmtc.dev/addshuffle/apis/farcash-longform-video-api/revisions/f0a14318fdf9?raw)