---
title: "GET /api/transform/runs"
method: GET
path: "/api/transform/runs"
tags: ["/api/transform"]
---

# GET /api/transform/runs

`GET /api/transform/runs`

## Request

- Base URL: `` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/transform/runs`
- Auth: API key in header `X-API-Key`

Paginated unified run history: every row is a root run — a job run, a manual DAG-reprocess run,
  or a standalone transform run — never a member run of a job/DAG (those are listed by `GET /run`
  and the per-run `transform-runs` endpoints).

  `types` selects which kinds to include (all by default); `transform-ids` narrows to runs that ran
  any of the given transforms. The remaining filters work as in `GET /run`.

## Query parameters

- `types` string[], nullable
- `statuses` string[], nullable
- `run-methods` string[], nullable
- `start-time` string, nullable: value must be a non-blank string.
- `end-time` string, nullable: value must be a non-blank string.
- `transform-ids` integer[], nullable
- `sort-column` 'start_time' | 'end_time', nullable
- `sort-direction` 'asc' | 'desc', nullable

## Response `2XX`

Successful response

- object
  - `data` object[], required
    - `direction` 'upstream' | 'downstream', nullable, required
    - `end_time` unknown
    - `entity_id` integer, nullable, required
    - `id` integer, required
    - `is_active` boolean, nullable, required
    - `message` string, nullable, required
    - `name` union, required
      - string
      - string
    - `run_method` string, nullable, required
    - `run_type` 'job' | 'dag' | 'transform', required
    - `start_time` unknown, required
    - `status` 'started' | 'succeeded' | 'failed' | 'timeout' | 'canceled' | 'canceling', required
    - `transform_count` integer, nullable, required
    - `user_id` integer, nullable, required
  - `limit` integer, required
  - `offset` integer, required
  - `total` integer, required

## Other responses

- `4XX`: Client error response
- `5XX`: Server error response

## Changes

- **2026-11-04** `2e178f5a7934`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/metabase/apis/metabase-api/changes/api/transform/runs/get.md)

---

[API](https://skmtc.dev/metabase/apis/metabase-api.md) - [All operations](https://skmtc.dev/metabase/apis/metabase-api/llms.txt) - [OpenAPI document](https://skmtc.dev/metabase/apis/metabase-api/revisions/2e178f5a7934?raw)