---
title: "Get Transforms"
method: GET
path: "/v1/transforms"
tags: ["transforms", "public"]
---

# Get Transforms

`GET /v1/transforms`

Retrieve all transformation associated with you.

Parameters:
- transform_ids (list, optional): The IDs of the transformations to retrieve.
- proj_ids (list, optional): The ids of the projects to retrieve transformations from.
- include_params (bool, optional): Include metadata in the response such as the transform_params. Defaults to false.

Returns:
- dict: A dict containing all the transformations associated with you.

## Query parameters

- `search_term` string — Search term to filter transformations against their id and name.
- `transform_ids` string[] — List of transform IDs to retrieve.
- `proj_ids` string[] — List of project ids to retrieve transformations from.
- `include_transform_params` boolean — Boolean flag to include transform params, which includes the operations.
- `limit` integer
- `offset` integer
- `order_by` 'updated_at' | 'created_at' | 'id' — An enumeration.
- `order` 'asc' | 'desc' — An enumeration.

## Headers

- `API-Version` string — Pass in an API version to guarantee a consistent response format. The latest version should be used for all new API calls. Existing API calls should be updated to the latest version when possible. **Valid versions:** - Latest API version (recommended): `2025-03` - Previous API version (maintenance mode): `2025-02` If no API version header is included, the response format is considered unstable and could change without notice (not recommended).

## Response `200`

Successful Response

- union
  - GetTransformsWithTransformParamsResponse
    - `message` string, required
    - `data` GetTransformsBaseWithParamsResponse[], required
      - `id` string, required
      - `name` string
      - `status` 'running' | 'failed' | 'completed' | 'not_started', required — An enumeration.
      - `proj_id` string, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `last_ran_at` string, date-time
      - `entity_type` 'inbox' | 'main' | 'playground' | 'child' — An enumeration.
      - `playground_entity_id` string
      - `params` GetTransformsParamsResponse, required
        - `transform_params` object, required
  - GetTransformsResponse
    - `message` string, required
    - `data` GetTransformsBaseResponse[], required
      - `id` string, required
      - `name` string
      - `status` 'running' | 'failed' | 'completed' | 'not_started', required — An enumeration.
      - `proj_id` string, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `last_ran_at` string, date-time
      - `entity_type` 'inbox' | 'main' | 'playground' | 'child' — An enumeration.
      - `playground_entity_id` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `408` — Request Timeout
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.dev/runtrellis/apis/trellis.md) · [All operations](https://skmtc.dev/runtrellis/apis/trellis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runtrellis/trellis/revisions/b7d8570ff3cc/schema)