Release notes
Start free trialRaise a request
Back to All

May 2025

about 1 month ago by Akhilesh

Release Notes

This release introduces new Tag Management and Income APIs, selective filters for Book Summary, a unified Income Inclusion toggle, and support for both classify-only and classify-and-capture documents.

What's new?

Analyze - mortgage lending

Shift differential - Wage earner income calculation

A new feature, shift differential, has been introduced in the wage earner income calculation to help underwriters evaluate borrower income by treating shift differential as a separately tracked and calculated income module.

Shift differential refers to compensation paid at a premium rate for hours worked during non-traditional times, such as nights, weekends, or holidays. This income segment is now handled independently from regular wages, overtime, or bonuses to ensure greater clarity and compliance in income evaluation.

👍

Info

Shift differential income is also available to the Analyze Income API that is currently in beta.

Feature spotlight

  • Dedicated module for shift differential income: This specialized module now identifies and manages shift differential pay separately from other income types. This separation is based on income description to ensure that the shift differential income is clearly categorized and isolated.
  • Independent income calculation: The system calculates shift differential income independently, using logic similar to overtime income calculations. This supports a more granular representation of income variability.
  • Eligibility logic enforcement : Shift differential income is excluded from the total monthly qualifying income by default unless there is sufficient payment history. To be considered eligible for inclusion, the borrower must have received consistent shift differential pay for a minimum of two years.
  • Encompass integration: Shift differential income is automatically mapped to the Other income field in the Verification of Employment (VOE) section in Encompass. If additional income is already present in the Other field (e.g., MISC income), the shift differential amount is added to the existing total.

To learn more, see the Wage earner page.

Tag management [beta]

We’re excited to introduce a suite of Tag Management APIs designed to give developers and analysts more control over how transactions are classified, grouped, and evaluated within the Ocrolus platform. In addition to the Dashboard UI, now you can use these APIs to create, retrieve, modify, and delete tags, manage revenue deduction logic, and override transaction-level tagging.

🚧

This feature is in beta!

This feature is in beta. You may occasionally experience unannounced changes or bugs. We'd greatly appreciate your feedback on this feature and its accompanying documentation.

Tag management APIs

You can now perform complete tag lifecycle operations using the following newly added APIs:

  • Create a tag: Create new custom tags with configurable logic, including thresholds, keywords, and recurrence patterns.
  • Retrieve a specific tag: Fetch full details of a single tag by its unique identifier, tag_uuid.
  • Retrieve all system and custom tags: This API retrieves a list of all tags, including system-defined and user-defined ones. It supports filtering with the is_system_tag parameter.
  • Modify a tag: Update tag details such as name, description, visual attributes, and logic.
  • Delete a tag: Remove any custom tag using tag_uuid. System tags remain protected from deletion.

Revenue deduction tag controls

Tags used to adjust credit-based revenue can now be managed programmatically using the following newly added APIs:

Transaction-level overrides

  • Override transaction tags: Manually apply or remove tags at the transaction level to improve tagging precision for downstream analytics.

These updates simplify and centralize tag logic management across the Ocrolus platform, and help streamline workflows, reduce manual overhead, and increase the accuracy of income and revenue analysis.

Analyze

Income summary and income calculation APIs [beta]

🚧

This feature is in beta!

This feature is in beta. You may occasionally experience unannounced changes or bugs. We'd greatly appreciate your feedback on this feature and its accompanying documentation.

We’ve introduced two new book-level Analyze API endpoints that deliver a comprehensive income summary and detailed income calculations for all borrowers and income sources within a Book:

These endpoints provide structured breakdowns for wage earners, self-employed income (including 1040, 1065, 1120, and 1120S forms), rental properties, and additional income types such as Social Security, pensions, and dividends. Lenders can specify loan programs—Fannie Mae, FHA, VA, or USDA—through request parameters to retrieve the calculations accordingly. The response also includes associated source documents, employer-level groupings, and validation alerts. This allows lenders to access Analyze results programmatically, eliminating the need to rely on the Analyze Dashboard and enabling broader integration across mortgage, consumer, and SMB lending workflows.

book.income.generated webhook event

A new webhook event book.income.generated is introduced. This event is triggered when the Book's income calculation is completed/refreshed.

To learn more about this event, see the Org-level and Account-level webhook sections.

Selective exclusion from Book Summary endpoint [beta]

🚧

This feature is in beta!

This feature is in beta. You may occasionally experience unannounced changes or bugs. We'd greatly appreciate your feedback on this feature and its accompanying documentation.

This release introduces enhanced filtering capabilities for the Book summary endpoint. It allows you to generate more focused analytics. You can now use query parameters to exclude specific bank accounts or monthly periods from the summary calculations of a Book. These filters help refine your insights without modifying the underlying transaction data.

  • exclude_bank_account_pks: Excludes one or more bank account primary keys from the summary. 
    GET https://api.ocrolus.com/v2/book/{book_uuid}/summary?exclude_bank_account_pks={bank_account_pk}
  • exclude_months: Excludes one or more months from the summary, specified in YYYY-MM format. 
    GET https://api.ocrolus.com/v2/book/{book_uuid}/summary?exclude_months=2024-11

To learn more, see Book summary endpoint.

Mortgage

Income inclusion toggle for Wage Earner and Self-Employed income

A unified Include/Exclude Income toggle has been introduced on both the Wage Earner and Self-Employed tabs of the Ocrolus Dashboard. This toggle allows you to control whether income from a borrower or business is included in the Income Summary and exports. The enhancement simplifies decision-making and ensures consistency across all income types.

The toggle controls the visibility and inclusion of related income types in calculations and summaries. By default, income is excluded for inactive employers and included for active ones. Excluded entities display greyed-out income, which is not factored into totals or PDF exports. In contrast, included entities have their income calculated and displayed as usual. Tooltips appear for greyed-out entries and disable interaction.

Legacy include/exclude toggles have been removed from individual income schedules and the Liquidity Ratio section. K-1 income inclusion is now also governed by the unified toggle, ensuring consistent behavior across all income sources.

Classify and Capture

New Classify and Capture supported documents

The Classify and Capture supports are enabled for the following newly onboarded documents:

Disclosure

Income/Employment

Other

To learn more, see the All Supported Documents page.

Classify

New Classify-specific documents support

Classify support is now extended for the various documents. Click the category name below to expand/collapse the list of newly supported documents:

Asset
  • Form 1006 - Request for Verification of Deposit
Closing
  • Outgoing Wire Transfer Request
  • Wire Transfer Authorization and Agreement
Disclosure
  • Certificate of Borrower and Guarantor
  • Electronic Consent Based Social Security Number Verification
  • Fair Credit Reporting Act
  • Flood Hazard Insurance Notice
  • Interest Rate Lock Agreement
  • Notice of Free Choice of Agent and Insurer
  • Property Condition Disclosure Statement
  • Wire Fraud Alert
Identification
  • Certificate of Naturalization
  • Marriage Certificate
  • Notary Identification Statement
  • Social Security Verification Services
Income/Employment
  • Employment Agreement
  • Special Depreciation Elections
Legal
  • Errors and Omissions Agreement
  • Lien Waiver Form
  • Notice of Assessment Lien
  • Pledge and Security Agreement
  • Purchase Money Security Document
  • Security Deed
  • Survivorship Deed
Mortgage specific forms
  • Borrower Servicing Data
  • Solar Power Purchase Agreement
Other
  • Child Care Certification
  • SmartLinx Business Report
  • SmartLinx Person Report
Property
  • Affidavit of Death of Life Estate Owner
  • Affidavit of Title
  • Confirmation of Clear Title Form
  • Form 1000 or 1007 - Single Family Comparable Rent Schedule
  • Form 2055 - Exterior-only Inspection Residential Appraisal Report
  • Form 465 or 1073 - Individual Condominium Unit Appraisal Report
  • Form 70B or 1004C - Manufactured Home Appraisal Report
  • Form 72 or 1025 - Small Residential Income Property Appraisal Report
  • Home Warranty Agreement
  • Land Appraisal Report
  • Property Coverage Confirmation
  • Real Estate Appraiser License
  • Residential Real Property Disclosure Report
Tax forms
  • 8936 Schedule A - Clean Vehicle Credit Amount
  • 8986 - Partner’s Share of Adjustment(s) to Partnership-Related Item(s)

To learn more, see the All Supported Documents page.

Enhancements

Mortgage

Self-service mapping tool

The following enhancements have been made to the self-service taxonomy mapping tool for Encompass to improve usability, reduce reliance on support, and streamline onboarding for new form types:

  • Search bar functionality: Quickly locate specific form types within Encompass mappings using a new, intuitive search bar.
  • Filter for unmapped form types: Effortlessly identify and focus on unmapped form types using the new filtering option.
  • Expand All option: View all form type mappings at once with the new Expand All feature.
  • Downloadable .csv reports: Export your Encompass mapping data as a .csv file for reporting, auditing, or collaboration purposes.
  • Attachment Name column: A new editable column enables you to rename document attachments directly within the tool, eliminating the need for Ocrolus support.

To learn more, see the Classify for Encompass page.