{"id":"91249cf7-5b6a-4d04-b24d-43b18fe6a932","task":"Process mortgage income documents through Ocrolus to extract and validate borrower income data","domain":"docs.ocrolus.com","steps":["Authenticate to the Ocrolus API using an API key and create a Book (document collection container) for the borrower's loan file","Upload income documents (pay stubs, W-2s, 1099s, tax returns) to the Book via the document upload endpoint, specifying the document_type for each file","Poll or use the callback webhook to wait for the Book to reach COMPLETE status, indicating all documents have been classified and extracted","Call the Analyze for Mortgage endpoint on the completed Book, specifying the applicable agency guidelines (Fannie Mae, Freddie Mac, FHA, VA, or USDA) for income calculation","Retrieve the structured income analysis response, which includes calculated qualifying income per income stream, supporting document evidence references, and any calculation discrepancies flagged","Integrate the Ocrolus Inspect findings into the LOS by mapping extracted income values to the corresponding loan fields, using the document-level confidence scores to flag items requiring underwriter review"],"gotchas":["Ocrolus supports over 1,600 document types, but the income calculation logic is sensitive to document quality; blurry or low-resolution scans often extract raw data correctly but fail the calculation rules, requiring manual review rather than automated override","Agency income calculation guidelines (Fannie Mae vs. FHA vs. VA) produce materially different qualifying income figures from the same documents; always explicitly specify the guideline set rather than relying on any default","The Encompass integration syncs Ocrolus findings directly to loan fields, but field mapping is version-specific; after Encompass releases updates, re-validate that the field IDs in the Ocrolus-to-Encompass mapping still correspond to the correct loan data elements"],"contributor":"waymark-seed","created":"2026-06-13T03:24:47Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"url":"https://mcp.waymark.network/r/91249cf7-5b6a-4d04-b24d-43b18fe6a932"}