---
title: "Search transformers"
method: GET
path: "/api/transformers/search"
tags: ["Transformers"]
---

# Search transformers

`GET /api/transformers/search`

Searches for transformers with optional filtering by type, input type, and output type

## Query parameters

- `type` 'standard' | 'custom', required
- `inputType` 'any' | 'time-values' | 'setpoint', required — Type representing an OIBus data type.
- `outputType` 'any' | 'time-values' | 'setpoint', required — Type representing an OIBus data type.
- `page` number, double

## Response `200`

Paginated list of transformers

- PageTransformerDTO — Represents a paginated response containing an array of elements.
  - `content` TransformerDTO[], required — The content of the page - an array of elements.
    - union — Union type representing either a custom or standard transformer.
      - CustomTransformerDTO — Data Transfer Object for a custom transformer. Extends the base transformer with custom-specific properties.
        - `id` string, required — The unique identifier of the transformer.
        - `type` 'custom', required — The type of the transformer (always 'custom' for this interface).
        - `inputType` string, required
        - `outputType` string, required
        - `manifest` OIBusObjectAttribute, required — Object-type attribute that groups related attributes. Used to create nested form structures.
          - `type` 'object', required — The type of this attribute (always "object").
          - `key` string, required — The unique key/identifier for this attribute.
          - `translationKey` string, required — Translation key for internationalization.
          - `validators` OIBusAttributeValidator[], required — Validators to apply to this attribute.
            - `type` 'REQUIRED' | 'MINIMUM' | 'MAXIMUM' | 'POSITIVE_INTEGER' | 'VALID_CRON' | 'PATTERN' | 'UNIQUE' | 'SINGLE_TRUE' | 'MQTT_TOPIC_OVERLAP' | 'PLATFORM', required — Type representing the possible validator types for OIBus form attributes.
            - `arguments` string[], required — Arguments for the validator. For example, for MINIMUM validator: ["10"] would set minimum value to 10.
          - `attributes` OIBusAttribute[], required — Child attributes contained within this object.
            - union — Union type representing all possible OIBus form attributes. Includes both displayable attributes and array/object containers.
              - …
          - `enablingConditions` OIBusEnablingCondition[], required — Conditions that determine when this object should be enabled.
            - `targetPathFromRoot` string, required — Path to the attribute that should be enabled/disabled.
            - `referralPathFromRoot` string, required — Path to the attribute whose value determines the enabling condition.
            - `values` union[], required — Values of the referral attribute that will enable the target attribute.
              - …
            - `operator` 'EQUALS' | 'CONTAINS' | 'NOT_EQUAL' — Operator to use for the condition. EQUALS: The referral attribute value must be equal to one of the values. CONTAINS: The referral attribute value must contain one of the values (string only).
          - `displayProperties` OIBusObjectDisplayProperties, required — Display properties for object-type form attributes. Controls visibility and styling of object containers.
            - `visible` boolean, required — Whether this object should be visible in the form.
            - `wrapInBox` boolean, required — Whether this object should be wrapped in a visual box/container.
        - `name` string, required — The name of the custom transformer.
        - `description` string, required — A description of what the custom transformer does.
        - `customCode` string, required — The custom JavaScript code that implements the transformation logic.
        - `language` string, required
        - `timeout` number, double, required — The maximum execution time for the custom code in milliseconds.
        - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
          - `id` string, required — The unique identifier of the user.
          - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
        - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
        - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
      - StandardTransformerDTO — Data Transfer Object for a standard transformer. Extends the base transformer with standard-specific properties.
        - `id` string, required — The unique identifier of the transformer.
        - `type` 'standard', required — The type of the transformer (always 'standard' for this interface).
        - `inputType` string, required
        - `outputType` string, required
        - `manifest` OIBusObjectAttribute, required — Object-type attribute that groups related attributes. Used to create nested form structures.
          - `type` 'object', required — The type of this attribute (always "object").
          - `key` string, required — The unique key/identifier for this attribute.
          - `translationKey` string, required — Translation key for internationalization.
          - `validators` OIBusAttributeValidator[], required — Validators to apply to this attribute.
            - `type` 'REQUIRED' | 'MINIMUM' | 'MAXIMUM' | 'POSITIVE_INTEGER' | 'VALID_CRON' | 'PATTERN' | 'UNIQUE' | 'SINGLE_TRUE' | 'MQTT_TOPIC_OVERLAP' | 'PLATFORM', required — Type representing the possible validator types for OIBus form attributes.
            - `arguments` string[], required — Arguments for the validator. For example, for MINIMUM validator: ["10"] would set minimum value to 10.
          - `attributes` OIBusAttribute[], required — Child attributes contained within this object.
            - union — Union type representing all possible OIBus form attributes. Includes both displayable attributes and array/object containers.
              - …
          - `enablingConditions` OIBusEnablingCondition[], required — Conditions that determine when this object should be enabled.
            - `targetPathFromRoot` string, required — Path to the attribute that should be enabled/disabled.
            - `referralPathFromRoot` string, required — Path to the attribute whose value determines the enabling condition.
            - `values` union[], required — Values of the referral attribute that will enable the target attribute.
              - …
            - `operator` 'EQUALS' | 'CONTAINS' | 'NOT_EQUAL' — Operator to use for the condition. EQUALS: The referral attribute value must be equal to one of the values. CONTAINS: The referral attribute value must contain one of the values (string only).
          - `displayProperties` OIBusObjectDisplayProperties, required — Display properties for object-type form attributes. Controls visibility and styling of object containers.
            - `visible` boolean, required — Whether this object should be visible in the form.
            - `wrapInBox` boolean, required — Whether this object should be wrapped in a visual box/container.
        - `functionName` string, required — The name of the standard function that implements the transformation.
  - `totalElements` number, double, required — The total number of elements across all pages.
  - `size` number, double, required — The size of the page, i.e., the maximum number of elements per page.
  - `number` number, double, required — The number of the current page, starting at 0.
  - `totalPages` number, double, required — The total number of pages (which can be 0 if there are no elements).

---

[API](https://skmtc.net/optimistiksas/apis/oibus-api.md) · [All operations](https://skmtc.net/optimistiksas/apis/oibus-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/optimistiksas/oibus-api/versions/743d1b62f042/schema)
