---
title: "Settling cash into different SHKs or custodian accounts"
slug: "settling-into-different-shks-or-custodian-accounts"
updated: 2026-06-08T08:02:40Z
published: 2026-06-08T08:02:40Z
canonical: "support.lusid.com/settling-into-different-shks-or-custodian-accounts"
---

> ## 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.

# Settling cash into different SHKs or custodian accounts

When you book a transaction you have the option to assign a [sub-holding key](/v1/docs/what-is-a-sub-holding-key-shk) (SHK) or [custodian account](/v1/docs/segregating-holdings-using-custodian-accounts) in order to segregate holding(s) impacted by that transaction from others in the same underlying instruments.

When you load a settlement instruction (SI) for a cash movement generated by that transaction you can choose to override your trade date choice by assigning a different SHK or custodian account. Note this is not currently possible for a stock movement.

> **Note**: SHKs not referenced in a SI are not affected.

For example, imagine we have a standard `Buy` transaction for 100 units of BP @ £5 per share with a `Transaction/MySHKs/Strategy` property set to `Growth`. On the trade date, both stock and temporary cash commitment holdings are segregated into a **Growth** strategy:

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

## Changing or removing a SHK for a cash holding

LUSID web appLUSID API

Call the [UpsertSettlementInstructions](https://www.lusid.com/docs/api/lusid/endpoints/transaction-portfolios/UpsertSettlementInstructions) API and, for a SI with a `settlementCategory` of `CashSettlement` or `DeferredCashReceipt`, specify a `subHoldingKeyOverrides` object with a new property value, or alternatively `null` to [remove the value](/v1/docs/updating-or-deleting-properties#perpetual-properties) and assign no strategy:

```json
curl -X POST "https://<your-domain>.lusid.com/api/api/transactionportfolios/Equities/UK-Growth/settlementinstructions"
  -H "Authorization: Bearer <your-API-access-token>"
  -H "Content-Type: application/json-patch+json"
  -d '[
  {
    "settlementInstructionId": "settle-cash-txn01",
    "transactionId": "Txn01",
    "settlementCategory": "CashSettlement",
    "instrumentIdentifiers": {"Instrument/default/LusidInstrumentId": "CCY_GBP"},
    "actualSettlementDate": "2025-09-10T00:00:00.0000000+00:00",
    "units": -500,
    "subHoldingKeyOverrides": {
      "Transaction/MySHKs/Strategy": {
        "key": "Transaction/MySHKs/Strategy",
        "value": {
          "labelValue": "Income"
        }
      }
    }
  }
]'
```

Follow the instructions for [creating a settlement instruction](/v1/docs/loading-settlement-instructions) and, in the **Create cash settlement** dialog, specify a new value for the SHK property, or click the **X** button to remove the value and assign no strategy:

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

In this example, the units and cost of the now-settled cash balance holding are transferred to an **Income** strategy:

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

## Changing the custodian account for a cash holding

LUSID web appLUSID API

Call the [UpsertSettlementInstructions](https://www.lusid.com/docs/api/lusid/endpoints/transaction-portfolios/UpsertSettlementInstructions) API and, for a SI with a `settlementCategory` of `CashSettlement` or `DeferredCashReceipt`, specify a `custodianAccountOverride` object referencing the scope and code of a new CA:

```json
curl -X POST "https://<your-domain>.lusid.com/api/api/transactionportfolios/Equities/UK-Growth/settlementinstructions"
  -H "Authorization: Bearer <your-API-access-token>"
  -H "Content-Type: application/json-patch+json"
  -d '[
  {
    "settlementInstructionId": "settle-cash-txn01",
    "transactionId": "Txn01",
    "settlementCategory": "CashSettlement",
    "instrumentIdentifiers": {"Instrument/default/LusidInstrumentId": "CCY_GBP"},
    "actualSettlementDate": "2025-09-10T00:00:00.0000000+00:00",
    "units": -500,
    "custodianAccountOverride": {
      "scope": "MyCAs",
      "code": "JPMorgan-LIFO"
    }
  }
]'
```

Follow the instructions for [creating a settlement instruction](/v1/docs/loading-settlement-instructions) and, in the **Create cash settlement** dialog, choose a new **Custodian account** from the dropdown:

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