> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tesouro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# DecisionComponentItem

> An item within an underwriting decision component representing a single verification check or data review task.

`OBJECT`

An item within an underwriting decision component representing a single verification check or data review task.

## Fields

<ResponseField name="outcomes" type="DecisionComponentOutcomes!" required>
  The processed underwriting outcome results and items to review.

  <Expandable title="child attributes">
    <ResponseField name="results" type="[DecisionComponentOutcome!]!" required>
      The outcomes of the underwriting processing on this decision component.

      <Expandable title="child attributes">
        <ResponseField name="displayOrder" type="Int!" required>
          An ordering of fields to provide a consistent view.
        </ResponseField>

        <ResponseField name="guidance" type="String">
          A detailed description of actions to be taken pertaining to a decision component.
        </ResponseField>

        <ResponseField name="label" type="String">
          A description of the component.
        </ResponseField>

        <ResponseField name="statusGuidance" type="String" deprecated>
          A detailed description of actions to be taken pertaining to a decision component.

          **Deprecated:** Use guidance instead.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="reviews" type="[DecisionComponentReview!]!" required>
      The items needing to be reviewed from the underwriting processing on this decision component.

      <Expandable title="child attributes">
        <ResponseField name="createdDate" type="Date">
          The date the data for this review was created.
        </ResponseField>

        <ResponseField name="fields" type="[DecisionComponentReviewField!]!" required>
          The data fields used in this underwriting review process.

          <Expandable title="child attributes">
            <ResponseField name="associatedApplicationFieldId" type="UUID">
              The associated application field id corresponding to the data field used in this review, if a corresponding field exists.
            </ResponseField>

            <ResponseField name="displayOrder" type="Int!" required>
              A logical ordering of the field for viewing.
            </ResponseField>

            <ResponseField name="format" type="DecisionComponentFieldFormat!" required>
              A format describing the type of data in the field value.

              <Expandable title="Possible enum values">
                <ResponseField name="CURRENCY_USD" type="enum">
                  A monetary value in US dollars.
                </ResponseField>

                <ResponseField name="DATE" type="enum">
                  A calendar date value.
                </ResponseField>

                <ResponseField name="NUMBER" type="enum">
                  A numeric value.
                </ResponseField>

                <ResponseField name="PHONE_NUMBER" type="enum">
                  A telephone number.
                </ResponseField>

                <ResponseField name="PERCENTAGE" type="enum">
                  A percentage, formatted as a decimal. e.g., 5.00% will be formatted as 0.05
                </ResponseField>

                <ResponseField name="TEXT" type="enum">
                  A plain text value.
                </ResponseField>
              </Expandable>
            </ResponseField>

            <ResponseField name="name" type="String!" required>
              The identifying name of the field.
            </ResponseField>

            <ResponseField name="status" type="DecisionComponentReviewFieldStatus!" required>
              The underwriting review process status associated with the field, e.g., MATCH - the fields value matched to the associated application field's value.

              <Expandable title="Possible enum values">
                <ResponseField name="MATCH" type="enum">
                  The field value exactly matches the corresponding application data.
                </ResponseField>

                <ResponseField name="NOT_ATTEMPTED" type="enum">
                  The comparison was not attempted for this field.
                </ResponseField>

                <ResponseField name="NOT_MATCHED" type="enum">
                  The field value does not match the corresponding application data.
                </ResponseField>

                <ResponseField name="PARTIAL_MATCH" type="enum">
                  The field value partially matches the corresponding application data.
                </ResponseField>
              </Expandable>
            </ResponseField>

            <ResponseField name="value" type="String!" required>
              The value of the field used in the underwriting review process.
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="label" type="String!" required>
          A descriptive label.
        </ResponseField>

        <ResponseField name="lastUpdatedDate" type="Date">
          The date the data for this review was last updated.
        </ResponseField>

        <ResponseField name="type" type="DecisionComponentReviewType!" required>
          The type of the data in the review.

          <Expandable title="Possible enum values">
            <ResponseField name="INQUIRY_DATA" type="enum">
              The data in the review was supplied as the inquiry data.
            </ResponseField>

            <ResponseField name="REVIEW" type="enum">
              The data in the review was returned from a review process.
            </ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="fields" type="[DecisionComponentField!]!" required>
  <Expandable title="child attributes">
    <ResponseField name="displayOrder" type="Int!" required>
      The display order of this field within the decision component item.
    </ResponseField>

    <ResponseField name="fieldValue" type="String">
      The current value of this field sourced from the associated application data.
    </ResponseField>

    <ResponseField name="id" type="UUID!" required>
      The unique identifier of the decision component field.
    </ResponseField>

    <ResponseField name="lastUpdatedBy" type="Actor">
      The actor (user or app) who last updated this record

      See [Actor](/acquiring/reference/graphql/types/actor)
    </ResponseField>

    <ResponseField name="schema" type="UnderwritingDecisionComponentFieldSchema">
      <Expandable title="child attributes">
        <ResponseField name="associatedApplicationField" type="String!" required>
          A JSON-type path of the location within the application of the field.
        </ResponseField>

        <ResponseField name="fieldType" type="DecisionComponentFieldType!" required>
          The type of the field, determining the UI input control used to collect data.

          <Expandable title="Possible enum values">
            <ResponseField name="CHECKBOX" type="enum">
              A boolean checkbox field for yes/no values.
            </ResponseField>

            <ResponseField name="CURRENCY" type="enum">
              A field whose value is a currency.
            </ResponseField>

            <ResponseField name="DATE_PICKER" type="enum">
              A date picker field for selecting a date value.
            </ResponseField>

            <ResponseField name="SELECT" type="enum">
              A single-value dropdown selection field.
            </ResponseField>

            <ResponseField name="SELECT_MULTIPLE" type="enum">
              A multi-value dropdown selection field.
            </ResponseField>

            <ResponseField name="TEXTAREA" type="enum">
              A multi-line text area field for longer text input.
            </ResponseField>

            <ResponseField name="TEXT_FIELD" type="enum">
              A single-line text field for short text input.
            </ResponseField>

            <ResponseField name="TEXT_FIELD_MASKED" type="enum">
              A masked text field for sensitive data such as tax identification numbers.
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="helperText" type="String!" required>
          A description of the decision component field.
        </ResponseField>

        <ResponseField name="id" type="UUID!" required>
          The unique identifier of the field schema.
        </ResponseField>

        <ResponseField name="isDisabled" type="Boolean!" required>
          Boolean with value true if the given field is no longer used by the decision component.
        </ResponseField>

        <ResponseField name="isReadOnly" type="Boolean!" required>
          Boolean with value true if the given field is not modifiable.
        </ResponseField>

        <ResponseField name="isRequired" type="Boolean!" required>
          Boolean with value true if the given field is required.
        </ResponseField>

        <ResponseField name="label" type="String!" required>
          The field name formatted for display.
        </ResponseField>

        <ResponseField name="selectFieldOptions" type="[SelectFieldOption!]!" required>
          The possible options for a select type field

          <Expandable title="child attributes">
            <ResponseField name="label" type="String!" required>
              The human-readable label displayed for this option.
            </ResponseField>

            <ResponseField name="value" type="String!" required>
              The underlying value submitted when this option is selected.
            </ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="sensitiveFields" type="DecisionComponentFieldSensitiveFields">
      Sensitive field values for TEXT\_FIELD\_MASKED fields (requires special permissions).

      <Expandable title="child attributes">
        <ResponseField name="fieldValue" type="String">
          The sensitive field value for TEXT\_FIELD\_MASKED fields (requires special permissions).
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="status" type="DecisionComponentFieldStatus">
      The current verification status of this field in the underwriting process.

      <Expandable title="Possible enum values">
        <ResponseField name="MATCH" type="enum">
          The field value matches the corresponding application data.
        </ResponseField>

        <ResponseField name="NEEDS_REVIEW" type="enum">
          The field value requires manual review by an underwriter.
        </ResponseField>

        <ResponseField name="NOT_MATCHED" type="enum">
          The field value does not match the corresponding application data.
        </ResponseField>

        <ResponseField name="NOT_VERIFIED" type="enum">
          The field value could not be verified against external data sources.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="updatedDateTime" type="DateTime!" required>
      The last date and time this was updated in UTC.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="dynamicFields" type="[UnderwritingDynamicField!]!" required>
  The dynamic field values captured against this decision-component item (e.g. one owner's identity fields), assembled into the catalog's recursive shape.

  <Expandable title="child attributes">
    <ResponseField name="children" type="[UnderwritingDynamicField!]!" required>
      The filled subfield values for a GROUP node, or for the selected variant of a CHOICE node.
    </ResponseField>

    <ResponseField name="decisionComponentItemId" type="UUID">
      The decision-component item this value is scoped to (e.g. one owner); null for an application-level value.
    </ResponseField>

    <ResponseField name="fieldValue" type="String">
      The captured value as a string, interpreted according to the schema node's field type. Null for CHOICE nodes (see selectedVariantKey); a masked field exposes its revealed value via sensitiveField.
    </ResponseField>

    <ResponseField name="id" type="UUID!" required>
      The unique identifier of this dynamic field value node.
    </ResponseField>

    <ResponseField name="parentDynamicFieldId" type="UUID">
      The id of this node's parent dynamic field value, or null for a top-level node. Lets clients reconstruct the tree from a flat list of values.
    </ResponseField>

    <ResponseField name="schema" type="UnderwritingDynamicFieldSchema">
      The dynamic field schema node this value is for, loaded from the catalog.

      <Expandable title="child attributes">
        <ResponseField name="children" type="[UnderwritingDynamicFieldSchema!]!" required>
          The child nodes of this node: a GROUP's children all apply, while a CHOICE's children are its mutually-exclusive variants. This single recursive resolver serves every level of the catalog tree.
        </ResponseField>

        <ResponseField name="fieldType" type="UnderwritingDynamicFieldType">
          The UI control type of a SCALAR node, determining how it is rendered and how its value is interpreted.

          <Expandable title="Possible enum values">
            <ResponseField name="CHECKBOX" type="enum">
              A boolean checkbox for true/false or yes/no values.
            </ResponseField>

            <ResponseField name="CURRENCY" type="enum">
              A field whose value is a currency.
            </ResponseField>

            <ResponseField name="DATE_PICKER" type="enum">
              A date picker control for selecting a calendar date.
            </ResponseField>

            <ResponseField name="SELECT" type="enum">
              A dropdown control allowing selection of a single value from a predefined list.
            </ResponseField>

            <ResponseField name="TEXTAREA" type="enum">
              A multi-line text area for entering longer text values.
            </ResponseField>

            <ResponseField name="TEXT_FIELD" type="enum">
              A single-line text input field.
            </ResponseField>

            <ResponseField name="TEXT_FIELD_MASKED" type="enum">
              A single-line text input field where the value is masked for sensitive data such as SSN or account numbers.
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="helperText" type="String">
          Optional helper text guiding the user when filling this field.
        </ResponseField>

        <ResponseField name="id" type="UUID!" required>
          The unique identifier of the dynamic field schema node.
        </ResponseField>

        <ResponseField name="isRequired" type="Boolean!" required>
          Whether a value for this node is required.
        </ResponseField>

        <ResponseField name="key" type="String!" required>
          The stable, immutable machine key for this node, e.g. "business\_id".
        </ResponseField>

        <ResponseField name="kind" type="UnderwritingDynamicFieldKind!" required>
          The structural kind of this node, determining how its value and child nodes are interpreted.

          <Expandable title="Possible enum values">
            <ResponseField name="CHOICE" type="enum">
              A container whose child nodes are mutually exclusive; exactly one variant is selected and only that variant's children apply.
            </ResponseField>

            <ResponseField name="GROUP" type="enum">
              A container whose child nodes all apply together.
            </ResponseField>

            <ResponseField name="SCALAR" type="enum">
              A leaf node holding a single typed value as described by its data type.
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="label" type="String!" required>
          The display label for this node.
        </ResponseField>

        <ResponseField name="parentDynamicFieldSchemaId" type="UUID">
          The id of this node's parent schema node, or null for a root node. Lets clients reconstruct the catalog tree from a flat list of nodes.
        </ResponseField>

        <ResponseField name="selectFieldOptions" type="[SelectFieldOption!]!" required>
          The selectable options for a SELECT field.

          <Expandable title="child attributes">
            <ResponseField name="label" type="String!" required>
              The human-readable label displayed for this option.
            </ResponseField>

            <ResponseField name="value" type="String!" required>
              The underlying value submitted when this option is selected.
            </ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="selectedOptions" type="[SelectFieldOption!]">
      The resolved options for a SELECT value, matching the selected option keys against the schema node's option list.

      <Expandable title="child attributes">
        <ResponseField name="label" type="String!" required>
          The human-readable label displayed for this option.
        </ResponseField>

        <ResponseField name="value" type="String!" required>
          The underlying value submitted when this option is selected.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="selectedVariant" type="UnderwritingDynamicFieldSchema">
      The selected variant schema node for a CHOICE value, resolved from the catalog by the selected variant key.

      <Expandable title="child attributes">
        <ResponseField name="children" type="[UnderwritingDynamicFieldSchema!]!" required>
          The child nodes of this node: a GROUP's children all apply, while a CHOICE's children are its mutually-exclusive variants. This single recursive resolver serves every level of the catalog tree.
        </ResponseField>

        <ResponseField name="fieldType" type="UnderwritingDynamicFieldType">
          The UI control type of a SCALAR node, determining how it is rendered and how its value is interpreted.

          <Expandable title="Possible enum values">
            <ResponseField name="CHECKBOX" type="enum">
              A boolean checkbox for true/false or yes/no values.
            </ResponseField>

            <ResponseField name="CURRENCY" type="enum">
              A field whose value is a currency.
            </ResponseField>

            <ResponseField name="DATE_PICKER" type="enum">
              A date picker control for selecting a calendar date.
            </ResponseField>

            <ResponseField name="SELECT" type="enum">
              A dropdown control allowing selection of a single value from a predefined list.
            </ResponseField>

            <ResponseField name="TEXTAREA" type="enum">
              A multi-line text area for entering longer text values.
            </ResponseField>

            <ResponseField name="TEXT_FIELD" type="enum">
              A single-line text input field.
            </ResponseField>

            <ResponseField name="TEXT_FIELD_MASKED" type="enum">
              A single-line text input field where the value is masked for sensitive data such as SSN or account numbers.
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="helperText" type="String">
          Optional helper text guiding the user when filling this field.
        </ResponseField>

        <ResponseField name="id" type="UUID!" required>
          The unique identifier of the dynamic field schema node.
        </ResponseField>

        <ResponseField name="isRequired" type="Boolean!" required>
          Whether a value for this node is required.
        </ResponseField>

        <ResponseField name="key" type="String!" required>
          The stable, immutable machine key for this node, e.g. "business\_id".
        </ResponseField>

        <ResponseField name="kind" type="UnderwritingDynamicFieldKind!" required>
          The structural kind of this node, determining how its value and child nodes are interpreted.

          <Expandable title="Possible enum values">
            <ResponseField name="CHOICE" type="enum">
              A container whose child nodes are mutually exclusive; exactly one variant is selected and only that variant's children apply.
            </ResponseField>

            <ResponseField name="GROUP" type="enum">
              A container whose child nodes all apply together.
            </ResponseField>

            <ResponseField name="SCALAR" type="enum">
              A leaf node holding a single typed value as described by its data type.
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="label" type="String!" required>
          The display label for this node.
        </ResponseField>

        <ResponseField name="parentDynamicFieldSchemaId" type="UUID">
          The id of this node's parent schema node, or null for a root node. Lets clients reconstruct the catalog tree from a flat list of nodes.
        </ResponseField>

        <ResponseField name="selectFieldOptions" type="[SelectFieldOption!]!" required>
          The selectable options for a SELECT field.

          <Expandable title="child attributes">
            <ResponseField name="label" type="String!" required>
              The human-readable label displayed for this option.
            </ResponseField>

            <ResponseField name="value" type="String!" required>
              The underlying value submitted when this option is selected.
            </ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="selectedVariantKey" type="String">
      The stable key of the variant chosen for a CHOICE node.
    </ResponseField>

    <ResponseField name="sensitiveField" type="UnderwritingDynamicFieldSensitiveFields">
      Sensitive field values for TEXT\_FIELD\_MASKED fields (requires special permissions).

      <Expandable title="child attributes">
        <ResponseField name="fieldValue" type="String">
          The sensitive field value for TEXT\_FIELD\_MASKED dynamic fields (requires special permissions).
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="id" type="UUID!" required>
  The unique identifier of the decision component item.
</ResponseField>

<ResponseField name="stakeholderId" type="UUID">
  The stakeholder id if this decision component item is associated with a particular stakeholder.
</ResponseField>

<ResponseField name="guidance" type="String">
  A detailed description of actions to be taken pertaining to a decision component.
</ResponseField>

<ResponseField name="label" type="String!" required>
  The display label for this decision component item.
</ResponseField>

<ResponseField name="descriptiveText" type="String!" required>
  A descriptive text providing context or guidance for this decision component item.
</ResponseField>

<ResponseField name="status" type="DecisionComponentItemStatus">
  The current processing status of this decision component item in the underwriting workflow.

  <Expandable title="Possible enum values">
    <ResponseField name="ACCEPTED" type="enum">
      The item has been reviewed and accepted by the underwriter.
    </ResponseField>

    <ResponseField name="ACTION_REQUIRED" type="enum">
      The item requires action from the underwriter before processing can continue.
    </ResponseField>

    <ResponseField name="INFORMATIONAL" type="enum">
      The item contains informational results that do not require action.
    </ResponseField>

    <ResponseField name="NOT_ACCEPTED" type="enum">
      The item has been reviewed and not accepted by the underwriter.
    </ResponseField>

    <ResponseField name="PROCESSING" type="enum">
      The item is currently being processed by an external verification service.
    </ResponseField>

    <ResponseField name="SERVICE_UNAVAILABLE" type="enum">
      The external verification service for this item was unavailable.
    </ResponseField>

    <ResponseField name="SUBMISSION_FAILED" type="enum">
      The submission of this item to the external verification service failed.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="displayOrder" type="Int!" required>
  The display order of this item within the decision component.
</ResponseField>
