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

# List transformations

`GET /transformations`

Lists reusable transformations between resource descriptors. Transformations can represent
existing attribute mappers, expression-based mappings, template mappings, redaction steps,
lookup steps, or future workflow-specific transformation engines.

## Query parameters

- `page` integer
- `size` integer
- `language` 'ATTRIBUTE_MAPPER' | 'JSONATA' | 'JQ' | 'CEL' | 'SQL' | 'TEMPLATE' | 'CUSTOM' — Transformation representation used by a transformation definition.
- `sourceDescriptorId` string, uuid — Stable identifier for a described external or internal resource shape.
- `targetDescriptorId` string, uuid — Stable identifier for a described external or internal resource shape.

## Response `200`

Paged transformations.

- TransformationPage — Page of transformation definitions.
  - `data` TransformationDefinition[], required
    - `displayName` string, required — Human-readable transformation name.
    - `description` string — Transformation purpose and scope.
    - `language` 'ATTRIBUTE_MAPPER' | 'JSONATA' | 'JQ' | 'CEL' | 'SQL' | 'TEMPLATE' | 'CUSTOM', required — Transformation representation used by a transformation definition.
    - `sourceDescriptorId` string, uuid — Stable identifier for a described external or internal resource shape.
    - `targetDescriptorId` string, uuid — Stable identifier for a described external or internal resource shape.
    - `steps` TransformationStep[] — Ordered transformation steps for step-based languages.
      - `stepType` 'MAP' | 'CONSTANT' | 'DEFAULT' | 'REQUIRE' | 'REDACT' | 'HASH' | 'LOOKUP' | 'CUSTOM', required — Transformation step operation.
      - `sourcePath` string — Source path or field used by this step.
      - `targetPath` string — Target path or field written by this step.
      - `value` string, nullable — Literal value used by CONSTANT or DEFAULT steps.
      - `expression` string — Optional expression used by LOOKUP, CUSTOM, or expression-based steps.
      - `metadata` StringMap — Small string-only metadata map for labels, ownership, routing hints, and implementation-specific annotations. Use first-class fields for contractually significant data.
    - `expression` string — Transformation expression for expression-based languages.
    - `metadata` StringMap — Small string-only metadata map for labels, ownership, routing hints, and implementation-specific annotations. Use first-class fields for contractually significant data.
    - `transformationId` string, uuid, required — Stable identifier for a transformation definition.
    - `createdAt` string, date-time, required — Creation timestamp.
    - `updatedAt` string, date-time, required — Last update timestamp.
  - `pagination` Page, required — Pagination metadata emitted with each paged response under the `pagination` property.
    - `limit` integer, required — Maximum number of records requested for this page.
    - `offset` integer, required — Zero-based offset of the first record in this page.
    - `page` integer, required — Zero-based page index derived from offset and limit.
    - `size` integer, required — Effective page size.
    - `total` integer, required — Total number of matching records.
    - `totalPages` integer, required — Total number of available pages.
    - `hasMore` boolean, required — Whether another page is available after this page.

## Other responses

- `401` — Authentication is required.

---

[API](https://skmtc.net/sphereon-opensource/apis/connector-integration-profile-api.md) · [All operations](https://skmtc.net/sphereon-opensource/apis/connector-integration-profile-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sphereon-opensource/connector-integration-profile-api/revisions/60cb8c70871b/schema)