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

      See [UnderwritingDynamicFieldType](/underwriting/reference/graphql/types/underwriting-dynamic-field-type)
    </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.

      See [UnderwritingDynamicFieldKind](/underwriting/reference/graphql/types/underwriting-dynamic-field-kind)
    </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.

      See [SelectFieldOption](/underwriting/reference/graphql/types/select-field-option)
    </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.

      See [UnderwritingDynamicFieldType](/underwriting/reference/graphql/types/underwriting-dynamic-field-type)
    </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.

      See [UnderwritingDynamicFieldKind](/underwriting/reference/graphql/types/underwriting-dynamic-field-kind)
    </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.

      See [SelectFieldOption](/underwriting/reference/graphql/types/select-field-option)
    </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>