---
title: "List commands"
method: GET
path: "/commands"
tags: ["Commands"]
---

# List commands

`GET /commands`

## Request

- Base URL: `https://renderio.dev/api/v1`
- URL: `https://renderio.dev/api/v1/commands`
- Auth: API key in header `X-API-KEY`

## Query parameters

- `limit` integer
- `offset` integer
- `status` 'QUEUED' | 'PROCESSING' | 'SUCCESS' | 'FAILED'

## Response `200`

Command list

- CommandListResponse
  - `commands` Command[], required
    - `command_id` string, uuid, required
    - `status` 'QUEUED' | 'PROCESSING' | 'SUCCESS' | 'FAILED', required
    - `command_type` 'FFMPEG_COMMAND' | 'CHAINED_COMMAND' | 'MULTIPLE_COMMAND' | 'YTDLP_COMMAND', required
    - `total_processing_seconds` number, nullable
    - `ffmpeg_command_run_seconds` number, nullable
    - `metadata` object, nullable
    - `error_status` string, nullable
    - `error_message` string, nullable
    - `output_files` object: Output alias mapped to file metadata. Present once `status` is `SUCCESS`.
    - `original_request` object, required
      - `input_files` InputFiles, required: Input aliases mapped to publicly reachable URLs. Keys must start with `in_`.
      - `output_files` OutputFiles, required: Output aliases mapped to filenames. Keys must start with `out_`.
      - `ffmpeg_command` string
      - `ffmpeg_commands` string[]
  - `limit` integer, required
  - `offset` integer, required

## Other responses

- `401`: Missing or invalid API key
- `429`: Rate limit exceeded — retry after the `Retry-After` interval

---

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