---
title: "Get Command Status"
method: GET
path: "/v1/commands/{command_id}"
tags: ["API", "FFmpeg Commands"]
---

# Get Command Status

`GET /v1/commands/{command_id}`

Get the status of a previously submitted FFmpeg command. Works for regular commands and chained commands.

## Path parameters

- `command_id` string, required — The UUID of the FFmpeg command to check status for

## Query parameters

- `presigned_ttl_seconds` integer, nullable — If set, output files that are private AND already stored return `storage_url` as a presigned URL valid for this many seconds. For any other file (public, not yet stored, or deleted) the default `storage_url` is returned unchanged. See the [private files guide](https://docs.rendi.dev/private-files).

## Response `200`

Successful Response

- CommandStatusResponse — Response model for FFmpeg command status. Contains information about the command execution status, any errors that occurred, output files generated, and the original request details.
  - `command_id` string, required — Unique identifier for the submitted command
  - `environment_name` string, nullable, required — The environment this command was created in (e.g., 'main', 'test', 'dev').
  - `status` 'QUEUED' | 'PROCESSING' | 'PREPARED_FFMPEG_COMMAND' | 'FAILED' | 'SUCCESS', required
  - `processing_stage` 'DOWNLOADING' | 'PREPARING_INPUT_FILES' | 'FFMPEG_PROCESSING' | 'UPLOADING'
  - `command_type` 'FFMPEG_COMMAND' | 'FFMPEG_CHAINED_COMMANDS', required
  - `error_status` string, nullable — Status of any error that occurred during command execution
  - `error_message` string, nullable — Error details if the command failed
  - `total_processing_seconds` number, nullable — Processing time, in seconds, since receiving the command, this includes network times, parsing times, and FFMPEG command execution time
  - `ffmpeg_command_run_seconds` number, nullable — The exact time the specific FFMPEG command took on our servers, in seconds
  - `vcpu_count` integer, nullable — Number of virtual CPUs used for the command
  - `output_files` object, nullable — Dictionary mapping file aliases to their output file storage, for output folder, the key is 'OUTPUT_FOLDER'
  - `original_request` object, required — The original request that was sent to the server
  - `processing_quota_used` number, nullable — Amount of processing quota used in MB
  - `metadata` object, nullable — Metadata stored with the command, used for custom tracking and reporting

## Other responses

- `401` — Invalid API key
- `422` — Validation Error
- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/rendi/apis/ffmpeg-command-api.md) · [All operations](https://skmtc.dev/rendi/apis/ffmpeg-command-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rendi/ffmpeg-command-api/revisions/d3136dbf90f0/schema)