Skip to main content
PATCH
/
account-service
/
v2
/
accounts
/
{id}
Update account information
curl --request PATCH \
  --url https://api.pgw-sandbox.finventi.com/account-service/v2/accounts/{id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "accountHolderName": "Jane A. Doe",
  "accountHolderNameAliases": "Jane Doe",
  "clientAccountId": "acc_001A",
  "organisationIdentification": {
    "lei": "3423455234Y45D34",
    "bic": "DEUTDEFFXXX",
    "other": {
      "identification": "123-AS-323",
      "schemeNameCode": "DUNS",
      "schemeNameProprietary": "LocalRegistry",
      "issuer": "ChamberOfCommerce"
    }
  }
}
'
{
  "id": 1,
  "clientAccountId": "acc_001",
  "iban": "LT121000011111111111",
  "accountType": "PRIVATE",
  "accountHolderName": "Jane Doe",
  "status": "OPEN",
  "createdAt": "2025-09-10T13:43:40.758Z",
  "updatedAt": "2025-09-10T13:55:40.758Z",
  "ibanMetadata": {
    "countryCode": "LT",
    "bankCode": "70440",
    "accountCode": "1869"
  },
  "accountHolderNameAliases": [
    "HGRP"
  ],
  "organisationIdentification": {
    "lei": "3423455234Y45D34",
    "bic": "DEUTDEFFXXX",
    "other": {
      "identification": "123-AS-323",
      "schemeNameCode": "BANK",
      "schemeNameProprietary": "LocalRegistry",
      "issuer": "ChamberOfCommerce"
    }
  }
}

​
Overview

Updates specific fields of an existing account. This endpoint allows you to modify account holder information without affecting other account properties like IBAN or status.

Path Parameters

​
id
integer<int64>
required

ID

Body

application/json

Request to update account information

​
accountHolderName
string | null

Updated account holder name

Example:

"Jane A. Doe"

​
accountHolderNameAliases
string[] | null

Updated account holder name aliases

Example:

"Jane Doe"

​
clientAccountId
string | null

Updated client account ID (must be unique)

Example:

"acc_001A"

​
organisationIdentification
object

Updated organisation identification details (for LEGAL accounts)

Response

Account updated successfully

Account information response

​
id
integer<int64>
required

Internal account identifier

Example:

1

​
clientAccountId
string
required

Client's internal account ID

Example:

"acc_001"

​
iban
string
required

International Bank Account Number

Example:

"LT121000011111111111"

​
accountType
enum<string>
required

Type of account

Available options:
PRIVATE,
LEGAL
Example:

"PRIVATE"

​
accountHolderName
string
required

Name of the account holder

Example:

"Jane Doe"

​
status
enum<string>
required

Account status

Available options:
OPEN,
CLOSED
Example:

"OPEN"

​
createdAt
string
required

Account creation timestamp

Example:

"2025-09-10T13:43:40.758Z"

​
updatedAt
string
required

Last update timestamp

Example:

"2025-09-10T13:55:40.758Z"

​
ibanMetadata
object

International Bank Account Generation Metadata

​
accountHolderNameAliases
string[] | null

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

Example:
["HGRP"]
​
organisationIdentification
object

Organisation identification details (for LEGAL accounts)