# Return User Data Fields

Returns the user data fields defined for the given decision tree GUID.

Endpoint: GET /decisionEngine/{provenirId}/userDataFields
Version: 1.0.0
Security: bearerToken

## Path parameters:

  - `provenirId` (string, required)
    The unique identifier of the decision tree, obtained from .

## Response 200 fields (application/json):

  - `decisionEngineId` (string)
    The unique reference for the decision tree.
    Example: "repoObj_0ed6a4aa_16e17d977e9_07ffb16e17d977e9"

  - `fields` (array)
    A list of user-input data fields that are supported by the provided decision tree. The values for these fields should be passed to the  endpoint call when running a decision.

  - `fields.orderIndex` (number)
    Used to assist ordering of the user data fields on a UI.
    Example: 100

  - `fields.label` (string)
    The user-friendly label for the field for display on a UI.
    Example: "Product Type"

  - `fields.paramName` (string)
    The string value for the parameter to be used when calling the  endpoint.
    Example: "productType"

  - `fields.fieldType` (string)
    The type of user data field.
    Enum: "Text", "Integer", "Dropdown"

  - `fields.mandatory` (boolean)
    Flag to dictate whether the user data field is required when running the associated decision tree.
    Example: true

  - `fields.dropdownDetails` (array,null)

  - `fields.dropdownDetails.label` (string)
    The user-friendly label for the drop-down option for display on a UI.
    Example: "Product A"

  - `fields.dropdownDetails.presentationOrder` (number)
    Used to assist ordering of the drop-down options on a UI.
    Example: 100

  - `fields.validation` (array,null)
    Optional validation rules that should be applied to the corresponding user data field prior to running the decision tree.

  - `fields.validation.validationType` (string)
    The type of validation rule.
    Enum: "Regex Match", "Maximum", "Minimum", "Length", "Custom"

  - `fields.validation.validationValue` (string)
    The value for the validation rule.
    Example: "100"

  - `fields.validation.description` (string)
    A description for the validation rule.
    Example: "Minimum Sales Value $100"

## Response 400 fields (application/json):

  - `correlationId` (string)
    A unique ID assigned to this request.

  - `message` (string)

  - `details` (string)
    Provides further information on why the request was rejected

## Response 401 fields (application/json):

  - `error` (string)