> ## 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.

# UnderwritingDynamicField

> A filled value, or selected variant, for a dynamic field schema node on an underwriting application.

`OBJECT`

A filled value, or selected variant, for a dynamic field schema node on an underwriting application.

## Fields

<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="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="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="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>

<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="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="selectedVariantKey" type="String">
  The stable key of the variant chosen for a CHOICE node.
</ResponseField>

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