---
title: "Get list of commands sent"
method: GET
path: "/v1/commands"
tags: ["API", "FFmpeg Commands"]
---

# Get list of commands sent

`GET /v1/commands`

Get the statuses of a previously submitted FFmpeg commands, ordered by creation time - descending.

## Query parameters

- `limit` integer — Maximum number of commands to return
- `offset` integer — Number of commands to skip before starting to collect the result set

## Response `200`

Successful Response

- CommandsListItemResponse[]
  - `command_id` string, required — Unique identifier for the submitted command
  - `environment_name` string, nullable — The environment this command was created in (e.g., 'main', 'test', 'dev').
  - `storage_quota_used` number, nullable — Amount of storage quota used in MB
  - `processing_quota_used` number, nullable — Amount of processing quota used in MB
  - `output_file_count` integer, nullable — Number of output files generated by the command
  - `error_status` string, nullable — Status of any error that occurred during command execution
  - `error_message` string, nullable — Error details if the command failed
  - `status` 'QUEUED' | 'PROCESSING' | 'PREPARED_FFMPEG_COMMAND' | 'FAILED' | 'SUCCESS', required
  - `created_at` string, date-time — Time when the command was created, in UTC
  - `ffmpeg_command_run_seconds` number, nullable — The exact time the specific FFMPEG command took on our servers, in seconds
  - `processing_seconds` number, nullable — Total processing time from queue to finish, in seconds (finished_at - queued_at)

## Other responses

- `401` — Invalid API key
- `422` — Invalid request
- `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)