Change the IBAN or account name of a liquidity bank account
curl --request PUT \
--url https://api.pgw-sandbox.finventi.com/v1/liquidity/bank-accounts/{id} \
--header 'Content-Type: application/json' \
--data '
{
"accountName": "<string>",
"iban": "<string>"
}
'import requests
url = "https://api.pgw-sandbox.finventi.com/v1/liquidity/bank-accounts/{id}"
payload = {
"accountName": "<string>",
"iban": "<string>"
}
headers = {"Content-Type": "application/json"}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({accountName: '<string>', iban: '<string>'})
};
fetch('https://api.pgw-sandbox.finventi.com/v1/liquidity/bank-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/v1/liquidity/bank-accounts/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'accountName' => '<string>',
'iban' => '<string>'
]),
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/v1/liquidity/bank-accounts/{id}"
payload := strings.NewReader("{\n \"accountName\": \"<string>\",\n \"iban\": \"<string>\"\n}")
req, _ := http.NewRequest("PUT", 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.put("https://api.pgw-sandbox.finventi.com/v1/liquidity/bank-accounts/{id}")
.header("Content-Type", "application/json")
.body("{\n \"accountName\": \"<string>\",\n \"iban\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pgw-sandbox.finventi.com/v1/liquidity/bank-accounts/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"accountName\": \"<string>\",\n \"iban\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"accountName": "<string>",
"accountType": "OPERATIONAL",
"bic": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"createdBy": "<string>",
"currency": "<string>",
"iban": "<string>",
"id": 123,
"updatedAt": "2023-11-07T05:31:56Z",
"updatedBy": "<string>"
}{
"code": "<string>",
"data": {
"errors": [
{
"code": "<string>",
"field_name": "<string>",
"message": "<string>",
"value": "<string>"
}
],
"message": "<string>"
},
"message": "<string>"
}{
"code": "<string>",
"data": {
"errors": [
{
"code": "<string>",
"field_name": "<string>",
"message": "<string>",
"value": "<string>"
}
],
"message": "<string>"
},
"message": "<string>"
}{
"code": "<string>",
"data": {
"errors": [
{
"code": "<string>",
"field_name": "<string>",
"message": "<string>",
"value": "<string>"
}
],
"message": "<string>"
},
"message": "<string>"
}Liquidity management
Edit bank account
Changes the IBAN or account name of a liquidity bank account.
PUT
/
v1
/
liquidity
/
bank-accounts
/
{id}
Change the IBAN or account name of a liquidity bank account
curl --request PUT \
--url https://api.pgw-sandbox.finventi.com/v1/liquidity/bank-accounts/{id} \
--header 'Content-Type: application/json' \
--data '
{
"accountName": "<string>",
"iban": "<string>"
}
'import requests
url = "https://api.pgw-sandbox.finventi.com/v1/liquidity/bank-accounts/{id}"
payload = {
"accountName": "<string>",
"iban": "<string>"
}
headers = {"Content-Type": "application/json"}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({accountName: '<string>', iban: '<string>'})
};
fetch('https://api.pgw-sandbox.finventi.com/v1/liquidity/bank-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/v1/liquidity/bank-accounts/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'accountName' => '<string>',
'iban' => '<string>'
]),
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/v1/liquidity/bank-accounts/{id}"
payload := strings.NewReader("{\n \"accountName\": \"<string>\",\n \"iban\": \"<string>\"\n}")
req, _ := http.NewRequest("PUT", 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.put("https://api.pgw-sandbox.finventi.com/v1/liquidity/bank-accounts/{id}")
.header("Content-Type", "application/json")
.body("{\n \"accountName\": \"<string>\",\n \"iban\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pgw-sandbox.finventi.com/v1/liquidity/bank-accounts/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"accountName\": \"<string>\",\n \"iban\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"accountName": "<string>",
"accountType": "OPERATIONAL",
"bic": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"createdBy": "<string>",
"currency": "<string>",
"iban": "<string>",
"id": 123,
"updatedAt": "2023-11-07T05:31:56Z",
"updatedBy": "<string>"
}{
"code": "<string>",
"data": {
"errors": [
{
"code": "<string>",
"field_name": "<string>",
"message": "<string>",
"value": "<string>"
}
],
"message": "<string>"
},
"message": "<string>"
}{
"code": "<string>",
"data": {
"errors": [
{
"code": "<string>",
"field_name": "<string>",
"message": "<string>",
"value": "<string>"
}
],
"message": "<string>"
},
"message": "<string>"
}{
"code": "<string>",
"data": {
"errors": [
{
"code": "<string>",
"field_name": "<string>",
"message": "<string>",
"value": "<string>"
}
],
"message": "<string>"
},
"message": "<string>"
}Overview
This endpoint changes the IBAN or account name of a registered liquidity bank account. The account type cannot be changed; remove the account and add it again instead. The same validation as when adding an account applies to the new IBAN. Transfers already created keep the account details they were created with. Requires thetransaction-manager role or a read-write API client.Path Parameters
Body
application/json
Response
Liquidity bank account updated
Available options:
OPERATIONAL, SAFEGUARDING BIC resolved from the IBAN when the account was registered
Last modified on October 8, 2026