Register an operational or safeguarding bank account
curl --request POST \
--url https://api.pgw-sandbox.finventi.com/v1/liquidity/bank-accounts \
--header 'Content-Type: application/json' \
--data '
{
"accountName": "<string>",
"iban": "<string>"
}
'import requests
url = "https://api.pgw-sandbox.finventi.com/v1/liquidity/bank-accounts"
payload = {
"accountName": "<string>",
"iban": "<string>"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({accountName: '<string>', iban: '<string>'})
};
fetch('https://api.pgw-sandbox.finventi.com/v1/liquidity/bank-accounts', 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",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
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"
payload := strings.NewReader("{\n \"accountName\": \"<string>\",\n \"iban\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.pgw-sandbox.finventi.com/v1/liquidity/bank-accounts")
.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")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.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>"
}Liquidity management
Add bank account
Registers an operational or safeguarding bank account for liquidity transfers.
POST
/
v1
/
liquidity
/
bank-accounts
Register an operational or safeguarding bank account
curl --request POST \
--url https://api.pgw-sandbox.finventi.com/v1/liquidity/bank-accounts \
--header 'Content-Type: application/json' \
--data '
{
"accountName": "<string>",
"iban": "<string>"
}
'import requests
url = "https://api.pgw-sandbox.finventi.com/v1/liquidity/bank-accounts"
payload = {
"accountName": "<string>",
"iban": "<string>"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({accountName: '<string>', iban: '<string>'})
};
fetch('https://api.pgw-sandbox.finventi.com/v1/liquidity/bank-accounts', 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",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
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"
payload := strings.NewReader("{\n \"accountName\": \"<string>\",\n \"iban\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.pgw-sandbox.finventi.com/v1/liquidity/bank-accounts")
.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")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.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>"
}Overview
This endpoint registers an operational or safeguarding account for withdrawals to safeguarding and EKS transfers. The BIC is resolved from the IBAN, the currency is EUR, and the account name is used as the debtor or creditor name of the payment.Validation
- The IBAN must not already be registered
- The BIC must be resolvable from the IBAN
- An operational account must be held under one of your BICs
transaction-manager role or a read-write API client.
For EKS transfers, the operational account must also be registered with Latvijas Banka as a pre-fund increase source (EKS registration forms, fields 1.3.1 and 1.5.1).
Body
application/json
Account name, used as the debtor or creditor name of the payment
Maximum string length:
70OPERATIONAL for the tenant's own account a withdrawal is debited from, SAFEGUARDING for the account it is paid to
Available options:
OPERATIONAL, SAFEGUARDING Account IBAN
Required string length:
1 - 34Response
Liquidity bank account registered
Available options:
OPERATIONAL, SAFEGUARDING BIC resolved from the IBAN when the account was registered
Last modified on October 8, 2026