---
title: "List transformation run steps"
method: GET
path: "/v2/sites/{site_id}/transformation_run_steps/"
tags: ["transformations"]
---

# List transformation run steps

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

Retrieves a paginated list of the individual steps that make up transformation runs for the specified site

Use the `q` parameter to filter steps by `transformation_run_id`, `step_type`, or `state`.

## 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 run steps successfully retrieved

- TransformationRunStepsResponse — Paginated list of transformation run steps
  - `transformation_run_steps` TransformationRunStepResource[]
    - `id` string — Unique identifier for a resource
    - `site_id` string — Unique identifier for a resource
    - `type` 'transformation_run_step' — Resource type identifier
    - `transformation_run_id` string — Unique identifier for a resource
    - `step_type` string — Type of work performed by this step, such as script generation, audio generation, or review
    - `lineage` object — Step provenance describing dependencies, attempt tracking, and retry linkage
      - `parent_step_ids` ResourceId[] — IDs of steps that must complete before this step can execute
      - `attempt_num` integer — Which attempt this is (1-indexed)
      - `retried_from_step_id` string — Unique identifier for a resource
    - `started_at` string, date-time, nullable — Timestamp when the step started processing
    - `metadata` object
      - `state` 'queued' | 'running' | 'awaiting_approval' | 'succeeded' | 'failed' | 'skipped' — Processing state of an individual transformation run step - `queued`: Step is waiting to be picked up for processing - `running`: Step is actively being processed - `awaiting_approval`: Step is paused for a human-in-the-loop review decision - `succeeded`: Step completed successfully - `failed`: Step encountered an error and did not complete - `skipped`: Step was not executed because it was not needed for this run
      - `input_data` object — Step inputs The schema varies by step type.
      - `output_data` object — Step outputs The schema varies by step type and outcome.
        - `asset_version_ids` ResourceId[] — Output asset version IDs produced by this step
        - `decision` object, nullable — Human-in-the-loop decision record, populated on review steps after a decision is made
          - `decision` 'approve' | 'reject' | 'regenerate' — Reviewer decision recorded on a human-in-the-loop review step
          - `decided_by` string — Unique identifier for a resource
          - `approved_asset_version_ids` ResourceId[]
          - `regenerate_input_asset_version_ids` ResourceId[] — Versions used as the regenerated step's input instead of reusing the predecessor's inputs This is populated only when supplied with a `regenerate` decision.
        - `error` object, nullable — Error details when the step failed
          - `code` string — Error code
          - `message` string — Human-readable error message
    - `relationships` object — Related resources
      - `transformation_run` 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.dev/jwplayer/apis/management-api-v2.md) · [All operations](https://skmtc.dev/jwplayer/apis/management-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/jwplayer/management-api-v2/revisions/180db7cada27/schema)