---
title: "Get Transform Results"
method: POST
path: "/v1/transforms/{transform_id}/results"
tags: ["transforms", "public"]
---

# Get Transform Results

`POST /v1/transforms/{transform_id}/results`

Retrieve the results of a transformation for a given transform_id and customer.

Parameters:
- transform_id (str): The ID of the transformation.
- asset_ids (List[str], optional): List of asset IDs to filter results by.
- row_ids (List[str], optional): List of row IDs to filter results by.
- result_id (str, optional): Result ID to retrieve.
- request_body (GetTransformResultsRequest, optional): Additional filters and parameters.

Returns:
- Dict[List]: A list of rows representing the transformation results.

Raises:
- HTTPException: If the user does not have access to the transformation.

## Path parameters

- `transform_id` string, required — Transformation ID for the transformation to retrieve.

## Query parameters

- `result_id` string — Result ID to retrieve. Will be deprecated in Jan 2025.
- `limit` integer
- `offset` integer
- `order_by` string
- `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).

## Request body

- GetTransformResultsRequest
  - `asset_ids` string[] — List of asset IDs to filter by. When this paramter is passed in, `blocking` defaults to `True`. This will override any `asset_id` filters in the request body.
  - `row_ids` string[] — List of row IDs to filter by. When this paramter is passed in, `blocking` defaults to `True`. This will override any `row_id` filters in the request body.
  - `blocking` boolean — Checks whether to block the return until all the `asset_ids` results are completed. If set to `False`, the response will return immediately with the results that are available.
  - `start_date` union — The start date for filtering results. If not provided, defaults to the earliest date. Provide a UTC datetime string in the format of `YYYY-MM-DDTHH:MM:SSZ`.
    - string, date
    - string, date-time
  - `end_date` union — The end date for filtering results. If not provided, defaults to the latest date. Provide a UTC datetime string in the format of `YYYY-MM-DDTHH:MM:SSZ`.
    - string, date
    - string, date-time
  - `created_by` string — The ID of the user who created the row.
  - `filters` object

## Response `200`

Successful Response

- union
  - GetTransformResultsResponse
    - `message` string, required
    - `transform_status` union
      - 'running' | 'failed' | 'completed' | 'not_started' — An enumeration.
      - 'running' | 'failed' | 'completed' | 'not_started' — An enumeration.
    - `metadata` GetTransformResultsMetadata
      - `total_results_count` integer, required
      - `total_filtered_results_count` integer, required
      - `column_definitions` GetTransformResultsMetadataColumnDefinitions[], required
        - `id` string, required
        - `name` string, required
        - `group` 'default' | 'operation' | 'validation', required — An enumeration.
        - `visual_index` integer
    - `data` GetTransformResultsBaseAssetFields[], required
      - `result_id` string
      - `metadata` GetTransformResultsBaseAssetFieldsMetadata[]
        - `op_id` string, required
        - `status` string, required
  - GetTransformResultsResponseV2
    - `message` string, required
    - `data` GetTransformResultsDataV2, required
      - `metadata` GetTransformResultsMetadataV2, required
        - `total_results_count` integer, required
        - `total_filter_results_count` integer, required
        - `transform_status` union, required
          - 'running' | 'failed' | 'completed' | 'not_started' — An enumeration.
          - 'running' | 'failed' | 'completed' | 'not_started' — An enumeration.
      - `operations` GetTransformResultsOperationV2[], required
        - `id` string, required
        - `name` string, required
        - `group` 'default' | 'operation' | 'validation', required — An enumeration.
        - `visual_index` integer
        - `type` 'assets' | 'text' | 'number' | 'boolean' | 'date' | 'time' | 'list' | 'object' | 'short_text' | 'single_select' | 'multi_select' | 'row_relation', required — An enumeration.
      - `rows` GetTransformResultsRowV2[], required
        - `id` string, required
        - `child_rows` GetTransformResultsRowChildRow[]
          - `row_id` string, required
          - `transform_id` string, required
          - `transform_name` string, required
        - `operation_values` GetTransformResultsOpValueV2[], required
          - `operation_id` string, required
          - `operation_name` string, required
          - `status` 'not_started' | 'running' | 'completed' | 'failed', required
          - `display_text` string, required
          - `type` 'assets' | 'text' | 'number' | 'boolean' | 'date' | 'time' | 'list' | 'object' | 'short_text' | 'single_select' | 'multi_select' | 'row_relation', required — An enumeration.
          - `raw_value` unknown

## 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)