# Read Data Transformation Definition Read Data Transformation Definition. Endpoint: GET /datatransformationdefinitions/{id} Version: 1 Security: apiKey ## Path parameters: - `id` (string, required) ID of the data transformation definition. Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4" ## Query parameters: - `featuresOn` (array) Features to be activated. Enum: "RESOLVE_IMPORTS" ## Response 200 fields (application/json): - `imports` (array) List of imported data transformation definitions. - `imports.id` (string) Unique identifier for a data transformation definition. Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4" - `name` (string) Name of the Data Transformation Definition. Example: "My DTD" - `type` (object) Type of the Data Transformation Definition - `type.name` (string) Name of the Data Transformation Definition Type Example: "BUSINESS_PARTNER" - `type.technicalKey` (string) Technical key of the Data Transformation Definition Type Enum: "BUSINESS_PARTNER", "MESSAGE_DETAILS" - `mappings` (array) List of attribute mappings. - `mappings.sourceAttributes` (array) List of source attributes. Example: ["businessPartner.record"] - `mappings.sourceSelections` (array) List of source selections. - `mappings.sourceSelections.selectionType` (string, required) Selection type. Enum: "CONCATENATION", "XOR" - `mappings.sourceSelections.value` (string) String which is used as a delimiter when joining multiple source values in CONCATENATION selection type. Example: "," - `mappings.targetAttributes` (array) List of target attributes. Example: ["businessPartner.externalId"] - `mappings.targetTransformations` (array) List of target transformations. - `mappings.targetTransformations.constantValue` (string) Constant value. Example: "constant" - `mappings.targetTransformations.transformationName` (string) Name of the transformation. Example: "CAPITALIZE" - `mappings.targetTransformations.defaultValue` (string) Default value. Example: "default" - `mappings.targetTransformations.transformationType` (string, required) Transformation type. Enum: "CAPITALIZE", "CONSTANT_MAPPING", "CONDITIONAL_CONSTANT_MAPPING", "WORD_LENGTH_SPLIT", "TO_UPPERCASE", "MULTIPLE_SOURCE_AND_TARGET_ATTRIBUTE_SUPPORT", "DEFAULT_IF_EMPTY", "SPLIT" - `mappings.ignoredValues` (array) Values to be ignored during transformation. Example: ["ignored value"] - `reverseMappings` (array) List of reverse attribute mappings. - `valueMappings` (array) List of value mappings. - `valueMappings.sourceConditions` (array) List of source conditions. - `valueMappings.sourceConditions.sourceValue` (string) Value that source attribute must be equal to meet condition. Example: "AU" - `valueMappings.sourceConditions.sourceAttribute` (string) Attribute that holds the source value eventually. Example: "$.identifications[*].country.code" - `valueMappings.sourceConditions.sourceRegex` (string) Regex that source attribute must match to meet condition. Example: "^GR\\..{1,}" - `valueMappings.sourceValue` (string) The source value for a value mapping. Example: "AE1" - `valueMappings.targetValue` (string) The target value for a value mapping. Example: "AE" - `valueMappings.targetAttribute` (string) The target attribute (business partner or address for a value mapping). Example: "$.identifications[*].country.code" - `valueMappings.sourceAttribute` (string) The source attribute (business partner or address for a value mapping). Example: "$.identifications[*].country.code" - `valueMappings.disabled` (boolean) Toggles if an element of a transformation definition is disabled or not. Example: "false" - `values` (array) List of values. - `values.sourceValue` (string) The source value for a value mapping Example: "AE1" - `values.sourceAttribute` (string) The source value for a value mapping Example: "identifications[*].indentificationType.code" - `workspaceId` (string) Uniquely identifying ID of the workspace. Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4" - `version` (integer) Version number of the resource. Example: 1 - `createdBy` (string) Creator of a resource. Example: "76248934691294444" - `createdAt` (string) Date of creation (ISO 8601-compliant). Example: "2025-08-29T09:47:35Z" - `modifiedBy` (string) User or Client UUID which modified the resource. Example: "76248934691294444" - `modifiedAt` (string) Date of modification (ISO 8601-compliant). Example: "2025-08-29T09:47:35Z"