customdropdowndatafetchpaginated

Instead of `customdropdowndatafetchpaginated`, use…	For…
`customdropdownpaginated`	A direct backend API call (no integration endpoint)
`customdropdown`	Small static option lists
`customcascadingdropdowns`	Hard-wired province → district → sector hierarchies

Prop	Type	Required?	Description
`label`	`string`	required	Display label; must be unique across the form.
`bindLabel`	`string`	required	Key in each option object used as the display text.
`bindValue`	`string`	required	Key in each option object used as the stored value.
`url`	`string`	required	Integration engine API URL (typically `/integration/v1/fetch/sync`).
`endpointCode`	`string`	required	Integration endpoint code sent in the request payload.
`dataset.dataField`	`string`	required	Dot-notation path to the array of options inside the integration response.
`dataset.pagination`	`boolean`	required	Must be `true` to enable load-more scrolling.
`required`	`boolean`	required	Always `false`. The expression controls the runtime value.
`defaultRequired`	`boolean`	required	`true` for required fields, `false` for optional ones.
`useBaseUrl`	`boolean`	optional	Prepend the API gateway base URL to `url`. Set `true` for production.
`dataset.httpMethod`	`string`	optional	`'GET'` or `'POST'`. Default `'POST'`.
`dataset.params`	`object`	optional	Extra params merged into the integration request payload.
`dataset.headers`	`object`	optional	Extra HTTP headers.
`dataset.totalPagesKey`	`string`	optional	Path to total pages in the response. Default `'totalPages'`.
`dataset.currentPageKey`	`string`	optional	Path to current page in the response. Default `'currentPage'`.
`dataset.pageKey`	`string`	optional	Param name for page number in the request. Default `'page'`.
`dataset.sizeKey`	`string`	optional	Param name for page size in the request. Default `'size'`.
`dataset.pageStart`	`number`	optional	Initial page number. Default `0`.
`dataset.searching`	`boolean`	optional	Shows the search box and sends a search query to the API as the user types. Default `true` — the search box shows unless you set this to `false` explicitly.
`dataset.searchLocal`	`boolean`	optional	When `true`, filters already-loaded items client-side instead of calling the API. Do not combine with `searching: true`.
`dataset.searchKey`	`string`	optional	Param name for the search value in API requests. Default `'search'`.
`triggerType`	`string`	required	Always `'FIELD_LISTENER'`. This is what makes the component fetch data at all — not just for re-fetching on a dependency change. Leave it out and the dropdown never loads any options.
`payloadKey`	`string`	optional	Field key whose value re-triggers the fetch when it changes. Leave unset for a plain lookup with no dependency — the component still fetches once, on load.
`useMultiplePayloadKeys`	`boolean`	optional	When `true`, use `payloadKeyMappings` instead of `payloadKey`.
`payloadKeyMappings`	`array`	optional	Multiple payload params — each `{ key, sourceField, isStatic, staticValue }`. Set `staticValue` when `isStatic: true`; a mapping with `isStatic: true` and only `sourceField` sends `undefined` for that param.
`debounceTime`	`number`	optional	Milliseconds to debounce field-listener re-fetches. Default `500`.
`populates`	`array`	optional	`{ valueKey, targetKey }` mappings to auto-fill downstream fields on selection.
`placeholder`	`string`	optional	Ghost text shown before a value is selected.
`multiple`	`boolean`	optional	Allows selecting multiple values.
`virtualScroll`	`boolean`	optional	Enables virtual scrolling.
`min`	`number`	optional	Minimum number of selectable items when `multiple: true`.
`max`	`number`	optional	Maximum number of selectable items when `multiple: true`.
`hideField`	`boolean`	optional	Hides the field and excludes its value from submission. Toggle via `expressions["props.hideField"]`.

¶ When to use

¶ When NOT to use

¶ Props

¶ Examples

¶ Minimal — doctor lookup via integration, no dependency

¶ Full example — country lookup that re-fetches when gender changes

¶ Common mistakes

¶ Checklist