---
title: "Get a transformation"
method: GET
path: "/transformations/{transformationId}"
tags: ["Transformations"]
---

# Get a transformation

`GET /transformations/{transformationId}`

Reads one transformation definition, including source and target descriptors, step-based
mappings, expression text, and metadata used by the runtime mapper.

## Path parameters

- `transformationId` string, uuid, required — Stable identifier for a transformation definition.

## Response `200`

Transformation.

- TransformationDefinition — Request to define a reusable transformation from one resource descriptor to another. Attribute mapper steps can coexist with expression-based transformations.
  - `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.

## Other responses

- `401` — Authentication is required.
- `404` — The requested resource was not found.

---

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