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"
}
}
}
'import requests
url = "https://api.pgw-sandbox.finventi.com/account-service/v2/accounts/{id}"
payload = {
"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"
}
}
}
headers = {"Content-Type": "application/json"}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
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'
}
}
})
};
fetch('https://api.pgw-sandbox.finventi.com/account-service/v2/accounts/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.pgw-sandbox.finventi.com/account-service/v2/accounts/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'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'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.pgw-sandbox.finventi.com/account-service/v2/accounts/{id}"
payload := strings.NewReader("{\n \"accountHolderName\": \"Jane A. Doe\",\n \"accountHolderNameAliases\": \"Jane Doe\",\n \"clientAccountId\": \"acc_001A\",\n \"organisationIdentification\": {\n \"lei\": \"3423455234Y45D34\",\n \"bic\": \"DEUTDEFFXXX\",\n \"other\": {\n \"identification\": \"123-AS-323\",\n \"schemeNameCode\": \"DUNS\",\n \"schemeNameProprietary\": \"LocalRegistry\",\n \"issuer\": \"ChamberOfCommerce\"\n }\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.pgw-sandbox.finventi.com/account-service/v2/accounts/{id}")
.header("Content-Type", "application/json")
.body("{\n \"accountHolderName\": \"Jane A. Doe\",\n \"accountHolderNameAliases\": \"Jane Doe\",\n \"clientAccountId\": \"acc_001A\",\n \"organisationIdentification\": {\n \"lei\": \"3423455234Y45D34\",\n \"bic\": \"DEUTDEFFXXX\",\n \"other\": {\n \"identification\": \"123-AS-323\",\n \"schemeNameCode\": \"DUNS\",\n \"schemeNameProprietary\": \"LocalRegistry\",\n \"issuer\": \"ChamberOfCommerce\"\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pgw-sandbox.finventi.com/account-service/v2/accounts/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"accountHolderName\": \"Jane A. Doe\",\n \"accountHolderNameAliases\": \"Jane Doe\",\n \"clientAccountId\": \"acc_001A\",\n \"organisationIdentification\": {\n \"lei\": \"3423455234Y45D34\",\n \"bic\": \"DEUTDEFFXXX\",\n \"other\": {\n \"identification\": \"123-AS-323\",\n \"schemeNameCode\": \"DUNS\",\n \"schemeNameProprietary\": \"LocalRegistry\",\n \"issuer\": \"ChamberOfCommerce\"\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"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",
"schemeNameProprietary": "LocalRegistry",
"issuer": "ChamberOfCommerce"
}
}
}{
"code": "<string>",
"message": "<string>",
"data": {
"errors": [
{
"field_name": "<string>",
"value": "<string>",
"code": "<string>",
"message": "<string>"
}
],
"message": "<string>"
}
}{
"code": "<string>",
"message": "<string>",
"data": {
"errors": [
{
"field_name": "<string>",
"value": "<string>",
"code": "<string>",
"message": "<string>"
}
],
"message": "<string>"
}
}{
"code": "<string>",
"message": "<string>",
"data": {
"errors": [
{
"field_name": "<string>",
"value": "<string>",
"code": "<string>",
"message": "<string>"
}
],
"message": "<string>"
}
}Update account information
Updates account holder name, legal entity ID, or client account ID.
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"
}
}
}
'import requests
url = "https://api.pgw-sandbox.finventi.com/account-service/v2/accounts/{id}"
payload = {
"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"
}
}
}
headers = {"Content-Type": "application/json"}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
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'
}
}
})
};
fetch('https://api.pgw-sandbox.finventi.com/account-service/v2/accounts/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.pgw-sandbox.finventi.com/account-service/v2/accounts/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'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'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.pgw-sandbox.finventi.com/account-service/v2/accounts/{id}"
payload := strings.NewReader("{\n \"accountHolderName\": \"Jane A. Doe\",\n \"accountHolderNameAliases\": \"Jane Doe\",\n \"clientAccountId\": \"acc_001A\",\n \"organisationIdentification\": {\n \"lei\": \"3423455234Y45D34\",\n \"bic\": \"DEUTDEFFXXX\",\n \"other\": {\n \"identification\": \"123-AS-323\",\n \"schemeNameCode\": \"DUNS\",\n \"schemeNameProprietary\": \"LocalRegistry\",\n \"issuer\": \"ChamberOfCommerce\"\n }\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.pgw-sandbox.finventi.com/account-service/v2/accounts/{id}")
.header("Content-Type", "application/json")
.body("{\n \"accountHolderName\": \"Jane A. Doe\",\n \"accountHolderNameAliases\": \"Jane Doe\",\n \"clientAccountId\": \"acc_001A\",\n \"organisationIdentification\": {\n \"lei\": \"3423455234Y45D34\",\n \"bic\": \"DEUTDEFFXXX\",\n \"other\": {\n \"identification\": \"123-AS-323\",\n \"schemeNameCode\": \"DUNS\",\n \"schemeNameProprietary\": \"LocalRegistry\",\n \"issuer\": \"ChamberOfCommerce\"\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pgw-sandbox.finventi.com/account-service/v2/accounts/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"accountHolderName\": \"Jane A. Doe\",\n \"accountHolderNameAliases\": \"Jane Doe\",\n \"clientAccountId\": \"acc_001A\",\n \"organisationIdentification\": {\n \"lei\": \"3423455234Y45D34\",\n \"bic\": \"DEUTDEFFXXX\",\n \"other\": {\n \"identification\": \"123-AS-323\",\n \"schemeNameCode\": \"DUNS\",\n \"schemeNameProprietary\": \"LocalRegistry\",\n \"issuer\": \"ChamberOfCommerce\"\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"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",
"schemeNameProprietary": "LocalRegistry",
"issuer": "ChamberOfCommerce"
}
}
}{
"code": "<string>",
"message": "<string>",
"data": {
"errors": [
{
"field_name": "<string>",
"value": "<string>",
"code": "<string>",
"message": "<string>"
}
],
"message": "<string>"
}
}{
"code": "<string>",
"message": "<string>",
"data": {
"errors": [
{
"field_name": "<string>",
"value": "<string>",
"code": "<string>",
"message": "<string>"
}
],
"message": "<string>"
}
}{
"code": "<string>",
"message": "<string>",
"data": {
"errors": [
{
"field_name": "<string>",
"value": "<string>",
"code": "<string>",
"message": "<string>"
}
],
"message": "<string>"
}
}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
Body
Request to update account information
Updated account holder name
"Jane A. Doe"
Updated account holder name aliases
"Jane Doe"
Updated client account ID (must be unique)
"acc_001A"
Updated organisation identification details (for LEGAL accounts)
Show child attributes
Show child attributes
Response
Account updated successfully
Account information response
Internal account identifier
1
Client's internal account ID
"acc_001"
International Bank Account Number
"LT121000011111111111"
Type of account
PRIVATE, LEGAL "PRIVATE"
Name of the account holder
"Jane Doe"
Account status
OPEN, CLOSED "OPEN"
Account creation timestamp
"2025-09-10T13:43:40.758Z"
Last update timestamp
"2025-09-10T13:55:40.758Z"
International Bank Account Generation Metadata
Show child attributes
Show child attributes
Optional alternative names or identifiers to improve matching (e.g., acronyms, short forms like "IBM" for "International Business Machines")
["HGRP"]
Organisation identification details (for LEGAL accounts)
Show child attributes
Show child attributes