Release Notes

In this release, we introduced new Encore APIs to accept and reject incoming Book copy requests with enhanced webhook notifications, launched Benchmarking for peer-based underwriting insights, released the Save Income Guideline API for mortgage workflows, added Email Forwarder for email-based document submission, published new SMB and Mortgage how-to video hubs, introduced a new FAQ page to support faster self-service, expanded webhook security with secret rotation support, and enhanced the book_summary endpoint with richer industry classification fields.

What's new?

SMB

Encore - new APIs for managing incoming Book copy requests

As part of ongoing enhancements to the Book copy workflow, we’ve introduced two new APIs that allow recipient organizations to accept or reject incoming Book copy requests directly through the Ocrolus API. These endpoints give recipients greater control, reduce manual coordination, and ensure sender organizations receive immediate webhook notifications based on the decision.

• Accept Book Copy Job [POST] https://api.ocrolus.com/v1/book/copy-jobs/{job_id}/accept:
  This API allows a recipient organization to accept an incoming Book copy request. Upon acceptance, Ocrolus begins copying the Book and all associated documents into the recipient’s organization. A book.copy.request_accepted webhook is automatically sent to the sender organization. You may optionally provide a sanitized custom book_name as part of the request.
• Reject Book Copy Job [POST] https://api.ocrolus.com/v1/book/copy-jobs/{job_id}/reject:
  This API allows a recipient organization to reject an incoming Book copy request. When rejected, a book.copy.request_rejected webhook is triggered and sent to the sender organization. No request body is required. This API is designed for SMB lenders using the Book copy feature.

Together, these APIs streamline decision-making on shared Books, improve workflow automation for recipients, and ensure senders receive clear, immediate feedback through webhook notifications. To learn more, see the Encore user guide and Encore API documentation.

Webhook events

We have introduced two new organization-level webhook events for senders. These events notify the sender organization when a recipient accepts or rejects a Book copy request:

• book.copy.request_accepted — Triggered when a recipient organization accepts the Book copy request.
• book.copy.request_rejected — Triggered when a recipient organization rejects the Book copy request.

Additionally, the book.copy.request_received webhook has been enhanced to include a cash flow preview section. This preview provides a high-level cash flow summary of the Book based on the recipient organization’s cash flow analytics configuration, helping recipients make informed decisions when accepting or rejecting a shared Book request.

To learn more, see the available events.

Benchmarking — peer-based financial insights for smarter underwriting

Benchmarking, a new Ocrolus Intelligence capability, is now available in the Ocrolus Dashboard. Benchmarking helps lenders evaluate a merchant’s financial performance by comparing revenue, expenses, and fintech activity against anonymized peers within the same naics4_code industry using percentile-based insights derived from Ocrolus’ normalized SMB dataset.

With Benchmarking, underwriting and operations teams can quickly determine whether a merchant’s performance is typical, above average, or potentially concerning—directly within their existing workflow and without relying on external research or backend integrations.

To learn more, see the Benchmarking guide.

Ocrolus platform

Email forwarder for document submission

We’ve introduced email forwarder, a new way for lenders, brokers, and partners to submit merchant documents by sending or forwarding emails with attachments to [email protected]. Ocrolus automatically validates attachments, creates a new Book or updates an existing one based on the email thread, uploads documents for verification and analysis, and sends a confirmation email with upload results and a link to the Book in the Dashboard. To learn more, see the Email forwarder guide.

🚧

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.

New FAQ page on Ocrolus doc site

We’ve published a new FAQ page on the Ocrolus documentation site, curated from the most common customer questions. The page is designed to help you quickly find clear answers and practical troubleshooting guidance, without needing to search across multiple guides or submit a support request. To learn more, see Frequently asked questions (FAQs).

📘

Note

This FAQ page will continue to expand as new questions and product features emerge.

Mortgage

Save income guideline API

We’ve introduced the Save Income Guideline API, which allows lenders to set or update the loan program or Government-Sponsored Enterprise (GSE) guideline for an Ocrolus Book. This ensures income calculations follow the correct guideline such as Fannie Mae, Freddie Mac, FHA, VA, or USDA, and are accurately reflected in the Ocrolus Dashboard for underwriting review.

The API supports applying a guideline immediately after Book creation or updating it later if the loan program changes. The most recent guideline is always used for income calculations. To learn more, see the Save income guideline API doc page.

SMB and Mortgage

New how-to videos on Ocrolus doc site

We’ve added two new video hubs to the Ocrolus documentation to help you get started faster and learn best practices through short, task-focused walkthroughs.

• SMB how-to videos: A new SMB how-to videos page is now available on the doc site. These videos cover common workflows across Classify, Analyze, and platform administration—such as creating and managing Books, uploading documents, reviewing results, using the Transactions tab, managing tags, exporting analytics, updating the income formula, and adding users. Use these videos to quickly learn the core SMB experience and apply best practices without trial and error. To learn more see, SMB how-to videos.
• Mortgage how-to videos: We’ve also published a new Mortgage how-to videos page focused on the Ocrolus + Encompass integration. These videos guide you through key mortgage workflows, including document classification, income analysis across borrower types, and reviewing discrepancies between borrower documents and Encompass 1003 data using Inspect. To learn more see, Mortgage how-to videos.

📘

Note

As the Ocrolus platform evolves, we’ll continue adding new walkthroughs and best practices to these video libraries to help you stay efficient and up to date.

Enhancements

Webhook

Webhook security and secret rotation support

We’ve expanded webhook security support with new documentation and APIs to help customers securely verify and manage webhook events from Ocrolus. This release introduces the enhancement on webhook security best practices using HMAC SHA256 signature verification to enable your team confidently validate webhook payloads and protect downstream systems. To learn more, see the Secure webhook URL page.

Analyze

Expanded industry classification fields in book_summary endpoint

We’ve enhanced the book_summary endpoint to include additional industry classification fields to provide more detailed context about a merchant’s business activity.

The response now includes:

• NAICS 6-digit code and description (naics6_code, naics6_description) for a more granular industry classification within the broader NAICS framework.
• NAICS override indicator (naics_override), which identifies whether the NAICS (4-digit code) classification has been manually overridden.
• Merchant Category Code (MCC) and description (mcc_code, mcc_description), which classify the merchant based on payment network definitions derived from transaction activity.
• Standard Industrial Classification (SIC) code and description (sic_code, sic_description), a legacy industry classification included for compatibility with historical and third-party datasets.

👍

Tip

Currently these classifications are available through the API only and are not surfaced in the Ocrolus Dashboard.

To learn more, see the Book summary API documentation.