[Public Transformations] Read a transformation.

This endpoint will give details about a particular transformation, such as its import date, source file name, download_url and more.

GET

https://api.staging.wetransform.com/transformation/{transformationId}

Parameter	Description	Type/Regex
`{transformationId}`	The transformation UUID to read	`[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}`

Responses

200 OK

Response 200

ResponseSuccess TransformationPublic

Property / Description
success boolean
Always `true` on successful responses. Sample value: `true`
payload object
Payload of the requested resource.
payload.source_id string
The source identifier. Sample value: `"306e6d71-3d87-4c15-935e-d1cb9743b220"`
payload.source_name ^* string
The source name. Sample value: `"my-employees.csv"`
payload.source_file_url ^* string
The source file URL, if it still exists
payload.imported_at datetime
The date and time the source was imported.
payload.template_name string
The template name. Sample value: `"Employee Leaves (RE)"`
payload.template_picture_url ^* string
The template picture URL. Sample value: `"https:\/\/api.staging.wetransform.com\/icon.png"`
payload.transformation_id string
The transformation identifier. Sample value: `"393e68a1-2e73-4f3a-a4a1-b3de32814124"`
payload.has_schedule boolean
Whether the transformation has an enabled schedule. Sample value: `true`
payload.column_names array
The columns' names.
payload.custom_field_names array
The custom fields' names.
payload.deleted_at ^* datetime
The date and time the transformation was deleted, if applicable.
payload.download_url ^* string
The download URL of the transformed file. Sample value: `"https:\/\/api.staging.wetransform.com\/file\/prqfit7vq7q152jvi58ps16b7vg1p01k.csv"`
payload.template_handle string
The template handle. Sample value: `"furniture"`
product ^* object
A product needed. Not null if user requires to buy a specific product (permission or limitation) in order to access a feature.
product.requirement ^* string
Whether the user requested a features s/he doesn't have access to, or the user needs greater limits. Possible values: `permission`, `limitation` Sample value: `"permission"`
product.permission ^* object
The required permission. You will need to know which permission is needed in order to fill up search filters in the shop.
product.permission.description ^* string
A human-understandable name for the permission.
product.permission.name string
A technical permission name (ex: ORGANISATION_UPDATE_SETTINGS). Possible values depend on the context, check the domain's metadata endpoint. Sample value: `"X_SOURCE_FORMAT_XML"`
product.limitation_type ^* string
The limitation that needs to be increased (ex: number of columns).
product.limitation_needed_value ^* integer
The needed resource quantity (if receiver uses 9 columns in a template, this value is 9).
product.limitation_current_value ^* integer
The current value of the limitation (if receiver is allowed to use 10 columns, this value is 10).
product.limitation_object ^* object
The limitation type in a readable format, for example, "lines per file".
product.is_cta ^* boolean
Whether a Call To Action should be displayed. It may not be displayed if: the limitation is on the membership role the limitation is on the customer role the user is a sender
debug array
Debug information. Contains logs about business logic explaining state of the response payload. Provided in development & admin modes only.

Properties suffixed with * are nullable.

Example Copy

{
    "success": true,
    "payload": {
        "source_id": "306e6d71-3d87-4c15-935e-d1cb9743b220",
        "source_name": "my-employees.csv",
        "source_file_url": null,
        "imported_at": "2026-04-05T14:44:58+00:00",
        "template_name": "Employee Leaves (RE)",
        "template_picture_url": "https:\/\/api.staging.wetransform.com\/icon.png",
        "transformation_id": "393e68a1-2e73-4f3a-a4a1-b3de32814124",
        "has_schedule": true,
        "column_names": [
            "column1",
            "column2"
        ],
        "custom_field_names": [
            "custom1",
            "custom2"
        ],
        "deleted_at": null,
        "download_url": "https:\/\/api.staging.wetransform.com\/file\/prqfit7vq7q152jvi58ps16b7vg1p01k.csv",
        "template_handle": "furniture"
    },
    "product": {
        "requirement": "permission",
        "permission": {
            "name": "X_SOURCE_FORMAT_XML",
            "description": "Can import XML files"
        },
        "limitation_type": null,
        "limitation_needed_value": null,
        "limitation_current_value": null,
        "limitation_object": null,
        "is_cta": false
    },
    "debug": []
}

Authentication required.

Response 401 This response is received when the authorization header does not contain a valid authentication token. It mostly happens because the current access_token has expired, and it needs to be renewed using a refresh_token.

ResponseError HttpUnauthorized

User must be authenticated to access the resource.

This response is received when the authorization header does not contain a valid authentication token.

It mostly happens because the current access_token has expired, and it needs to be renewed using a refresh_token.

Property / Description
success boolean
Always `false` on error responses. Sample value: `false`
payload object
Context about the error, if any.
product ^* object
A product needed. Not null if user requires to buy a specific product (permission or limitation) in order to access a feature.
product.requirement ^* string
Whether the user requested a features s/he doesn't have access to, or the user needs greater limits. Possible values: `permission`, `limitation` Sample value: `"permission"`
product.permission ^* object
The required permission. You will need to know which permission is needed in order to fill up search filters in the shop.
product.permission.description ^* string
A human-understandable name for the permission.
product.permission.name string
A technical permission name (ex: ORGANISATION_UPDATE_SETTINGS). Possible values depend on the context, check the domain's metadata endpoint. Sample value: `"X_SOURCE_FORMAT_XML"`
product.limitation_type ^* string
The limitation that needs to be increased (ex: number of columns).
product.limitation_needed_value ^* integer
The needed resource quantity (if receiver uses 9 columns in a template, this value is 9).
product.limitation_current_value ^* integer
The current value of the limitation (if receiver is allowed to use 10 columns, this value is 10).
product.limitation_object ^* object
The limitation type in a readable format, for example, "lines per file".
product.is_cta ^* boolean
Whether a Call To Action should be displayed. It may not be displayed if: the limitation is on the membership role the limitation is on the customer role the user is a sender
debug array
Debug information. Contains logs about business logic explaining state of the response payload. Provided in development & admin modes only.

Properties suffixed with * are nullable.

Example Copy

{
    "success": false,
    "payload": [],
    "product": {
        "requirement": "permission",
        "permission": {
            "name": "X_SOURCE_FORMAT_XML",
            "description": "Can import XML files"
        },
        "limitation_type": null,
        "limitation_needed_value": null,
        "limitation_current_value": null,
        "limitation_object": null,
        "is_cta": false
    },
    "debug": []
}

Access denied.

Response 403 It can happen if user is trying to use a feature that s/he didn't pay for, access someone else's resource, etc. These issues are normally fixed by the frontend, which should render features and resources user has access to.

ResponseError HttpForbidden

User is well authenticated, but not authorized to access the resource.

It can happen if user is trying to use a feature that s/he didn't pay for, access someone else's resource, etc.

These issues are normally fixed by the frontend, which should render features and resources user has access to.

Property / Description
success boolean
Always `false` on error responses. Sample value: `false`
payload object
Context about the error, if any.
product ^* object
A product needed. Not null if user requires to buy a specific product (permission or limitation) in order to access a feature.
product.requirement ^* string
Whether the user requested a features s/he doesn't have access to, or the user needs greater limits. Possible values: `permission`, `limitation` Sample value: `"permission"`
product.permission ^* object
The required permission. You will need to know which permission is needed in order to fill up search filters in the shop.
product.permission.description ^* string
A human-understandable name for the permission.
product.permission.name string
A technical permission name (ex: ORGANISATION_UPDATE_SETTINGS). Possible values depend on the context, check the domain's metadata endpoint. Sample value: `"X_SOURCE_FORMAT_XML"`
product.limitation_type ^* string
The limitation that needs to be increased (ex: number of columns).
product.limitation_needed_value ^* integer
The needed resource quantity (if receiver uses 9 columns in a template, this value is 9).
product.limitation_current_value ^* integer
The current value of the limitation (if receiver is allowed to use 10 columns, this value is 10).
product.limitation_object ^* object
The limitation type in a readable format, for example, "lines per file".
product.is_cta ^* boolean
Whether a Call To Action should be displayed. It may not be displayed if: the limitation is on the membership role the limitation is on the customer role the user is a sender
debug array
Debug information. Contains logs about business logic explaining state of the response payload. Provided in development & admin modes only.

Properties suffixed with * are nullable.

Example Copy

{
    "success": false,
    "payload": [],
    "product": {
        "requirement": "permission",
        "permission": {
            "name": "X_SOURCE_FORMAT_XML",
            "description": "Can import XML files"
        },
        "limitation_type": null,
        "limitation_needed_value": null,
        "limitation_current_value": null,
        "limitation_object": null,
        "is_cta": false
    },
    "debug": []
}

Interactive Console

Please login in order to access the console.

Back to API Reference