Skip to main content
PUT
/
v1
/
accounts
/
client
/
{clientId}
Patch account details by Client Id
curl --request PUT \
  --url https://api.vop-sandbox.finventi.com/v1/accounts/client/{clientId} \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_holder_names": [
    "Bob Smith"
  ],
  "aliases": [
    "HGRP"
  ],
  "organisation_identification": {
    "bic": "DEUTDEFFXXX",
    "lei": "5493001KJTIIGC8Y1R12",
    "other": {
      "identification": "123-ABC-XYZ",
      "issuer": "ChamberOfCommerce",
      "scheme_name_code": "BANK",
      "scheme_name_proprietary": "LocalRegistry"
    }
  }
}
'
{
  "accounts": [
    {
      "account_holder_names": [
        "Alice Johnson"
      ],
      "aliases": [
        "HGRP"
      ],
      "client_id": "client-12345",
      "iban": "LT121000011101001000",
      "organisation_identification": {
        "bic": "DEUTDEFFXXX",
        "lei": "5493001KJTIIGC8Y1R12",
        "other": {
          "identification": "123-ABC-XYZ",
          "issuer": "ChamberOfCommerce",
          "scheme_name_code": "VAT",
          "scheme_name_proprietary": "LocalRegistry"
        }
      }
    }
  ]
}

Path Parameters

​
clientId
string
required

Client identifier of the account to update

Body

application/json

Fields to update for the account

​
account_holder_names
string[]
required

New account holder name. Optional; if provided must not be blank.

New account holder name. Optional; if provided must not be blank.

Example:
["Bob Smith"]
​
aliases
string[]

Optional alternative names or identifiers to improve matching (e.g., acronyms, short forms like "IBM" for "International Business Machines")

Optional alternative names or identifiers to improve matching (e.g., acronyms, short forms like "IBM" for "International Business Machines")

Example:
["HGRP"]
​
organisation_identification
object

Legal-entity identifiers for the IBAN owner.

Response

The list of accounts that were updated

​
accounts
object[]
required