Release Notes

In this release, we’ve added the new API to get loan details using Book UUID for LOS synchronization and introduced the XID attribute in entity config and income APIs for improved data traceability.

What's new?

Mortgage

Retrieve Encompass loan details by book_uuid

We’re excited to introduce the GET /v2/los-connect/book/{book_uuid}/loan API. This API is designed to fetch and correlate the Encompass Loan GUID for a given Ocrolus Book UUID. This ensures accurate, point-in-time synchronization between the Ocrolus platform and Encompass LOS for improved workflow automation and data consistency. To learn more, see the loan details from Book API doc page.

Sample response

{
  "loan_details": {
    "loan_id": "c45d08b2-f123-4dff-82b0-11aa3f5c34d9",
    "loan_number": "TEST202512345",
    "client_instance_id": "TEBE98765432",
    "created_ts": "2025-10-27T17:47:18.955864+00:00"
  },
  "book_details": {
    "book_pk": 764839,
    "name": "Encompass TE Integration Testing-c45d08b2-f123-4dff-82b0-11aa3f5c34d9-001",
    "book_status": "ACTIVE",
    "created_ts": "2025-10-27T17:47:21.129183",
    "book_uuid": "abf37196-12e5-47ca-b33c-e12aa3c9de11"
  }
}

Enhancements

Mortgage

XID attribute support in entity config and income APIs

We’ve introduced a new xid attribute in the entity configuration (request and response payloads) and the income APIs(response payload).

The xid serves as a unique identifier for each borrower–employer pair, enabling seamless data mapping, improved traceability, and easier reconciliation across systems. This enhancement will help you align Ocrolus data with your internal identifiers or external data sources to ensure consistency across income analysis and entity configuration workflows.

To learn more, see the income calculations and entity configuration API documentation pages.