---
title: "List transformation runs"
method: GET
path: "/v2/sites/{site_id}/transformation_runs/"
tags: ["transformations"]
---

# List transformation runs

`GET /v2/sites/{site_id}/transformation_runs/`

Retrieves a paginated list of transformation runs for the specified site

## Path parameters

- `site_id` string, required — Unique identifier for a resource

## Query parameters

- `page` integer
- `page_length` integer
- `q` string
- `sort` string

## Response `200`

Transformation runs successfully retrieved

- TransformationRunsResponse — Paginated list of transformation runs
  - `transformation_runs` TransformationRunResource[]
    - `id` string — Unique identifier for a resource
    - `site_id` string — Unique identifier for a resource
    - `type` 'transformation_run' — Resource type identifier
    - `created` string, date-time — Timestamp when the run was created
    - `transformation_type` 'article_to_audio' | 'article_to_podcast' | 'article_to_video' | 'text_to_audio' — Type of content transformation
    - `state` 'queued' | 'running' | 'awaiting_approval' | 'failed' | 'succeeded' — Processing state of the transformation run - `queued`: Run is waiting to be picked up for processing - `running`: Run is actively being processed - `awaiting_approval`: Run is paused on a human-in-the-loop review step - `failed`: Run encountered an error and did not complete - `succeeded`: Run completed successfully
    - `run_inputs` RunInputs — Inputs supplied to a transformation run
      - `input_asset_version_ids` ResourceId[], required — Default input asset version IDs for the run All input assets must belong to the same project. The project is derived from the input assets.
      - `step_inputs` StepInputOverride[] — Optional per-step input overrides Each entry targets a step type and an optional selector, and provides the input asset versions for matching steps. Steps without a matching override use `input_asset_version_ids`.
        - `step_type` string, required — Step type to which this override applies.
        - `selector` object — Optional additional matching criteria for the targeted step
        - `input_asset_version_ids` ResourceId[], required — Input asset version IDs to use for matching steps
        - `instruction_text` string — Optional free-text instruction passed to the step
    - `output_asset_version_ids` ResourceId[] — IDs of the output asset versions produced by this transformation
    - `transformation_config` object — Configuration snapshot used for this run
    - `error` object — Error details if the transformation failed
      - `code` string — Error code
      - `message` string — Human-readable error message
    - `started_at` string, date-time — Timestamp when processing started
    - `ended_at` string, date-time — Timestamp when processing completed
    - `metadata` object — No mutable fields for transformation runs
    - `relationships` object — Related resources
      - `project` object
        - `id` string — Unique identifier for a resource
      - `transformation_agent` object
        - `id` string — Unique identifier for a resource
  - `page` integer — Current page number
  - `page_length` integer — Number of items per page
  - `total` integer — Total number of items

---

[API](https://skmtc.net/jwplayer/apis/management-api-v2.md) · [All operations](https://skmtc.net/jwplayer/apis/management-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jwplayer/management-api-v2/revisions/180db7cada27/schema)