---
title: "Retrieve transformations"
method: GET
path: "/transformations"
tags: ["Transformations"]
---

# Retrieve transformations

`GET /transformations`

This endpoint lists transformations, or a subset of transformations.

## Query parameters

- `id` union — Filter by transformation IDs
  - string
  - string[]
- `name` union — Filter by transformation name
  - string, nullable
  - Operators
    - `gt` string, date-time, nullable
    - `gte` string, date-time, nullable
    - `le` string, date-time, nullable
    - `lte` string, date-time, nullable
    - `any` boolean
    - `all` boolean
- `order_by` 'name' | 'created_at' | 'updated_at' — Sort key
- `dir` 'asc' | 'desc' — Sort direction
- `limit` integer — Result set size
- `next` string — The ID to provide in the query to get the next set of results
- `prev` string — The ID to provide in the query to get the previous set of results

## Response `200`

List of transformations

- TransformationPaginatedResult
  - `pagination` SeekPagination
    - `order_by` union
      - string
      - string[]
    - `dir` union
      - union
        - 'asc'
        - 'desc'
        - 'ASC'
        - 'DESC'
      - OrderByDirection[]
        - union
          - 'asc'
          - 'desc'
          - 'ASC'
          - 'DESC'
    - `limit` integer
    - `prev` string
    - `next` string
  - `count` integer
  - `models` Transformation[]
    - `id` string, required — ID of the transformation
    - `team_id` string, required — ID of the project
    - `name` string, required — A unique, human-friendly name for the transformation
    - `code` string, required — JavaScript code to be executed
    - `encrypted_env` string, nullable
    - `iv` string, nullable
    - `env` object, nullable — Key-value environment variables to be passed to the transformation
    - `updated_at` string, date-time, required — Date the transformation was last updated
    - `created_at` string, date-time, required — Date the transformation was created

## Other responses

- `400` — Bad Request
- `422` — Unprocessable Entity

---

[API](https://skmtc.dev/hookdeck/apis/hookdeck-admin-rest-api.md) · [All operations](https://skmtc.dev/hookdeck/apis/hookdeck-admin-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hookdeck/hookdeck-admin-rest-api/revisions/091808eac7fa/schema)