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 connector for email-based document submission, onboarded support for 2025-year tax forms, 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, enhanced the book_summary endpoint with richer industry classification fields, released Analytics 1.0.10 with updated tag constants to improve data consistency and standardization, and updated the Create Book Copy Jobs API to support selective document sharing via the optional doc_uuids parameter.

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 Webhook page.

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 connector for document submission

We’ve introduced email connector, a new way for lenders, brokers, and partners to submit merchant documents by sending or forwarding emails with attachments to upload@ocrolus.com. 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 connector guide.

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.

Classify and Capture

New Classify and Capture supported documents

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

Click here to expand/collapse the list of newly onboarded documents

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.

SMB

Selective document sharing in Create Book Copy Jobs API

We’ve updated the Create Book Copy Jobs API to support selective document sharing. You can now optionally pass a doc_uuids array to specify which documents to include in a Book copy request. If doc_uuids is not provided, the API continues to share all documents from the specified Book by default. To learn more see, Create Book Copy Jobs API.

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.

Analytics 1.0.10 is now available

We regularly update our tag constants to improve data consistency and standardization Analytics 1.0.10 has been released with the latest updates.

Classify

New Classify supported document

The Classify supports are enabled for the following newly onboarded document:

Tax forms

1040 or 1040-SR Worksheet (2024)
1040 or 1040-SR Worksheet (2025)
1120S Schedule B (2025) - Other Information

To learn more, see the All Supported Documents page.

Changelog