---
title: "Auditing transaction settlement status"
slug: "auditing-settlement-status"
updated: 2026-06-08T08:02:26Z
published: 2026-06-08T08:02:26Z
canonical: "support.lusid.com/auditing-settlement-status"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.lusid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Auditing transaction settlement status

Imagine we have a `Buy` transaction of 100 units of BP @ £5 per share:

- The transaction date is 1 September 2025 at 00:00:00.
- The contractual settlement date is 5 September 2025 at 00:00:00.

For the purposes of this example, [LUSID is configured](/v1/docs/configuring-lusid-to-enable-settlement-strategies) as follows:

- The `Buy` transaction type has a settlement mode of `External` for both the `StockMovement` and `CashCommitment` movement types.
- The parent portfolio has `Automatic` set for stock settlement method but `Instructed` for cash settlement method.

If we examine the **Portfolio Management > Holdings** dashboard (or call the [GetHoldings](https://www.lusid.com/docs/api/lusid/endpoints/transaction-portfolios/GetHoldings/) API) on the transaction date, we see both stock and cash holdings are unsettled, as expected:

![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image-CC2QR2V3.png)

If we fast-forward to the contractual settlement date, we see that LUSID has automatically settled the stock holding in full, but the cash holding remains unsettled and the units are now overdue. Note the [holding type](/v1/docs/what-are-the-holding-types) is also still classified as a temporary, unsettled **Cash Commitment**:

![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image-85N4OCEL.png)

We can call the [GetTransactionSettlementStatus](https://www.lusid.com/docs/api/lusid/endpoints/transaction-portfolios/GetTransactionSettlementStatus) API for this transaction on the contractual settlement date to understand the cause. For the cash holding we can see that, in the picture below:

- The `settlementMode` on the transaction type is `External` (in yellow) and `configuredSettlement` on the portfolio is `Instructed` (in green), so LUSID has negated the contractual settlement date.
- No `settlementInstructions` have been received (in red), so the `status` remains `Unsettled` (in blue).

[See how to load a settlement instruction](/v1/docs/loading-settlement-instructions).

![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image-8K281ZFC.png)