
Verification workflow
- The loan officer orders the required verification products for the borrower.
- Payroll and banking orders send or launch the appropriate user session.
- The borrower connects the requested accounts at their direction, or the loan team uploads documents for Doc VOI.
- The integration tracks each verification independently.
- Completed reports and supported source documents are routed to the loan file.
Product status
Each requested product can complete, require action, or fail independently. Do not combine payroll, banking, and Doc VOI into one status when the LOS supports product-level status. Use the verificationstatus object to determine the next action:
- Continue waiting while processing is active.
- Return the borrower to the existing active verification when connection steps are incomplete.
- Surface verification errors and their current remediation.
- Retrieve the report when the verification is complete.
Reports and documents
When a verification reachescompleted or completed_with_errors:
- Retrieve the report PDF from
report.file_url. - Retrieve report JSON from
report.json_urlwhen available. - Retrieve supported payroll documents through the Payroll Documents API.
- Retrieve uploaded source files through the User Uploads API.
Re-verification
Use Re-verification for updated payroll, banking, or Doc VOI results. An active connection can support a refreshed verification without borrower action. When updated authentication is required, create the appropriate new session and return the borrower to the existing account.Notifications
Use the LOS event model for loan-team notifications and Argyle webhooks for backend lifecycle state. Keep these responsibilities separate:- LOS events notify operators inside the loan system.
- The
verifications.updatedwebhook updates the verification record and report readiness. - Account and resource webhooks support direct-data workflows.