> ## Documentation Index
> Fetch the complete documentation index at: https://docs-dev-fix-docs-5546-update-db-search.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Type Alias: MfaPollingOptions

```ts Example theme={null}
type MfaPollingOptions = {
  intervalMs?: number;
  onCompleted?: () => void;
  onError?: (error: Error) => void;
}
```

<ParamField body="MfaPollingOptions" type="object">
  Configuration options for managing an MFA push-notification polling process.

  Supply these options when starting a polling session to control how often
  the challenge endpoint is queried and how success or failure is handled.

  <Expandable title="properties">
    <ParamField body="intervalMs" type="number">
      Optional interval, in **milliseconds**, between consecutive polling requests.

      * If omitted, the SDK’s internal default interval is used (typically 5000 ms).
      * Choose a value that balances responsiveness with rate-limit considerations.

      ```ts Default Value theme={null}
      Implementation-specific (commonly 5000 ms)
      ```
    </ParamField>

    <ParamField body="onCompleted" type="() => void">
      Optional callback executed once the MFA push challenge is successfully
      approved and polling completes.

      * Called exactly **once**, after which polling stops automatically.
      * Useful for advancing the login flow (e.g., calling `continue()`).
    </ParamField>

    <ParamField body="onError" type="(error: Error) => void">
      Optional callback invoked if an error occurs while polling.

      Receives an [ULError](/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/Error) object containing:

      * `status` — the HTTP status code from the failed request

      * `responseText` — the raw response body, if available

      * Called once per error event; polling may retry depending on error type.

      * Use to surface error messages or trigger custom retry/abort logic.

      **Properties**

      <ParamField body="error" type={<a href="/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/Error">Error</a>}>
        An error object containing the HTTP status code and raw response body from the failed polling request.
      </ParamField>
    </ParamField>
  </Expandable>
</ParamField>
