Information request lifecycle
Each information request progresses through the following statuses as defined in theUnderwritingInformationRequestStatus enum:
Requested
The underwriter has requested additional information.- The request includes instructions describing the information required
- The request is visible via the
underwritingInformationRequestsquery - The application remains in Pending status
ScenarioDuring manual review, an underwriter notices that Ben’s address doesn’t match
records from a third-party verification service. They create an information
request asking for proof of his current address, such as a utility bill or
lease agreement for his keyboard business location.
Fulfilled
The requested information has been provided and received by the platform.- Information is provided using
fulfillUnderwritingInformationRequests - Once fulfilled, the underwriter can review the provided information
- The application may transition to Decisioned after all requests are fulfilled and reviewed
Information request options
The platform provides pre-defined information request options that underwriters can use for common scenarios. These options ensure consistency in how information is requested. Query available options using theunderwritingInformationRequestOptions query.
Information request options help standardize common requests and make it easier for integrators to
anticipate and handle typical information request scenarios.