Get bank information for iban
curl --request GET \
--url https://api.pgw-sandbox.finventi.com/v1/bank-info/{iban}import requests
url = "https://api.pgw-sandbox.finventi.com/v1/bank-info/{iban}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.pgw-sandbox.finventi.com/v1/bank-info/{iban}', 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/bank-info/{iban}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.pgw-sandbox.finventi.com/v1/bank-info/{iban}"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.pgw-sandbox.finventi.com/v1/bank-info/{iban}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pgw-sandbox.finventi.com/v1/bank-info/{iban}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"bic": "EXAMPLEBICX",
"sepaSchemas": {
"SDDCORE": false,
"SEPACT": true,
"SEPAINST": true,
"SWIFTCORE": false
},
"address": {
"buildingName": "EXAMPLE HOUSE",
"buildingNumber": "14",
"countryCode": "LT",
"countryName": "LITHUANIA",
"countrySubDivisionCode": "LT-VL",
"countrySubDivisionName": "VILNIUS COUNTY",
"districtName": "CENTRAL DISTRICT",
"postCode": "LT-01234",
"streetName": "EXAMPLE STREET",
"townLocationName": "OLD TOWN",
"townName": "VILNIUS"
},
"bankName": "EXAMPLE BANK LTD"
}{
"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>"
}Bank Information
Get bank information for IBAN
Retrieves bank details and supported payment schemes for a given IBAN.
GET
/
v1
/
bank-info
/
{iban}
Get bank information for iban
curl --request GET \
--url https://api.pgw-sandbox.finventi.com/v1/bank-info/{iban}import requests
url = "https://api.pgw-sandbox.finventi.com/v1/bank-info/{iban}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.pgw-sandbox.finventi.com/v1/bank-info/{iban}', 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/bank-info/{iban}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.pgw-sandbox.finventi.com/v1/bank-info/{iban}"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.pgw-sandbox.finventi.com/v1/bank-info/{iban}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pgw-sandbox.finventi.com/v1/bank-info/{iban}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"bic": "EXAMPLEBICX",
"sepaSchemas": {
"SDDCORE": false,
"SEPACT": true,
"SEPAINST": true,
"SWIFTCORE": false
},
"address": {
"buildingName": "EXAMPLE HOUSE",
"buildingNumber": "14",
"countryCode": "LT",
"countryName": "LITHUANIA",
"countrySubDivisionCode": "LT-VL",
"countrySubDivisionName": "VILNIUS COUNTY",
"districtName": "CENTRAL DISTRICT",
"postCode": "LT-01234",
"streetName": "EXAMPLE STREET",
"townLocationName": "OLD TOWN",
"townName": "VILNIUS"
},
"bankName": "EXAMPLE BANK LTD"
}{
"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 retrieves comprehensive bank information based on an IBAN. Use it to validate account details and check payment scheme support before initiating transactions.Information Provided
- Bank Identifier Code (BIC)
- Bank name
- Supported SEPA schemes
- Reachability status
Use Cases
- IBAN validation
- Payment routing verification
- Scheme compatibility checks
- Bank identification
Unresolvable IBANs
If the bank for the IBAN cannot be resolved (the IBAN is not covered by the bank directory or its format is invalid), the endpoint returns HTTP 400 with an error message such asFailed to resolve bic for iban. Treat this as “unknown bank”: before creating a payment to such an IBAN, either obtain the BIC from the payer and pass it explicitly in the payment request, or reject the payment on your side. The same resolution is used when a payment is created without a BIC, so calling this endpoint first lets you catch the problem before the payment is submitted.Path Parameters
Iban to get information for
Response
Returned iban information
Bank BIC.
Example:
"EXAMPLEBICX"
Map of supported payment schemas.
Show child attributes
Show child attributes
Example:
{ "SDDCORE": false, "SEPACT": true, "SEPAINST": true, "SWIFTCORE": false }
Structured bank address. Returned only for SWIFT-reachable banks; may be absent when the reference data has no structured address.
Show child attributes
Show child attributes
Bank name. For SWIFT-reachable banks this is the institution name from SWIFT reference data; otherwise it is resolved from the BIC directory and returned only when enabled by tenant configuration.
Example:
"EXAMPLE BANK LTD"
Last modified on September 2, 2026