Skip to main content
PUT
/
v1
/
accounts
/
iban
/
{iban}
Patch account details by IBAN
curl --request PUT \
  --url https://api.vop-sandbox.finventi.com/v1/accounts/iban/{iban} \
  --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"
    }
  }
}
'
{
  "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

​
iban
string
required

IBAN 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

Updated account details

List of account entries that were successfully imported

​
account_holder_names
string[]
required

Names of the account holders

Names of the account holders

Example:
["Alice Johnson"]
​
aliases
string[]
required

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

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

Example:
["HGRP"]
​
iban
string
required

IBAN of the account

Example:

"LT121000011101001000"

​
client_id
string

Client identifier

Example:

"client-12345"

​
organisation_identification
object

Identification details for the organisation.