Sign in

v1

latestOpenAPI 3.1.02026-08-043160244.3 KB
Holdings

Update the maturity action for a holding

Updates the maturity action for an existing holding. This operation applies to the entire holding amount and will overwrite any next actions that have been set. For more granular control over next actions, use the TreasurySpring portal.

put/holding/{entity_code}/{holding_uid}/maturity-action

Path parameters

entity_codestring required

Entity code

Entity code

holding_uidstring required

uid of the holding whose maturity action is being modified.

uid of the holding whose maturity action is being modified.

Request body

action'ROLL' | 'SWITCH' | 'HOLD' | 'REDEEM' required
indicationUidstring nullable

The uid of indication to switch to (Required if action is set to SWITCH)

reason'Funds returning shortly' | 'Better terms elsewhere' | 'Receipt of interest payment' | 'Switching FTF product' | 'Treasury Operations changed' | 'Need proceeds'

Example request

{
  "indicationUid": "f952ed5df4g84f8gh148f4f8sf6g4"
}

Response

Maturity actions

entityCodestring required

Entity Code

holdingUidstring required

Holding uid

Example response

{
  "entityCode": "TEST0001",
  "holdingUid": "16cdb3fe25e743fc9eed4b9742869424",
  "maturityActions": [
    {
      "amount": 5000,
      "currency": "GBP",
      "holdingUid": "74628ebad0f54881b3c76acf146eb3c3",
      "subscriptionUid": "dade0389c66241bd8366b017f1ffe19a",
      "type": "ROLL",
      "uid": "96cd54e5ddfd41b0a77afef15a96660d"
    }
  ]
}